Wiki source code of BLE Bluetooth Remote Configure
Last modified by Mengting Qiu on 2025/02/14 18:29
Show last authors
author | version | line-number | content |
---|---|---|---|
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 LA66 and LB Series ==== | ||
143 | |||
144 | |||
145 | Remote Upgrade Instructions:[[LA66 & LB Series Upgrade>>https://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/#H3.2OTAUpdateFirmwareviaMobilePhone2BLA66]] | ||
146 | |||
147 | |||
148 | === 3.1.4 How to export logs === | ||
149 | |||
150 | |||
151 | Open the Devices Tool and click the icon in the upper right corner. | ||
152 | |||
153 | [[image:image-20241230155425-16.png||_mstalt="454233" height="85" width="330"]] | ||
154 | |||
155 | |||
156 | 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. | ||
157 | |||
158 | [[image:image-20241230155528-17.png||_mstalt="455936" height="324" width="327"]] | ||
159 | |||
160 | |||
161 | == 3.2 How to use PC to connect? == | ||
162 | |||
163 | |||
164 | Firstly, a USB to Bluetooth host is required | ||
165 | |||
166 | [[image:image-20230601152915-3.png||_mstalt="430144"]] | ||
167 | |||
168 | |||
169 | [[image:image-20230601152950-4.png||_mstalt="430118"]] | ||
170 | |||
171 | Insert the Bluetooth host into the computer | ||
172 | |||
173 | [[image:image-20230518151327-5.png||_mstalt="431535"]] | ||
174 | |||
175 | |||
176 | Open the serial port assistant on the computer | ||
177 | |||
178 | [[image:image-20230518145316-3.png||_mstalt="431054" height="560" width="730"]] | ||
179 | |||
180 | Then connect according to the operating instructions of the purchased Bluetooth host | ||
181 | |||
182 | (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) | ||
183 | |||
184 | The Bluetooth name to be connected is the DEVEUI of the node | ||
185 | |||
186 | [[image:image-20230518151444-6.png||_mstalt="431847"]] | ||
187 | |||
188 | |||
189 | = 4. Access Password and Command = | ||
190 | |||
191 | |||
192 | 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. | ||
193 | |||
194 | For AT Commands list please refer user manual for each sensor. | ||
195 | |||
196 | [[image:image-20240204111711-2.png||_mstalt="426413"]] | ||
197 | |||
198 | |||
199 | = 5. Use MAC Bluetooth to connect to nodes = | ||
200 | |||
201 | |||
202 | 1.Download BLE terminal or BLE Device Info | ||
203 | |||
204 | 2. Turn on MAC Bluetooth | ||
205 | |||
206 | 3.Open the Bluetooth tool, check the Bluetooth list, and find the device name | ||
207 | |||
208 | [[image:image-20240802162132-1.png||_mstalt="427778" height="557" width="907"]] | ||
209 | |||
210 | |||
211 | 4.Click Connect, find the read/write window, and you can complete the communication with the device. | ||
212 | |||
213 | [[image:image-20240802162318-2.png||_mstalt="430144" height="558" width="892"]] |