Laird BL654 Installation and operating instructions

A
Embedded Wireless Solutions Support Center:
http://ews-support.lairdtech.com
www.lairdtech.com/bluetooth
1
© Copyright 2021 Laird Connectivty. All Rights Reserved
Americas: [phone]
Europe: [phone]
Hong Kong: [phone]
Application Note v1.2
The BL654 firmware natively supports Direct Test Mode (DTM) commands as specified in the Bluetooth SIG’s Bluetooth Core
Specifications v 5.0 vol. 6 part F - Direct Test Mode, accessible from the following link:
www.bluetooth.com/specifications/bluetooth-core-specification
The purpose of DTM is to test the operation of radio at the physical layers such as for transmit power and receiver
sensitivity. This is useful for regulatory EMC testing or for co-located radio testing with another radio system.
This radio test can be carried out by dedicated test equipment (such as Anritsu MT8852 or similar) with the BL654 in DTM
mode as the device under test. Alternatively, you can send DTM commands from a PC using a terminal program such as
UwTerminalX. In both cases, the DTM commands remain the same.
This document describes BL654 radio testing using the in-built Direct Test Mode (DTM) firmware and Nordic’s nRFgo Studio
or Laird Connectivity BleDtmRfTool.
▪Entering DTM mode for the BL654
▪Using Nordic nRFgoStudio DTM panel (or Laird BleDtmRfTool) to BLE radio test BL654 in either Transmit or Receive
mode.
▪Exiting DTM mode for the BL654
To use DTM, you need the following:
▪DVK-BL654-1.0 development board
▪Windows PC
▪UwTerminalX by Laird Connectivity (available at https://github.com/LairdCP/UwTerminalX/releases)
▪Laird Connectivity BleDtmRfTool –This is available from the Documentation section of the BL654 product page.
Note: You must be logged into your Laird Connectivity account for the BleDtmRfTool to work.
▪Nordic nRFgoStudio application software (the complete install found on the Downloads panel at the following link:
http://www.nordicsemi.com/eng/Products/Bluetooth-low-energy/nRF52832
Note: Please install the correct version (32- or 64-bit) for your operating system.
Code
Name
Version
nRFgo Studio-Win32
Software tool for nRFgo Starter Kit and Development Kits for 32-bit (x86) Windows
XP, Windows Vista, Windows 7, and Windows 8
1.21.2
nRFgo Studio-Win64
Software tool for nRFgo Starter Kit and Development Kits for 64-bit (x64) Windows
Vista, Windows 7, and Windows 8
1.21.2

https://www.lairdconnect.com/wireless-
modules/bluetooth-modules
2
© Copyright 2021 Laird Connectivity, Inc.
All Rights Reserved
Americas: [phone]
Europe: [phone]
Hong Kong: [phone]
We assume the DVK-BL654-1.0 development kit has its default out-of-the-box settings as described in the BL654 Quick Start
Guide (available from the BL654 product page https://www.lairdconnect.com/wireless-modules/bluetooth-
modules/bluetooth-5-modules/bl654-series-bluetooth-module-nfc). In this mode, it is in AT or interactive mode (no
smartBASIC application loaded or running) on power up.
Figure 1: J12 fitted over pins 1 and 2, and SW3 (reset button)

https://www.lairdconnect.com/wireless-
modules/bluetooth-modules
3
© Copyright 2021 Laird Connectivity, Inc.
All Rights Reserved
Americas: [phone]
Europe: [phone]
Hong Kong: [phone]
To enter DTM, follow these steps:
Open UwTerminalX.
Ensure you’re using the latest version of UwTerminalX by clicking the Update tab and then, in the UwTerminalX
panel, click Check for Updates.
When you’re running the newest version of UwTerminalX, open the Config tab.
In the device drop down, select BL654 to populate the default communications settings.
Select the correct COM port.
If you cannot select BL654, manually select the following UART settings (shown in Figure 2):
COM Port
Port corresponding to your development kit
Baud Rate
115200
Parity
None
Stop Bits
1
Data Bits
8
Handshaking
CTS/RTS
Figure 2: UwTerminalX Settings
Click OK to connect.

https://www.lairdconnect.com/wireless-
modules/bluetooth-modules
4
© Copyright 2021 Laird Connectivity, Inc.
All Rights Reserved
Americas: [phone]
Europe: [phone]
Hong Kong: [phone]
Set up the module into Direct Test Mode, you will need to retrieve two sets of four characters each which function as
a unique passcode to enter direct test mode. To retrieve the characters, issue the following command:
AT I 14
You should receive a response such as:
10 14 01 123456789ABC
Note the characters in the highlighted positions above. In our example in Figure 3, they are CB71 and 7B03.
Figure 3: Return from at i 14
To enter Direct Test Mode, using the characters you found in the previous steps, issue the AT+DTM command as
follows:
AT+DTM 0xCB717B03
The module is now in Direct Test mode.
Click Close Port to disconnect the development board from UwTerminalX.

https://www.lairdconnect.com/wireless-
modules/bluetooth-modules
5
© Copyright 2021 Laird Connectivity, Inc.
All Rights Reserved
Americas: [phone]
Europe: [phone]
Hong Kong: [phone]
Now that the module is in Direct Test Mode, it accepts DTM commands as specified in the BT SIG Bluetooth Core
Specifications. See Bluetooth Core Specifications v 4.1 vol. 6 part F - Direct Test Mode, at
https://www.bluetooth.com/specifications/bluetooth-core-specification.
To use Direct Test Mode, you need Nordic’s nRFgo Studio, found at: http://www.nordicsemi.com/eng/Products/Bluetooth-
low-energy/nRF52832
Once the BL654 is in DTM mode, you can communicate with the BL654 over the UART with UwTerminal using the following
communications settings:
COM Port
Same as before
Baud Rate
19200
Parity
None
Stop Bits
1
Data Bits
8
Handshaking
CTS/RTS
Before entering DTM Mode, you may configure TX Power, Baud Rate, and DCDC. Changing these values is optional.
However, if you choose, you may set these values as follows (Note that if using BL654 firmware 29.5.7.2 and an option is
changed, the following command must be used prior to entering DTM mode to allow the radio to operate: AT+DTMCFG 19
1):
Command
AT+DTMCFG 1 n
Values for n
8, 7, 6, 5, 4, 3, 2, 0, -4, -8, -12, -16, -20, -40
Default
8
Command
AT+DTMCFG 2 n
Values for n
9600, 14400, 19200, 38400, 57600, 115200
Default
19200
Command
AT+DTMCFG 3 n
Values for n
0 (Disabled), 1 (enabled)
Default
1

https://www.lairdconnect.com/wireless-
modules/bluetooth-modules
6
© Copyright 2021 Laird Connectivity, Inc.
All Rights Reserved
Americas: [phone]
Europe: [phone]
Hong Kong: [phone]
Command
AT+DTMCFG 11 n
Values for n
0 (Disabled), 1 (enabled)
Default
0
Command
AT+DTMCFG 4 n
Values for n
0 (Disabled), 1 (enabled)
Default
1
Command
AT+DTMCFG 5 n
Values for n
0 (Disabled), 1 (enabled)
Default
0
This will be ignored if AT+DTMCFG 5 is set to 0 (which is the default). If a bit is set then the bit number corresponds to the
GPIO number which is enabled.
Command
AT+DTMCFG 6 bitmask
Values for n
0x00000000 to 0xFFFFFFFF (bit 0 is the lowest significant bit)
Default
0
This will be ignored if AT+DTMCFG 5 is set to 0 (which is the default). If a bit is set then the bit number corresponds to the
GPIO number will have the direction input when the bit is 0 and an output when the bit is 1.
Command
AT+DTMCFG 7 bitmask
Values for n
0x00000000 to 0xFFFFFFFF (bit 0 is the lowest significant bit)
Default
0
This will be ignored if AT+DTMCFG 5 is set to 0 (which is the default). If a bit is set then the bit number corresponds to the
GPIO number will have the output set to this value if DTMCFG 7 was used to set the direction as output.
Command
AT+DTMCFG 8 bitmask
Values for n
0x00000000 to 0xFFFFFFFF (bit 0 is the lowest significant bit)
Default
0xFFFFFFFF

https://www.lairdconnect.com/wireless-
modules/bluetooth-modules
7
© Copyright 2021 Laird Connectivity, Inc.
All Rights Reserved
Americas: [phone]
Europe: [phone]
Hong Kong: [phone]
This will be ignored if AT+DTMCFG 5 is set to 0 (which is the default). If a bit is set then the bit number corresponds to the
GPIO number which is enabled.
Command
AT+DTMCFG 16 bitmask
Values for n
0x0000 to 0xFFFF (bit 0 is the lowest significant bit)
Default
0
This will be ignored if AT+DTMCFG 5 is set to 0 (which is the default). If a bit is set then the bit number corresponds to the
GPIO number will have the direction input when the bit is 0 and an output when the bit is 1.
Command
AT+DTMCFG 17 bitmask
Values for n
0x0000 to 0xFFFF (bit 0 is the lowest significant bit)
Default
0
This will be ignored if AT+DTMCFG 5 is set to 0 (which is the default). If a bit is set then the bit number corresponds to the
GPIO number will have the output set to this value if DTMCFG 7 was used to set the direction as output.
Command
AT+DTMCFG 18 bitmask
Values for n
0x0000 to 0xFFFF (bit 0 is the lowest significant bit)
Default
0xFFFFFFFF

https://www.lairdconnect.com/wireless-
modules/bluetooth-modules
8
© Copyright 2021 Laird Connectivity, Inc.
All Rights Reserved
Americas: [phone]
Europe: [phone]
Hong Kong: [phone]
nRFgoStudio does not allow the data rate to be changed and default is 1Mbps, other PHY data rates such as 2Mbps, coded
PHY 500kbps (s=2) and 125kbps (s=8) cannot be selected.
To begin using Direct Test Mode, follow these steps:
Open Nordic nRFgo Studio.
In nRFgo Studio, click Direct Test Mode in the features panel to open the Direct Test Mode panel as shown in
Figure 4.
Figure 4: Opening the Direct Test Mode panel
From there, you can place the module in constant TX or RX mode. Consult the nRFgo Studio built-in help for more
information.
To conduct a transmit test, configure the options in the Direct Test Mode panel as follows:
COM Port
Same as previous
Mode
Transmit
Channel
19 (2440 MHz)
Payload Model
PRBS9 –If a BLE-modulated TX signal is required
-or-
Constant Carrier –If a continuous [CW] TX signal is required
Payload Length
37 bytes
Once configured, click Start Test. If successful, no errors should show, as illustrated in Figure 5.

https://www.lairdconnect.com/wireless-
modules/bluetooth-modules
9
© Copyright 2021 Laird Connectivity, Inc.
All Rights Reserved
Americas: [phone]
Europe: [phone]
Hong Kong: [phone]
Figure 5: Successful initiation of TX Test
With the module is in a Transmit test, you can measure the signal on a spectrum analyzer.
To conduct a receive test, configure the options in the Direct Test Mode panel as follows:
COM Port
Same as previous
Mode
Receive
Channel
0 (2402 MHz)
Once configured, click Start Test. If successful, no errors should show.
Note: Rx Mode produces an RX LO leakage at the following frequency: 2*fRx-1MHz.

https://www.lairdconnect.com/wireless-
modules/bluetooth-modules
10
© Copyright 2021 Laird Connectivity, Inc.
All Rights Reserved
Americas: [phone]
Europe: [phone]
Hong Kong: [phone]
Laird Connectivity’s BleDtmRfTool allows all BT PHY data rates to be tested, 1 Mbps, 2 Mbps and coded PHY 500 kbps (s=2)
and 125 kbps (s=8).
To begin using Direct Test Mode, follow these steps:
Open Laird Connectivity BleDtmRfTool (Figure 6).
Figure 6: BleDtmRfTool UART communication settings
In BleDtmRfTool, click DTM button located in the top right to open the Direct Test Mode panel as shown in
Figure 7.
Figure 7: BleDtmRfTool