Wiki source code of BLE Bluetooth Remote Configure

Version 202.1 by Yi Wang on 2025/02/13 18:06
Show last authors
1 **Table of Contents:**
2
3 {{toc/}}
4
5
6
7
8 = 1. Overview =
9
10
11 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.
12
13
14 = 2. Support Models =
15
16
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
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" %)(((
27 All models with -LB, -LS , -NB, -NS, -CB, -CS suffix
28 )))|(% style="width:439px" %)(((
29 Device is battery power type and BLE will be only activate on below case:
30
31 * Press button to send an uplink
32
33 * Press button to active device.
34
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.
38 )))|(% style="width:211px" %)
39
40 = 3. How to connect =
41
42 == 3.1 Use Dragino Device Tool to configure or upgrade firmware ==
43
44 === 3.1.1 How to download ===
45
46 ==== 3.1.1.1 Download from Google Play Store ====
47
48
49 Open the Google Play Store, search for "Devices.tool", download and install.
50
51 [[image:image-20241230134826-1.png||_mstalt="429767" height="292" width="514"]]
52
53 (% class="box errormessage" %)
54 (((
55 Note: APPLE version is not ready yet.
56 )))
57
58
59 ==== 3.1.1.2 Download from Dropbox ====
60
61
62 Click on the URL below to enter Dropbox to download the app:
63
64 [[Download link>>url:https://www.dropbox.com/scl/fo/gyscmfn1s03oz3n8rif8w/AJW7JoMQsQ56dtlls2SNf9c?rlkey=3q2cxwriyzh26vuairx01yebc&st=be5jv92w&dl=0]] 
65
66
67 === 3.1.2 How to use BLE to configure Sensors ===
68
69
70 See Video Instruction: **[[Use BLE to configure Sensors>>https://youtube.com/shorts/Ajq2NvUslnw?feature=share]]**
71
72
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).
74
75 [[image:image-20241230135129-4.png||_mstalt="429988" height="134" width="502"]]
76
77 [[image:image-20241230152054-8.png||_mstalt="430092" height="241" width="504"]]
78
79
80 After the connection is successful, enter the interface and click (% style="color:blue" %)**"DIALOGBOX".**
81
82
83 [[image:image-20241230151129-6.png||_mstalt="430092" height="413" width="507"]]
84
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.
86
87 [[image:image-20241230152403-9.png||_mstalt="429741" height="232" width="506"]]
88
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.
90
91 [[image:image-20241230151602-7.png||_mstalt="429000" height="568" width="348"]]
92
93
94 (% style="color:red" %)**Note:**
95
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.**
97
98 [[image:image-20241230153041-10.png||_mstalt="449423" height="599" width="353"]]
99
100
101 === 3.1.3 How to use Mobile Phone to upgrade firmware ===
102
103 ==== 3.1.3.1 NB / CB series ( Use BLE to upgrade firmware) ====
104
105
106 See Video Instruction: [[Use BLE to Upgrade Firmware>>https://www.youtube.com/watch?v=fErXzc6m0gU]]
107
108 (% id="cke_bm_120427S" style="display:none" %)
109
110 Open the Devices Tool and click on (% _mstmutation="1" style="color:blue" %)**"Upgrade Device"**(%%).
111
112 [[image:image-20241230153300-11.png||_mstalt="449098" height="83" width="326"]]
113
114
115 Select the device type and click **"NB"**.
116
117 [[image:image-20250110114321-2.png||_mstalt="425568" height="189" width="317"]](% title="Click and drag to resize" %)​
118
119 (% id="cke_bm_120427E" style="display:none" %) (%%)
120
121 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.**If the user does not wish to open the casing, they can press and hold the KEY until the device flashes a green light; this action is equivalent to pressing the reset button.**
122
123 (% 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.**
124
125 [[image:image-20241230154001-13.png||_mstalt="449553" height="381" width="327"]]
126
127 (% 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.
128
129 **If the user does not wish to open the casing, they can press and hold the KEY until the device flashes a green light; this action is equivalent to pressing the reset button.**
130
131
132 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.
133
134 [[image:image-20241230154747-14.png||_mstalt="455442" height="695" width="324"]]
135
136
137 When the upgrade is complete, it will prompt:"**update successfully**".
138
139 [[image:image-20241230172614-19.png||_mstalt="455000" height="428" width="322"]]
140
141
142 ==== 3.1.3.2 LB series ====
143
144 * Hardware: LA66 USB
145 [[image:image-20250213172807-1.png]][[image:image-20250213172928-2.png]]
146 * Before using LA66 as a firmware burning tool for -LB products, you need to burn OTA_firmware for LA66 first.
147 * The firmware burning method refers to the LA66 upgrade below.[[Click to redirect.>>https://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/#H3.1.3.3LA66upgrade]]
148
149 The LA66 USB connects to the phone via the USB-Type c adapter.
150
151 [[image:image-20241207113056-9.png||_mstalt="431366" height="240" width="555"]]
152
153
154 After the connection is successful, the phone will pop up a prompt box, check it and click to confirm.
155
156 (% style="color:red" %)**Note:**
157
158 **Some mobile phone models need to manually enable the OTG function to properly identify external devices.**
159
160 [[image:image-20250110114614-3.png||_mstalt="427557" height="654" width="317"]]
161
162
163 (% class="wikigeneratedid" id="H-1" %)
164 Then, the Device Tool will automatically open.
165
166 (% class="wikigeneratedid" %)
167 Open the Devices Tool and click on (% _mstmutation="1" style="color:blue" %)**"Upgrade Device"**(%%).
168
169 (% class="wikigeneratedid" %)
170 Select the device type and click **"LB"**.
171
172 (% class="wikigeneratedid" %)
173 Follow the steps in order:
174
175 (% class="wikigeneratedid" %)
176 ① Enter the DUIEI,t
177
178 (% class="wikigeneratedid" %)
179 ② Enter the PIN (**the PIN is the last 8 bytes of APPSKEY**),
180
181 (% class="wikigeneratedid" %)
182 ③ Select the LoRa frequency to match the original frequency of the node,
183
184 (% class="wikigeneratedid" %)
185 ④ Choose the upgrade file,(% style="color:red" %)**(The firmware upgrade file format only supports .bin files)**
186
187 (% class="wikigeneratedid" %)
188 ⑤ After pressing the device's reset button, click start.
189
190 (% class="wikigeneratedid" %)
191 **(If the upgrade does not start for a long time, you can press the device reset button again.**
192
193 (% class="wikigeneratedid" %)
194 **If the user does not wish to open the casing, they can press and hold the KEY until the device flashes a green light; this action is equivalent to pressing the reset button.)**
195
196 [[image:image-20250213142919-1.png||height="428" width="329"]]
197
198
199 (% class="wikigeneratedid" id="H-2" %)
200 When the upgrade is complete, it will prompt:"**update successfully**".
201
202 [[image:image-20241230163315-18.png||_mstalt="454038" height="443" width="328"]]
203
204
205 ==== 3.1.3.3 LA66 upgrade ====
206
207 The LA66 USB connects to the phone via the USB-Type C adapter.
208
209 [[image:image-20241207113056-9.png||_mstalt="431366" height="240" width="555"]]
210
211
212 After the connection is successful, the phone will pop up a prompt box, check it, and click to confirm.
213
214 (% style="color:red" %)**Note:**
215
216 **Some mobile phone models need to manually enable the OTG function to properly identify external devices.**
217
218 [[image:image-20250110114614-3.png||_mstalt="427557" height="654" width="317"]]
219
220
221 (% class="wikigeneratedid" id="H-1" %)
222 Then, the Device Tool will automatically open.
223
224 (% class="wikigeneratedid" %)
225 Follow the steps in order:
226
227 (% class="wikigeneratedid" %)
228 ① Click "SELECT UPGRADE FILE" to choose the firmware to upgrade.
229
230 (% class="wikigeneratedid" %)
231 **In order to ensure that the LA66 USB works properly, make sure that there is a corresponding bootloader before updating the firmware.**
232
233 (% class="wikigeneratedid" %)
234 **If you don't have a bootloader, you need to use the "[[Tremo Programmer>>https://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H3.1.3Howtouploadbootloadertodevice3F]]" software to download it.**
235
236 (% class="wikigeneratedid" %)
237 ② Click "START".
238
239 (% class="wikigeneratedid" %)
240 ③ Press the reset key on the LA66 device.
241
242 (% class="wikigeneratedid" %)
243 **For LA66 USB LoRaWAN Adapter v1.2, the design of the reset button has been eliminated on the hardware. **
244
245
246 (% class="wikigeneratedid" %)
247 [[image:image-20250110134640-5.png||_mstalt="428480" height="294" width="319"]]/
248
249 [[image:image-20250110135354-8.png||_mstalt="430612" height="253" width="319"]]
250
251 When the upgrade is complete, it will prompt:"**update successfully**".
252
253 [[image:image-20250110134822-6.png||_mstalt="429494" height="446" width="323"]]
254
255
256 === 3.1.4 How to export logs ===
257
258
259 Open the Devices Tool and click the icon in the upper right corner.
260
261 [[image:image-20241230155425-16.png||_mstalt="454233" height="85" width="330"]]
262
263
264 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.
265
266 [[image:image-20241230155528-17.png||_mstalt="455936" height="324" width="327"]]
267
268
269 == 3.2 How to use PC to connect? ==
270
271
272 Firstly, a USB to Bluetooth host is required
273
274 [[image:image-20230601152915-3.png||_mstalt="430144"]]
275
276
277 [[image:image-20230601152950-4.png||_mstalt="430118"]]
278
279 Insert the Bluetooth host into the computer
280
281 [[image:image-20230518151327-5.png||_mstalt="431535"]]
282
283
284 Open the serial port assistant on the computer
285
286 [[image:image-20230518145316-3.png||_mstalt="431054" height="560" width="730"]]
287
288 Then connect according to the operating instructions of the purchased Bluetooth host
289
290 (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)
291
292 The Bluetooth name to be connected is the DEVEUI of the node
293
294 [[image:image-20230518151444-6.png||_mstalt="431847"]]
295
296
297 = 4. Access Password and Command =
298
299
300 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.
301
302 For AT Commands list please refer user manual for each sensor.
303
304 [[image:image-20240204111711-2.png||_mstalt="426413"]]
305
306
307 = 5. Use MAC Bluetooth to connect to nodes =
308
309
310 1.Download BLE terminal or BLE Device Info
311
312 2. Turn on MAC Bluetooth
313
314 3.Open the Bluetooth tool, check the Bluetooth list, and find the device name
315
316 [[image:image-20240802162132-1.png||_mstalt="427778" height="557" width="907"]]
317
318
319 4.Click Connect, find the read/write window, and you can complete the communication with the device.
320
321 [[image:image-20240802162318-2.png||_mstalt="430144" height="558" width="892"]]

Applications

Navigation

Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0