Wiki source code of BLE Firmware Update for NB-IoT Node
Last modified by Mengting Qiu on 2025/04/21 17:48
Show last authors
author | version | line-number | content |
---|---|---|---|
1 | (% class="wikigeneratedid" %) | ||
2 | **Table of Contents:** | ||
3 | |||
4 | {{toc/}} | ||
5 | |||
6 | |||
7 | |||
8 | = 1. Overview = | ||
9 | |||
10 | |||
11 | There are some new models of Dragino sensors support BLE remote configure. User can use mobile phone to configure the sensor via BLE. | ||
12 | |||
13 | |||
14 | = 2. Support Models & Firmware = | ||
15 | |||
16 | == 2.1 Hardware Models == | ||
17 | |||
18 | |||
19 | Here list the models that support BLE and the method to activate BLE function. | ||
20 | |||
21 | {{velocity}} | ||
22 | $xwiki.ssfx.use("js/xwiki/table/table.css") | ||
23 | $xwiki.jsfx.use("js/xwiki/table/tablefilterNsort.js", true) | ||
24 | {{/velocity}} | ||
25 | |||
26 | (% border="1" cellspacing="5" class="doOddEven filterable grid sortable" id="tableid" style="background-color:#f2f2f2; width:959px" %) | ||
27 | (% class="sortHeader" %)|=(% style="width: 237px; background-color: rgb(217, 226, 243);" %)Models|=(% style="width: 544px; background-color: rgb(217, 226, 243);" %)BLE Activate Method|=(% style="width: 175px; background-color: rgb(217, 226, 243);" %)**Comments** | ||
28 | |(% style="width:237px" %)((( | ||
29 | All NB-IoT /LTE-M models with BLE support | ||
30 | |||
31 | Normally Suffix -NB / -NS, -CB/-CS | ||
32 | )))|(% style="width:544px" %)((( | ||
33 | Device is battery power type and BLE will be only activate on below case: | ||
34 | |||
35 | * Press button to send an uplink | ||
36 | * Press button to active device. | ||
37 | * Device Power on or reset. | ||
38 | |||
39 | If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode | ||
40 | )))|(% style="width:175px" %) | ||
41 | |(% style="width:237px" %) |(% style="width:544px" %) |(% style="width:175px" %) | ||
42 | |||
43 | == 2.2 Where to find firmware == | ||
44 | |||
45 | |||
46 | (% class="wikigeneratedid" %) | ||
47 | User can find the firmware in the[[** Product Share directory**>>https://www.dropbox.com/scl/fo/ztlw35a9xbkomu71u31im/ABer5TZbrpkmqNh-B8FO2qc?rlkey=ojjcsw927eaow01dgooldq3nu&e=4&st=gv1vtrbj&dl=0]]. | ||
48 | |||
49 | (% class="wikigeneratedid" %) | ||
50 | The product firmware of -NB model can be found in the NB-IoT directory, and the product firmware of -CB model can be found in the LTE-M directory. | ||
51 | |||
52 | (% class="wikigeneratedid" %) | ||
53 | [[image:image-20250421174149-1.png||height="138" width="273"]] | ||
54 | |||
55 | (% class="wikigeneratedid" %) | ||
56 | There are two kind of firmware: | ||
57 | |||
58 | * **.bin** : original firmware file. | ||
59 | * **.hex** : file with control / meta info. | ||
60 | |||
61 | (% class="wikigeneratedid" %) | ||
62 | Please note that user needs to use (% class="mark" %)**.bin**(%%) file for update. | ||
63 | |||
64 | (% class="wikigeneratedid" %) | ||
65 | The **.bin** firmware of the -NB model products is placed in the (% class="mark" %)BC660 Wireless upgrade NB & NS firmware(%%) directory of each product. | ||
66 | |||
67 | (% class="wikigeneratedid" %) | ||
68 | [[image:image-20250421174358-3.png||height="82" width="449"]] | ||
69 | |||
70 | (% class="wikigeneratedid" %) | ||
71 | The** .bin** Firmware of the CB model products is placed in the (% class="mark" %)BG95M2_M3 CB & CS Bluetooth Upgrade Firmware(%%) directory of each product. | ||
72 | |||
73 | (% class="wikigeneratedid" %) | ||
74 | [[image:image-20250421174326-2.png||height="77" width="396"]] | ||
75 | |||
76 | (% style="color:red" %)**Note: Using Dragino Sensor Management Tool to upgrade firmware only supports burning firmware without bootloader. If the firmware with bootloader is burned, the node will always restart after running.** | ||
77 | |||
78 | |||
79 | = 3. How to use PC to upgrade via BLE? = | ||
80 | |||
81 | |||
82 | (% class="lead" %) | ||
83 | (% style="color:blue" %)**Step1:**(%%)** Connect a BLE USB to TTL Host into PC** | ||
84 | |||
85 | Below is the example BLE to USB TTL adapter. Insert it to PC | ||
86 | |||
87 | [[image:image-20230601152950-4.png]] | ||
88 | |||
89 | |||
90 | (% class="lead" %) | ||
91 | (% style="color:blue" %)**Step2:**(%%)** Modify Bluetooth host parameters to support Dragino Sensor Management Tool** **v1.4** | ||
92 | |||
93 | The default baudrate of the general Bluetooth host is 9600, we can use the three commands: **AT+BAUD7; AT+TIMEINQ40; AT+RESET** to change the baudrate of the Bluetooth host to 115200, in order to support the use of Dragino Sensor Management Tool V1.4 to download the firmware faster. | ||
94 | |||
95 | If your Bluetooth host's baud rate is already 115200, please refer to (% style="color:blue" %)**Step3**(%%) directly. | ||
96 | |||
97 | * Check if the Bluetooth host is functioning properly. | ||
98 | |||
99 | Open the serial assistant and send **AT+INQ** (remember to bring carriage return and line feed). | ||
100 | |||
101 | Seeing this interface proves that the host is working properly: | ||
102 | |||
103 | [[image:image-20240912174330-9.png||height="528" width="674"]] | ||
104 | |||
105 | * Connect to Bluetooth host through serial port and send **AT+BAUD7; AT+TIMEINQ40; AT+RESET** successively, confirm that each command returns OK, and finally disconnect the serial port connection. | ||
106 | |||
107 | An example diagram is as follows: | ||
108 | |||
109 | [[image:image-20240912174428-10.png||height="554" width="704"]] | ||
110 | |||
111 | (% style="color:red" %)**Note:** | ||
112 | |||
113 | (% style="color:red" %)**1. Because the baudrate of the unmodified Bluetooth host is 9600, the serial port baud rate needs to be selected 9600 when sending the above three instructions.** | ||
114 | |||
115 | (% style="color:red" %)**2. These commands need to be used only once. After successful modification, the Bluetooth host baud rate is changed to 115200 and this change is maintained.** | ||
116 | |||
117 | * If the serial command sending fails, please modify the sending settings of the serial assistant as below: | ||
118 | |||
119 | [[image:image-20240912174714-12.png||height="529" width="669"]] | ||
120 | |||
121 | |||
122 | (% class="lead" %) | ||
123 | (% style="color:blue" %)**Step3:**(%%)** Download Dragino Sensor Management Tool** | ||
124 | |||
125 | **[[Download URL >>https://www.dropbox.com/scl/fo/9kqeqf6wmet10o9hgxuwa/h?rlkey=4ikrg6kg5v0yjxwhp0i37wrv7&dl=0]]** | ||
126 | |||
127 | |||
128 | (% class="lead" %) | ||
129 | (% style="color:blue" %)**Step4:**(%%)** Update .bin Firmware** | ||
130 | |||
131 | (% style="color:red" %)**Note: Before upgrading, it is necessary to ensure that the baud rate of the Bluetooth host is 115200(Refer to Step 2).** | ||
132 | |||
133 | * Select the** **Dragino Sensor Management Tool parameter: | ||
134 | |||
135 | [[image:image-20240912165247-1.png]] | ||
136 | |||
137 | * Before clicking "Start", make sure that the switch of the node is in **FLASH**. | ||
138 | |||
139 | [[image:image-20240912170209-3.png||height="351" width="616"]] | ||
140 | |||
141 | |||
142 | * Click "Start", then reset the node, and the node's Bluetooth will turn on. Dragino Sensor Management prints the Bluetooth information searched by the Bluetooth tool. | ||
143 | |||
144 | The following screen indicates that the Bluetooth host has successfully connected to the node and started the upgrade | ||
145 | |||
146 | [[image:image-20240912171847-5.png]] | ||
147 | |||
148 | (% style="color:red" %)**Note:** | ||
149 | |||
150 | 1. (% style="color:red" %)**Reset the node: Hold down the ACT key for 3s or press the Reset key to reset the node, then the node's Bluetooth will turn on.** | ||
151 | 1. (% style="color:red" %)**If the node has been restarted before the upgrade, wait two minutes before the upgrade.** | ||
152 | 1. (% style="color:red" %)**The Bluetooth of the node will be enabled for 8~~15seconds. If the operation is not timely, reset the Bluetooth tool and node again.** | ||
153 | 1. (% style="color:red" %)**Ensure that the IMEI entered is correct, and the firmware upgrade will only be performed when the Bluetooth host scans the Bluetooth of the corresponding node.** | ||
154 | |||
155 | [[image:image-20240912092847-6.png]] | ||
156 | |||
157 | * Successful firmware upgrade will print “Upgrade Successful”. | ||
158 | |||
159 | [[image:image-20240912170859-4.png]] | ||
160 | |||
161 | |||
162 | |||
163 | = 4. Access Password and Command = | ||
164 | |||
165 | |||
166 | 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. | ||
167 | |||
168 | For AT Commands list please refer user manual for each sensor. | ||
169 | |||
170 | [[image:image-20240204111847-1.png]] | ||
171 | |||
172 | |||
173 | = 5.FAQ = | ||
174 | |||
175 | == 5.1 What should I do if the upgrade process is automatically interrupted? == | ||
176 | |||
177 | |||
178 | Example: | ||
179 | |||
180 | [[image:image-20240912172143-6.png||height="445" width="460"]] | ||
181 | |||
182 | **How to operate:** | ||
183 | |||
184 | 1. After the upgrade is interrupted, you need to close the wireless upgrade tool and reopen it later. | ||
185 | |||
186 | 2. Before restarting the upgrade, you need to reset the Bluetooth host, otherwise the upgrade may not be possible. | ||
187 | |||
188 | * If your Bluetooth host has a RESET button, you can use the RESET button to reset it. | ||
189 | * If your Bluetooth host does not have a RESET button, you can directly unplug the Bluetooth tool from the computer to power it off, and then reconnect it to the computer. | ||
190 | |||
191 | == 5.2 Why does the node keep resetting even though the firmware upgrade is successful? == | ||
192 | |||
193 | |||
194 | If the user burns the firmware with a boot loader, the following situation may occur. | ||
195 | Therefore, users need to select firmware without boot loader when burning firmware. | ||
196 | |||
197 | [[image:image-20240913172520-1.png||height="640" width="803"]] | ||
198 | |||
199 | |||
200 |