Changes for page NMDS200 - NB-IoT Microwave Radar Distance Sensor User Manual
Last modified by Mengting Qiu on 2024/04/02 17:03
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 0 added, 10 removed)
Details
- Page properties
-
- Content
-
... ... @@ -4,7 +4,6 @@ 4 4 5 5 **Table of Contents:** 6 6 7 -{{toc/}} 8 8 9 9 10 10 ... ... @@ -15,31 +15,51 @@ 15 15 16 16 17 17 ((( 18 -The Dragino NMDS200 is a(% style="color:blue" %)** NB-IoT Microwave Radar distance sensor**(%%). It uses (% style="color:blue" %)**24Ghz Microwave**(%%) to detect the distance between sensor and different objects. Compare vs ultrasonic or Lidar measurement method, Microwave Radar is (% style="color:blue" %)**more reliable for condensation / dusty environment**(%%). It can sense correct distance even there is water or thick dust on top of the sensor. 17 +The Dragino NDS03A is an (% style="color:blue" %)**Open/Close NB-IoT Door Sensor**(%%). It detects door (% style="color:blue" %)**open/close status**(%%) and (% style="color:blue" %)**uplinks**(%%) to IoT server via NB-IoT network. NDS03A can connect two door sensors. user can see the door status, open duration, open counts in the IoT Server. 18 +))) 19 19 20 -The NMDS200 can be applied to scenarios such as horizontal distance measurement, parking management system, object proximity and presence detection, intelligent trash can management system, robot obstacle avoidance, automatic control, sewer, etc. 20 +((( 21 +The NDS03A will send periodically data (% style="color:blue" %)**every 4 hours** (%%)as well as for each door open/close action. It also counts the door open times and calculates the last door open duration. Users can also disable the uplink for each open/close event, instead, NDS03A can count each open event and uplink periodically. 22 +))) 21 21 22 -NMDS200 can (% style="color:blue" %)**measure two distances**(%%): the closest object and next object behind the closest one. 24 +((( 25 +NDS03A has a (% style="color:blue" %)**Datalog feature**(%%), it will record the open/close event and the user can retrieve the history from NB-IoT. 26 +))) 23 23 24 -NMDS200 (% style="color:blue" %)**supports Alarm Feature**(%%), user can set the NMDS200 to uplink data in a short interval when the distance is out of configured range. 28 +((( 29 +NDS03A has the(% style="color:blue" %)**open alarm feature**(%%), user can set this feature so the device will send an alarm if the door has been open for a certain time. 30 +))) 25 25 32 +((( 33 +NDS03A is designed for outdoor use. It has a weatherproof enclosure and industrial level battery to work in low to high temperatures. 34 +))) 35 + 36 +((( 26 26 NarrowBand-Internet of Things (NB-IoT) is a (% style="color:blue" %)**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. 38 +))) 27 27 28 -NMDS200 (% style="color:blue" %)**supports different uplink**(%%) methods including (% style="color:blue" %)**TCP, MQTT, UDP, and CoAP**(%%) for different application requirements. 40 +((( 41 +NDS03A supports different uplink methods including (% style="color:blue" %)**TCP, MQTT, UDP, and CoAP**(%%) for different application requirements. 42 +))) 29 29 30 -NMDS200 is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**,(%%) It is designed for long-term use of up to 5 years. (Actually Battery life depends on the use environment, update period & uplink method) 44 +((( 45 +NDS03A is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), It is designed for long-term use of up to 5 years. (Actually Battery life depends on the use environment, update period & uplink method) 46 +))) 31 31 32 -To use NMDS200, user needs to check if there is NB-IoT coverage in the field and with the Nb-IoT bands that NMDS200 supports. If local operator support it, user needs to get a** (% style="color:blue" %)NB-IoT SIM card(%%)** from the operator and install into NMDS200 to get NB-IoT network connection. 48 +((( 49 +To use NDS03A, user needs to check if there is NB-IoT coverage in the field and with the Nb-IoT bands that NDS03A supports. If local operator support it, user needs to get a (% style="color:blue" %)**NB-IoT SIM card**(%%) from the operator and install into NDS03A to get NB-IoT network connection. 33 33 ))) 34 34 35 35 53 + 36 36 == 1.2 Features == 37 37 38 38 39 39 * NB-IoT Bands: B1/B3/B8/B5/B20/B28 @H-FDD 40 -* Short uplink interval for Distance Alarm 58 +* Open/Close detect 59 +* Open/Close statistics 41 41 * Monitor Battery Level 42 -* MicrowaveRadarfordistancedetection61 +* connect two door sensors 43 43 * Datalog feature 44 44 * Uplink periodically 45 45 * Downlink to change configure ... ... @@ -50,37 +50,33 @@ 50 50 * Micro SIM card slot for NB-IoT SIM 51 51 * 8500mAh Battery for long-term use 52 52 53 -== 1.3 Radar probe specification == 54 54 73 +== 1.3 Storage & Operation == 55 55 56 -* Measuring Method: FMCW 57 -* Frequency: 24.000 24.500 GHz 58 -* Measurement output power: 6dBm 59 -* Measure range: 0.5 20m 60 -* Accuracy: ±0.1m 61 -* Resolution: 0.01m 62 -* Horizontal Angel: 78° 63 -* Vertical Angel: 23° 64 64 65 - == 1.4 StorageTemperature==76 +Temperature -40°C to +85°C 66 66 67 67 68 - -40°Cto+85°C79 +== 1.4 Mechanical == 69 69 70 70 82 +[[image:image-20221117114937-4.png]] 83 + 84 + 85 +[[image:image-20221117114949-5.png]] 86 + 87 + 88 +[[image:image-20221117115010-6.png]] 89 + 90 + 91 + 71 71 == 1.5 Applications == 72 72 73 73 74 -* Horizontal distance measurement 75 -* Liquid level measurement 76 -* Parking management system 77 -* Object proximity and presence detection 78 -* Intelligent trash can management system 79 -* Robot obstacle avoidance 80 -* Automatic control 81 -* Sewer 82 -* Bottom water level monitoring 95 +[[image:image-20221117114842-3.png]] 83 83 97 + 98 + 84 84 == 1.6 Specification == 85 85 86 86 ... ... @@ -87,7 +87,7 @@ 87 87 (% style="color:blue" %)**Common DC Characteristics:** 88 88 89 89 * Supply Voltage: 2.1v ~~ 3.6v 90 -* Operating Temperature: 0 ~~ 70°C105 +* Operating Temperature: -40 ~~ 85°C 91 91 92 92 (% style="color:blue" %)**NB-IoT Spec:** 93 93 ... ... @@ -98,49 +98,86 @@ 98 98 * B20 @H-FDD: 800MHz 99 99 * B28 @H-FDD: 700MHz 100 100 101 -== 1.7 Installation == 102 102 117 +== 1.7 Pin Definitions and Switch == 103 103 104 -Sensor measure direction and angle is as below. When install the sensor, please make sure the sensor direct to object. 105 105 120 +[[image:image-20221021110429-4.png]] 106 106 107 -[[image:image-20221207170748-1.png]] [[image:image-20221207170748-2.png||height="366" width="672"]] 108 108 123 +=== 1.7.1 Pin Definition === 109 109 110 110 111 - ==1.8PinDefinitions and Switch=126 +The device is pre-configured to connect to a door sensor. The other pins are not used. If user wants to know more about other pins, please refer to the user manual of LSN50v2 at: [[https:~~/~~/www.dropbox.com/sh/djkxs7mr17y94mi/AABVlWbM9uzK9OA3mXyAT10Za?dl=0>>https://www.dropbox.com/sh/djkxs7mr17y94mi/AABVlWbM9uzK9OA3mXyAT10Za?dl=0]] 112 112 113 113 114 - [[image:1670404362039-351.png]]129 +=== 1.7.2 Jumper JP2(Power ON/OFF) === 115 115 116 116 117 - = 2. UseNMDS200 tocommunicate withIoT Server =132 +Power on Device when putting this jumper. 118 118 134 + 135 +=== 1.7.3 BOOT MODE / SW1 === 136 + 137 + 138 +1) ISP: upgrade mode, device won't have any signal in this mode. but ready for upgrade firmware. LED won't work. The firmware won't run. 139 + 140 +2) Flash: working mode, the device starts to work for NB-IoT connection and sends out console output for further debugging. 141 + 142 + 143 +=== 1.7.4 Reset Button === 144 + 145 + 146 +Press to reboot the device. 147 + 148 + 149 +=== 1.7.5 LED === 150 + 151 + 152 +The LED will blink when : 153 + 154 +1. Boot the device in flash mode 155 + 156 +2. Send an uplink packet 157 + 158 + 159 +== 1.8 Magnet Distance == 160 + 161 + 162 +(% style="color:blue" %)**Wood Door:**(%%) 10 ~~ 30mm 163 + 164 +(% style="color:blue" %)**Iron Door:**(%%)** **30 ~~ 45mm 165 + 166 + 167 += 2. Use NDS03A to communicate with IoT Server = 168 + 119 119 == 2.1 How it works == 120 120 121 121 122 -The NB-IoT network will forward this value to IoT server via the protocol defined by N MDS200.172 +In this user case, the NDS03A is installed on the door edge to detect the open/close event and send the status to the NB-IoT server. The NB-IoT network will forward this value to IoT server via the protocol defined by NDS03A. 123 123 124 -The diagram below shows the working flow in the default firmware of N MDS200:174 +The diagram below shows the working flow in the default firmware of NDS03A: 125 125 126 126 [[image:image-20221021110615-5.png]] 127 127 128 128 129 -== 2.2 Configure N MDS200==179 +== 2.2 Configure NDS03A == 130 130 181 +=== 2.2.1 Test Requirement === 131 131 132 -To use NMDS200 in your city, make sure to meet below requirements: 133 133 184 +To use NDS03A in your city, make sure to meet below requirements: 185 + 134 134 * Your local operator has already distributed an NB-IoT Network. 135 -* The local NB-IoT network used the band that N MDS200supports.187 +* The local NB-IoT network used the band that NDS03A supports. 136 136 * Your operator is able to distribute the data received in their NB-IoT network to your IoT server. 137 137 138 -Below figure shows our testing structure. Here we have NB-IoT network coverage by China Mobile, the band they use is B8. The N MDS200will use** (% style="color:red" %)CoAP(120.24.4.116:5683)(%%)** or raw (% style="color:red" %)**UDP(120.24.4.116:5601) **(%%)or (% style="color:red" %)**MQTT(120.24.4.116:1883) **(%%)or (% style="color:red" %)**TCP(120.24.4.116:5600)protocol**(%%) to send data to the test server.190 +Below figure shows our testing structure. Here we have NB-IoT network coverage by China Mobile, the band they use is B8. The NDS03A will use** (% style="color:red" %)CoAP(120.24.4.116:5683)(%%)** or raw (% style="color:red" %)**UDP(120.24.4.116:5601) **(%%)or (% style="color:red" %)**MQTT(120.24.4.116:1883) **(%%)or (% style="color:red" %)**TCP(120.24.4.116:5600)protocol**(%%) to send data to the test server. 139 139 140 -[[image:image-20221 208090742-1.png]]192 +[[image:image-20221117142300-1.png]] 141 141 142 142 143 -=== 2.2. 1Insert NB-IoT SIM card ===195 +=== 2.2.2 Insert NB-IoT SIM card === 144 144 145 145 146 146 Insert the NB-IoT Card get from your provider. ... ... @@ -150,10 +150,10 @@ 150 150 [[image:image-20221021110745-6.png]] 151 151 152 152 153 -=== 2.2. 2Connect USB – TTL to NMDS200and configure it ===205 +=== 2.2.3 Connect USB – TTL to NDS03A and configure it === 154 154 155 155 156 -User need to configure N MDS200via serial port to set the (% style="color:red" %)**Server Address** / **Uplink Topic**(%%) to define where and how-to uplink packets. NMDS200support AT Commands, user can use a USB to TTL adapter to connect to NMDS200and use AT Commands to configure it, as below.208 +User need to configure NDS03A via serial port to set the (% style="color:red" %)**Server Address** / **Uplink Topic**(%%) to define where and how-to uplink packets. NDS03A support AT Commands, user can use a USB to TTL adapter to connect to NDS03A and use AT Commands to configure it, as below. 157 157 158 158 (% style="color:blue" %)**Connection:** 159 159 ... ... @@ -176,11 +176,11 @@ 176 176 177 177 * Flow Control: (% style="color:red" %)**None** 178 178 179 -Make sure the switch is in FLASH position, then power on N MDS200by connecting the (% style="color:orange" %)**Yellow Jumper**(%%).231 +Make sure the switch is in FLASH position, then power on NDS03A by connecting the (% style="color:orange" %)**Yellow Jumper**(%%). 180 180 181 181 [[image:image-20221021110817-7.png]] 182 182 183 -N MDS200will output system info once powered on as below, we can enter the **password: 12345678** to access AT Command input.235 +NDS03A will output system info once powered on as below, we can enter the **password: 12345678** to access AT Command input. 184 184 185 185 186 186 (% style="color:red" %)**Note: the valid AT Commands can be found at: **(%%)[[**https:~~/~~/www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0**>>url:https://www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0]] ... ... @@ -187,13 +187,13 @@ 187 187 188 188 189 189 190 -=== 2.2. 3Use CoAP protocol to uplink data ===242 +=== 2.2.4 Use CoAP protocol to uplink data === 191 191 192 192 193 193 (% style="color:red" %)**Note: if you don't have a CoAP server, you can refer this link to set up a CoAP server: **(%%)[[**http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Set%20up%20CoAP%20Server/**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Set%20up%20CoAP%20Server/]] 194 194 195 195 196 -(% style="color:blue" %)**Use below commands in N MDS200:**248 +(% style="color:blue" %)**Use below commands in NDS03A:** 197 197 198 198 * (% style="color:#037691" %)**AT+PRO=1** (%%) ~/~/ Set to use CoAP protocol to uplink 199 199 ... ... @@ -206,12 +206,12 @@ 206 206 [[image:image-20221021110948-8.png]] 207 207 208 208 209 -After configuring the server address and (% style="color:green" %)**reset N MDS200**(%%)MDS200will start to uplink sensor values to the CoAP server.261 +After configuring the server address and (% style="color:green" %)**reset NDS03A**(%%) (via AT+ATZ ), NDS03A will start to uplink sensor values to the CoAP server. 210 210 211 -[[image:1 670405841875-916.png]] 263 +[[image:image-20221118103547-9.png||height="605" width="837"]] 212 212 213 213 214 -=== 2.2. 4Use UDP protocol to uplink data(Default protocol) ===266 +=== 2.2.5 Use UDP protocol to uplink data(Default protocol) === 215 215 216 216 217 217 (% style="color:blue" %)**AT Commands:** ... ... @@ -229,7 +229,7 @@ 229 229 230 230 231 231 232 -=== 2.2. 5Use MQTT protocol to uplink data ===284 +=== 2.2.6 Use MQTT protocol to uplink data === 233 233 234 234 235 235 (% style="color:blue" %)**AT Commands:** ... ... @@ -251,7 +251,7 @@ 251 251 [[image:image-20221118103445-7.png]] 252 252 253 253 254 -[[image: 1670405928926-116.png]]306 +[[image:image-20221118103453-8.png||height="608" width="841"]] 255 255 256 256 257 257 ... ... @@ -258,7 +258,7 @@ 258 258 MQTT protocol has a much higher power consumption compare with UDP / CoAP protocol. Please check the power analyze document and adjust the uplink period to a suitable interval. 259 259 260 260 261 -=== 2.2. 6Use TCP protocol to uplink data ===313 +=== 2.2.7 Use TCP protocol to uplink data === 262 262 263 263 264 264 (% style="color:blue" %)**AT Commands:** ... ... @@ -267,19 +267,18 @@ 267 267 268 268 * (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5600 ** (%%) ~/~/ Set TCP server address and port 269 269 270 - [[image:1 670406036256-101.png||height="676" width="713"]]322 + [[image:image-20221021111125-14.png]] 271 271 272 - 273 273 [[image:image-20221021111131-15.png]] 274 274 275 275 276 276 277 -=== 2.2. 7Change Update Interval ===328 +=== 2.2.8 Change Update Interval === 278 278 279 279 280 280 User can use below command to change the (% style="color:blue" %)**uplink interval**. 281 281 282 -* (% style="color:#037691" %)**AT+TDC= 7200 ** (%%) ~/~/ Set Update Interval to7200s (4 hours)333 +* (% style="color:#037691" %)**AT+TDC=14400 ** (%%) ~/~/ Set Update Interval to 14400s (4 hours) 283 283 284 284 (% style="color:red" %)**NOTE:** 285 285 ... ... @@ -289,51 +289,71 @@ 289 289 == 2.3 Uplink Payload == 290 290 291 291 292 -The uplink payload includes 2 3bytes in total by default.343 +The uplink payload includes 26 bytes in total by default. 293 293 294 294 Each time the device uploads a data package. The user can use the AT+NOUD command to upload the recorded data.Up to 32 sets of recorded data can be uploaded. 295 295 347 +(% style="color:blue" %)**When AT+TTRCHANNEL=1:** 296 296 297 297 (% border="1" cellspacing="5" style="background-color:#ffffcc; color:green; width:510px" %) 298 -|=(% scope="row" style="width: 50px;" %)**Size(bytes)**|(% style="width:50px" %)**8**|(% style="width:20px" %)**2**|(% style="width:20px" %)**2**|(% style="width:65px" %)**1**|(% style="width:25px" %)**1**|(% style="width:50px" %)**1**|(% style="width:90px" %)** 2**|(% style="width:100px" %)**2**299 -|=(% style="width: 93px;" %)**Value**|(% style="width:67px" %)[[Device ID>>||anchor="H2.4.1A0A0DeviceID"]]|(% style="width:40px" %)[[Ver>>||anchor="H2.4.2A0VersionInfo"]]|(% style="width:45px" %)[[BAT>>||anchor="H2.4.3A0BatteryInfo"]]|(% style="width:75px" %)[[Signal Strength>>||anchor="H2.4.4A0SignalStrength"]]|(% style="width:54px" %)MOD|(% style="width:62px" %) Exitflag|(% style="width:94px" %)Distance1>>||anchor="H2.4.5A0Distance"]]3px" %)[[Distance2>>||anchor="H2.4.5A0Distance"]]350 +|=(% scope="row" style="width: 50px;" %)**Size(bytes)**|(% style="width:50px" %)**8**|(% style="width:20px" %)**2**|(% style="width:20px" %)**2**|(% style="width:65px" %)**1**|(% style="width:25px" %)**1**|(% style="width:50px" %)**1**|(% style="width:60px" %)**1**|(% style="width:90px" %)**3**|(% style="width:100px" %)**3** 351 +|=(% style="width: 93px;" %)**Value**|(% style="width:67px" %)[[Device ID>>||anchor="H2.4.1A0A0DeviceID"]]|(% style="width:40px" %)[[Ver>>||anchor="H2.4.2A0VersionInfo"]]|(% style="width:45px" %)[[BAT>>||anchor="H2.4.3A0BatteryInfo"]]|(% style="width:75px" %)[[Signal Strength>>||anchor="H2.4.4A0SignalStrength"]]|(% style="width:54px" %)MOD|(% style="width:62px" %)Door Status|(% style="width:60px" %)[[Alarm Status>>||anchor="H2.7A0AlarmBaseonTimeout"]]|(% style="width:94px" %)door open num(pb14) |(% style="width:93px" %)last open time(pb14) 300 300 301 301 (% border="1.5" style="background-color:#ffffcc; color:green; width:450px" %) 302 -|(% style="width:50px" %)**4**|(% style="width:90px" %)** 2**|(% style="width:90px" %)**2**|(% style="width:60px" %)**4**|(% style="width:50px" %)(((354 +|(% style="width:50px" %)**4**|(% style="width:90px" %)**1**|(% style="width:90px" %)**3**|(% style="width:90px" %)**3**|(% style="width:60px" %)4|(% style="width:50px" %)((( 303 303 **1-32 group** 304 304 ))) 305 -|(% style="width:98px" %)[[Time stamp>>||anchor="H2.4. 6A0Timestamp"]]|DistanceDistance2|(% style="width:67px" %)Time stamp|(% style="width:74px" %)...357 +|(% style="width:98px" %)[[Time stamp>>||anchor="H2.4.7A0Timestamp"]]|(% style="width:115px" %)Door Status(pb14)|(% style="width:92px" %)door open num(pb14)|(% style="width:99px" %)last open time(pb14)|(% style="width:67px" %)Time stamp|(% style="width:74px" %)... 306 306 307 - Ifwe usetheMQTTclient tosubscribeto this MQTT topic, wecansee the following information when theNMDS200 uplink data.359 +(% style="color:blue" %)**When AT+TTRCHANNEL=2:** 308 308 309 -[[image:1670406261143-723.png]] 310 310 362 +(% border="1" cellspacing="5" style="background-color:#ffffcc; color:green; width:510px" %) 363 +|=(% scope="row" style="width: 50px;" %)**Size(bytes)**|(% style="width:45px" %)**8**|(% style="width:20px" %)**2**|(% style="width:20px" %)**2**|(% style="width:65px" %)**1**|(% style="width:25px" %)**1**|(% style="width:60px" %)**1**|(% style="width:60px" %)**1**|(% style="width:87px" %)**3**|(% style="width:80px" %)**3** 364 +|=(% style="width: 96px;" %)**Value**|(% style="width:66px" %)[[Device ID>>||anchor="H2.4.1A0A0DeviceID"]]|(% style="width:40px" %)[[Ver>>||anchor="H2.4.2A0VersionInfo"]]|(% style="width:46px" %)[[BAT>>||anchor="H2.4.3A0BatteryInfo"]]|(% style="width:70px" %)[[Signal Strength>>||anchor="H2.4.4A0SignalStrength"]]|(% style="width:54px" %)MOD|(% style="width:55px" %)Door Status(pb14)|(% style="width:57px" %)[[Alarm Status>>||anchor="H2.7A0AlarmBaseonTimeout"]](pb14)|(% style="width:86px" %)door open num(pb14) |(% style="width:82px" %)last open time(pb14) 311 311 312 -The payload is ASCII string, representative same HEX: f867787050471071 0064 0cc3 09 01 00 00ef 013d 6390453d 366 +(% border="1" cellspacing="5" style="background-color:#ffffcc; color:green; width:510px" %) 367 +|(% style="width:80px" %)**1**|(% style="width:80px" %)**1**|(% style="width:88px" %)**3**|(% style="width:81px" %)**3**|(% style="width:50px" %)**4**|(% style="width:75px" %)**1**|(% style="width:75px" %)**3** 368 +|(% style="width:59px" %)Door Status(pb15)|(% style="width:67px" %)[[Alarm Status>>||anchor="H2.7A0AlarmBaseonTimeout"]](pb15)|(% style="width:88px" %)door open num(pb15)|(% style="width:81px" %)last open time(pb15)|(% style="width:50px" %)[[Time stamp>>||anchor="H2.4.7A0Timestamp"]]|(% style="width:66px" %)Door Status(pb14)|(% style="width:92px" %)door open num(pb14) 313 313 314 -**0x (% style="color:red" %)__f867787050471071__ (% style="color:blue" %)__0064__ (% style="color:green" %) __0cc3__(% style="color:#00b0f0" %) 0__9__(% style="color:#7030a0" %) __01__(% style="color:#0020b0" %) __00__ (% style="color:#420042" %)__00ef__(% style="color:#660066" %) (% style="color:#663300" %)__013d__ (% style="color:#d60093" %)__6390453d__(%%)** 370 +(% border="1" cellspacing="5" style="background-color:#ffffcc; color:green; width:510px" %) 371 +|(% style="width:100px" %)**3**|(% style="width:80px" %)**1**|(% style="width:90px" %)**3**|(% style="width:90px" %)**3**|(% style="width:70px" %)**4**|(% style="width:80px" %)((( 372 +**1-32 group** 373 +))) 374 +|(% style="width:102px" %)last open time(pb14)|(% style="width:93px" %)Door Status(pb15)|(% style="width:91px" %)door open num(pb15)|(% style="width:100px" %)last open time(pb15)|(% style="width:63px" %)[[Time stamp>>||anchor="H2.4.7A0Timestamp"]]|(% style="width:87px" %)...... 315 315 376 +If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NDS03A uplink data. 377 + 378 +[[image:image-20221117145932-2.png]] 379 + 380 + 381 +The payload is ASCII string, representative same HEX: 382 + 383 +**0x (% style="color:red" %)__f867787050213317__ (% style="color:blue" %)__0064__ (% style="color:green" %) __0ccf__(% style="color:#00b0f0" %) __19__(% style="color:#7030a0" %) __01__(% style="color:#0020b0" %) __00__ (% style="color:#420042" %)__00__(% style="color:#660066" %) (% style="color:#aaaa40" %)__000016__(% style="color:#663300" %) __000017__ (% style="color:#d60093" %)__637590df__(%%)** 384 + 316 316 **where:** 317 317 318 -* (% style="color:#037691" %)**Device ID:**(%%) 0x 471071 =471071387 +* (% style="color:#037691" %)**Device ID:**(%%) 0x f867787050213317 = f867787050213317 319 319 320 320 * (% style="color:#037691" %)**Version:**(%%) 0x0064=100=1.0.0 321 321 322 -* (% style="color:#037691" %)**BAT :**(%%) 0x0cc 3= 3267 mV = 3.267V391 +* (% style="color:#037691" %)**BAT :**(%%) 0x0ccf = 3279 mV = 3.279V 323 323 324 -* (% style="color:#037691" %)**Singal: **(%%)0x 09 =9393 +* (% style="color:#037691" %)**Singal: **(%%)0x19 = 25 325 325 326 326 * (% style="color:#037691" %)**Mod:**(%%) 0x01 = 1 327 327 328 -* (% style="color:#037691" %)** Exitflag:397 +* (% style="color:#037691" %)**Door Status:**(%%) 0x00=0 329 329 330 -* (% style="color:#037691" %)** Distance1: **(%%)0x00ef=239399 +* (% style="color:#037691" %)**Alarm Status: **(%%)0x00 =0 331 331 332 -* (% style="color:#037691" %)** Distance2: **(%%)0x013d=317401 +* (% style="color:#037691" %)**door open num: **(%%)0x000016 =22 333 333 334 -* (% style="color:#037691" %)** Timestamp: **(%%)0x6390453d =1670399293(Unix Time)403 +* (% style="color:#037691" %)**last open time: **(%%)0x000017 =23 335 335 405 +* (% style="color:#037691" %)**Timestamp:**(%%) 0x637590df =1668649183 (Unix Time) 336 336 407 + 337 337 == 2.4 Payload Explanation and Sensor Interface == 338 338 339 339 === 2.4.1 Device ID === ... ... @@ -355,13 +355,13 @@ 355 355 356 356 Specify the software version: 0x64=100, which means firmware version 1.00. 357 357 358 -For example 0x00 64 : This device is N MDS2001 with firmware version 1.0.0.429 +For example 0x00 64 : This device is NDS03A 1 with firmware version 1.0.0. 359 359 360 360 361 361 === 2.4.3 Battery Info === 362 362 363 363 364 -Check the battery voltage for N MDS200.435 +Check the battery voltage for NDS03A. 365 365 366 366 Ex1: 0x0B45 = 2885mV 367 367 ... ... @@ -373,49 +373,51 @@ 373 373 374 374 NB-IoT Network signal Strength. 375 375 376 - (% style="color:blue" %)**Ex1: 0x1d = 29**447 +**Ex1: 0x1d = 29** 377 377 378 - (% style="color:#037691" %)**0**(%%)449 +**0** -113dBm or less 379 379 380 - (% style="color:#037691" %)**1**(%%)451 +**1** -111dBm 381 381 382 - (% style="color:#037691" %)**2...30**(%%)-109dBm... -53dBm453 +**2...30** -109dBm... -53dBm 383 383 384 - (% style="color:#037691" %)**31**(%%)455 +**31** -51dBm or greater 385 385 386 - (% style="color:#037691" %)**99**(%%)457 +**99** Not known or not detectable 387 387 388 388 389 -=== 2.4.5 Dis tance ===460 +=== 2.4.5 Disalarm: (default: 0) === 390 390 391 391 392 - [[image:1670407401682-959.png]]463 +(% style="color:blue" %)**If Disalarm = 1**(%%), NDS03A will only send uplink at every TDC periodically. This is normally use for pulse meter application, in this application, there are many open/close event, and platform only care about the total number of pulse. 393 393 465 +(% style="color:blue" %)**If Disalarm = 0**(%%), NDS03A will send uplink at every TDC periodically and send data on each open/close event. This is useful for the application user need to monitor the open/close event in real-time. 394 394 395 -(% style="color: blue" %)**Object1Distance:**467 + (% style="color:red" %)**Note:**(%%) When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast. 396 396 397 -Distance between sensor probe to the first object. (unit: cm) 398 398 399 - Forexample,ifthe data youget from the registeris0x02 0x05, thedistancebetween the sensor and themeasuredobject is470 +=== 2.4.6 Keep Status & Keep Time === 400 400 401 -(% style="color:blue" %)**0205(H) = 517 (D) = 517 cm.** 402 402 473 +Shows the configure value of Alarm Base on Timeout Feature 403 403 404 -(% style="color:blue" %)**Object2 Distance:** 405 405 406 - Distancebetweensensor probeto the second object. (unit: cm)476 +=== 2.4.7 Timestamp === 407 407 408 408 409 - === 2.4.6Timestamp ===479 +Timestamp : 0x6315537b =1662342011 410 410 411 411 412 - Timestamp:0x6315537b=1662342011482 +=== 2.4.8 Switch Dual Channel Mode === 413 413 414 414 485 +NDS03A can connect two door sensors. Another door sensor can be connected to PB15 pin. Both channels support alarm function. 486 + 487 + 415 415 == 2.5 Downlink Payload == 416 416 417 417 418 -By default, N MDS200prints the downlink payload to console port.491 +By default, NDS03A prints the downlink payload to console port. 419 419 420 420 [[image:image-20221021111414-18.png]] 421 421 ... ... @@ -432,7 +432,7 @@ 432 432 433 433 * (% style="color:#037691" %)**Reset** 434 434 435 -If payload = 0x04FF, it will reset the N MDS200508 +If payload = 0x04FF, it will reset the NDS03A 436 436 437 437 * (% style="color:#037691" %)**INTMOD** 438 438 ... ... @@ -442,34 +442,113 @@ 442 442 == 2.6 LED Indicator == 443 443 444 444 445 -The N MDS200has an internal LED which is to show the status of different states.518 +The NDS03A has an internal LED which is to show the status of different states. 446 446 447 447 * When the device starts normally, the LED will light up for 1 second. 448 -* After N MDS200join NB-IoT network. The LED will be ON for 3 seconds.521 +* After NDS03A join NB-IoT network. The LED will be ON for 3 seconds. 449 449 * For each uplink probe, LED will be on for 500ms. 450 450 451 451 525 +== 2.7 Alarm Base on Timeout == 452 452 453 -== 2.7 Distance alarm function == 454 454 528 +NDS03A can monitor the timeout for a status change, this feature can be used to monitor some events such as door opening too long etc. Related Parameters are: 455 455 456 -(% style="color:blue" %)**AT Command: AT+ALARM1=min,max** 457 457 458 -(% style="color: #037691" %)**Example1:**531 +(% style="color:blue" %)**1. Keep Status: Status to be monitor** 459 459 460 - AT+ALARM1=60,200~/~/ Alarm when moisturelowerthan60.533 +Keep Status = 1: Monitor Close to Open event 461 461 462 - AT+ALARM2=min,max535 +Keep Status = 0: Monitor Open to Close event 463 463 464 464 465 -(% style="color: #037691" %)**Example2:**538 +(% style="color:blue" %)**2. Keep Time: Timeout to send an Alarm** 466 466 467 - AT+ ALARM2=200,1500/~/Alarmwhen temperature lower than1500540 +Range 0 ~~ 65535(0xFFFF) seconds. 468 468 542 +If keep time = 0, Disable Alarm Base on Timeout feature. 469 469 470 - ==2.8Set thenumberof dataobeuploaded andtherecording time==544 +If keep time > 0, device will monitor the keep status event and send an alarm when status doesn't change after timeout. 471 471 472 472 547 +(% style="color:blue" %)**AT Command to configure:** 548 + 549 +(% style="color:blue" %)**PB14 PIN:** 550 + 551 +(% style="color:#037691" %)**AT+TTRIG=1,30** (%%) **~-~->** When the **Keep Status** change from connected to disconnect, and device remains in disconnect status for more than 30 seconds. NDS03A will send an uplink packet, the [[Alarm bit>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/#H2.3.3Real-TimeOpen2FCloseStatus2CUplinkFPORT3D2]] (the second bit of 1^^st^^ byte of payload) on this uplink packet is set to 1. 552 + 553 +(% style="color:#037691" %)**AT+TTRIG=0,0 ** (%%) **~-~->** Default Value, disable timeout Alarm. 554 + 555 + 556 +(% style="color:blue" %)**PB15 PIN:** 557 + 558 +(% style="color:#037691" %)**AT+TTRIG2=1,30** 559 + 560 +(% style="color:#037691" %)**AT+TTRIG2=0,0 ** 561 + 562 + 563 +== 2.8 Set debug mode == 564 + 565 + 566 +Feature: Enable or Disable debug mode 567 + 568 +(% style="color:blue" %)**AT Command: AT+DEBUG** 569 + 570 +[[image:image-20221021111629-21.png]] 571 + 572 + 573 + 574 +== 2.9 Clear Flash Record == 575 + 576 + 577 +Feature: Clear flash storage for data log feature. 578 + 579 +(% style="color:blue" %)**AT Command: AT+CLRDTA** 580 + 581 +[[image:image-20221021111527-19.png]] 582 + 583 + 584 +== 2.10 Count Mod == 585 + 586 + 587 +(% style="color:blue" %)**AT Command: AT+COUNTMOD** 588 + 589 +[[image:image-20221118092935-1.png]] 590 + 591 + 592 +== 2.11 Interrupt Pin Channel Mod == 593 + 594 + 595 +(% style="color:blue" %)**AT Command: AT+TTRCHANNEL** 596 + 597 +[[image:image-20221118093144-2.png]] 598 + 599 + 600 +== 2.12 TTRIG1/2 timeout status alarm == 601 + 602 + 603 +It needs to be used with AT+TTRIG1 or AT+TTRIG2. When TTRIG1 or TTRIG2 times out and causes an alarm, and the status does not change subsequently, an alarm packet will be sent at the alarm interval. 604 + 605 +(% style="color:blue" %)**AT Command: AT+TTRALARM** 606 + 607 +[[image:image-20221118093512-3.png]] 608 + 609 + 610 +== 2.13 Select counting mode == 611 + 612 + 613 +(% style="color:blue" %)**AT Command: AT+TTRMODx=a,b** 614 + 615 +When (% style="color:red" %)**a=0**(%%), the door is opened to count, and when (% style="color:red" %)**a=1**(%%),the closed door is counted. 616 + 617 +When (% style="color:red" %)**b=0**(%%), it is the last door open duration, and when (% style="color:red" %)**b=1**(%%),the last door close duration. 618 + 619 +[[image:image-20221118093658-4.png]] 620 + 621 + 622 +== 2.14 Set the number of data to be uploaded and the recording time == 623 + 624 + 473 473 (% style="color:blue" %)**AT Command:** 474 474 475 475 (% style="color:#037691" %)**AT+TR=900**(%%) ~/~/ The unit is seconds, and the default is to record data once every 900 seconds.( The minimum can be set to 180 seconds) ... ... @@ -477,7 +477,7 @@ 477 477 (% style="color:#037691" %)**AT+NOUD=8**(%%)** ** ~/~/ The device uploads 0 sets of recorded data by default. Up to 32 sets of record data can be uploaded. 478 478 479 479 480 -== 2. 9Read or Clear cached data ==632 +== 2.15 Read or Clear cached data == 481 481 482 482 483 483 (% style="color:blue" %)**AT Command:** ... ... @@ -486,10 +486,10 @@ 486 486 487 487 (% style="color:#037691" %)**AT+CDP=0** (%%) ~/~/ Clear cached data 488 488 489 -[[image:1 670408172929-569.png]]641 +[[image:image-20221118094227-5.png]] 490 490 491 491 492 -== 2.1 0Firmware Change Log ==644 +== 2.16 Firmware Change Log == 493 493 494 494 495 495 Download URL & Firmware Change log: [[https:~~/~~/www.dropbox.com/sh/hacq385w6qgnonr/AAC3D79GFGF1JdZUIzNegn2Ha?dl=0>>https://www.dropbox.com/sh/hacq385w6qgnonr/AAC3D79GFGF1JdZUIzNegn2Ha?dl=0]] ... ... @@ -497,12 +497,12 @@ 497 497 Upgrade Instruction: [[Upgrade Firmware>>||anchor="H5.1200BHowtoUpgradeFirmware"]] 498 498 499 499 500 -== 2.1 1Battery Analysis ==652 +== 2.17 Battery Analysis == 501 501 502 -=== 2.1 1.1 Battery Type ===654 +=== 2.17.1 Battery Type === 503 503 504 504 505 -The N MDS200battery is a combination of an 8500mAh Li/SOCI2 Battery and a Super Capacitor. The battery is non-rechargeable battery type with a low discharge rate (<2% per year). This type of battery is commonly used in IoT devices such as water meter.657 +The NDS03A battery is a combination of an 8500mAh Li/SOCI2 Battery and a Super Capacitor. The battery is non-rechargeable battery type with a low discharge rate (<2% per year). This type of battery is commonly used in IoT devices such as water meter. 506 506 507 507 The battery is designed to last for several years depends on the actual use environment and update interval. 508 508 ... ... @@ -517,7 +517,7 @@ 517 517 [[image:image-20221021111911-26.png]] 518 518 519 519 520 -=== 2.1 1.2 Power consumption Analyze ===672 +=== 2.17.2 Power consumption Analyze === 521 521 522 522 523 523 Dragino battery powered product are all runs in Low Power mode. We have an update battery calculator which base on the measurement of the real device. User can use this calculator to check the battery life and calculate the battery life if want to use different transmit interval. ... ... @@ -539,16 +539,16 @@ 539 539 [[image:1666596205057-567.png]] 540 540 541 541 542 -=== 2.1 1.3 Battery Note ===694 +=== 2.17.3 Battery Note === 543 543 544 544 545 545 The Li-SICO battery is designed for small current / long period application. It is not good to use a high current, short period transmit method. The recommended minimum period for use of this battery is 5 minutes. If you use a shorter period time to transmit LoRa, then the battery life may be decreased. 546 546 547 547 548 -=== 2.1 1.4 Replace the battery ===700 +=== 2.17.4 Replace the battery === 549 549 550 550 551 -The default battery pack of N MDS200includes a ER26500 plus super capacitor. If user can't find this pack locally, they can find ER26500 or equivalence without the SPC1520 capacitor, which will also work in most case. The SPC can enlarge the battery life for high frequency use (update period below 5 minutes).703 +The default battery pack of NDS03A includes a ER26500 plus super capacitor. If user can't find this pack locally, they can find ER26500 or equivalence without the SPC1520 capacitor, which will also work in most case. The SPC can enlarge the battery life for high frequency use (update period below 5 minutes). 552 552 553 553 554 554 = 3. Access NB-IoT Module = ... ... @@ -602,51 +602,57 @@ 602 602 603 603 AT+SERVADDR : Server Address 604 604 605 -AT+TR : Get or Set record time 757 +AT+TR : Get or Set record time 606 606 607 -AT+NOUD : 759 +AT+NOUD : Get or Set the number of data to be uploaded 608 608 609 609 AT+CDP : Read or Clear cached data 610 610 611 -AT+DEBUG :Enable or Disable debug mode763 +AT+ DEBUG : Enable or Disable debug mode 612 612 613 -AT+ ALARM1:Get or Setalarm ofdistance1765 +AT+ TTRIG1 : Get or Set PB14 PIN Alarm Base on Timeout 614 614 615 -AT+ ALARM2:Get or Setalarm ofdistance2767 +AT+ TTRIG2 : Get or Set PB15 PIN Alarm Base on Timeout 616 616 617 -AT+ GETSENSORVALUE:Returnsthe currentsensormeasurement769 +AT+COUNTMOD : Get or Set the count mode 618 618 619 -AT+ POWERIC :set thePowerICflag771 +AT+TTRCHANNEL : Get or Set the number of interrupt channels 620 620 773 +AT+TTRALARM : Get or Set TTRIG1 of Alarm interval (unit: minute) 621 621 775 +AT+DISALARM : Enable/Disable Alarm for door open/close or water leak event 776 + 777 +AT+ CLRC : Clear current door open count 778 + 779 + 622 622 (% style="color:blue" %)**COAP Management** 623 623 624 -AT+URI : 782 +AT+URI : Resource parameters 625 625 626 626 627 627 (% style="color:blue" %)**UDP Management** 628 628 629 -AT+CFM : 787 +AT+CFM : Upload confirmation mode (only valid for UDP) 630 630 631 631 632 632 (% style="color:blue" %)**MQTT Management** 633 633 634 -AT+CLIENT : Get or Set MQTT client 792 +AT+CLIENT : Get or Set MQTT client 635 635 636 -AT+UNAME : Get or Set MQTT Username 794 +AT+UNAME : Get or Set MQTT Username 637 637 638 -AT+PWD : 796 +AT+PWD : Get or Set MQTT password 639 639 640 -AT+PUBTOPIC :Get or Set MQTT publish topic798 +AT+PUBTOPIC : Get or Set MQTT publish topic 641 641 642 -AT+SUBTOPIC :Get or Set MQTT subscription topic800 +AT+SUBTOPIC : Get or Set MQTT subscription topic 643 643 644 644 645 645 (% style="color:blue" %)**Information** 646 646 647 -AT+FDR :Factory Data Reset805 +AT+FDR : Factory Data Reset 648 648 649 -AT+PWORD :Serial Access Password807 +AT+PWORD : Serial Access Password 650 650 651 651 652 652 = 5. FAQ = ... ... @@ -658,7 +658,7 @@ 658 658 659 659 Please see this link for how to upgrade: [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H2.HardwareUpgradeMethodSupportList>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H2.HardwareUpgradeMethodSupportList]] 660 660 661 -(% style="color:red" %)**Notice: **(% style="color:blue" %)**N MDS200** (%%)**and (% style="color:blue" %)LMDS200(%%)**(% style="color:blue" %) (%%)**share the same mother board. They use the same connection and method to update.**819 +(% style="color:red" %)**Notice: **(% style="color:blue" %)**NDS03A** (%%)**and (% style="color:blue" %)LDS03A(%%)**(% style="color:blue" %) (%%)**share the same mother board. They use the same connection and method to update.** 662 662 663 663 664 664 = 6. Trouble Shooting = ... ... @@ -678,7 +678,7 @@ 678 678 = 7. Order Info = 679 679 680 680 681 -Part Number: (% style="color:blue" %)** NMDS200**839 +Part Number**:** NDS03A 682 682 683 683 684 684 = 8. Packing Info = ... ... @@ -686,8 +686,9 @@ 686 686 687 687 (% style="color:blue" %)**Package Includes**: 688 688 689 -* N MDS200NB-IoT MicrowaveRadarDistanceSensor x 1847 +* NDS03A Open/Close Door Sensor x 1 690 690 849 + 691 691 = 9. Support = 692 692 693 693
- 1670404362039-351.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -492.6 KB - Content
- 1670405841875-916.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -76.1 KB - Content
- 1670405928926-116.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -76.7 KB - Content
- 1670406036256-101.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -181.0 KB - Content
- 1670406261143-723.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -77.9 KB - Content
- 1670407401682-959.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -23.7 KB - Content
- 1670408172929-569.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -211.8 KB - Content
- image-20221207173200-3.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -76.7 KB - Content
- image-20221207173300-4.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -77.0 KB - Content
- image-20221208090742-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -79.7 KB - Content