Wiki source code of BLE Bluetooth Remote Configure

Version 171.1 by Yi Wang on 2025/01/15 17:53

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
75 You can scroll down the page to download Devices Tool in the attachment or [[click to download>>attach:Devices_Tool_1.3.apk]] directly.
76
77 [[image:image-20250113143717-1.png||height="139" width="508"]]
78
79
80 ==== 3.1.1.3 Download from Dropbox ====
81
82
83 Click on the URL below to enter Dropbox to download the app:
84
85 [[https:~~/~~/www.dropbox.com/scl/fo/gyscmfn1s03oz3n8rif8w/AJW7JoMQsQ56dtlls2SNf9c?rlkey=3q2cxwriyzh26vuairx01yebc&st=be5jv92w&dl=0>>url:https://www.dropbox.com/scl/fo/gyscmfn1s03oz3n8rif8w/AJW7JoMQsQ56dtlls2SNf9c?rlkey=3q2cxwriyzh26vuairx01yebc&st=be5jv92w&dl=0]]
86
87
88 (% _msthidden="1" %)
89 === (% _msthash="800" _msthidden="1" _msttexthash="388687" %)3.1.2 How to use BLE to configure Sensors(%%) ===
90
91
92 (% _msthash="800" _msthidden="1" _msttexthash="388687" %)See Video Instruction: **[[Use BLE to configure Sensors>>https://youtube.com/shorts/Ajq2NvUslnw?feature=share]]**
93
94
95 (% _msthash="799" _msthidden="1" _msttexthash="25546196" %)
96 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).
97
98 (% _msthidden="2" %)
99 [[image:image-20241230135129-4.png||height="134" width="502"]]
100
101 (% _msthidden="2" %)
102 [[image:image-20241230152054-8.png||height="241" width="504"]]
103
104
105 (% _msthash="798" _msthidden="1" _msttexthash="3894137" %)
106 After the connection is successful, enter the interface and click (% style="color:blue" %)**"DIALOGBOX".**
107
108
109 [[image:image-20241230151129-6.png||height="413" width="507"]]
110
111 (% _msthash="797" _msthidden="1" _msttexthash="7801690" %)
112 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.
113
114 (% _msthidden="2" %)
115 [[image:image-20241230152403-9.png||height="232" width="506"]]
116
117 (% _msthash="796" _msthidden="1" _msttexthash="10136945" %)
118 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.
119
120 (% _msthidden="2" %)
121 [[image:image-20241230151602-7.png||height="568" width="348"]]
122
123
124 (% _msthidden="1" %)
125 (% style="color:red" %)**Note:**
126
127 (% _msthidden="1" %)
128 (% _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.**
129
130 (% _msthidden="2" %)
131 [[image:image-20241230153041-10.png||height="599" width="353"]]
132
133
134 (% _msthidden="1" %)
135 === (% _msthash="792" _msthidden="1" _msttexthash="626002" %)3.1.3 How to use Mobile Phone to upgrade firmware(%%) ===
136
137 (% _msthidden="1" %)
138 ==== (% _msthash="791" _msthidden="1" _msttexthash="227461" %)3.1.3.1 NB / CB series ( Use BLE to upgrade firmware)(%%) ====
139
140
141 (% _msthash="800" _msthidden="1" _msttexthash="388687" %)See Video Instruction: [[Use BLE to Upgrade Firmware>>https://www.youtube.com/watch?v=fErXzc6m0gU]]
142
143 (% _msthidden="1" %)
144 (% id="cke_bm_120427S" style="display:none" %)
145
146 (% _msthidden="1" %)
147 Open the Devices Tool and click on (% _mstmutation="1" style="color:blue" %)**"Upgrade Device"**(%%).
148
149 (% _msthidden="2" %)
150 [[image:image-20241230153300-11.png||height="83" width="326"]]
151
152
153 (% _msthash="789" _msthidden="1" _msttexthash="858533" %)
154 Select the device type and click **"NB"**.
155
156 (% _msthidden="6" %)
157 [[image:image-20250110114321-2.png||height="189" width="317"]](% _msthash="788" _msthidden="1" _msttexthash="746473" title="Click and drag to resize" %)​
158
159 (% _msthidden="94" %)
160 (% id="cke_bm_120427E" style="display:none" %) (%%)
161
162 (% _msthash="784" _msthidden="1" _msttexthash="47162089" %)
163 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.
164
165 (% _msthidden="1" %)
166 (% 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.**
167
168 (% _msthidden="2" %)
169 [[image:image-20241230154001-13.png||height="381" width="327"]]
170
171 (% 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.
172
173
174 (% _msthash="781" _msthidden="1" _msttexthash="16138434" %)
175 In addition, the firmware upgrade supports importing the IMEI upgrade file, manually selecting the IMIE required in the file, and the password (PIN) will be entered automatically.
176
177 (% _msthidden="2" %)
178 [[image:image-20241230154747-14.png||height="695" width="324"]]
179
180
181 (% _msthash="779" _msthidden="1" _msttexthash="2791880" %)
182 When the upgrade is complete, it will prompt:"**update successfully**".
183
184 [[image:image-20241230172614-19.png||height="428" width="322"]]
185
186
187 (% _msthidden="1" %)
188 ==== (% _msthash="777" _msthidden="1" _msttexthash="227097" %)3.1.3.2 LB series(%%) ====
189
190 * Hardware: [[LA66 USB>>url:https://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LA66%20USB%20LoRaWAN%20Adapter%20User%20Manual/]] with [[OTA_firmware>>url:https://www.dropbox.com/sh/4qnjreg1esxu16i/AADbRjW_tuBP3IIkmf11nSoma?dl=0]] installed.
191 * Before using LA66 as -LB product to burn firmware, you need to burn the OTA_ firmware for LA66. Refer to this [[link>>https://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LA66%20USB%20LoRaWAN%20Adapter%20User%20Manual/#H1.10.1LA66V1Updatemethod]] for burning methods.
192
193 (% _msthash="776" _msthidden="1" _msttexthash="2082054" %)
194 The LA66 USB connects to the phone via the USB-Type c adapter.
195
196 (% _msthidden="2" %)
197 [[image:image-20241207113056-9.png||_mstalt="431366" _msthash="775" _msthidden="A" height="240" width="555"]]
198
199
200 (% _msthash="774" _msthidden="1" _msttexthash="5487131" %)
201 After the connection is successful, the phone will pop up a prompt box, check it and click to confirm.
202
203 (% style="color:red" %)**Note:**
204
205 **Some mobile phone models need to manually enable the OTG function to properly identify external devices.**
206
207 (% _msthidden="2" %)
208 [[image:image-20250110114614-3.png||height="654" width="317"]]
209
210
211 (% _msthash="772" _msthidden="1" _msttexthash="5279781" class="wikigeneratedid" id="H-1" %)
212 Then, the Device Tool will automatically open.
213
214 (% _msthash="772" _msthidden="1" _msttexthash="5279781" class="wikigeneratedid" %)
215 Open the Devices Tool and click on (% _mstmutation="1" style="color:blue" %)**"Upgrade Device"**(%%).
216
217 (% _msthash="772" _msthidden="1" _msttexthash="5279781" class="wikigeneratedid" %)
218 Select the device type and click **"LB"**.
219
220 (% _msthash="772" _msthidden="1" _msttexthash="5279781" class="wikigeneratedid" %)
221 Follow the steps in order:
222
223 (% _msthash="771" _msthidden="1" _msttexthash="1071018" class="wikigeneratedid" %)
224 ① Enter the DUIEI,
225
226 (% _msthash="770" _msthidden="1" _msttexthash="3167970" class="wikigeneratedid" %)
227 ② Enter the PIN (**the PIN is the last 8 bytes of APPSKEY**),
228
229 (% _msthash="769" _msthidden="1" _msttexthash="1417689" class="wikigeneratedid" %)
230 ③ Select the LoRa frequency,
231
232 (% _msthash="768" _msthidden="1" _msttexthash="1340859" class="wikigeneratedid" %)
233 ④ Choose the upgrade file,(% style="color:red" %)**(The firmware upgrade file format only supports .bin files)**
234
235 (% _msthash="767" _msthidden="1" _msttexthash="12279657" class="wikigeneratedid" %)
236 ⑤ 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.)
237
238 (% _msthidden="2" %)
239 [[image:image-20250111151237-1.png]]
240
241
242 (% _msthash="765" _msthidden="1" _msttexthash="2791880" class="wikigeneratedid" id="H-2" %)
243 When the upgrade is complete, it will prompt:"**update successfully**".
244
245 [[image:image-20241230163315-18.png||height="443" width="328"]]
246
247
248 ==== (% _msthash="777" _msthidden="1" _msttexthash="227097" %)3.1.3.3 LA66 upgrade(%%) ====
249
250 ===== 3.1.3.3.1 How to upgrade the bootloader =====
251
252 (% style="color:red" %)**Note: When using the LA66 upgrade function, make sure that the firmware is withbootloader version.**
253
254 **Firmware download(Please select withbootloader version):**
255
256 [[Firmware - Dropbox>>url:https://www.dropbox.com/sh/g99v0fxcltn9r1y/AABJQUWNgt61Z567OcUf-sIya/LA66%20LoRaWAN%20module/Firmware?dl=0&subfolder_nav_tracking=1]]
257
258 ①、Open the "ASR6601Programmer_v0.9" software;
259
260 ②、Insert LA66 into the PC (if the LA66 hardware version is V1.2 or above, the user needs to short Boot and RX);
261
262 ③、Select the serial port, select the baud rate of 9600, select the downloaded with bootloader.bin file in front of the @0x0800s0000;
263
264 ④、 Click Start to burn.
265
266 [[image:image-20250115174551-1.png]][[image:image-20250115174601-2.png||height="226" width="265"]]
267
268 [[image:image-20250115174621-3.png||height="515" width="402"]]
269
270
271 ===== 3.1.3.3.2 How to upgrade the LA66 firmware =====
272
273 (% _msthash="776" _msthidden="1" _msttexthash="2082054" %)
274 The LA66 USB connects to the phone via the USB-Type C adapter.
275
276 (% _msthidden="2" %)
277 [[image:image-20241207113056-9.png||_mstalt="431366" _msthash="775" _msthidden="A" height="240" width="555"]]
278
279
280 (% _msthash="774" _msthidden="1" _msttexthash="5487131" %)
281 After the connection is successful, the phone will pop up a prompt box, check it, and click to confirm.
282
283 (% style="color:red" %)**Note:**
284
285 **Some mobile phone models need to manually enable the OTG function to properly identify external devices.**
286
287 (% _msthidden="2" %)
288 [[image:image-20250110114614-3.png||height="654" width="317"]]
289
290
291 (% _msthash="772" _msthidden="1" _msttexthash="5279781" class="wikigeneratedid" id="H-1" %)
292 Then, the Device Tool will automatically open.
293
294 (% _msthash="772" _msthidden="1" _msttexthash="5279781" class="wikigeneratedid" %)
295 Open the Devices Tool and click on (% _mstmutation="1" style="color:blue" %)**"Upgrade Device"**(%%).
296
297 (% _msthash="772" _msthidden="1" _msttexthash="5279781" class="wikigeneratedid" %)
298 Select the device type and click **"LA66"**., insert
299
300 (% _msthash="772" _msthidden="1" _msttexthash="5279781" class="wikigeneratedid" %)
301 Follow the steps in order:
302
303 (% _msthash="772" _msthidden="1" _msttexthash="5279781" class="wikigeneratedid" %)
304 ① Click "SELECT UPGRADE FILE" to select the .bin file to be upgraded to LA66.
305
306 (% _msthash="772" _msthidden="1" _msttexthash="5279781" class="wikigeneratedid" %)
307 ② Click "START".
308
309 (% _msthash="772" _msthidden="1" _msttexthash="5279781" class="wikigeneratedid" %)
310 ③ Press the reset key on the LA66 device.
311
312 (% _msthash="772" _msthidden="1" _msttexthash="5279781" class="wikigeneratedid" %)
313 **For LA66 USB LoRaWAN Adapter v1.2, the design of the reset button has been eliminated on the hardware. The user needs to unplug the LA66 and insert it again, and then perform steps ① and ②.**
314
315
316 (% _msthash="772" _msthidden="1" _msttexthash="5279781" class="wikigeneratedid" %)
317 [[image:image-20250110134640-5.png||height="294" width="319"]]/
318
319 [[image:image-20250110135354-8.png||height="253" width="319"]]
320
321 When the upgrade is complete, it will prompt:"**update successfully**".
322
323 [[image:image-20250110134822-6.png||height="446" width="323"]]
324
325
326 (% _msthidden="1" %)
327 === (% _msthash="763" _msthidden="1" _msttexthash="436423" %)3.1.4 How to export logs(%%) ===
328
329
330 (% _msthash="762" _msthidden="1" _msttexthash="2549469" %)
331 Open the Devices Tool and click the icon in the upper right corner.
332
333 (% _msthidden="2" %)
334 [[image:image-20241230155425-16.png||height="85" width="330"]]
335
336
337 (% _msthash="761" _msthidden="1" _msttexthash="11510694" %)
338 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.
339
340 (% _msthidden="2" %)
341 [[image:image-20241230155528-17.png||height="324" width="327"]]
342
343
344 (% _msthidden="1" %)
345 == (% _msthash="760" _msthidden="1" _msttexthash="530101" %)3.2 How to use PC to connect?(%%) ==
346
347
348 (% _msthash="759" _msthidden="1" _msttexthash="1271491" %)
349 Firstly, a USB to Bluetooth host is required
350
351 (% _msthidden="2" %)
352 [[image:image-20230601152915-3.png||_mstalt="430144" _msthidden="A"]]
353
354
355 (% _msthidden="2" %)
356 [[image:image-20230601152950-4.png||_mstalt="430118" _msthidden="A"]]
357
358 (% _msthash="758" _msthidden="1" _msttexthash="1309451" %)
359 Insert the Bluetooth host into the computer
360
361 (% _msthidden="2" %)
362 [[image:image-20230518151327-5.png||_mstalt="431535" _msthidden="A"]]
363
364
365 (% _msthash="757" _msthidden="1" _msttexthash="1438853" %)
366 Open the serial port assistant on the computer
367
368 (% _msthidden="2" %)
369 [[image:image-20230518145316-3.png||_mstalt="431054" _msthidden="A" height="560" width="730"]]
370
371 (% _msthash="756" _msthidden="1" _msttexthash="4396743" %)
372 Then connect according to the operating instructions of the purchased Bluetooth host
373
374 (% _msthash="755" _msthidden="1" _msttexthash="19061640" %)
375 (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)
376
377 (% _msthash="754" _msthidden="1" _msttexthash="1988116" %)
378 The Bluetooth name to be connected is the DEVEUI of the node
379
380 (% _msthidden="2" %)
381 [[image:image-20230518151444-6.png||_mstalt="431847" _msthidden="A"]]
382
383
384 (% _msthidden="1" %)
385 = (% _msthash="753" _msthidden="1" _msttexthash="668304" %)4. Access Password and Command(%%) =
386
387
388 (% _msthash="752" _msthidden="1" _msttexthash="6655389" %)
389 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.
390
391 (% _msthash="751" _msthidden="1" _msttexthash="2298829" %)
392 For AT Commands list please refer user manual for each sensor.
393
394 (% _msthidden="2" %)
395 [[image:image-20240204111711-2.png||_mstalt="426413" _msthidden="A"]]
396
397
398 (% _msthidden="1" %)
399 = (% _msthash="750" _msthidden="1" _msttexthash="1031914" %)5. Use MAC Bluetooth to connect to nodes(%%) =
400
401
402 (% _msthash="749" _msthidden="1" _msttexthash="1107314" %)
403 1.Download BLE terminal or BLE Device Info
404
405 (% _msthash="748" _msthidden="1" _msttexthash="423917" %)
406 2. Turn on MAC Bluetooth
407
408 (% _msthash="747" _msthidden="1" _msttexthash="3402854" %)
409 3.Open the Bluetooth tool, check the Bluetooth list, and find the device name
410
411 (% _msthidden="2" %)
412 [[image:image-20240802162132-1.png||_mstalt="427778" _msthidden="A" height="557" width="907"]]
413
414
415 (% _msthash="746" _msthidden="1" _msttexthash="5758103" %)
416 4.Click Connect, find the read/write window, and you can complete the communication with the device.
417
418 (% _msthidden="2" %)
419 [[image:image-20240802162318-2.png||_mstalt="430144" _msthidden="A" height="558" width="892"]]