Bluetooth Master

is an application designed for Android-powered devices, that allows you to obtain comprehensive data about Bluetooth devices in Classic and Low Energy mode over RFComm and GATT terminals and share it.

How it works?

Over Bluetooth technology Bluetooth Master lets users perform the following tasks easily and promptly:

  • Find and explore any Bluetooth device characteristics in Classic and Low Energy modes.
  • Manipulate Bluetooth devices over RFComm and GATT terminals, having all settings in your hand.
  • Send reports about Bluetooth devices in plain text and JSON formats to your private server or using local programs , for example, clipboard, SMS, WhatsApp and others.
  • Store your devices records and refer to them periodically without preliminary scanning, inquiry it and send new reports accumulating and analyzing device data by time.

Why Bluetooth Master?

  • The application design is responsive both for small smartphone screens and big tablet screens.
  • The application interface is understandable and succinct, that allows to focus on data received from Bluetooth devices.
  • All operations start after one or two clicks. No need to do multiple click to start operation.
  • You are provided with a full control over Bluetooth devices interaction as each interaction parameter can be set up in accordance with your desire.
  • It has comparatively small size, that allows you to install and run it on devices with different capability.
  • It is supported by Android 4.3 and later devices.

By installing this application you will get

  • Efficient tool for Bluetooth devices monitoring, set up in accordance with your demands.
  • An opportunity to receive, keep and export monitoring data by the most convenient and customary ways.
  • A perfect tool for manipulating you Bluetooth devices.

The application includes four modules:

  • Search
  • Details
  • Dashboard
  • Settings

 Search, Dashboard and Settings modules are accesses through More 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.

Search Module

 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 Search 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 Share 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 Share 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.

Details Module

 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 Bluetooth connect 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 Command list 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 Settings 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 Bluetooth disconnect 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 Bluetooth connect 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 Command list 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 Settings 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 Bluetooth disconnect 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).

Dashboard Module

 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 Delete 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 Module

 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:

  • Report format (plain text or JSON) for sending it to the receiver.
  • Report receiver - local programs or server.
  • Startup screen (Dashboard, Search, Settings), which will appear first upon application running.
  • Settings for receiving server report.

 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.

BT Master is now available on Google Play.