The Bluetooth GATT (Generic Attribute Profile) governs communication between BLE devices via a dedicated connection.
For GATT documentation, see https://www.bluetooth.org:
The TruConnect device acts as the Peripheral (GATT server) and a BLE mobile device such as a phone or pad acts as the Central (GATT client).
Once Central can connect to many Peripherals, but each Peripheral may connect to only one Central.
The Central can connect to a TruConnect module via BLE, and place it in remote command mode. This allows the full range of control and monitoring available via TruConnect.
You can also place the TruConnect module in STREAM mode, and send and receive streams of data to and from the device.
This section introduces a few terms necessary for later discussion. These terms have a specific meaning in the BLE context.
BLE devices operate in two broad classifications: Central and Peripheral.
Peripherals offer Services, which consist of Characteristics. Services and Characteristics are distinguished by universally unique identifiers, or UUIDs.
Peripherals advertise, by broadcasting some services and characteristics. This allows them to be discovered by Centrals.
After discovering a Peripheral of interest, a Central requests a connection to the Peripheral. After connecting, the Central can discover the Peripheral's Services, and within those Services the Peripheral's Characteristics. The Central can read the value of Characteristics, subscribe to the value of Characteristics, and in some cases write the value of the Characteristic back to the Peripheral.
To subscribe to a Characteristic, the BLE mechanism is to register for notification when that Characteristic is changed, and provide a callback to be called on each notification. Typically the callback reads the Characteristic value and takes any action required.
The general procedure for using a Central to interact with a Peripheral is as follows:
The implementation of these procedural steps depends on the Central platform.
TruConnect defines a GATT profile consisting of a TruConnect Service and three TruConnect Characteristics, Rx, Tx and Mode.
An ACKme TruConnect device can be identified by its
SERVICE_TRUCONNECT_UUID. To interact with a TruConnect device as a Peripheral, use the TruConnect serial interface service.
The Rx (receive) and Tx (transmit) Characteristics are named from the point of view of the Peripheral TruConnect device.
To send a string to be received by the Peripheral serial interface, write to the Rx Characteristic.
To read a string transmitted from the Peripheral serial interface, read from the Tx Characteristic.
For an ACKme TruConnect device, the serial interface Service and Characteristics are as follows:
|Service or Characteristic||Abbr||UUID||Values|
| || ||-|
| ||Rx|| ||Strings sent to TruConnect serial interface|
| ||Tx|| ||Strings received from TruConnect serial interface|
| ||Mode|| ||
The Abbr column in the table defines abbreviations used in this documentation only.
The TruConnect device acts as a Peripheral, and the BLE mobile device acts as a Central.
This section describes TruConnect connection and communication procedures in general.
Specific implementations are documented in the Communicating via BLE application note as described below.
Scan for the TruConnect Peripheral using the procedure required by the Central platform.
After obtaining the Peripheral's advertising data by scanning, discover the Peripheral's Characteristics and subscribe to the appropriate Characteristics by registering for notification when the value of a Characteristic changes.
To read from the Peripheral's serial interface, subscribe to the Tx characteristic as described above.
On each notification, a local variable can be set to the value of the Tx characteristic.
To write to the device serial interface, write to the Rx characteristic.
Only the following command mode transitions are permitted via BLE:
Note: The TruConnect device must be in
STREAM_MODE before another BLE device can switch it into
See Serial Interface for details of serial interface mode operation.
Switch the mode via BLE by writing to the Mode characteristic.
First switch to
REMOTE_COMMAND_MODE as described above.
Then, write the command to the TruConnect Rx characteristic. See Writing to a TruConnect Device Serial Interface above.
Up to 20 bytes can be written to Rx in a single write. Repeated writes are required for longer strings.
Read the response back as described in Reading from a TruConnect Device Serial Interface.
All commands must be terminated by CR-LF (\r\n), adding two bytes to the length.
It may be more convenient to read responses to TruConnect commands if echo is turned off and response headers are turned on.
See Serial Interface for details of response format.
First switch to
STREAM_MODE as described above.
To stream data to the TruConnect device, write the data to the TruConnect Rx characteristic. See Writing to a TruConnect Device Serial Interface above.
You can verify that the data is received by connecting a TruConnect terminal to the device. See Getting Started. The data appears on the terminal display.
To stream data to the TruConnect device, read the data from the TruConnect Tx characteristic. See Reading from a TruConnect Device Serial Interface above.
You can verify that the data is received by connecting a TruConnect terminal to the device. Data sent from the central appears directly on the terminal display.
You can send data by connecting a TruConnect terminal to the device. Type data into the terminal. The data is sent directly to the central.
Toggle sidebar with ctrl+left arrow.