Skip to Content

Wiki source code of BLE Bluetooth Remote Configure

Last modified by Karry Zhuang on 2025/07/04 18:25
Hide last authors
Yi Wang 98.1 1 **Table of Contents:**
Xiaoling 8.2 2
Yi Wang 98.1 3 {{toc/}}
Xiaoling 37.1 4
Yi Wang 98.1 5
6
7
Yi Wang 190.1 8 = 1. Overview =
Xiaoling 8.2 9
10
Xiaoling 211.1 11 There are some new models of Dragino sensors support BLE type the link label remote configure. User can use mobile phone to configure the sensor via BLE.
Edwin Chen 1.1 12
13
Yi Wang 190.1 14 = 2. Support Models =
Edwin Chen 1.1 15
Xiaoling 8.2 16
Edwin Chen 1.1 17 Here list the models that support BLE and the method to activate BLE function.
18
19 {{velocity}}
20 $xwiki.ssfx.use("js/xwiki/table/table.css")
21 $xwiki.jsfx.use("js/xwiki/table/tablefilterNsort.js", true)
22 {{/velocity}}
23
Yi Wang 190.1 24 (% border="1" cellspacing="5" class="doOddEven filterable grid sortable" id="tableid" style="background-color:#f2f2f2; width:955px" %)
25 (% class="sortHeader" %)|=(% style="width: 303px; background-color: rgb(217, 226, 243);" %)Models|=(% style="width: 439px; background-color: rgb(217, 226, 243);" %)BLE Activate Method|=(% style="width: 211px; background-color: rgb(217, 226, 243);" %)Comments
26 |(% style="width:303px" %)(((
Mengting Qiu 38.1 27 All models with -LB, -LS , -NB, -NS, -CB, -CS suffix
Yi Wang 190.1 28 )))|(% style="width:439px" %)(((
Edwin Chen 2.1 29 Device is battery power type and BLE will be only activate on below case:
30
31 * Press button to send an uplink
Xiaoling 8.2 32
Edwin Chen 2.1 33 * Press button to active device.
Xiaoling 8.2 34
Edwin Chen 2.1 35 * Device Power on or reset.
36
37 If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
Xiaoling 33.1 38 )))|(% style="width:211px" %)
Edwin Chen 3.1 39
Edwin Chen 211.5 40 = 3. How to configure via BLE =
Edwin Chen 8.1 41
Edwin Chen 211.5 42 == 3.1 Configure via Mobile APP ==
Xiaoling 8.2 43
Edwin Chen 211.5 44 === 3.1.1 Download APP ===
Xiaoling 8.2 45
Edwin Chen 211.4 46
Edwin Chen 211.3 47 ==== **Download from Google Play Store** ====
Xiaoling 8.2 48
Yi Wang 123.1 49 Open the Google Play Store, search for "Devices.tool", download and install.
Edwin Chen 8.1 50
Yi Wang 190.1 51 [[image:image-20241230134826-1.png||_mstalt="429767" height="292" width="514"]]
Edwin Chen 8.1 52
Yi Wang 190.1 53 (% class="box errormessage" %)
Edwin Chen 188.1 54 (((
55 Note: APPLE version is not ready yet.
56 )))
Edwin Chen 8.1 57
Yi Wang 132.1 58
Edwin Chen 211.2 59 ==== **Download from Dropbox** ====
Xiaoling 161.1 60
Yi Wang 132.1 61
Yi Wang 152.1 62 Click on the URL below to enter Dropbox to download the app:
63
Yi Wang 189.1 64 [[Download link>>url:https://www.dropbox.com/scl/fo/gyscmfn1s03oz3n8rif8w/AJW7JoMQsQ56dtlls2SNf9c?rlkey=3q2cxwriyzh26vuairx01yebc&st=be5jv92w&dl=0]] 
Yi Wang 152.1 65
Xiaoling 161.1 66
Yi Wang 190.1 67 === 3.1.2 How to use BLE to configure Sensors ===
Edwin Chen 8.1 68
Xiaoling 103.1 69
Yi Wang 190.1 70 See Video Instruction: **[[Use BLE to configure Sensors>>https://youtube.com/shorts/Ajq2NvUslnw?feature=share]]**
Edwin Chen 105.1 71
72
Yi Wang 123.1 73 Install in mobile and run. Press the reset button of the device to be tested, and then click (% style="color:blue" %)**"SCAN BLUETOOTH DEVICES".**(%%) Find the correct device and connect(the correct device name should be the same as the DEV EUI of the device).
Edwin Chen 8.1 74
Yi Wang 190.1 75 [[image:image-20241230135129-4.png||_mstalt="429988" height="134" width="502"]]
Yi Wang 55.2 76
Yi Wang 190.1 77 [[image:image-20241230152054-8.png||_mstalt="430092" height="241" width="504"]]
Yi Wang 55.2 78
79
Yi Wang 123.1 80 After the connection is successful, enter the interface and click (% style="color:blue" %)**"DIALOGBOX".**
Yi Wang 55.2 81
82
Yi Wang 190.1 83 [[image:image-20241230151129-6.png||_mstalt="430092" height="413" width="507"]]
Yi Wang 55.2 84
Edwin Chen 30.1 85 Each device has unique password named **AT PIN**. Input the password and you will be able to get access to the UART of the device.
Edwin Chen 8.1 86
Yi Wang 190.1 87 [[image:image-20241230152403-9.png||_mstalt="429741" height="232" width="506"]]
Edwin Chen 30.1 88
Yi Wang 55.2 89 Enter AT PIN + line break in the dialog box, click (% style="color:blue" %)**"Send"**(%%), and return the data display (% style="color:blue" %)**"Password Correct"**(%%) to start configuring the AT command.
Edwin Chen 8.1 90
Yi Wang 190.1 91 [[image:image-20241230151602-7.png||_mstalt="429000" height="568" width="348"]]
Yi Wang 55.2 92
Yi Wang 91.1 93
Xiaoling 103.1 94 (% style="color:red" %)**Note:**
Yi Wang 55.2 95
Yi Wang 190.1 96 **Devices.Tool is now compatible with sending commands without line breaks, and supports the simultaneous configuration of multiple AT commands. A record is also automatically saved after an instruction is sent, and clicking on a command in the history will display it directly in the input box.**
Yi Wang 55.2 97
Yi Wang 190.1 98 [[image:image-20241230153041-10.png||_mstalt="449423" height="599" width="353"]]
Yi Wang 55.2 99
Yi Wang 85.2 100
Edwin Chen 213.1 101 === 3.1.3 Batch Configure ===
Yi Wang 55.2 102
Karry Zhuang 214.3 103 If you have many devices, you can use this batch modification function to uniformly modify the setting parameters of all devices.
Yi Wang 55.2 104
Karry Zhuang 214.3 105 The specific steps are as follows
Karry Zhuang 213.2 106
Karry Zhuang 214.4 107 Click the upper right corner and select Multi-device Config Json
Karry Zhuang 214.3 108
Karry Zhuang 216.2 109 [[image:1751623776387-758.png||height="415" width="290"]]
Karry Zhuang 214.4 110
Karry Zhuang 216.3 111 ~1. Choose your json configuration file.
Karry Zhuang 214.3 112
Karry Zhuang 216.3 113 2. Search for your Bluetooth device.
Karry Zhuang 214.4 114
Karry Zhuang 216.3 115 3. Click on the Bluetooth signal with the corresponding name to connect.
Karry Zhuang 214.4 116
Karry Zhuang 216.4 117 [[image:1751623802789-156.png||height="551" width="253"]]
Karry Zhuang 214.4 118
Karry Zhuang 216.5 119 The first step is to check your configuration instructions and device passwords.
Karry Zhuang 214.4 120
Karry Zhuang 216.5 121 Click the "Process" button to configure, wait for the configuration to complete.
Karry Zhuang 214.4 122
Karry Zhuang 216.5 123 If the instructions or passwords are incorrect, a prompt will be given and manual modification will be required.
Karry Zhuang 214.4 124
Karry Zhuang 218.2 125 [[image:1751624084823-405.png||height="522" width="268"]]
Karry Zhuang 214.4 126
Karry Zhuang 218.3 127 After clicking process, this pop-up is displayed, indicating that the configuration has been modified successfully.
Karry Zhuang 216.2 128
Karry Zhuang 218.3 129 [[image:1751624271257-846.png||height="637" width="414"]]
Karry Zhuang 216.4 130
Karry Zhuang 219.2 131 The content of the JSON file is as follows. You can modify it according to your desired settings. The above is just an example.
Karry Zhuang 216.4 132
Karry Zhuang 220.1 133 ~1. Default command: Configuration command that all devices will use (lower priority).
134 2. Special command for a single device:
135 Single device configuration command is matched based on the ID value.
136 Higher priority. Commands that conflict with the default command will override the default command.
137 The "pwd" field indicates the device password. It is not a required field. If you fill in "pwd", the user does not need to enter the password manually.
Karry Zhuang 216.4 138
Karry Zhuang 220.1 139 [[image:1751624398456-705.png||height="554" width="426"]]
140
Edwin Chen 213.1 141 === 3.1.4 Export configure logs ===
142
143
Yi Wang 55.2 144 Open the Devices Tool and click the icon in the upper right corner.
145
Yi Wang 190.1 146 [[image:image-20241230155425-16.png||_mstalt="454233" height="85" width="330"]]
Yi Wang 55.2 147
148
149 select the log you want to export, then click the share icon on the far right to enter the document that comes with your phone and choose to export it.
150
Yi Wang 190.1 151 [[image:image-20241230155528-17.png||_mstalt="455936" height="324" width="327"]]
Yi Wang 55.2 152
153
Edwin Chen 211.7 154 == 3.2 Configure via PC & USB to BLE adapter ==
Edwin Chen 11.1 155
Xiaoling 25.2 156
Herong Lu 19.1 157 Firstly, a USB to Bluetooth host is required
158
Yi Wang 190.1 159 [[image:image-20230601152915-3.png||_mstalt="430144"]]
Herong Lu 19.1 160
161
Yi Wang 190.1 162 [[image:image-20230601152950-4.png||_mstalt="430118"]]
Xiaoling 25.2 163
Herong Lu 19.1 164 Insert the Bluetooth host into the computer
165
Yi Wang 190.1 166 [[image:image-20230518151327-5.png||_mstalt="431535"]]
Herong Lu 19.1 167
Xiaoling 25.2 168
Herong Lu 19.1 169 Open the serial port assistant on the computer
170
Yi Wang 190.1 171 [[image:image-20230518145316-3.png||_mstalt="431054" height="560" width="730"]]
Herong Lu 19.1 172
173 Then connect according to the operating instructions of the purchased Bluetooth host
174
175 (be careful! The AT command in this description may be different from the AT command of the Bluetooth host you purchased. Please follow the instructions for the Bluetooth host you purchased)
176
177 The Bluetooth name to be connected is the DEVEUI of the node
178
Yi Wang 190.1 179 [[image:image-20230518151444-6.png||_mstalt="431847"]]
Edwin Chen 21.1 180
181
Yi Wang 190.1 182 = 4. Access Password and Command =
Edwin Chen 21.1 183
184
Xiaoling 25.2 185 Each device is shipped with a label as below include (% style="color:blue" %)**6 chars AT PIN**(%%). this is the PIN to access the console of sensor.
186
Edwin Chen 21.1 187 For AT Commands list please refer user manual for each sensor.
188
Yi Wang 190.1 189 [[image:image-20240204111711-2.png||_mstalt="426413"]]
Bei Jinggeng 36.1 190
191
Yi Wang 190.1 192 = 5. Use MAC Bluetooth to connect to nodes =
Bei Jinggeng 36.1 193
Xiaoling 37.1 194
Bei Jinggeng 36.1 195 1.Download BLE terminal or BLE Device Info
196
197 2. Turn on MAC Bluetooth
198
199 3.Open the Bluetooth tool, check the Bluetooth list, and find the device name
200
Yi Wang 190.1 201 [[image:image-20240802162132-1.png||_mstalt="427778" height="557" width="907"]]
Bei Jinggeng 36.1 202
Xiaoling 127.1 203
Bei Jinggeng 36.1 204 4.Click Connect, find the read/write window, and you can complete the communication with the device.
205
Yi Wang 190.1 206 [[image:image-20240802162318-2.png||_mstalt="430144" height="558" width="892"]]