How it works?
Over Bluetooth technology Bluetooth Master lets users perform the following tasks easily and promptly:
Why Bluetooth Master?
By installing this application you will get
The application includes four modules:
Search, Dashboard and Settings modules are accesses through icon in the top right corner of the application. Transfer to Details module is available after single click on the device in the lists of Search and Dashboard modules.
Lets you start Bluetooth devices search process separately for each type - Bluetooth Classic and Bluetooth Low Energy (device type can be set up by default in Settings).
To enforce search select Bluetooth device type using the appropriate radio button and press icon in the top right corner of the application. The search will run during the time, which was set up in Settings for this module. The Search can be terminated by pressing round progress bar in the top right corner of the application.
Each time you start search, an appropriate list of the earlier found devices of the selected type will be cleared, while the list f another type will remain. Two lists - Bluetooth Classic and Low Energy - are independent, that is why you can transfer between the lists and explore each device in details.
Completeness of the device data displaying can be set up in Settings.
Search Module has filters, which enable found devices displaying by set up criteria. Filter is called up via floating button in bottom-right corner of the Search Module. In a filter you can assign a plain text, which will be searched in the name of the device, it's MAC address, class, type as well as scanrecord. RSSI level can de assigned. In this case, devices with the higher level value will be displayed in the list. Also you can assign filter for both plain text information and RSSI level connecting the query by logical AND/ OR. Found devices list is available for sending in a plain text or JSON report to your local server or local programs. Just press icon in the top right corner of the application.
Reports are sent separately by device type after you have chosen it via appropriate radio button. You can also send report on chosen devices only. To do this, chose required devices by long click and press icon. Single click on the device in the list will transit you to the Details. This module parameters can be assigned in Search section of the Settings.
Allows you to view detailed information about chosen Bluetooth device, interact with the device through RFComm and GATT terminals, send reports on this interaction, add device to the Dashboard.
The Module consists of three sections: Home, GATT terminal, RFComm terminal.
An appropriate section can be chosen using floating button in the bottom-right corner of the application. Sections are symbolized by letters: H - Home, S - GATT terminal, T - RFComm terminal. In the top part of each section a general information about the device is displayed. After a long press on the device name a dialog will appear, where you can change the device name.
In the Home section you can find data on device geography, SDP service list, scanrecord decoding. Transition between these data is available via appropriate radio buttons - Map, SDP, Scanrecord.
Once you transit to Map position, you will be able to specify geographic coordinates of any device by one click. In the list of SDP services UUID of the services and their names are displayed. Upon single click on SDP service his UUID will be added to My Service parameter in RFComm terminal settings.
You can pairing to this device or cancel it in Home section through P icon in the top right corner of the application.
In GATT terminal section you can read and change GATT characteristics of Bluetooth devices, that support GATT server. To connect a Bluetooth device press icon in the top right corner of the application. Event log will be displayed during connection. If connection succeeded, the application will turn to Service position and display GATT services with it's characteristics received from device. Upon pressing the characteristic, the application will display the screen where you will be able to assign a new value of the characteristic, both in plain text and в hexadecimal formats, as well as turn on a notification. If a characteristic has descriptors, the application will display it and enable assigning of a new value for them both in plain text and hexadecimal formats.
To operate with the other characteristic, just turn to service list using Services radio button and select required characteristic.
GATT terminal screen has icon, command list will appear upon pressing it. This command list allows you to inquire RSSI level on remote device, assign new MTU value, set connection priority, display and clear the log of GATT connection. Upon pressing icon a GATT terminal settings dialog will appear, like in Settings Module. In this dialog you can specify the terminal to read all given characteristics at once upon connection to the device. In this case the application will read all data at once, but it will take more time in comparison with reading each separate characteristic after pressing it in the service list.
The Expand Service List flag specifies the application to display service list expanded/ minimized. If you know the characteristic you will operate with, clear the check box. This will let you to go right to the necessary characteristic without long scrolling of the service list.
In these settings you can also set up an Automatic Connection flag and Reading Timeout. The last parameter will let you accelerate characteristics reading while working with fast devices, as well as enhance reliability during reading characteristics while working with slow devices.
GATT terminal will always notify you about successful command execution. By pressing icon you can close GATT connection, like pressing progress bar icon in the top right corner of the application during GATT connection.
RFComm terminal will allow you to connect to Bluetooth device via RFComm protocol. Prior to connection to the device chose required SDP service (SPP, Dial up, My service) using radio button and press RFComm terminal will allow you to connect to Bluetooth device via RFComm protocol. Prior to connection to the device chose required SDP service (SPP, Dial up, My service) using radio button and press icon. During this connection an event log will be displayed. If connection successes you can enter the command and get response from the device. Your commands and device responses will be displayed below in reverse chronological icon. During this connection an event log will be displayed. If connection successes you can enter the command and get response from the device. Your commands and device responses will be displayed below in reverse chronological order.
The screen has icon. When you press it a dialog with the commands list appears, including Clear Log command. Upon being selected one the first five (fast) command will be sent to the device automatically. This command list can be updated in this module settings by pressing icon.
In the settings in addition to command assigning you can specify the type of mode (secure/ insecure connection), insert LF and CR symbols in the end of the command, sending format - plain text or hexadecimal, device response displaying format (plain text or hexadecimal), as well as specify your service UUID, which will be used when you chose My Service radio button during connection to the device.
By pressing icon, you can close RFComm connection, like pressing round progress bar icon in the top right corner of the application during RFComm connection.
Upon Send Report menu option call up the application makes consolidated report by the whole information, that had been received in GATT, RFComm terminals and sends it to the specified by you in Report Receiver (local programs or server).
This module parameters can be assigned in Details section of Settings module. RFComm and GATT terminal settings are duplicated on their screens, that will allow you to change it rapidly without leaving Details module while operating with a concrete Bluetooth device. Also you can specify in settings a screen that will be displayed when Details module opens (Home, GATT terminal, RFComm terminal).
Allows you to work with earlier saved devices and transit to Details module of the chosen device. The module has expanded search, which allows to find devices by any information (device name, MAC address, class, type, manufacturer), as well as assign geographic location for device search.
Geographic search allows you, while being in definite location, to select rapidly devices in this location. That can be very convenient if you have a lot of geographically distributed Bluetooth devices, which need to be inquired periodically, for example meteorological, technological, medical probes and smart things. The size of Search area can be assigned in Settings, by choosing the square length in meters. Also you can set up search by both plain text data and geographic location, connecting requests by logical AND/OR.
In order to delete devices, make long click on it to select it and press icon in the top right corner of the application. Repeated long click cancels the device choice.
This module parameters can be assigned in Dashboard section of the Settings module, where you can also call up a command of all devices deletion from the Dashboard.
Settings for the each module have been described above.
In this part of the Tutorial you will obtain general settings description for the application and all modules, mentioned in Settings module.
In Bluetooth Section using the Turn on When Starting flag you specify the application to enable Bluetooth adapter upon application running. Using Turn off When Closing flag you specify the application to disable the adapter upon closing the application.
In General section you can assign:
In settings for receiving server report an alias name is to be indicated in the Name field, in URL field a full URL of the script is to be indicated, which will receive POST query from reports in the body of this request. Supported protocols are HTTP, HTTPS, Web Socket, Web Socket Secure. Web Socket protocols are specified separated by commas.
If you server requests authorization by the name/ password, type you authorization data in the Name and Password fields. If these data are not specified, the application will attempt to send a report to the served without authorization.