Wiki source code of BLE Bluetooth Remote Configure

Version 132.1 by Yi Wang on 2025/01/07 09:46

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 Download>>attach:Devices_1.1.apk]].
75
76
77 (% _msthidden="1" %)
78 === (% _msthash="800" _msthidden="1" _msttexthash="388687" %)3.1.2 How to use BLE to configure Sensors(%%) ===
79
80
81 (% _msthash="800" _msthidden="1" _msttexthash="388687" %)See Video Instruction: **[[Use BLE to configure Sensors>>https://youtube.com/shorts/Ajq2NvUslnw?feature=share]]**
82
83
84 (% _msthash="799" _msthidden="1" _msttexthash="25546196" %)
85 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).
86
87 (% _msthidden="2" %)
88 [[image:image-20241230135129-4.png||height="134" width="502"]]
89
90 (% _msthidden="2" %)
91 [[image:image-20241230152054-8.png||height="241" width="504"]]
92
93
94 (% _msthash="798" _msthidden="1" _msttexthash="3894137" %)
95 After the connection is successful, enter the interface and click (% style="color:blue" %)**"DIALOGBOX".**
96
97
98 [[image:image-20241230151129-6.png||height="413" width="507"]]
99
100 (% _msthash="797" _msthidden="1" _msttexthash="7801690" %)
101 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.
102
103 (% _msthidden="2" %)
104 [[image:image-20241230152403-9.png||height="232" width="506"]]
105
106 (% _msthash="796" _msthidden="1" _msttexthash="10136945" %)
107 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.
108
109 (% _msthidden="2" %)
110 [[image:image-20241230151602-7.png||height="568" width="348"]]
111
112
113 (% _msthidden="1" %)
114 (% style="color:red" %)**Note:**
115
116 (% _msthidden="1" %)
117 (% _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.**
118
119 (% _msthidden="2" %)
120 [[image:image-20241230153041-10.png||height="599" width="353"]]
121
122
123 (% _msthidden="1" %)
124 === (% _msthash="792" _msthidden="1" _msttexthash="626002" %)3.1.3 How to use Mobile Phone to upgrade firmware(%%) ===
125
126 (% _msthidden="1" %)
127 ==== (% _msthash="791" _msthidden="1" _msttexthash="227461" %)3.1.3.1 NB / CB series   ( Use BLE to upgrade firmware)(%%) ====
128
129
130 (% _msthash="800" _msthidden="1" _msttexthash="388687" %)See Video Instruction: [[Use BLE to Upgrade Firmware>>https://www.youtube.com/watch?v=fErXzc6m0gU]]
131
132 (% _msthidden="1" %)
133 (% id="cke_bm_120427S" style="display:none" %)
134
135 (% _msthidden="1" %)
136 Open the Devices Tool and click on (% _mstmutation="1" style="color:blue" %)**"Upgrade Device"**(%%).
137
138 (% _msthidden="2" %)
139 [[image:image-20241230153300-11.png||height="83" width="326"]]
140
141
142 (% _msthash="789" _msthidden="1" _msttexthash="858533" %)
143 Select the device type and click **"NB"**.
144
145 (% _msthidden="6" %)
146 [[image:image-20241230153410-12.png||height="184" width="322"]](% _msthash="788" _msthidden="1" _msttexthash="746473" title="Click and drag to resize" %)​
147
148 (% _msthidden="94" %)
149 (% id="cke_bm_120427E" style="display:none" %) (%%)
150
151 (% _msthash="784" _msthidden="1" _msttexthash="47162089" %)
152 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, 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.
153
154 (% _msthidden="1" %)
155 (% 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.**
156
157 (% _msthidden="2" %)
158 [[image:image-20241230154001-13.png||height="381" width="327"]]
159
160 (% 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.
161
162
163 (% _msthash="781" _msthidden="1" _msttexthash="16138434" %)
164 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.
165
166 (% _msthidden="2" %)
167 [[image:image-20241230154747-14.png||height="695" width="324"]]
168
169
170 (% _msthash="779" _msthidden="1" _msttexthash="2791880" %)
171 When the upgrade is complete, it will prompt:"**updata successfully**".
172
173 [[image:image-20241230172614-19.png||height="428" width="322"]]
174
175
176 (% _msthidden="1" %)
177 ==== (% _msthash="777" _msthidden="1" _msttexthash="227097" %)3.1.3.2 LB series(%%) ====
178
179
180 (% _msthash="776" _msthidden="1" _msttexthash="2082054" %)
181 The LA66 USB connects to the phone via the USB-Type c adapter.
182
183 (% _msthidden="2" %)
184 [[image:image-20241207113056-9.png||_mstalt="431366" _msthash="775" _msthidden="A" height="240" width="555"]]
185
186
187 (% _msthash="774" _msthidden="1" _msttexthash="5487131" %)
188 After the connection is successful, the phone will pop up a prompt box, check it and click to confirm.
189
190 **Note:**
191
192 **Some mobile phone models need to manually enable the OTG function to properly identify external devices.**
193
194 (% _msthidden="2" %)
195 [[image:image-20241207114921-11.png||_mstalt="452192" _msthash="773" _msthidden="A" height="282" width="333"]]
196
197
198 (% _msthash="772" _msthidden="1" _msttexthash="5279781" class="wikigeneratedid" id="H-1" %)
199 Then, the LB upgrade interface of Device Tool will automatically open. Follow the steps in order:
200
201 (% _msthash="771" _msthidden="1" _msttexthash="1071018" class="wikigeneratedid" %)
202 ① Enter the DUIEI,
203
204 (% _msthash="770" _msthidden="1" _msttexthash="3167970" class="wikigeneratedid" %)
205 ② Enter the PIN (**the PIN is the last 8 bytes of APPSKEY**),
206
207 (% _msthash="769" _msthidden="1" _msttexthash="1417689" class="wikigeneratedid" %)
208 ③ Select the LoRa frequency,
209
210 (% _msthash="768" _msthidden="1" _msttexthash="1340859" class="wikigeneratedid" %)
211 ④ Choose the upgrade file,
212
213 (% _msthash="767" _msthidden="1" _msttexthash="12279657" class="wikigeneratedid" %)
214 ⑤ 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.)
215
216 (% _msthidden="2" %)
217 [[image:image-20241230155258-15.png||height="339" width="322"]]
218
219
220 (% _msthash="765" _msthidden="1" _msttexthash="2791880" class="wikigeneratedid" id="H-2" %)
221 When the upgrade is complete, it will prompt:"**updata successfully**".
222
223 [[image:image-20241230163315-18.png||height="443" width="328"]]
224
225 (% _msthidden="1" %)
226 === (% _msthash="763" _msthidden="1" _msttexthash="436423" %)3.1.4 How to export logs(%%) ===
227
228
229 (% _msthash="762" _msthidden="1" _msttexthash="2549469" %)
230 Open the Devices Tool and click the icon in the upper right corner.
231
232 (% _msthidden="2" %)
233 [[image:image-20241230155425-16.png||height="85" width="330"]]
234
235
236 (% _msthash="761" _msthidden="1" _msttexthash="11510694" %)
237 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.
238
239 (% _msthidden="2" %)
240 [[image:image-20241230155528-17.png||height="324" width="327"]]
241
242
243 (% _msthidden="1" %)
244 == (% _msthash="760" _msthidden="1" _msttexthash="530101" %)3.2 How to use PC to connect?(%%) ==
245
246
247 (% _msthash="759" _msthidden="1" _msttexthash="1271491" %)
248 Firstly, a USB to Bluetooth host is required
249
250 (% _msthidden="2" %)
251 [[image:image-20230601152915-3.png||_mstalt="430144" _msthidden="A"]]
252
253
254 (% _msthidden="2" %)
255 [[image:image-20230601152950-4.png||_mstalt="430118" _msthidden="A"]]
256
257 (% _msthash="758" _msthidden="1" _msttexthash="1309451" %)
258 Insert the Bluetooth host into the computer
259
260 (% _msthidden="2" %)
261 [[image:image-20230518151327-5.png||_mstalt="431535" _msthidden="A"]]
262
263
264 (% _msthash="757" _msthidden="1" _msttexthash="1438853" %)
265 Open the serial port assistant on the computer
266
267 (% _msthidden="2" %)
268 [[image:image-20230518145316-3.png||_mstalt="431054" _msthidden="A" height="560" width="730"]]
269
270 (% _msthash="756" _msthidden="1" _msttexthash="4396743" %)
271 Then connect according to the operating instructions of the purchased Bluetooth host
272
273 (% _msthash="755" _msthidden="1" _msttexthash="19061640" %)
274 (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)
275
276 (% _msthash="754" _msthidden="1" _msttexthash="1988116" %)
277 The Bluetooth name to be connected is the DEVEUI of the node
278
279 (% _msthidden="2" %)
280 [[image:image-20230518151444-6.png||_mstalt="431847" _msthidden="A"]]
281
282
283 (% _msthidden="1" %)
284 = (% _msthash="753" _msthidden="1" _msttexthash="668304" %)4. Access Password and Command(%%) =
285
286
287 (% _msthash="752" _msthidden="1" _msttexthash="6655389" %)
288 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.
289
290 (% _msthash="751" _msthidden="1" _msttexthash="2298829" %)
291 For AT Commands list please refer user manual for each sensor.
292
293 (% _msthidden="2" %)
294 [[image:image-20240204111711-2.png||_mstalt="426413" _msthidden="A"]]
295
296
297 (% _msthidden="1" %)
298 = (% _msthash="750" _msthidden="1" _msttexthash="1031914" %)5. Use MAC Bluetooth to connect to nodes(%%) =
299
300
301 (% _msthash="749" _msthidden="1" _msttexthash="1107314" %)
302 1.Download BLE terminal or BLE Device Info
303
304 (% _msthash="748" _msthidden="1" _msttexthash="423917" %)
305 2. Turn on MAC Bluetooth
306
307 (% _msthash="747" _msthidden="1" _msttexthash="3402854" %)
308 3.Open the Bluetooth tool, check the Bluetooth list, and find the device name
309
310 (% _msthidden="2" %)
311 [[image:image-20240802162132-1.png||_mstalt="427778" _msthidden="A" height="557" width="907"]]
312
313
314 (% _msthash="746" _msthidden="1" _msttexthash="5758103" %)
315 4.Click Connect, find the read/write window, and you can complete the communication with the device.
316
317 (% _msthidden="2" %)
318 [[image:image-20240802162318-2.png||_mstalt="430144" _msthidden="A" height="558" width="892"]]