Skip to Content

Wiki source code of BLE Bluetooth Remote Configure

Version 151.1 by Yi Wang on 2025/01/10 16:33
Show last authors
1 **Table of Contents:**
2
3 {{toc/}}
4
5
6
7
8 (% _msthidden="1" %)
9 = (% _msthash="819" _msthidden="1" _msttexthash="149552" %)1. Overview(%%) =
10
11
12 (% _msthash="818" _msthidden="1" _msttexthash="11994229" %)
13 There are some new models of Dragino sensors support BLE[[type the link label>>attach:DeviceTool_1.1.apk]] remote configure. User can use mobile phone to configure the sensor via BLE.
14
15
16 (% _msthidden="1" %)
17 = (% _msthash="817" _msthidden="1" _msttexthash="278239" %)2. Support Models(%%) =
18
19
20 (% _msthash="816" _msthidden="1" _msttexthash="3359837" %)
21 Here list the models that support BLE and the method to activate BLE function.
22
23 {{velocity}}
24 $xwiki.ssfx.use("js/xwiki/table/table.css")
25 $xwiki.jsfx.use("js/xwiki/table/tablefilterNsort.js", true)
26 {{/velocity}}
27
28 (% _msthidden="9" border="1" cellspacing="5" class="doOddEven filterable grid sortable" id="tableid" style="background-color:#f2f2f2; width:955px" %)
29 (% _msthidden="3" class="sortHeader" %)|=(% _msthash="806" _msthidden="1" _msttexthash="76765" style="width: 303px; background-color: rgb(217, 226, 243);" %)Models|=(% _msthash="807" _msthidden="1" _msttexthash="330434" style="width: 439px; background-color: rgb(217, 226, 243);" %)BLE Activate Method|=(% _msthash="808" _msthidden="1" _msttexthash="116701" style="width: 211px; background-color: rgb(217, 226, 243);" %)Comments
30 (% _msthidden="6" %)|(% _msthidden="1" style="width:303px" %)(% _msthidden="1" %)
31 (((
32 (% _msthash="809" _msthidden="1" _msttexthash="1183767" %)
33 All models with -LB, -LS , -NB, -NS, -CB, -CS suffix
34 )))|(% _msthidden="5" style="width:439px" %)(% _msthidden="5" %)
35 (((
36 (% _msthash="810" _msthidden="1" _msttexthash="2964052" %)
37 Device is battery power type and BLE will be only activate on below case:
38
39 (% _msthidden="1" %)
40 * Press button to send an uplink
41
42 (% _msthidden="1" %)
43 * Press button to active device.
44
45 (% _msthidden="1" %)
46 * Device Power on or reset.
47
48 (% _msthash="814" _msthidden="1" _msttexthash="6646042" %)
49 If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
50 )))|(% style="width:211px" %)
51
52 (% _msthidden="1" %)
53 = (% _msthash="805" _msthidden="1" _msttexthash="251251" %)3. How to connect(%%) =
54
55 (% _msthidden="1" %)
56 == (% _msthash="804" _msthidden="1" _msttexthash="2234648" %)3.1 Use Dragino Device Tool to configure or upgrade firmware(%%) ==
57
58 (% _msthidden="1" %)
59 === (% _msthash="803" _msthidden="1" _msttexthash="353002" %)3.1.1 How to download(%%) ===
60
61 (% _msthash="802" _msthidden="1" _msttexthash="4840069" %)
62 ==== 3.1.1.1 Download from Google Play Store ====
63
64
65 (% _msthash="802" _msthidden="1" _msttexthash="4840069" %)
66 Open the Google Play Store, search for "Devices.tool", download and install.
67
68 (% _msthidden="2" %)
69 [[image:image-20241230134826-1.png||height="292" width="514"]]
70
71
72 ==== 3.1.1.2 Download from the attachment ====
73
74 You can scroll down the page to download Devices Tool in the attachment or [[click to download>>attach:Devices.Tool_1.2.apk]] directly.
75
76 [[image:image-20250110163254-1.png||height="219" width="506"]]
77
78 (% _msthidden="1" %)
79 === (% _msthash="800" _msthidden="1" _msttexthash="388687" %)3.1.2 How to use BLE to configure Sensors(%%) ===
80
81
82 (% _msthash="800" _msthidden="1" _msttexthash="388687" %)See Video Instruction: **[[Use BLE to configure Sensors>>https://youtube.com/shorts/Ajq2NvUslnw?feature=share]]**
83
84
85 (% _msthash="799" _msthidden="1" _msttexthash="25546196" %)
86 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).
87
88 (% _msthidden="2" %)
89 [[image:image-20241230135129-4.png||height="134" width="502"]]
90
91 (% _msthidden="2" %)
92 [[image:image-20241230152054-8.png||height="241" width="504"]]
93
94
95 (% _msthash="798" _msthidden="1" _msttexthash="3894137" %)
96 After the connection is successful, enter the interface and click (% style="color:blue" %)**"DIALOGBOX".**
97
98
99 [[image:image-20241230151129-6.png||height="413" width="507"]]
100
101 (% _msthash="797" _msthidden="1" _msttexthash="7801690" %)
102 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.
103
104 (% _msthidden="2" %)
105 [[image:image-20241230152403-9.png||height="232" width="506"]]
106
107 (% _msthash="796" _msthidden="1" _msttexthash="10136945" %)
108 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.
109
110 (% _msthidden="2" %)
111 [[image:image-20241230151602-7.png||height="568" width="348"]]
112
113
114 (% _msthidden="1" %)
115 (% style="color:red" %)**Note:**
116
117 (% _msthidden="1" %)
118 (% _msthash="794" _msthidden="1" _msttexthash="45456905" %)**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.**
119
120 (% _msthidden="2" %)
121 [[image:image-20241230153041-10.png||height="599" width="353"]]
122
123
124 (% _msthidden="1" %)
125 === (% _msthash="792" _msthidden="1" _msttexthash="626002" %)3.1.3 How to use Mobile Phone to upgrade firmware(%%) ===
126
127 (% _msthidden="1" %)
128 ==== (% _msthash="791" _msthidden="1" _msttexthash="227461" %)3.1.3.1 NB / CB series   ( Use BLE to upgrade firmware)(%%) ====
129
130
131 (% _msthash="800" _msthidden="1" _msttexthash="388687" %)See Video Instruction: [[Use BLE to Upgrade Firmware>>https://www.youtube.com/watch?v=fErXzc6m0gU]]
132
133 (% _msthidden="1" %)
134 (% id="cke_bm_120427S" style="display:none" %)
135
136 (% _msthidden="1" %)
137 Open the Devices Tool and click on (% _mstmutation="1" style="color:blue" %)**"Upgrade Device"**(%%).
138
139 (% _msthidden="2" %)
140 [[image:image-20241230153300-11.png||height="83" width="326"]]
141
142
143 (% _msthash="789" _msthidden="1" _msttexthash="858533" %)
144 Select the device type and click **"NB"**.
145
146 (% _msthidden="6" %)
147 [[image:image-20250110114321-2.png||height="189" width="317"]](% _msthash="788" _msthidden="1" _msttexthash="746473" title="Click and drag to resize" %)​
148
149 (% _msthidden="94" %)
150 (% id="cke_bm_120427E" style="display:none" %) (%%)
151
152 (% _msthash="784" _msthidden="1" _msttexthash="47162089" %)
153 Enter the IMEI (DEV EUI) of the upgraded device, enter the password (PIN), click "SELECT UPGRADE FILE" to find the file you want to upgrade(% style="color:red" %)**(The firmware upgrade file format only supports .bin files)**(%%), and then click "START". While waiting for the upgrade, let the device reset once. If it keeps stopping on the download screen, you can try pressing the reset button of your device.
154
155 (% _msthidden="1" %)
156 (% style="color:red" %)**Note: The password check function will only take effect if the DRAGINO NB bootloader is v1.3. If the version is earlier than 1.3, whether the password is entered correctly does not affect the NB upgrade.**
157
158 (% _msthidden="2" %)
159 [[image:image-20241230154001-13.png||height="381" width="327"]]
160
161 (% style="color:red" %)**⑤ **(%%)While waiting for the upgrade, let the device reset once. If it keeps stopping on the download screen, you can try pressing the reset button of your device.
162
163
164 (% _msthash="781" _msthidden="1" _msttexthash="16138434" %)
165 In addition, the firmware upgrade supports importing the IMEI upgrade file, manually select the IMIE required in the file, and the password (PIN) will be entered automatically.
166
167 (% _msthidden="2" %)
168 [[image:image-20241230154747-14.png||height="695" width="324"]]
169
170
171 (% _msthash="779" _msthidden="1" _msttexthash="2791880" %)
172 When the upgrade is complete, it will prompt:"**updata successfully**".
173
174 [[image:image-20241230172614-19.png||height="428" width="322"]]
175
176
177 (% _msthidden="1" %)
178 ==== (% _msthash="777" _msthidden="1" _msttexthash="227097" %)3.1.3.2 LB series(%%) ====
179
180
181 (% _msthash="776" _msthidden="1" _msttexthash="2082054" %)
182 The LA66 USB connects to the phone via the USB-Type c adapter.
183
184 (% _msthidden="2" %)
185 [[image:image-20241207113056-9.png||_mstalt="431366" _msthash="775" _msthidden="A" height="240" width="555"]]
186
187
188 (% _msthash="774" _msthidden="1" _msttexthash="5487131" %)
189 After the connection is successful, the phone will pop up a prompt box, check it and click to confirm.
190
191 **Note:**
192
193 **Some mobile phone models need to manually enable the OTG function to properly identify external devices.**
194
195 (% _msthidden="2" %)
196 [[image:image-20250110114614-3.png||height="654" width="317"]]
197
198
199 (% _msthash="772" _msthidden="1" _msttexthash="5279781" class="wikigeneratedid" id="H-1" %)
200 Then, the Device Tool will automatically open.
201
202 (% _msthash="772" _msthidden="1" _msttexthash="5279781" class="wikigeneratedid" %)
203 Open the Devices Tool and click on (% _mstmutation="1" style="color:blue" %)**"Upgrade Device"**(%%).
204
205 (% _msthash="772" _msthidden="1" _msttexthash="5279781" class="wikigeneratedid" %)
206 Select the device type and click **"LB"**.
207
208 (% _msthash="772" _msthidden="1" _msttexthash="5279781" class="wikigeneratedid" %)
209 Follow the steps in order:
210
211 (% _msthash="771" _msthidden="1" _msttexthash="1071018" class="wikigeneratedid" %)
212 ① Enter the DUIEI,
213
214 (% _msthash="770" _msthidden="1" _msttexthash="3167970" class="wikigeneratedid" %)
215 ② Enter the PIN (**the PIN is the last 8 bytes of APPSKEY**),
216
217 (% _msthash="769" _msthidden="1" _msttexthash="1417689" class="wikigeneratedid" %)
218 ③ Select the LoRa frequency,
219
220 (% _msthash="768" _msthidden="1" _msttexthash="1340859" class="wikigeneratedid" %)
221 ④ Choose the upgrade file,(% style="color:red" %)**(The firmware upgrade file format only supports .bin files)**
222
223 (% _msthash="767" _msthidden="1" _msttexthash="12279657" class="wikigeneratedid" %)
224 ⑤ After pressing the device's reset button, click start.(If the upgrade does not start for a long time, you can press the device reset button again.)
225
226 (% _msthidden="2" %)
227 [[image:image-20241230155258-15.png||height="339" width="322"]]
228
229
230 (% _msthash="765" _msthidden="1" _msttexthash="2791880" class="wikigeneratedid" id="H-2" %)
231 When the upgrade is complete, it will prompt:"**updata successfully**".
232
233 [[image:image-20241230163315-18.png||height="443" width="328"]]
234
235
236 ==== (% _msthash="777" _msthidden="1" _msttexthash="227097" %)3.1.3.3 LA66 upgrade(%%) ====
237
238 (% style="color:red" %)**Note: The prerequisite for the LA66 upgrade is that the current version of the LA66 device contains a bootloader.**(%%)
239
240
241 (% _msthash="776" _msthidden="1" _msttexthash="2082054" %)
242 The LA66 USB connects to the phone via the USB-Type c adapter.
243
244 (% _msthidden="2" %)
245 [[image:image-20241207113056-9.png||_mstalt="431366" _msthash="775" _msthidden="A" height="240" width="555"]]
246
247
248 (% _msthash="774" _msthidden="1" _msttexthash="5487131" %)
249 After the connection is successful, the phone will pop up a prompt box, check it and click to confirm.
250
251 **Note:**
252
253 **Some mobile phone models need to manually enable the OTG function to properly identify external devices.**
254
255 (% _msthidden="2" %)
256 [[image:image-20250110114614-3.png||height="654" width="317"]]
257
258
259 (% _msthash="772" _msthidden="1" _msttexthash="5279781" class="wikigeneratedid" id="H-1" %)
260 Then, the Device Tool will automatically open.
261
262 (% _msthash="772" _msthidden="1" _msttexthash="5279781" class="wikigeneratedid" %)
263 Open the Devices Tool and click on (% _mstmutation="1" style="color:blue" %)**"Upgrade Device"**(%%).
264
265 (% _msthash="772" _msthidden="1" _msttexthash="5279781" class="wikigeneratedid" %)
266 Select the device type and click **"LA66"**.
267
268 (% _msthash="772" _msthidden="1" _msttexthash="5279781" class="wikigeneratedid" %)
269 Follow the steps in order:
270
271 (% _msthash="772" _msthidden="1" _msttexthash="5279781" class="wikigeneratedid" %)
272 ① Click "SELECT UPGRADE FILE" to select the .bin file to be upgraded to LA66.
273
274 (% _msthash="772" _msthidden="1" _msttexthash="5279781" class="wikigeneratedid" %)
275 ② Click "START".
276
277 (% _msthash="772" _msthidden="1" _msttexthash="5279781" class="wikigeneratedid" %)
278 ③ Press the reset key on the LA66 device.
279
280
281 (% _msthash="772" _msthidden="1" _msttexthash="5279781" class="wikigeneratedid" %)
282 [[image:image-20250110134640-5.png||height="294" width="319"]]
283
284 [[image:image-20250110135354-8.png||height="253" width="319"]]
285
286 When the upgrade is complete, it will prompt:"**updata successfully**".
287
288 [[image:image-20250110134822-6.png||height="446" width="323"]]
289
290
291 (% _msthidden="1" %)
292 === (% _msthash="763" _msthidden="1" _msttexthash="436423" %)3.1.4 How to export logs(%%) ===
293
294
295 (% _msthash="762" _msthidden="1" _msttexthash="2549469" %)
296 Open the Devices Tool and click the icon in the upper right corner.
297
298 (% _msthidden="2" %)
299 [[image:image-20241230155425-16.png||height="85" width="330"]]
300
301
302 (% _msthash="761" _msthidden="1" _msttexthash="11510694" %)
303 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.
304
305 (% _msthidden="2" %)
306 [[image:image-20241230155528-17.png||height="324" width="327"]]
307
308
309 (% _msthidden="1" %)
310 == (% _msthash="760" _msthidden="1" _msttexthash="530101" %)3.2 How to use PC to connect?(%%) ==
311
312
313 (% _msthash="759" _msthidden="1" _msttexthash="1271491" %)
314 Firstly, a USB to Bluetooth host is required
315
316 (% _msthidden="2" %)
317 [[image:image-20230601152915-3.png||_mstalt="430144" _msthidden="A"]]
318
319
320 (% _msthidden="2" %)
321 [[image:image-20230601152950-4.png||_mstalt="430118" _msthidden="A"]]
322
323 (% _msthash="758" _msthidden="1" _msttexthash="1309451" %)
324 Insert the Bluetooth host into the computer
325
326 (% _msthidden="2" %)
327 [[image:image-20230518151327-5.png||_mstalt="431535" _msthidden="A"]]
328
329
330 (% _msthash="757" _msthidden="1" _msttexthash="1438853" %)
331 Open the serial port assistant on the computer
332
333 (% _msthidden="2" %)
334 [[image:image-20230518145316-3.png||_mstalt="431054" _msthidden="A" height="560" width="730"]]
335
336 (% _msthash="756" _msthidden="1" _msttexthash="4396743" %)
337 Then connect according to the operating instructions of the purchased Bluetooth host
338
339 (% _msthash="755" _msthidden="1" _msttexthash="19061640" %)
340 (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)
341
342 (% _msthash="754" _msthidden="1" _msttexthash="1988116" %)
343 The Bluetooth name to be connected is the DEVEUI of the node
344
345 (% _msthidden="2" %)
346 [[image:image-20230518151444-6.png||_mstalt="431847" _msthidden="A"]]
347
348
349 (% _msthidden="1" %)
350 = (% _msthash="753" _msthidden="1" _msttexthash="668304" %)4. Access Password and Command(%%) =
351
352
353 (% _msthash="752" _msthidden="1" _msttexthash="6655389" %)
354 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.
355
356 (% _msthash="751" _msthidden="1" _msttexthash="2298829" %)
357 For AT Commands list please refer user manual for each sensor.
358
359 (% _msthidden="2" %)
360 [[image:image-20240204111711-2.png||_mstalt="426413" _msthidden="A"]]
361
362
363 (% _msthidden="1" %)
364 = (% _msthash="750" _msthidden="1" _msttexthash="1031914" %)5. Use MAC Bluetooth to connect to nodes(%%) =
365
366
367 (% _msthash="749" _msthidden="1" _msttexthash="1107314" %)
368 1.Download BLE terminal or BLE Device Info
369
370 (% _msthash="748" _msthidden="1" _msttexthash="423917" %)
371 2. Turn on MAC Bluetooth
372
373 (% _msthash="747" _msthidden="1" _msttexthash="3402854" %)
374 3.Open the Bluetooth tool, check the Bluetooth list, and find the device name
375
376 (% _msthidden="2" %)
377 [[image:image-20240802162132-1.png||_mstalt="427778" _msthidden="A" height="557" width="907"]]
378
379
380 (% _msthash="746" _msthidden="1" _msttexthash="5758103" %)
381 4.Click Connect, find the read/write window, and you can complete the communication with the device.
382
383 (% _msthidden="2" %)
384 [[image:image-20240802162318-2.png||_mstalt="430144" _msthidden="A" height="558" width="892"]]