Wiki source code of NDS01 - NB-IoT Door Sensor User Manual
Hide last authors
author | version | line-number | content |
---|---|---|---|
2.2 | 1 | (% style="text-align:center" %) | |
2 | [[image:image-20221112113258-1.jpeg]] | ||
3 | |||
4 | |||
5 | |||
6 | |||
7 | |||
8 | |||
9 | |||
10 | |||
11 | |||
12 | |||
13 | |||
2.3 | 14 | = 1. Introduction = | |
2.2 | 15 | ||
2.3 | 16 | == 1.1 What is NDS01 NB-IoT Door Sensor == | |
2.2 | 17 | ||
18 | |||
11.2 | 19 | The Dragino NDS01 is a **NB-IOT Door Sensor** for Internet of Things solution. It is used to **detect the open/close event for door and uplink the event** to IoT server via NB-IoT network. | |
2.2 | 20 | ||
3.2 | 21 | Besides open/close event, NDS01 also has an internal temperature and humidity sensor which can detect the temperature and humidity inside the sensor. | |
2.2 | 22 | ||
11.2 | 23 | (% style="color:blue" %)**NarrowBand-Internet of Things (NB-IoT)**(%%) is a standards-based low power wide area (LPWA) technology developed to enable a wide range of new IoT devices and services. NB-IoT significantly improves the power consumption of user devices, system capacity and spectrum efficiency, especially in deep coverage. | |
2.2 | 24 | ||
11.2 | 25 | NDS01 is powered by **2 x AAA batteries** for long term use. | |
2.2 | 26 | ||
27 | *The measured temperature is 2~~3 degree higher than the actually environment temperature out of NDS01. | ||
28 | |||
29 | |||
3.2 | 30 | [[image:1668224602353-769.png]] | |
2.2 | 31 | ||
32 | |||
33 | |||
2.3 | 34 | == 1.2 Specifications == | |
2.2 | 35 | ||
3.2 | 36 | ||
11.2 | 37 | (% style="color:blue" %)**Common DC Characteristics:** | |
2.2 | 38 | ||
3.2 | 39 | * Supply Voltage: 2.1v ~~ 3.6v | |
40 | * Operating Temperature: -10 ~~ 50°C | ||
2.2 | 41 | ||
11.2 | 42 | (% style="color:blue" %)**NB-IoT Spec:** | |
2.2 | 43 | ||
44 | * - B1 @H-FDD: 2100MHz | ||
45 | * - B3 @H-FDD: 1800MHz | ||
46 | * - B8 @H-FDD: 900MHz | ||
47 | * - B5 @H-FDD: 850MHz | ||
48 | * - B20 @H-FDD: 800MHz | ||
49 | * - B28 @H-FDD: 700MHz | ||
50 | |||
11.2 | 51 | (% style="color:blue" %)**Power Consumption** | |
2.2 | 52 | ||
53 | * IDEL Mode: 10uA @ 3.3v | ||
54 | * Max transmit power: <500mA@3.3v | ||
55 | |||
56 | | ||
57 | |||
3.2 | 58 | ||
2.3 | 59 | == 1.3 Features == | |
60 | |||
3.2 | 61 | ||
2.2 | 62 | * NB-IoT Bands: B1/B3/B5/B8/B20/B28 @H-FDD | |
63 | * Ultra low power consumption | ||
64 | * Door Open / Close Detect | ||
65 | * Device remove alarm | ||
66 | * Uplink Protocol: TCP or UDP | ||
67 | * Uplink on periodically | ||
68 | * Micro SIM card slot for NB-IoT SIM | ||
69 | * 2 x AAA LR03 Batteries | ||
3.2 | 70 | ||
11.2 | 71 | ||
72 | |||
3.2 | 73 | == 1.4 Applications == | |
74 | |||
75 | |||
2.2 | 76 | * Smart Buildings & Home Automation | |
77 | * Logistics and Supply Chain Management | ||
78 | * Smart Cities | ||
79 | * Smart Factory | ||
80 | |||
11.2 | 81 | ||
82 | |||
2.3 | 83 | = 2. Use NDS01 to communicate with IoT Server = | |
2.2 | 84 | ||
2.3 | 85 | == 2.1 How it works == | |
2.2 | 86 | ||
3.2 | 87 | ||
2.2 | 88 | The NDS01 is equipped with a NB-IoT module, the pre-loaded firmware in NDS01 will get environment data from sensors and send the value to local NB-IoT network via the NB-IoT module. The NB-IoT network will forward this value to IoT server via the protocol defined by NDS01. | |
89 | |||
90 | The diagram below shows the working flow in default firmware of NDS01: | ||
91 | |||
92 | |||
4.2 | 93 | == 2.2 Configure the NDS01 == | |
2.2 | 94 | ||
2.3 | 95 | === 2.2.1 Test Requirement === | |
2.2 | 96 | ||
97 | |||
98 | To use NDS01 in your city, make sure meet below requirements: | ||
99 | |||
100 | * Your local operator has already distributed a NB-IoT Network there. | ||
101 | * The local NB-IoT network used the band that NDS01 supports. | ||
102 | * Your operator is able to distribute the data received in their NB-IoT network to your IoT server. | ||
103 | |||
11.2 | 104 | Below figure shows our testing structure.Here we have NB-IoT network coverage by China Mobile, the band they use is B8. The NDS01 will use (% style="color:red" %)UDP(120.24.4.116:5601) (%%)or (% style="color:blue" %)TCP(120.24.4.116:5600)(%%)protocol to send data to IoT server. | |
2.2 | 105 | ||
106 | |||
4.2 | 107 | [[image:1668224789474-811.png]] | |
2.2 | 108 | ||
109 | |||
2.3 | 110 | === 2.2.1 Insert SIM card === | |
2.2 | 111 | ||
7.2 | 112 | ||
2.2 | 113 | Insert the NB-IoT Card get from your provider. | |
114 | |||
115 | User need to take out the NB-IoT module and insert the SIM card like below: | ||
116 | |||
117 | |||
7.2 | 118 | [[image:1668224846067-276.png]] | |
2.2 | 119 | ||
120 | |||
2.4 | 121 | === 2.2.3 Configure NDS01 === | |
2.2 | 122 | ||
7.2 | 123 | ||
2.2 | 124 | User need to configure NDS01 via serial port to set the **Server Address** / **Uplink Topic** to define where and how-to uplink packets. NDS01 support AT Commands, user can use a USB to TTL adapter to connect to NDS01 and use AT Commands to configure it, NDS01 needs to be in the wake-up state when using AT commands,as below. | |
125 | |||
126 | |||
7.2 | 127 | [[image:1668224930349-417.png]] | |
2.2 | 128 | ||
129 | |||
7.2 | 130 | (% style="color:blue" %)**Connection:** | |
2.2 | 131 | ||
7.2 | 132 | **~ (% style="background-color:yellow" %)USB TTL GND <~-~-~-~-> GND(%%)** | |
2.2 | 133 | ||
7.2 | 134 | **~ (% style="background-color:yellow" %)USB TTL TXD <~-~-~-~-> UART_RXD(%%)** | |
2.2 | 135 | ||
7.2 | 136 | **~ (% style="background-color:yellow" %)USB TTL RXD <~-~-~-~-> UART_TXD(%%)** | |
2.2 | 137 | ||
138 | |||
139 | In the PC, use below serial tool settings: | ||
140 | |||
7.2 | 141 | * Baud: (% style="color:green" %)**9600** | |
142 | * Data bits:** (% style="color:green" %)8(%%)** | ||
143 | * Stop bits: (% style="color:green" %)**1** | ||
144 | * Parity: (% style="color:green" %)**None** | ||
145 | * Flow Control: (% style="color:green" %)**None** | ||
2.2 | 146 | ||
147 | After powering on the NDS01, the following information will be printed | ||
148 | |||
7.2 | 149 | [[image:1668225099789-919.png]] | |
2.2 | 150 | ||
151 | |||
7.2 | 152 | (% style="color:blue" %)**AT command set** | |
2.2 | 153 | ||
7.3 | 154 | (% style="color:#037691" %)**1. Set and query the communication protocol** | |
7.2 | 155 | ||
10.2 | 156 | **Send: ** AT+PRO=<val> Val: 0:TCP 1:UDP | |
2.2 | 157 | ||
10.2 | 158 | **Reply: **OK | |
2.2 | 159 | ||
10.2 | 160 | **Send: ** AT+PRO? ~/~/ Inquire | |
2.2 | 161 | ||
10.2 | 162 | **Reply:** +PRO:0 | |
2.2 | 163 | ||
164 | OK | ||
165 | |||
166 | |||
7.3 | 167 | (% style="color:#037691" %)**2. Set and query the server address** | |
7.2 | 168 | ||
10.2 | 169 | **Send:** AT+SERVADDR=<server>,<port> | |
2.2 | 170 | ||
10.2 | 171 | **Reply:** OK | |
2.2 | 172 | ||
10.2 | 173 | **Send:** AT+SERVADDR? ~/~/ Inquire | |
2.2 | 174 | ||
10.2 | 175 | **Reply: **+SERVADDR:<server>,<port> | |
2.2 | 176 | ||
177 | OK | ||
178 | |||
179 | |||
7.3 | 180 | (% style="color:#037691" %)**3. Set and query the TDC** | |
2.2 | 181 | ||
10.2 | 182 | **Send:** AT+TDC=<value> ~/~/ Heartbeat time, in seconds, the default is 86400s,which is 24 hours | |
2.2 | 183 | ||
10.2 | 184 | **Reply:** OK | |
2.2 | 185 | ||
10.2 | 186 | **Send:** AT+TDC? ~/~/ Inquire | |
7.2 | 187 | ||
10.2 | 188 | **Reply:** +TDC:<value> | |
2.2 | 189 | ||
190 | OK | ||
191 | |||
192 | |||
7.3 | 193 | (% style="color:#037691" %)**4. Query parameters** | |
2.2 | 194 | ||
10.2 | 195 | **Send:** AT+CFG? | |
2.2 | 196 | ||
10.2 | 197 | **Reply:** +PRO:0 | |
7.2 | 198 | ||
2.2 | 199 | +SERVADDR:120.27.12.119,2023 | |
200 | |||
201 | +TDC:86400 | ||
202 | |||
203 | +CSQ:31 | ||
204 | |||
205 | +IMEI:868163049937383 | ||
206 | |||
207 | +ICCID:898604611619C0854626 | ||
208 | |||
209 | +IMSI:460048118204626 | ||
210 | |||
211 | OK | ||
212 | |||
213 | |||
7.3 | 214 | (% style="color:#037691" %)**5. Set and query the APN** | |
2.2 | 215 | ||
10.2 | 216 | **Send:** AT+APN="<apn>" ~/~/ Set APN | |
7.2 | 217 | ||
7.3 | 218 | **Reply:** OK | |
2.2 | 219 | ||
7.3 | 220 | **Send:** AT+APN? ~/~/ Inquire | |
2.2 | 221 | ||
7.3 | 222 | **Reply:** +APN:"cmiot" | |
2.2 | 223 | ||
224 | OK | ||
225 | |||
226 | |||
7.3 | 227 | (% style="color:#037691" %)**6. Alarm and Silencer** | |
2.2 | 228 | ||
7.3 | 229 | **Send: **AT+ALARM=<value> ~/~/ 0~~1,0: mute 1: buzzer alarm (note that no data will be reported, only the buzzer and the red light are on, if it is in silent mode, only the red light is on) | |
7.2 | 230 | ||
7.3 | 231 | **Reply:** OK | |
2.2 | 232 | ||
233 | |||
234 | |||
2.4 | 235 | === 2.2.4 Use UDP protocol to uplink data (Default protocol) === | |
2.2 | 236 | ||
10.2 | 237 | ||
7.2 | 238 | * (% style="color:blue" %)**AT+PRO=1 **(%%) ~/~/ Set to use UDP protocol to uplink | |
239 | * (% style="color:blue" %)**AT+SERVADDR=119.91.62.30,1999 ** (%%) ~/~/ to set UDP server address and port | ||
2.2 | 240 | ||
10.2 | 241 | [[image:1668231759500-524.png]] | |
2.2 | 242 | ||
11.2 | 243 | ||
244 | |||
2.4 | 245 | === 2.2.5 Use TCP protocol to uplink data === | |
3.2 | 246 | ||
10.2 | 247 | ||
7.2 | 248 | * (% style="color:blue" %)**AT+PRO=0 ** (%%) ~/~/ Set to use TCP protocol to uplink | |
249 | * (% style="color:blue" %)**AT+SERVADDR=119.91.62.30,2002 **(%%) ~/~/ to set TCP server address and port | ||
2.2 | 250 | ||
10.2 | 251 | [[image:1668231789502-211.png]] | |
2.2 | 252 | ||
253 | |||
254 | |||
2.4 | 255 | === 2.2.6 Change Update Interval === | |
2.2 | 256 | ||
10.2 | 257 | ||
7.2 | 258 | User can use below command to change the (% style="color:blue" %)**uplink interval**. | |
2.2 | 259 | ||
7.2 | 260 | (% style="color:blue" %)**AT+TDC=86400 ** (%%)~/~/ Set Update Interval to 86400s | |
2.2 | 261 | ||
262 | |||
7.2 | 263 | (% style="color:red" %)**NOTE:** | |
2.2 | 264 | ||
10.2 | 265 | ~1. By default, the device will send an uplink message every 24 hour (86400s). | |
2.2 | 266 | ||
267 | |||
10.2 | 268 | [[image:1668231824288-204.png]] | |
2.2 | 269 | ||
270 | |||
271 | |||
2.4 | 272 | == 2.3 Uplink Payload == | |
2.2 | 273 | ||
10.2 | 274 | ||
2.2 | 275 | registration package, uplink payload includes in total 61 bytes | |
276 | |||
277 | |||
10.2 | 278 | (% border="1" cellspacing="5" style="background-color:#ffffcc; color:green; width:520px" %) | |
279 | |(% style="width:94px" %)((( | ||
280 | **Size(bytes)** | ||
281 | )))|(% style="width:51px" %)**2**|(% style="width:68px" %)**1**|(% style="width:81px" %)**1**|(% style="width:96px" %)**1**|(% style="width:94px" %)**1**|(% style="width:80px" %)**15**|(% style="width:49px" %)**15**|(% style="width:57px" %)**20**|(% style="width:43px" %)**1**|(% style="width:59px" %)**1**|(% style="width:41px" %)**3** | ||
282 | |(% style="width:94px" %)**Value**|(% style="width:51px" %)head|(% style="width:68px" %)Version|(% style="width:81px" %)data type|(% style="width:96px" %)Data length|(% style="width:94px" %)device type|(% style="width:80px" %)device ID|(% style="width:49px" %)IMSI|(% style="width:57px" %)ICCID|(% style="width:43px" %)BAT|(% style="width:59px" %)Signal|(% style="width:41px" %)tail | ||
2.2 | 283 | ||
10.4 | 284 | The payload is ASCII string, representative same HEX: **0x (% style="color:red" %)4B57 (% style="color:blue" %)10 (% style="color:green" %)01 (% style="color:#00b0f0" %)34 (% style="color:#7030a0" %) 01 (% style="color:#d60093" %)383639393735303334343431303832 (% style="color:#0020b0" %)3839383631313230323234303134333938373632 (% style="color:#420042" %)1E (% style="color:#663300" %)15 (% style="color:#660066" %)494F54(%%)** | |
2.2 | 285 | ||
10.4 | 286 | **where:** | |
2.2 | 287 | ||
10.4 | 288 | * (% style="color:#037691" %)**Head:** (%%)0x4B57(fixed) | |
2.2 | 289 | ||
10.4 | 290 | * (% style="color:#037691" %)**Version:** (%%)0x10=”V1.0” | |
2.2 | 291 | ||
10.4 | 292 | * (% style="color:#037691" %)**Data type:** (%%)0x01=1(1:register,2:data sending) | |
2.2 | 293 | ||
10.4 | 294 | * (% style="color:#037691" %)**Data length:** (%%)0x34=52(Valid data is 52 bytes) | |
2.2 | 295 | ||
10.4 | 296 | * (% style="color:#037691" %)**Device type:**(%%) 0x01 = 1(Representative NDS01) | |
2.2 | 297 | ||
10.4 | 298 | * (% style="color:#037691" %)**Device ID:** (%%)0x383639393735303334343431303832=869975034441082(ASCII) | |
2.2 | 299 | ||
10.4 | 300 | * (% style="color:#037691" %)**IMSI:**(%%) 0x343630313133313138373433373332 = 460113118743732(ASCII) | |
2.2 | 301 | ||
10.4 | 302 | * (% style="color:#037691" %)**ICCID:**(%%) 0x3839383631313230323234303134333938373632=89861120224014398762(ASCII) | |
2.2 | 303 | ||
10.4 | 304 | * (% style="color:#037691" %)**Bat: **(%%)0x1E = 30/10=3.0V | |
2.2 | 305 | ||
10.4 | 306 | * (% style="color:#037691" %)**Signal:**(%%) 0x15=21 | |
10.2 | 307 | ||
11.2 | 308 | (% style="color:red" %)** 0**(%%) -113dBm or less | |
10.2 | 309 | ||
11.2 | 310 | (% style="color:red" %)** 1** (%%)-111dBm | |
10.2 | 311 | ||
11.2 | 312 | (% style="color:red" %)** 2...30**(%%) -109dBm... -53dBm | |
10.2 | 313 | ||
11.2 | 314 | (% style="color:red" %)** 31** (%%)-51dBm or greater | |
10.2 | 315 | ||
11.2 | 316 | (% style="color:red" %)** 99** (%%)Not known or not detectable | |
10.2 | 317 | ||
10.4 | 318 | * (% style="color:#037691" %)**Tail: **(%%)0x494F54(fixed) | |
319 | |||
2.2 | 320 | data upload, uplink payload includes in total 32 bytes | |
321 | |||
11.2 | 322 | (% border="1" cellspacing="5" style="background-color:#ffffcc; color:green; width:520px" %) | |
323 | |(% style="width:95px" %)((( | ||
10.2 | 324 | **Size(bytes)** | |
11.2 | 325 | )))|(% style="width:51px" %)**2**|(% style="width:68px" %)**1**|(% style="width:51px" %)**1**|(% style="width:68px" %)**1**|(% style="width:61px" %)**1**|(% style="width:64px" %)**15**|(% style="width:57px" %)**1**|(% style="width:78px" %)**1**|(% style="width:42px" %)**1**|(% style="width:58px" %)**1**|(% style="width:67px" %)**1**|(% style="width:72px" %)**1**|(% style="width:67px" %)**1**|(% style="width:69px" %)**1**|(% style="width:38px" %)**3** | |
326 | |(% style="width:95px" %)**Value**|(% style="width:51px" %)head|(% style="width:68px" %)Version|(% style="width:51px" %)data type|(% style="width:68px" %)Data length|(% style="width:61px" %)device type|(% style="width:64px" %)device ID|(% style="width:57px" %)event type|(% style="width:78px" %)Door magnetic state|(% style="width:42px" %)BAT|(% style="width:58px" %)Signal|(% style="width:67px" %)((( | ||
2.2 | 327 | Temp | |
328 | integer | ||
11.2 | 329 | )))|(% style="width:72px" %)((( | |
2.2 | 330 | Temp | |
331 | decimal | ||
11.2 | 332 | )))|(% style="width:67px" %)((( | |
2.2 | 333 | Hum | |
334 | integer | ||
11.2 | 335 | )))|(% style="width:69px" %)((( | |
2.2 | 336 | Hum | |
337 | decimal | ||
11.2 | 338 | )))|(% style="width:38px" %)tail | |
2.2 | 339 | ||
10.4 | 340 | The payload is ASCII string, representative same HEX: 0x (% style="color:red" %)4B57 (% style="color:blue" %)10 (% style="color:green" %)02 (% style="color:#00b0f0" %)14 (% style="color:#7030a0" %)01 (% style="color:#d60093" %)383639393735303334343431303832 (% style="color:#a14d07" %)01 (% style="color:#0020b0" %)00 (% style="color:#420042" %)20 (% style="color:#663300" %)15 (% style="color:#660066" %)1c (% style="color:#aaaa40" %)55 (% style="color:#abaa70" %)23 (% style="color:#ba5a70" %)12 (% style="color:#acaab0" %)494F54 | |
2.2 | 341 | ||
10.4 | 342 | **where:** | |
10.2 | 343 | ||
10.4 | 344 | * (% style="color:#037691" %)**Head:** (%%)0x4B57(fixed) | |
10.2 | 345 | ||
10.4 | 346 | * (% style="color:#037691" %)**Version:** (%%)0x10=”V1.0” | |
2.2 | 347 | ||
10.4 | 348 | * (% style="color:#037691" %)**Data type:** (%%)0x02=2(1:register,2:data sending) | |
10.2 | 349 | ||
10.4 | 350 | * (% style="color:#037691" %)**Data length:** (%%)0x14=20(Valid data is 20 bytes) | |
2.2 | 351 | ||
10.4 | 352 | * (% style="color:#037691" %)**Device type: **(%%)0x01 = 1(Representative NDS01) | |
2.2 | 353 | ||
10.4 | 354 | * (% style="color:#037691" %)**Device ID:** (%%)0x383639393735303334343431303832=869975034441082(ASCII) | |
2.2 | 355 | ||
10.4 | 356 | * (% style="color:#037691" %)**Event type:** (%%)0x01 | |
2.2 | 357 | ||
10.4 | 358 | (% style="color:red" %)** 01:**(%%) TDC | |
2.2 | 359 | ||
11.2 | 360 | (% style="color:red" %)** 02:**(%%)** **alarm | |
2.2 | 361 | ||
11.2 | 362 | (% style="color:red" %)** 03:**(%%) remove alarm | |
2.2 | 363 | ||
11.2 | 364 | (% style="color:red" %)**04: **(%%)dismantling alarm | |
2.2 | 365 | ||
11.2 | 366 | (% style="color:red" %)**05:** (%%)remove demolition alarm | |
2.2 | 367 | ||
11.2 | 368 | (% style="color:red" %)**06:** (%%)low voltage | |
2.2 | 369 | ||
11.2 | 370 | **~ (% style="color:red" %)07: (%%)**remove low voltage | |
2.2 | 371 | ||
10.4 | 372 | * (% style="color:#037691" %)**Door magnetic state:** (%%)0x00 | |
10.2 | 373 | ||
10.4 | 374 | (% style="color:red" %)**00:**(%%) Door sensor is close | |
2.2 | 375 | ||
10.4 | 376 | (% style="color:red" %)**01:** (%%)Door sensor is open | |
2.2 | 377 | ||
10.4 | 378 | * (% style="color:#037691" %)**Bat:**(%%)** **0x20 = 32/10=3.2V | |
2.2 | 379 | ||
10.4 | 380 | * (% style="color:#037691" %)**Signal:**(%%)** **0x15=21 | |
2.2 | 381 | ||
10.4 | 382 | (% style="color:red" %)** 0** (%%)-113dBm or less | |
2.2 | 383 | ||
10.4 | 384 | (% style="color:red" %)** 1** (%%)-111dBm | |
2.2 | 385 | ||
10.4 | 386 | (% style="color:red" %)** 2...30**(%%) -109dBm... -53dBm | |
10.2 | 387 | ||
10.4 | 388 | (% style="color:red" %)** 31** (%%)-51dBm or greater | |
2.2 | 389 | ||
10.4 | 390 | (% style="color:red" %)** 99** (%%)Not known or not detectable | |
391 | |||
392 | * (% style="color:#037691" %)**Temp integer:**(%%) 0x1c=28 | ||
393 | |||
394 | * (% style="color:#037691" %)**Temp decimal:** (%%)0x55=85 | ||
395 | |||
2.2 | 396 | Temp =Temp integer+(Temp decimal)/100=28+85/100=28.85℃ | |
397 | |||
10.4 | 398 | * (% style="color:#037691" %)**Hum integer: **(%%)0x23=35 | |
10.2 | 399 | ||
10.4 | 400 | * (% style="color:#037691" %)**Hum decimal:** (%%)0x12=18 | |
2.2 | 401 | ||
11.2 | 402 | Hum =Hum integer+(Hum decimal)/100=35+18/100=35.18**%**rh | |
2.2 | 403 | ||
10.4 | 404 | * (% style="color:#037691" %)**Tail:** (%%)0x494F54(fixed) | |
2.2 | 405 | ||
2.4 | 406 | == 2.4 Node-Red Example == | |
2.2 | 407 | ||
11.2 | 408 | ||
2.2 | 409 | Please refer to this link for the use of Node-RED: | |
410 | |||
11.2 | 411 | [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Node-RED/>>http://wiki.dragino.com/xwiki/bin/view/Main/Node-RED/]] | |
2.2 | 412 | ||
413 | Please visit this link to download the Node-RED process: | ||
414 | |||
415 | [[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/Node-RED>>url:https://github.com/dragino/dragino-end-node-decoder/tree/main/Node-RED]] | ||
416 | |||
11.2 | 417 | [[image:1668234343252-612.png]] | |
2.2 | 418 | ||
419 | |||
420 | |||
2.4 | 421 | == 2.5 Buttons and LED and Mode == | |
2.2 | 422 | ||
423 | |||
11.2 | 424 | (% style="color:blue" %)**Operating mode** | |
425 | |||
2.2 | 426 | (1) In the self-check mode (the default is the self-check mode when power on for the first time), the state change of the tamper switch does not trigger an alarm; | |
427 | |||
428 | (2) In normal working mode, the state change of the tamper switch triggers an alarm; | ||
429 | |||
430 | (3) In silent mode (the default is non-silent mode when power on for the first time), the buzzer is silent. | ||
431 | |||
432 | |||
11.2 | 433 | (% style="color:blue" %)**led lights** | |
2.2 | 434 | ||
435 | (1) After the device is powered on, the green light flashes once; | ||
436 | |||
437 | (2) The device does not set server parameters or cannot connect to the server, and the green light flashes quickly; | ||
438 | |||
439 | (3) SIM card recognition fails, the green light is always on for 20s; | ||
440 | |||
441 | (4) The equipment signal is poor, and the green light flashes once every 3 seconds; | ||
442 | |||
443 | (5) When the device sends data, the green light flashes twice; | ||
444 | |||
445 | (6) The communication of the equipment is normal, and the green light flashes 3 times continuously; | ||
446 | |||
447 | (7) Trigger the tamper switch, the red light is always on for 30s, and goes out when the alarm is canceled; | ||
448 | |||
449 | (8) Trigger the door magnetic alarm, the red light is always on for 30s, and goes out when the alarm is canceled; | ||
450 | |||
451 | |||
11.2 | 452 | (% style="color:blue" %)**buzzer** | |
2.2 | 453 | ||
454 | (1) When the door magnetic alarm is triggered, the buzzer will sound for 30s; after the alarm is restored, the buzzer will be silenced; | ||
455 | |||
456 | (2) Enter the normal working mode (the tamper switch is closed for more than 5s or the door sensor is locked for more than 5s), the buzzer will sound for 1500ms; | ||
457 | |||
458 | (3) After entering the normal working mode, the tamper switch does not close, the buzzer sounds for 30s, the tamper switch is closed, and the buzzer sounds 1 time; | ||
459 | |||
460 | (4) When the door sensor does not alarm, press the button to trigger the alarm, and the buzzer will sound for 30s; when the door sensor alarms, press it once to cancel the alarm, and the buzzer will be silenced. | ||
461 | |||
462 | |||
11.2 | 463 | (% style="color:blue" %)**button** | |
2.2 | 464 | ||
465 | (1) When there is no alarm, press it once to trigger the alarm, and the buzzer will sound; when it alarms, press the buzzer to silence the sound. | ||
466 | |||
467 | (2) Press twice to silence the buzzer; | ||
468 | |||
469 | (3) Press the button three times or more, when the mute function is turned off, the mute function is turned on, and the green light flashes once; when the mute function is turned on, the mute function is turned off, and the green light flashes once. | ||
470 | |||
471 | |||
11.2 | 472 | (% style="color:blue" %)**data pack** | |
2.2 | 473 | ||
474 | (1) The device needs to send a registration packet and a heartbeat packet every time it is powered on and registered; | ||
475 | |||
476 | (2) The heartbeat time is reported once every 24 hours by default. | ||
477 | |||
11.2 | 478 | ||
2.4 | 479 | = 3. FAQ = | |
2.2 | 480 | ||
2.4 | 481 | == 3.1 How to Upgrade Firmware == | |
482 | |||
11.2 | 483 | ||
2.2 | 484 | User can upgrade the firmware for 1) bug fix, 2) new feature release. | |
485 | |||
486 | Burning software please go to this link to download: | ||
487 | |||
11.2 | 488 | (% style="color:red" %)**Note:** | |
2.2 | 489 | ||
490 | Disconnect one battery before starting the upgrade | ||
491 | |||
492 | Please use 1.8V USB TO TTL serial port | ||
493 | |||
11.2 | 494 | (% style="color:blue" %)**Connection:** | |
2.2 | 495 | ||
11.2 | 496 | * | |
497 | ** (% style="background-color:yellow" %)USB TTL GND <~-~-~-~-> GND | ||
2.2 | 498 | ||
11.2 | 499 | * | |
500 | ** (% style="background-color:yellow" %)USB TTL TXD <~-~-~-~-> UART_RXD | ||
2.2 | 501 | ||
11.2 | 502 | * | |
503 | ** (% style="background-color:yellow" %)USB TTL RXD <~-~-~-~-> UART_TXD | ||
2.2 | 504 | ||
505 | 1. Double-click "FlashTool.exe" to start the program | ||
506 | |||
507 | [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image010.png]] | ||
508 | |||
509 | [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image011.png]] | ||
510 | |||
511 | 1. Select burn serial port and firmware package to complete the upgrade | ||
512 | |||
513 | [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image012.png]] | ||
514 | |||
515 | [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image013.png]] | ||
516 | |||
517 | 1. Install the battery to the node, and the upgrade will start at this time | ||
518 | |||
519 | [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image014.png]] | ||
520 | |||
521 | 1. The following screenshot appears, indicating that the upgrade has been successful | ||
522 | |||
523 | [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image015.png]] | ||
524 | |||
525 | |||
2.4 | 526 | = 4. Order Info = | |
2.2 | 527 | ||
11.2 | 528 | Part Number: (% style="color:blue" %)**NDS01** | |
2.2 | 529 | ||
530 | |||
2.4 | 531 | = 5. Packing Info = | |
2.2 | 532 | ||
2.4 | 533 | ||
11.2 | 534 | (% style="color:#037691" %)**Package Includes**: | |
2.2 | 535 | ||
536 | * NDS01 NB-IoT Door Sensor | ||
537 | |||
11.2 | 538 | (% style="color:#037691" %)**Dimension and weight**: | |
2.2 | 539 | ||
540 | * Device Size: | ||
541 | * Device Weight: | ||
542 | * Package Size / pcs : | ||
543 | * Weight / pcs : |