Wiki source code of BLE Firmware Update for NB-IoT Node
Last modified by Mengting Qiu on 2024/09/13 17:28
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 [[**NB-IoT Product Share directory**>>https://www.dropbox.com/sh/qasyy7n8631lve2/AABZFontYtyj6Meyxd7Tar7Ta?dl=0]]: There are two kind of firmware: | ||
48 | |||
49 | * **.bin** : original firmware file. | ||
50 | * **.hex** : file with control / meta info. | ||
51 | |||
52 | (% class="wikigeneratedid" %) | ||
53 | Please note that user needs to use (% class="mark" %)**.bin**(%%) file for update. | ||
54 | |||
55 | (% 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.** | ||
56 | |||
57 | |||
58 | = 3. How to use PC to upgrade via BLE? = | ||
59 | |||
60 | |||
61 | (% class="lead" %) | ||
62 | (% style="color:blue" %)**Step1:**(%%)** Connect a BLE USB to TTL Host into PC** | ||
63 | |||
64 | Below is the example BLE to USB TTL adapter. Insert it to PC | ||
65 | |||
66 | [[image:image-20230601152950-4.png]] | ||
67 | |||
68 | |||
69 | (% class="lead" %) | ||
70 | (% style="color:blue" %)**Step2:**(%%)** Modify Bluetooth host parameters to support Dragino Sensor Management Tool** **v1.4** | ||
71 | |||
72 | 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. | ||
73 | |||
74 | If your Bluetooth host's baud rate is already 115200, please refer to (% style="color:blue" %)**Step3**(%%) directly. | ||
75 | |||
76 | * Check if the Bluetooth host is functioning properly. | ||
77 | |||
78 | Open the serial assistant and send **AT+INQ** (remember to bring carriage return and line feed). | ||
79 | |||
80 | Seeing this interface proves that the host is working properly: | ||
81 | |||
82 | [[image:image-20240912174330-9.png||height="528" width="674"]] | ||
83 | |||
84 | * 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. | ||
85 | |||
86 | An example diagram is as follows: | ||
87 | |||
88 | [[image:image-20240912174428-10.png||height="554" width="704"]] | ||
89 | |||
90 | (% style="color:red" %)**Note:** | ||
91 | |||
92 | (% 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.** | ||
93 | |||
94 | (% 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.** | ||
95 | |||
96 | * If the serial command sending fails, please modify the sending settings of the serial assistant as below: | ||
97 | |||
98 | [[image:image-20240912174714-12.png||height="529" width="669"]] | ||
99 | |||
100 | |||
101 | (% class="lead" %) | ||
102 | (% style="color:blue" %)**Step3:**(%%)** Download Dragino Sensor Management Tool** | ||
103 | |||
104 | **[[Download URL >>https://www.dropbox.com/scl/fo/9kqeqf6wmet10o9hgxuwa/h?rlkey=4ikrg6kg5v0yjxwhp0i37wrv7&dl=0]]** | ||
105 | |||
106 | |||
107 | (% class="lead" %) | ||
108 | (% style="color:blue" %)**Step4:**(%%)** Update .bin Firmware** | ||
109 | |||
110 | (% 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).** | ||
111 | |||
112 | * Select the** **Dragino Sensor Management Tool parameter: | ||
113 | |||
114 | [[image:image-20240912165247-1.png]] | ||
115 | |||
116 | * Before clicking "Start", make sure that the switch of the node is in **FLASH**. | ||
117 | |||
118 | [[image:image-20240912170209-3.png||height="351" width="616"]] | ||
119 | |||
120 | |||
121 | * 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. | ||
122 | |||
123 | The following screen indicates that the Bluetooth host has successfully connected to the node and started the upgrade | ||
124 | |||
125 | [[image:image-20240912171847-5.png]] | ||
126 | |||
127 | (% style="color:red" %)**Note:** | ||
128 | |||
129 | 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.** | ||
130 | 1. (% style="color:red" %)**If the node has been restarted before the upgrade, wait two minutes before the upgrade.** | ||
131 | 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.** | ||
132 | 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.** | ||
133 | |||
134 | [[image:image-20240912092847-6.png]] | ||
135 | |||
136 | * Successful firmware upgrade will print “Upgrade Successful”. | ||
137 | |||
138 | [[image:image-20240912170859-4.png]] | ||
139 | |||
140 | |||
141 | |||
142 | = 4. Access Password and Command = | ||
143 | |||
144 | |||
145 | 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. | ||
146 | |||
147 | For AT Commands list please refer user manual for each sensor. | ||
148 | |||
149 | [[image:image-20240204111847-1.png]] | ||
150 | |||
151 | |||
152 | = 5.FAQ = | ||
153 | |||
154 | == 5.1 What should I do if the upgrade process is automatically interrupted? == | ||
155 | |||
156 | |||
157 | Example: | ||
158 | |||
159 | [[image:image-20240912172143-6.png||height="445" width="460"]] | ||
160 | |||
161 | **How to operate:** | ||
162 | |||
163 | 1. After the upgrade is interrupted, you need to close the wireless upgrade tool and reopen it later. | ||
164 | |||
165 | 2. Before restarting the upgrade, you need to reset the Bluetooth host, otherwise the upgrade may not be possible. | ||
166 | |||
167 | * If your Bluetooth host has a RESET button, you can use the RESET button to reset it. | ||
168 | * 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. | ||
169 | |||
170 | |||
171 | |||
172 | == 5.2 Why does the node keep resetting even though the firmware upgrade is successful? == | ||
173 | |||
174 | |||
175 | If the user burns the firmware with a boot loader, the following situation may occur. | ||
176 | Therefore, users need to select firmware without boot loader when burning firmware. | ||
177 | |||
178 | [[image:image-20240913172520-1.png||height="640" width="803"]] | ||
179 | |||
180 | |||
181 |