CalAmp BLD01 User Manual
User Manual
Version:
Page #:
Feature: Bluetooth Support
CalAmp BlueBoard User Manual
FCC ID: APV-BLD01
IC: 5843A-BLD01
1.1
1 of 20
Version:
Page #:
Author
Version
Date
Note of changes
Boris Velv
1.0
Imad Rizk
1.1
4/16/2018
Feature: Bluetooth Support
User Manual
1.1
2 of 20
User Manual
Version:
Page #:
Feature: Bluetooth Support
1 Introduction ........................................................................................................................ 4
2 Description .......................................................................................................................... 4
3 Setup ................................................................................................................................... 5
3.1 LMU BT LE driver streams and serial port configuration parameters setup example.
5
3.2 LMU BTST SPP driver streams and serial port configuration parameters setup
example. ................................................................................................................................. 5
3.3 LMU Bluetooth driver configuration parameters setup. ............................................ 6
3.4 LMU user serial message configuration parameters setup example......................... 7
3.5 BTCS version format. ................................................................................................... 8
1.1
3 of 20
3.6 BTCS default Pass key. ................................................................................................. 8
3.7 Verification of LMU BTST SPP mode “Data” state example. ...................................... 8
3.8 Verification of LMU configuration for BLE “connection” mode example. ................. 9
3.9 Verification of LMU BLE “Advert broadcast scanning” mode configuration
example. ................................................................................................................................. 9
4 Usage ................................................................................................................................ 10
4.1 Demonstration of LMU BT SPP mode. ...................................................................... 10
4.2 Demonstration of BLE “connection” mode based remote temperature sensor
device. .................................................................................................................................. 10
4.3 Demonstration of BLE “broadcast scanning” mode based remote KeyFob DriverID
device. .................................................................................................................................. 12
5 PWA Label ......................................................................................................................... 12
6 Integration Instructions .................................................................................................... 13
7 License Agreement ........................................................................................................ 13
8 Limited Warranty ............................................................................................................ 18
9 Regulatory Information .................................................................................................. 20
User Manual
Version:
Page #:
Feature: Bluetooth Support
1 Introduction
This application note documents the use of Bluetooth chipset device based on TI
MSP430F5438A microcontroller and CC2564 RF processor. And the module based on TI2640
chipset.
The BTCS device has Bluetooth LE4.0 dual mode capabilities. The firmware is based on
Stonestreet One Bluetopia protocol stack. The document uses as an example the Texas
Instruments CC 2541 Sensor Tag with the purpose of reading the temperature from TI
TMP006 temperature sensor. A “KeyFob” device which broadcasts “Button xx press” events
together with “battery charge state as percentage“ information is used as another
examplechiop. It is a Bluetooth LE only.
2 Dscription
1.1
4 of 20
The BTCS device is connected to a LMU serial port. The BTCS unit supports Bluetooth SPP
mode of operation. BTCS plays a server slave device which upon connection with a Remote
Bluetooth client master device can exchange data. There are two Bluetooth low energy
(BLE) modes of operation: “Connection” based and an “Advert Broadcast Scanning” mode.
In “Connection” mode, the LMU firmware starts the discovery process of all BLE remote
devices. If a match is found based on the remote address stored as an “APP PARAM 2082”,
the discovery sequence is ended and the connection process starts. Upon the reception of
“CONNECTED_OK” event, the user will be able to send setup commands to the remote
device, and consequently receive the sensor data.
In “Advert Broadcast scanning” mode BT driver simply receives the broadcast
advertisements from all remote BLE devices.
The block diagram is presented in Figure 1 below.
Version:
Page #:
User Serial
BT STREAM
BLE “AT cmd” Parser
BT_DRV
BT_ Sensor
BT_ Sensor
BT_DRV
BT STREAM
User Serial
BTCS
BTCS
SPP
Feature: Bluetooth Support
Tx Data
Rx Data
User Manual
1.1
5 of 20
Figure 1
3 Setup
3.1 LMU BT LE driver streams and serial port configuration parameters
setup example.
• Map debug stream to Aux1 port.
AT$APP PARAM 3072,3,0
• Bluetooth stream to AUX 2.
AT$APP PARAM 3072,14,1
• A Bluetooth stream baud rate set to 115200
AT$APP PARAM 3073,14,12
• A Bluetooth stream set to 8, n, 1
AT$APP PARAM 3074,14,3
• User0 Stream to Bluetooth Port
AT$APP PARAM 3072,0,8
3.2 LMU BTST SPP driver streams and serial port configuration
parameters setup example.
• LMU BT driver SPP mode setup:
at$app param 2083,0,0
User Manual
Version:
Page #:
Feature: Bluetooth Support
• Turn off stream for User 0:
at$app param 3072,0,255
• Map Debug stream to BT_port:
at$app param 3072,3,8
• Reset LMU :
ATRESET
LMU debug log will be visible on BT remote Android device console upon connection.
The connection process is initiated by Android master device.
3.3 LMU Bluetooth driver configuration parameters setup.
• PID 2082 holds up to 8 remote device addresses 6 Bytes long.
at$app param 2082,0,144,89,175,10,169,169 corresponding to remote device MAC
address: 0x9059AF0AA9A9
The first location in the array of addresses above is used to establish a BLE
connection to a remote BLE device in BLE” Connected” mode.
All unused addresses must contain 255,255,255,255,255,255.
1.1
6 of 20
• PID 2083 holds the mode of operation and it is 2 Bytes long. Bit 0 is used for mode
selection 0- standard-SPP, and 1- Low Energy.
For instance to configure BT driver in SPP mode use the following:
at$app param 2083,0,0
For example in order to configure BT driver in BLE “Connection” mode use:
at$app param 2083,0,1
Bit 1 defines if broadcast scanning is enabled 0 – disabled , 1 – enabled.
Bit 2: 0- whitelist should be used to filter out the remote devices with MAC
addresses which are not found in the list of the remote addresses. BTCS ignores the
whitelist functionality at present.
1: scan all advert broadcasts, no whitelist.
For instance in order to configure BT driver in “LE advert broadcast scan all” mode
use:
at$app param 2083,0,7
• To disable Bluetooth driver use:
at$app param 2083,0,65535
• The above commands allow the LMU to switch from one mode to another without
the necessity of AT reset command, given that the data stream configuration is not
changed. It could take up to 40s to complete the switch.
User Manual
Version:
Page #:
Feature: Bluetooth Support
3.4 LMU user serial message configuration parameters setup example.
• If user data packets from the remote device are required to be transmitted to the
backend server at a rate above one per five seconds, the User Message Disposition
S-Register must be set to unacknowledged Message:
S-137< VALUE = 5>
ats137=5
• Configure serial message filters:
at$app param 2178,0,""
at$app param 2178,1,""
at$app param 2178,2,""
at$app param 2178,3,""
at$app param 2178,4,""
at$app param 2178,5,""
at$app param 2178,6,""
at$app param 2178,7,""
Use the same as above for 2176 app param:
at$app param 2176,0,""
at$app param 2176,1,""
at$app param 2176,2,""
at$app param 2176,3,""
at$app param 2176,4,""
at$app param 2176,5,""
at$app param 2176,6,""
at$app param 2176,7,""
1.1
7 of 20
• Ensure that these new configurations do not cause any stream conflicts. Send the
query:
at$app stream?
Below is an example of a stream conflict:
at$app stream?
Stream Port Rate Word
------ ---- ---- --- 0:User0 8:BTPort 9600 8/N/1
1:Modem 4:Radio 115200 8/N/1
2:User1 - 3:Debug 0:Aux1 115200 8/N/1 PREEMPT
4:NMEA Out - 5:DUN --
Loading...