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