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