Wiki source code of BLE Bluetooth Remote Configure

Version 160.1 by Yi Wang on 2025/01/14 10:03

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