Last modified by Xiaoling on 2024/01/18 18:04
<
From version < 7.1 >
edited by Xiaoling
on 2022/11/12 11:51
To version < 10.2 >
edited by Xiaoling
on 2022/11/12 13:56
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -13,7 +13,6 @@
13 13  
14 14  = 1. Introduction =
15 15  
16 -
17 17  == 1.1 ​What is NDS01 NB-IoT Door Sensor ==
18 18  
19 19  
... ... @@ -32,7 +32,6 @@
32 32  
33 33  
34 34  
35 -
36 36  == 1.2 Specifications ==
37 37  
38 38  
... ... @@ -41,7 +41,6 @@
41 41  * Supply Voltage: 2.1v ~~ 3.6v
42 42  * Operating Temperature: -10 ~~ 50°C
43 43  
44 -
45 45  **NB-IoT Spec:**
46 46  
47 47  * - B1 @H-FDD: 2100MHz
... ... @@ -51,7 +51,6 @@
51 51  * - B20 @H-FDD: 800MHz
52 52  * - B28 @H-FDD: 700MHz
53 53  
54 -
55 55  **Power Consumption**
56 56  
57 57  * IDEL Mode: 10uA @ 3.3v
... ... @@ -72,8 +72,6 @@
72 72  * Micro SIM card slot for NB-IoT SIM
73 73  * 2 x AAA LR03 Batteries
74 74  
75 -
76 -
77 77  == 1.4  ​Applications ==
78 78  
79 79  
... ... @@ -82,11 +82,8 @@
82 82  * Smart Cities
83 83  * Smart Factory
84 84  
85 -
86 -
87 87  = 2. Use NDS01 to communicate with IoT Server =
88 88  
89 -
90 90  == 2.1 How it works ==
91 91  
92 92  
... ... @@ -97,7 +97,6 @@
97 97  
98 98  == 2.2 Configure the NDS01 ==
99 99  
100 -
101 101  === 2.2.1 Test Requirement ===
102 102  
103 103  
... ... @@ -113,92 +113,95 @@
113 113  [[image:1668224789474-811.png]]
114 114  
115 115  
116 -
117 117  === 2.2.1 Insert SIM card ===
118 118  
108 +
119 119  Insert the NB-IoT Card get from your provider.
120 120  
121 -
122 122  User need to take out the NB-IoT module and insert the SIM card like below:
123 123  
124 124  
125 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image003.png]]
114 +[[image:1668224846067-276.png]]
126 126  
127 127  
128 128  === 2.2.3 Configure NDS01 ===
129 129  
119 +
130 130  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.
131 131  
132 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image004.png]]
133 133  
123 +[[image:1668224930349-417.png]]
134 134  
135 135  
136 -Connection:
126 +(% style="color:blue" %)**Connection:**
137 137  
138 -USB TTL GND <~-~-~-~-> GND
128 +**~ (% style="background-color:yellow" %)USB TTL GND <~-~-~-~-> GND(%%)**
139 139  
140 -USB TTL TXD <~-~-~-~-> UART_RXD
130 +**~ (% style="background-color:yellow" %)USB TTL TXD  <~-~-~-~-> UART_RXD(%%)**
141 141  
142 -USB TTL RXD <~-~-~-~-> UART_TXD
132 +**~ (% style="background-color:yellow" %)USB TTL RXD  <~-~-~-~-> UART_TXD(%%)**
143 143  
144 144  
145 -
146 146  In the PC, use below serial tool settings:
147 147  
148 -* Baud: **115200**
149 -* Data bits:** 8**
150 -* Stop bits: **1**
151 -* Parity: **None**
152 -* Flow Control: **None**
137 +* Baud:  (% style="color:green" %)**9600**
138 +* Data bits:**  (% style="color:green" %)8(%%)**
139 +* Stop bits:  (% style="color:green" %)**1**
140 +* Parity:  (% style="color:green" %)**None**
141 +* Flow Control: (% style="color:green" %)**None**
153 153  
154 154  After powering on the NDS01, the following information will be printed
155 155  
156 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image005.png]]
145 +[[image:1668225099789-919.png]]
157 157  
158 -AT command set
159 159  
160 -1. Set and query the communication protocol
148 +(% style="color:blue" %)**AT command set**
161 161  
162 - Send:  AT+PRO=<val>  Val: 0:TCP 1:UDP
150 +(% style="color:#037691" %)**1. Set and query the communication protocol**
163 163  
164 - Reply: OK
152 +**Send: ** AT+PRO=<val>  Val: 0:TCP 1:UDP
165 165  
166 - Send:  AT+PRO? ~/~/Inquire
154 +**Reply: **OK
167 167  
168 - Reply: +PRO:0
156 +**Send: ** AT+PRO?  ~/~/ Inquire
169 169  
158 +**Reply:** +PRO:0
159 +
170 170  OK
171 171  
172 -1. Set and query the server address
173 173  
174 -Send: AT+SERVADDR=<server>,<port>        
163 +(% style="color:#037691" %)**2. Set and query the server address**
175 175  
176 - Reply: OK
165 +**Send:** AT+SERVADDR=<server>,<port>        
177 177  
178 -Send: AT+SERVADDR? ~/~/Inquire
167 +**Reply:** OK
179 179  
180 -Reply: +SERVADDR:<server>,<port>
169 +**Send:** AT+SERVADDR?  ~/~/ Inquire
181 181  
171 +**Reply: **+SERVADDR:<server>,<port>
172 +
182 182  OK
183 183  
184 -1. Set and query the TDC
185 185  
186 -Send:AT+TDC=<value>~/~/Heartbeat time, in seconds, the default is 86400s,which is 24 hours
176 +(% style="color:#037691" %)**3. Set and query the TDC**
187 187  
188 -Reply:OK
178 +**Send:** AT+TDC=<value>  ~/~/ Heartbeat time, in seconds, the default is 86400s,which is 24 hours
189 189  
190 -Send:AT+TDC?       ~/~/Inquire
180 +**Reply:** OK
191 191  
192 -Reply: +TDC:<value>
182 +**Send:** AT+TDC?       ~/~/ Inquire
193 193  
184 +**Reply:** +TDC:<value>
185 +
194 194  OK
195 195  
196 -1. Query parameters
197 197  
198 -Send:AT+CFG?            
189 +(% style="color:#037691" %)**4. Query parameters**
199 199  
200 -Reply:+PRO:0
191 +**Send:** AT+CFG?            
201 201  
193 +**Reply:** +PRO:0
194 +
202 202  +SERVADDR:120.27.12.119,2023
203 203  
204 204  +TDC:86400
... ... @@ -213,108 +213,117 @@
213 213  
214 214  OK
215 215  
216 -1. Set and query the APN
217 217  
218 -Send: AT+APN="<apn>"             ~/~/Set APN          
210 +(% style="color:#037691" %)**5. Set and query the APN**
219 219  
220 - Reply: OK
212 +**Send:** AT+APN="<apn>"  ~/~/ Set APN          
221 221  
222 -Send: AT+APN?     ~/~/Inquire
214 +**Reply:** OK
223 223  
224 -Reply: +APN:"cmiot"
216 +**Send:** AT+APN?  ~/~/ Inquire
225 225  
218 +**Reply:** +APN:"cmiot"
219 +
226 226  OK
227 227  
228 -1. Alarm and Silencer
229 229  
230 -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)
223 +(% style="color:#037691" %)**6. Alarm and Silencer**
231 231  
232 -Reply: OK
225 +**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)
233 233  
227 +**Reply:** OK
234 234  
235 235  
236 236  
237 237  === 2.2.4 Use UDP protocol to uplink data (Default protocol) ===
238 238  
239 -* **AT+PRO=1   ** ~/~/ Set to use UDP protocol to uplink
240 -* **AT+SERVADDR=119.91.62.30,1999   **~/~/ to set UDP server address and port
241 241  
242 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image006.png]]
234 +* (% style="color:blue" %)**AT+PRO=1   **(%%) ~/~/ Set to use UDP protocol to uplink
235 +* (% style="color:blue" %)**AT+SERVADDR=119.91.62.30,1999   ** (%%) ~/~/ to set UDP server address and port
243 243  
244 244  
245 245  
239 +[[image:1668231759500-524.png]]
240 +
241 +
242 +
246 246  === 2.2.5 Use TCP protocol to uplink data ===
247 247  
248 -* **AT+PRO=0   ** ~/~/ Set to use TCP protocol to uplink
249 -* **AT+SERVADDR=119.91.62.30,2002   **~/~/ to set TCP server address and port
250 250  
251 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image007.png]]
246 +* (% style="color:blue" %)**AT+PRO=0   ** (%%) ~/~/ Set to use TCP protocol to uplink
247 +* (% style="color:blue" %)**AT+SERVADDR=119.91.62.30,2002   **(%%) ~/~/ to set TCP server address and port
252 252  
249 +[[image:1668231789502-211.png]]
253 253  
254 254  
255 255  
256 256  === 2.2.6 Change Update Interval ===
257 257  
258 -User can use below command to change the **uplink interval**.
259 259  
260 -**AT+TDC=86400      **~/~/ Set Update Interval to 86400s
256 +User can use below command to change the (% style="color:blue" %)**uplink interval**.
261 261  
258 +(% style="color:blue" %)**AT+TDC=86400      ** (%%)~/~/ Set Update Interval to 86400s
262 262  
263 -**NOTE:**
264 264  
265 -1. By default, the device will send an uplink message every 24 hour (86400s).
261 +(% style="color:red" %)**NOTE:**
266 266  
267 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image008.png]]
263 +~1. By default, the device will send an uplink message every 24 hour (86400s).
268 268  
269 269  
266 +[[image:1668231824288-204.png]]
270 270  
271 271  
269 +
272 272  == 2.3 Uplink Payload ==
273 273  
272 +
274 274  registration package, uplink payload includes in total 61 bytes
275 275  
276 276  
277 -|(((
278 -**Size**
276 +(% border="1" cellspacing="5" style="background-color:#ffffcc; color:green; width:520px" %)
277 +|(% style="width:94px" %)(((
278 +**Size(bytes)**
279 +)))|(% 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**
280 +|(% 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
279 279  
280 -**(bytes)**
281 -)))|**2**|**1**|**1**|**1**|**1**|**15**|**15**|**20**|**1**|**1**|**3**
282 -|**Value**|head|Version|data type|Data length|device type|device ID|IMSI|ICCID|BAT|Signal|tail
282 +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:#a14d07" %343630313133313138373433373332 (% style="color:#0020b0" %)3839383631313230323234303134333938373632 (% style="color:#420042" %)1E (% style="color:#663300" %)15 (% style="color:#660066" %)494F54 where:
283 283  
284 -The payload is ASCII string, representative same HEX: 0x4B5710013401383639393735303334343431303832343630313133313138373433373332
284 +* (% style="color:#037691" %)Head: (%%)0x4B57(fixed)
285 285  
286 -38393836313132303232343031343339383736321E15494F54 where:
286 +* (% style="color:#037691" %)Version: (%%)0x10=”V1.0”
287 287  
288 -* Head: 0x4B57(fixed)
289 -* Version: 0x10=”V1.0”
290 -* Data type: 0x01=1(1:register,2:data sending)
291 -* Data length: 0x34=52(Valid data is 52 bytes)
288 +* (% style="color:#037691" %)Data type: (%%)0x01=1(1:register,2:data sending)
292 292  
293 -* Device type: 0x01 = 1(Representative NDS01)
294 -* Device ID:0x383639393735303334343431303832=869975034441082(ASCII)
295 -* IMSI: 0x343630313133313138373433373332 = 460113118743732(ASCII)
296 -* ICCID: 0x3839383631313230323234303134333938373632=89861120224014398762(ASCII)
297 -* Bat: 0x1E = 30/10=3.0V
298 -* Signal: 0x15=21
290 +* (% style="color:#037691" %)Data length: (%%)0x34=52(Valid data is 52 bytes)
299 299  
300 -**0** -113dBm or less
292 +* (% style="color:#037691" %)Device type:(%%) 0x01 = 1(Representative NDS01)
301 301  
302 -**1** -111dBm
294 +* (% style="color:#037691" %)Device ID: (%%)0x383639393735303334343431303832=869975034441082(ASCII)
303 303  
304 -**2...30** -109dBm... -53dBm
296 +* (% style="color:#037691" %)IMSI:(%%) 0x343630313133313138373433373332 = 460113118743732(ASCII)
305 305  
306 -**31** -51dBm or greater
298 +* (% style="color:#037691" %)ICCID:(%%) 0x3839383631313230323234303134333938373632=89861120224014398762(ASCII)
307 307  
308 -**99** Not known or not detectable
300 +* (% style="color:#037691" %)Bat: (%%)0x1E = 30/10=3.0V
309 309  
310 -* Tail:0x494F54(fixed)
302 +* (% style="color:#037691" %)Signal:(%%) 0x15=21
311 311  
304 +**(% style="color:red" %)0**(%%) -113dBm or less
305 +
306 +**(% style="color:red" %)1** (%%)-111dBm
307 +
308 +**(% style="color:red" %)2...30**(%%) -109dBm... -53dBm
309 +
310 +**(% style="color:red" %)31** (%%)-51dBm or greater
311 +
312 +**(% style="color:red" %)99** (%%)Not known or not detectable
313 +
314 +* (% style="color:#037691" %)Tail: 0x494F54(fixed)
315 +
312 312  data upload, uplink payload includes in total 32 bytes
313 313  
314 314  |(((
315 -**Size**
316 -
317 -**(bytes)**
319 +**Size(bytes)**
318 318  )))|**2**|**1**|**1**|**1**|**1**|**15**|**1**|**1**|**1**|**1**|**1**|**1**|**1**|**1**|**3**
319 319  |**Value**|head|Version|data type|Data length|device type|device ID|event type|Door magnetic state|BAT|Signal|(((
320 320  Temp
... ... @@ -337,12 +337,17 @@
337 337  The payload is ASCII string, representative same HEX: 0x4B5710021401383639393735303334343431303832010020151c552312494F54 where:
338 338  
339 339  * Head: 0x4B57(fixed)
342 +
340 340  * Version: 0x10=”V1.0”
344 +
341 341  * Data type: 0x02=2(1:register,2:data sending)
346 +
342 342  * Data length: 0x14=20(Valid data is 20 bytes)
343 343  
344 344  * Device type: 0x01 = 1(Representative NDS01)
350 +
345 345  * Device ID:0x383639393735303334343431303832=869975034441082(ASCII)
352 +
346 346  * Event type:0x01
347 347  
348 348   01:TDC
... ... @@ -366,6 +366,7 @@
366 366   01:Door sensor is open
367 367  
368 368  * Bat: 0x20 = 32/10=3.2V
376 +
369 369  * Signal: 0x15=21
370 370  
371 371  **0** -113dBm or less
... ... @@ -379,11 +379,13 @@
379 379  **99** Not known or not detectable
380 380  
381 381  * Temp integer:0x1c=28
390 +
382 382  * Temp decimal:0x55=85
383 383  
384 384   Temp =Temp integer+(Temp decimal)/100=28+85/100=28.85℃
385 385  
386 386  * Hum integer:0x23=35
396 +
387 387  * Hum decimal:0x12=18
388 388  
389 389   Hum =Hum integer+(Hum decimal)/100=35+18/100=35.18**%rh**
... ... @@ -391,7 +391,6 @@
391 391  * Tail:0x494F54(fixed)
392 392  
393 393  
394 -
395 395  == 2.4 Node-Red Example ==
396 396  
397 397  Please refer to this link for the use of Node-RED:
1668231759500-524.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +121.7 KB
Content
1668231789502-211.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +167.5 KB
Content
1668231824288-204.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +111.6 KB
Content

Applications

Navigation

Copyright ©2010-2022 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0