Version 83.7 by Xiaoling on 2022/12/08 11:20

Hide last authors
Xiaoling 1.5 1 (% style="text-align:center" %)
Xiaoling 71.2 2 [[image:LMDS200_10.jpg]]
Xiaoling 1.5 3
Xiaoling 48.2 4
5 **Table of Contents:**
6
Xiaoling 83.5 7 {{toc/}}
Xiaoling 1.5 8
9
10
Xiaoling 48.2 11
12 = 1.  Introduction =
13
Xiaoling 71.2 14 == 1.1 ​ What is NMDS200 NB-IoT Microwave Radar Distance Sensor ==
Xiaoling 48.2 15
16
Xiaoling 52.2 17 (((
Xiaoling 74.2 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.
Xiaoling 1.5 19
Xiaoling 74.2 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.
Xiaoling 1.5 21
Xiaoling 74.2 22 NMDS200 can (% style="color:blue" %)**measure two distances**(%%): the closest object and next object behind the closest one.
Xiaoling 53.2 23
Xiaoling 74.2 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.
Xiaoling 1.5 25
Xiaoling 70.23 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.
Xiaoling 1.5 27
Xiaoling 74.2 28 NMDS200 (% style="color:blue" %)**supports different uplink**(%%) methods including (% style="color:blue" %)**TCP, MQTT, UDP, and CoAP**(%%) for different application requirements.
Xiaoling 70.23 29
Xiaoling 74.2 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)
Xiaoling 53.3 31
Xiaoling 74.2 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.
Xiaoling 53.3 33 )))
34
35
Xiaoling 48.2 36 == ​1.2  Features ==
37
38
David Huang 2.1 39 * NB-IoT Bands: B1/B3/B8/B5/B20/B28 @H-FDD
Xiaoling 74.2 40 * Short uplink interval for Distance Alarm
David Huang 2.1 41 * Monitor Battery Level
Xiaoling 74.2 42 * Microwave Radar for distance detection
David Huang 2.1 43 * Datalog feature
Edwin Chen 34.1 44 * Uplink periodically
David Huang 2.1 45 * Downlink to change configure
46 * Wall Mountable
47 * Outdoor Use
48 * Ultra-Low Power consumption
49 * AT Commands to change parameters
50 * Micro SIM card slot for NB-IoT SIM
Edwin Chen 34.1 51 * 8500mAh Battery for long-term use
Xiaoling 1.5 52
Xiaoling 74.2 53 == 1.3 Radar probe specification ==
Xiaoling 70.2 54
Xiaoling 1.5 55
Xiaoling 74.3 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°
Xiaoling 1.5 64
Xiaoling 74.2 65 == 1.4  Storage Temperature ==
Xiaoling 1.5 66
67
Xiaoling 74.2 68 -40°C to +85°C
Xiaoling 52.2 69
Xiaoling 1.5 70
Xiaoling 48.2 71 == 1.5 ​ Applications ==
72
73
Xiaoling 74.2 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
Xiaoling 1.5 83
Xiaoling 58.2 84 == 1.6  Specification ==
Xiaoling 1.5 85
86
Xiaoling 58.2 87 (% style="color:blue" %)**Common DC Characteristics:**
Xiaoling 48.2 88
Xiaoling 58.2 89 * Supply Voltage: 2.1v ~~ 3.6v
Xiaoling 74.2 90 * Operating Temperature: 0 ~~ 70°C
Xiaoling 58.2 91
92 (% style="color:blue" %)**NB-IoT Spec:**
93
Xiaoling 70.24 94 * B1 @H-FDD: 2100MHz
95 * B3 @H-FDD: 1800MHz
96 * B8 @H-FDD: 900MHz
97 * B5 @H-FDD: 850MHz
98 * B20 @H-FDD: 800MHz
99 * B28 @H-FDD: 700MHz
Xiaoling 58.2 100
Xiaoling 74.2 101 == 1.7  Installation ==
Xiaoling 52.2 102
Xiaoling 1.5 103
Xiaoling 74.2 104 Sensor measure direction and angle is as below. When install the sensor, please make sure the sensor direct to object.
Xiaoling 1.5 105
Xiaoling 48.2 106
Xiaoling 74.2 107 [[image:image-20221207170748-1.png]] [[image:image-20221207170748-2.png||height="366" width="672"]]
Xiaoling 48.2 108
Xiaoling 1.5 109
Edwin Chen 38.1 110
Xiaoling 74.2 111 == 1.8  Pin Definitions and Switch ==
Xiaoling 48.2 112
113
Xiaoling 74.2 114 [[image:1670404362039-351.png]]
David Huang 2.1 115
116
Xiaoling 74.3 117 = 2.  Use NMDS200 to communicate with IoT Server =
Xiaoling 48.2 118
119 == 2.1  How it works ==
120
121
Xiaoling 74.3 122 The NB-IoT network will forward this value to IoT server via the protocol defined by NMDS200.
Xiaoling 48.2 123
Xiaoling 74.3 124 The diagram below shows the working flow in the default firmware of NMDS200:
David Huang 2.1 125
David Huang 31.1 126 [[image:image-20221021110615-5.png]]
David Huang 2.1 127
128
Xiaoling 76.2 129 == 2.2 ​ Configure NMDS200 ==
David Huang 2.1 130
Xiaoling 48.2 131
Xiaoling 76.2 132 To use NMDS200 in your city, make sure to meet below requirements:
Xiaoling 48.2 133
Edwin Chen 40.1 134 * Your local operator has already distributed an NB-IoT Network.
Xiaoling 76.2 135 * The local NB-IoT network used the band that NMDS200 supports.
David Huang 2.1 136 * Your operator is able to distribute the data received in their NB-IoT network to your IoT server.
137
Xiaoling 76.2 138 Below figure shows our testing structure. Here we have NB-IoT network coverage by China Mobile, the band they use is B8.  The NMDS200 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.
David Huang 2.1 139
Xiaoling 83.2 140 [[image:image-20221208090742-1.png]]
Edwin Chen 40.1 141
David Huang 2.1 142
Xiaoling 76.2 143 === 2.2.1 Insert NB-IoT SIM card ===
Xiaoling 48.2 144
145
David Huang 2.1 146 Insert the NB-IoT Card get from your provider.
147
Edwin Chen 40.1 148 User needs to take out the NB-IoT module and insert the SIM card like below:
David Huang 2.1 149
David Huang 31.1 150 [[image:image-20221021110745-6.png]] ​
David Huang 2.1 151
Edwin Chen 40.1 152
Xiaoling 79.2 153 === 2.2.2 Connect USB – TTL to NMDS200 and configure it ===
David Huang 2.1 154
155
Xiaoling 79.2 156 User need to configure NMDS200 via serial port to set the (% style="color:red" %)**Server Address** / **Uplink Topic**(%%) to define where and how-to uplink packets. NMDS200 support AT Commands, user can use a USB to TTL adapter to connect to NMDS200 and use AT Commands to configure it, as below.
David Huang 2.1 157
Xiaoling 48.2 158 (% style="color:blue" %)**Connection:**
David Huang 2.1 159
Xiaoling 48.2 160 (% style="background-color:yellow" %)** USB TTL GND <~-~-~-~-> GND**
David Huang 2.1 161
Xiaoling 48.2 162 (% style="background-color:yellow" %)** USB TTL TXD <~-~-~-~-> UART_RXD**
163
164 (% style="background-color:yellow" %)** USB TTL RXD <~-~-~-~-> UART_TXD**
165
166
David Huang 2.1 167 In the PC, use below serial tool settings:
168
Xiaoling 48.2 169 * Baud:  (% style="color:red" %)**9600**
David Huang 2.1 170
Xiaoling 48.2 171 * Data bits:** (% style="color:red" %)8(%%)**
172
173 * Stop bits: (% style="color:red" %)**1**
174
175 * Parity:  (% style="color:red" %)**None**
176
177 * Flow Control: (% style="color:red" %)**None**
178
Xiaoling 79.2 179 Make sure the switch is in FLASH position, then power on NMDS200 by connecting the (% style="color:orange" %)**Yellow Jumper**(%%).
David Huang 2.1 180
David Huang 31.1 181 ​[[image:image-20221021110817-7.png]]
David Huang 2.1 182
Xiaoling 79.2 183 NMDS200 will output system info once powered on as below, we can enter the **password: 12345678** to access AT Command input.
Edwin Chen 40.1 184
185
Xiaoling 48.2 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]]
David Huang 2.1 187
Edwin Chen 42.1 188
David Huang 2.1 189
Xiaoling 79.2 190 === 2.2.3 Use CoAP protocol to uplink data ===
David Huang 2.1 191
192
Xiaoling 48.2 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/]]
Edwin Chen 42.1 194
David Huang 2.1 195
Xiaoling 83.2 196 (% style="color:blue" %)**Use below commands in NMDS200:**
Xiaoling 48.2 197
Xiaoling 48.3 198 * (% style="color:#037691" %)**AT+PRO=1**                (%%) ~/~/ Set to use CoAP protocol to uplink
Xiaoling 48.2 199
Xiaoling 48.3 200 * (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5683   ** (%%) ~/~/ Set CoAP server address and port
Xiaoling 48.2 201
Xiaoling 48.3 202 * (% style="color:#037691" %)**AT+URI=0,0,11,2,"mqtt" ** (%%) ~/~/  Set CoAP resource path
Xiaoling 48.2 203
David Huang 2.1 204 For parameter description, please refer to AT command set
205
David Huang 31.1 206 [[image:image-20221021110948-8.png]]
David Huang 2.1 207
208
Xiaoling 79.2 209 After configuring the server address and (% style="color:green" %)**reset NMDS200**(%%) (via AT+ATZ ), NMDS200 will start to uplink sensor values to the CoAP server.
Edwin Chen 42.1 210
Xiaoling 79.2 211 [[image:1670405841875-916.png]] ​
David Huang 2.1 212
Edwin Chen 42.1 213
Xiaoling 79.2 214 === 2.2.4 Use UDP protocol to uplink data(Default protocol) ===
David Huang 2.1 215
Edwin Chen 42.1 216
Xiaoling 48.2 217 (% style="color:blue" %)**AT Commands:**
David Huang 2.1 218
Xiaoling 48.3 219 * (% style="color:#037691" %)**AT+PRO=2   ** (%%) ~/~/  Set to use UDP protocol to uplink
Xiaoling 48.2 220
Xiaoling 48.3 221 * (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5601   ** (%%) ~/~/  Set UDP server address and port
Xiaoling 48.2 222
Xiaoling 48.3 223 * (% style="color:#037691" %)**AT+CFM=1       ** (%%) ~/~/  If the server does not respond, this command is unnecessary
Xiaoling 48.2 224
David Huang 32.1 225 ​ [[image:image-20221021111025-10.png]]
David Huang 2.1 226
Xiaoling 48.3 227
David Huang 31.1 228 [[image:image-20221021111033-11.png||height="241" width="576"]]
David Huang 2.1 229
230
231
Xiaoling 79.2 232 === 2.2.5 Use MQTT protocol to uplink data ===
David Huang 2.1 233
Edwin Chen 42.1 234
Xiaoling 48.2 235 (% style="color:blue" %)**AT Commands:**
David Huang 2.1 236
Xiaoling 48.3 237 * (% style="color:#037691" %)**AT+PRO=3   ** (%%) ~/~/  Set to use MQTT protocol to uplink
Xiaoling 48.2 238
Xiaoling 48.3 239 * (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,1883   ** (%%) ~/~/  Set MQTT server address and port
Xiaoling 48.2 240
Xiaoling 48.3 241 * (% style="color:#037691" %)**AT+CLIENT=CLIENT       ** (%%) ~/~/  Set up the CLIENT of MQTT
Xiaoling 48.2 242
Xiaoling 48.3 243 * (% style="color:#037691" %)**AT+UNAME=UNAME                     **(%%)** **~/~/  Set the username of MQTT
Xiaoling 48.2 244
Xiaoling 48.3 245 * (% style="color:#037691" %)**AT+PWD=PWD                         **(%%)** **~/~/  Set the password of MQTT
Xiaoling 48.2 246
Xiaoling 48.3 247 * (% style="color:#037691" %)**AT+PUBTOPIC=NSE01_PUB              **(%%)** **~/~/  Set the sending topic of MQTT
Xiaoling 48.2 248
Xiaoling 48.3 249 * (% style="color:#037691" %)**AT+SUBTOPIC=NSE01_SUB          ** (%%) ~/~/  Set the subscription topic of MQTT
Xiaoling 48.2 250
Xiaoling 70.2 251 ​ [[image:image-20221118103445-7.png]]
David Huang 2.1 252
Xiaoling 48.3 253
Xiaoling 79.2 254 [[image:1670405928926-116.png]]
David Huang 2.1 255
256
257
Edwin Chen 42.1 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.
David Huang 2.1 259
Edwin Chen 42.1 260
Xiaoling 79.2 261 === 2.2.6 Use TCP protocol to uplink data ===
David Huang 2.1 262
263
Xiaoling 48.3 264 (% style="color:blue" %)**AT Commands:**
David Huang 2.1 265
Xiaoling 48.3 266 * (% style="color:#037691" %)**AT+PRO=4   ** (%%) ~/~/  Set to use TCP protocol to uplink
Xiaoling 48.2 267
Xiaoling 48.3 268 * (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5600   ** (%%) ~/~/  Set TCP server address and port
Xiaoling 48.2 269
Xiaoling 79.2 270 ​ [[image:1670406036256-101.png||height="676" width="713"]]
David Huang 2.1 271
Xiaoling 79.2 272
David Huang 31.1 273 [[image:image-20221021111131-15.png]]
David Huang 2.1 274
275
276
Xiaoling 79.2 277 === 2.2.7 Change Update Interval ===
David Huang 2.1 278
279
Xiaoling 48.2 280 User can use below command to change the (% style="color:blue" %)**uplink interval**.
David Huang 2.1 281
Xiaoling 79.2 282 * (% style="color:#037691" %)**AT+TDC=7200      ** (%%) ~/~/ Set Update Interval to 7200s (4 hours)
David Huang 2.1 283
Xiaoling 48.2 284 (% style="color:red" %)**NOTE:**
David Huang 2.1 285
Xiaoling 59.3 286 1.  By default, the device will send an uplink message every 4 hour.
Edwin Chen 42.1 287
Xiaoling 48.3 288
Xiaoling 48.2 289 == 2.3  Uplink Payload ==
David Huang 2.1 290
Xiaoling 48.2 291
Xiaoling 80.2 292 The uplink payload includes 23 bytes in total by default.
David Huang 2.1 293
Xiaoling 61.3 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.
David Huang 2.1 295
296
Xiaoling 70.8 297 (% border="1" cellspacing="5" style="background-color:#ffffcc; color:green; width:510px" %)
Xiaoling 80.2 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**
Xiaoling 83.7 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" %)Exit flag|(% style="width:94px" %) [[Distance 1>>||anchor="H2.4.5A0Distance"]] |(% style="width:93px" %) [[Distance 2>>||anchor="H2.4.5A0Distance"]]
David Huang 2.1 300
Xiaoling 83.7 301 (% border="1" style="background-color:#ffffcc; color:green; width:471px" %)
302 |(% style="width:50px" %)**4**|(% style="width:90px" %)**2**|(% style="width:90px" %)**2**|(% style="width:60px" %)**4**|(% style="width:98px" %)(((
Xiaoling 61.3 303 **1-32 group**
304 )))
Xiaoling 83.7 305 |(% style="width:98px" %)[[Time stamp>>||anchor="H2.4.6A0Timestamp"]]| Distance 1 | Distance  2|(% style="width:67px" %)Time stamp|(% style="width:98px" %)...
Xiaoling 48.3 306
Xiaoling 80.2 307 If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NMDS200 uplink data.
Xiaoling 61.3 308
Xiaoling 80.2 309 [[image:1670406261143-723.png]]
Xiaoling 61.3 310
311
Xiaoling 80.2 312 The payload is ASCII string, representative same HEX: f867787050471071  0064  0cc3  09  01  00 00ef  013d  6390453d
Xiaoling 61.3 313
Xiaoling 80.2 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__(%%)**
Xiaoling 61.3 315
Xiaoling 48.2 316 **where:**
David Huang 2.1 317
Xiaoling 80.2 318 * (% style="color:#037691" %)**Device ID:**(%%) 0x f867787050471071 = f867787050471071
David Huang 2.1 319
Xiaoling 70.2 320 * (% style="color:#037691" %)**Version:**(%%)  0x0064=100=1.0.0
David Huang 33.1 321
Xiaoling 80.2 322 * (% style="color:#037691" %)**BAT :**(%%)  0x0cc3 = 3267 mV = 3.267V
David Huang 33.1 323
Xiaoling 80.2 324 * (% style="color:#037691" %)**Singal: **(%%)0x09 = 9
David Huang 33.1 325
Xiaoling 70.2 326 * (% style="color:#037691" %)**Mod:**(%%)  0x01 = 1
David Huang 33.1 327
Xiaoling 80.2 328 * (% style="color:#037691" %)**Exit flag: **(%%)0x00 =0
David Huang 33.1 329
Xiaoling 80.2 330 * (% style="color:#037691" %)**Distance 1: **(%%)0x00ef=239
David Huang 33.1 331
Xiaoling 80.2 332 * (% style="color:#037691" %)**Distance 2: **(%%)0x013d =317
David Huang 33.1 333
Xiaoling 80.2 334 * (% style="color:#037691" %)**Timestamp: **(%%)0x6390453d =1670399293 (Unix Time)
David Huang 33.1 335
Xiaoling 48.2 336 == 2.4  Payload Explanation and Sensor Interface ==
337
338 === 2.4.1  Device ID ===
339
340
Edwin Chen 42.1 341 By default, the Device ID is equal to the last 15 bits of IMEI.
David Huang 2.1 342
Xiaoling 48.2 343 User can use (% style="color:blue" %)**AT+DEUI** (%%)to set Device ID
David Huang 2.1 344
345 **Example:**
346
347 AT+DEUI=868411056754138
348
Edwin Chen 42.1 349 The Device ID is stored in a non-erase area, Upgrade the firmware or run AT+FDR won't erase the Device ID.
David Huang 2.1 350
Edwin Chen 42.1 351
Xiaoling 48.2 352 === 2.4.2  Version Info ===
353
354
Edwin Chen 42.1 355 Specify the software version: 0x64=100, which means firmware version 1.00.
David Huang 2.1 356
Xiaoling 81.2 357 For example 0x00 64 : This device is NMDS200 1 with firmware version 1.0.0.
David Huang 2.1 358
Edwin Chen 42.1 359
Xiaoling 48.2 360 === 2.4.3  Battery Info ===
361
362
Xiaoling 81.2 363 Check the battery voltage for NMDS200.
David Huang 2.1 364
365 Ex1: 0x0B45 = 2885mV
366
367 Ex2: 0x0B49 = 2889mV
368
Edwin Chen 42.1 369
Xiaoling 48.2 370 === 2.4.4  Signal Strength ===
371
372
David Huang 2.1 373 NB-IoT Network signal Strength.
374
Xiaoling 83.4 375 (% style="color:blue" %)**Ex1: 0x1d = 29**
David Huang 2.1 376
Xiaoling 83.4 377 (% style="color:#037691" %)**0** (%%) -113dBm or less
David Huang 2.1 378
Xiaoling 83.4 379 (% style="color:#037691" %)**1**  (%%) -111dBm
David Huang 2.1 380
Xiaoling 83.4 381 (% style="color:#037691" %)**2...30** (%%) -109dBm... -53dBm
David Huang 2.1 382
Xiaoling 83.4 383 (% style="color:#037691" %)**31** (%%) -51dBm or greater
David Huang 2.1 384
Xiaoling 83.4 385 (% style="color:#037691" %)**99** (%%) Not known or not detectable
David Huang 2.1 386
Edwin Chen 42.1 387
Xiaoling 81.2 388 === 2.4.5  Distance ===
Xiaoling 48.2 389
390
Xiaoling 81.2 391 [[image:1670407401682-959.png]]
David Huang 2.1 392
Xiaoling 83.2 393
Xiaoling 81.3 394 (% style="color:blue" %)**Object1 Distance:**
David Huang 2.1 395
Xiaoling 81.2 396 Distance between sensor probe to the first object. (unit: cm)
David Huang 2.1 397
Xiaoling 81.2 398 For example, if the data you get from the register is 0x02 0x05, the distance between the sensor and the measured object is
David Huang 2.1 399
Xiaoling 81.3 400 (% style="color:blue" %)**0205(H) = 517 (D) = 517 cm.**
Edwin Chen 42.1 401
Xiaoling 48.2 402
Xiaoling 81.3 403 (% style="color:blue" %)**Object2 Distance:**
Xiaoling 48.2 404
Xiaoling 81.2 405 Distance between sensor probe to the second object. (unit: cm)
David Huang 2.1 406
Edwin Chen 42.1 407
Xiaoling 81.2 408 === 2.4.6  Timestamp ===
David Huang 2.1 409
Xiaoling 81.2 410
Xiaoling 61.6 411 Timestamp : 0x6315537b =1662342011
Xiaoling 48.2 412
413
414 == 2.5  Downlink Payload ==
415
416
Xiaoling 81.3 417 By default, NMDS200 prints the downlink payload to console port.
David Huang 2.1 418
David Huang 31.1 419 [[image:image-20221021111414-18.png]] ​
David Huang 2.1 420
Xiaoling 48.2 421
David Huang 2.1 422 **Examples:**
423
Xiaoling 48.2 424 * (% style="color:#037691" %)**Set TDC**
David Huang 2.1 425
426 If the payload=0100003C, it means set the END Node's TDC to 0x00003C=60(S), while type code is 01.
427
428 Payload:    01 00 00 1E    TDC=30S
429
430 Payload:    01 00 00 3C    TDC=60S
431
Xiaoling 48.2 432 * (% style="color:#037691" %)**Reset**
David Huang 2.1 433
Xiaoling 81.3 434 If payload = 0x04FF, it will reset the NMDS200
David Huang 2.1 435
Xiaoling 48.2 436 * (% style="color:#037691" %)**INTMOD**
David Huang 2.1 437
438 Downlink Payload: 06000003, Set AT+INTMOD=3
439
440
Xiaoling 48.2 441 == 2.6  ​LED Indicator ==
442
443
Xiaoling 81.3 444 The NMDS200 has an internal LED which is to show the status of different states.
David Huang 2.1 445
David Huang 45.1 446 * When the device starts normally, the LED will light up for 1 second.
Xiaoling 83.2 447 * After NMDS200 join NB-IoT network. The LED will be ON for 3 seconds.
David Huang 2.1 448 * For each uplink probe, LED will be on for 500ms.
449
450
Xiaoling 81.3 451 == 2.7  Distance alarm function ==
452
453
Xiaoling 81.4 454 (% style="color:blue" %)**AT Command: AT+ALARM1=min,max**
David Huang 2.1 455
Xiaoling 83.4 456 (% style="color:#037691" %)**Example 1:**
David Huang 2.1 457
Xiaoling 81.4 458 AT+ ALARM1 =60,200  ~/~/ Alarm when moisture lower than 60.
David Huang 2.1 459
Xiaoling 81.4 460 AT+ ALARM2 =min,max
David Huang 2.1 461
462
Xiaoling 83.4 463 (% style="color:#037691" %)**Example 2:**
David Huang 2.1 464
Xiaoling 81.4 465 AT+ ALARM2 =200,1500  ~/~/ Alarm when temperature lower than 1500
David Huang 2.1 466
467
Xiaoling 82.2 468 == 2.8  Set the number of data to be uploaded and the recording time ==
Xiaoling 48.2 469
470
471 (% style="color:blue" %)**AT Command:**
472
Xiaoling 66.2 473 (% 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)
474
475 (% 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.
476
477
Xiaoling 82.2 478 == 2.9  Read or Clear cached data ==
Xiaoling 66.2 479
480
481 (% style="color:blue" %)**AT Command:**
482
Xiaoling 48.2 483 (% style="color:#037691" %)**AT+CDP**  (%%) ~/~/ Read cached data
484
485 (% style="color:#037691" %)**AT+CDP=0**  (%%) ~/~/ Clear cached data ​
486
Xiaoling 82.2 487 [[image:1670408172929-569.png]]
David Huang 2.1 488
489
Xiaoling 82.2 490 == 2.10  ​Firmware Change Log ==
David Huang 2.1 491
Xiaoling 48.2 492
Xiaoling 70.2 493 Download URL & Firmware Change log: [[https:~~/~~/www.dropbox.com/sh/hacq385w6qgnonr/AAC3D79GFGF1JdZUIzNegn2Ha?dl=0>>https://www.dropbox.com/sh/hacq385w6qgnonr/AAC3D79GFGF1JdZUIzNegn2Ha?dl=0]]
David Huang 2.1 494
Xiaoling 48.12 495 Upgrade Instruction: [[Upgrade Firmware>>||anchor="H5.1200BHowtoUpgradeFirmware"]]
David Huang 2.1 496
497
Xiaoling 82.2 498 == 2.11  ​Battery Analysis ==
Xiaoling 48.2 499
Xiaoling 82.2 500 === 2.11.1  ​Battery Type ===
Xiaoling 48.2 501
502
Xiaoling 82.2 503 The NMDS200 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.
David Huang 2.1 504
Edwin Chen 42.1 505 The battery is designed to last for several years depends on the actual use environment and update interval. 
David Huang 2.1 506
Edwin Chen 42.1 507 The battery-related documents as below:
David Huang 2.1 508
509 * [[Battery Dimension>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
Xiaoling 48.2 510
David Huang 2.1 511 * [[Lithium-Thionyl Chloride Battery datasheet>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
Xiaoling 48.2 512
David Huang 2.1 513 * [[Lithium-ion Battery-Capacitor datasheet>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
514
David Huang 31.1 515 [[image:image-20221021111911-26.png]] ​
David Huang 2.1 516
517
Xiaoling 82.2 518 === 2.11.2  Power consumption Analyze ===
Xiaoling 48.2 519
520
David Huang 2.1 521 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.
522
523 Instruction to use as below:
524
Xiaoling 48.2 525 (% style="color:blue" %)**Step 1:  **(%%)Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from: [[https:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_End_Node/Battery_Analyze/>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/Battery_Analyze/]]
David Huang 2.1 526
Xiaoling 48.2 527 (% style="color:blue" %)**Step 2: **(%%) Open it and choose
David Huang 2.1 528
529 * Product Model
Xiaoling 48.2 530
David Huang 2.1 531 * Uplink Interval
Xiaoling 48.2 532
David Huang 2.1 533 * Working Mode
534
535 And the Life expectation in difference case will be shown on the right.
536
Xiaoling 48.2 537 [[image:1666596205057-567.png]] ​
David Huang 2.1 538
539
Xiaoling 82.2 540 === 2.11.3  ​Battery Note ===
Xiaoling 48.2 541
542
David Huang 2.1 543 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.
544
545
Xiaoling 82.2 546 === 2.11.4  Replace the battery ===
Xiaoling 48.2 547
548
Xiaoling 82.2 549 The default battery pack of NMDS200 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).
David Huang 2.1 550
Edwin Chen 42.1 551
Xiaoling 48.2 552 = 3. ​ Access NB-IoT Module =
553
554
David Huang 2.1 555 Users can directly access the AT command set of the NB-IoT module.
556
557 The AT Command set can refer the BC35-G NB-IoT Module AT Command: [[https:~~/~~/www.dragino.com/downloads/index.php?dir=datasheet/other_vendors/BC35-G/>>url:https://www.dragino.com/downloads/index.php?dir=datasheet/other_vendors/BC35-G/]] 
558
Xiaoling 70.22 559
Xiaoling 67.2 560 [[image:image-20221118094449-6.png]] ​
David Huang 2.1 561
562
Xiaoling 48.2 563 = 4.  Using the AT Commands =
564
565 == 4.1  Access AT Commands ==
566
567
David Huang 2.1 568 See this link for detail:  [[https:~~/~~/www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0>>url:https://www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0]]
569
570 AT+<CMD>?  : Help on <CMD>
571
572 AT+<CMD>         : Run <CMD>
573
574 AT+<CMD>=<value> : Set the value
575
576 AT+<CMD>=?  : Get the value
577
578
Xiaoling 48.2 579 (% style="color:blue" %)**General Commands**      
580
David Huang 2.1 581 AT  : Attention       
582
583 AT?  : Short Help     
584
585 ATZ  : MCU Reset    
586
587 AT+TDC  : Application Data Transmission Interval
588
589 AT+CFG  : Print all configurations
590
591 AT+CFGMOD           : Working mode selection
592
593 AT+INTMOD            : Set the trigger interrupt mode
594
595 AT+5VT  : Set extend the time of 5V power  
596
597 AT+PRO  : Choose agreement
598
599 AT+RXDL  : Extend the sending and receiving time
600
601 AT+SERVADDR  : Server Address
602
Xiaoling 83.2 603 AT+TR      :  Get or Set record time
David Huang 2.1 604
Xiaoling 83.2 605 AT+NOUD :  Get or Set the number of data to be uploaded
David Huang 2.1 606
Xiaoling 48.2 607 AT+CDP     :  Read or Clear cached data
David Huang 2.1 608
Xiaoling 83.2 609 AT+DEBUG:  Enable or Disable debug mode
David Huang 2.1 610
Xiaoling 83.2 611 AT+ALARM1:  Get or Set alarm of distance1
David Huang 2.1 612
Xiaoling 83.2 613 AT+ALARM2:  Get or Set alarm of distance2
David Huang 2.1 614
Xiaoling 83.2 615 AT+GETSENSORVALUE :  Returns the current sensor measurement
David Huang 2.1 616
Xiaoling 83.2 617 AT+POWERIC :  Get or set the Power IC flag
David Huang 2.1 618
619
Xiaoling 48.2 620 (% style="color:blue" %)**COAP Management**      
621
Xiaoling 83.2 622 AT+URI :  Resource parameters
David Huang 2.1 623
624
Xiaoling 48.2 625 (% style="color:blue" %)**UDP Management**
626
Xiaoling 83.2 627 AT+CFM :  Upload confirmation mode (only valid for UDP)
David Huang 2.1 628
629
Xiaoling 48.2 630 (% style="color:blue" %)**MQTT Management**
631
Xiaoling 83.2 632 AT+CLIENT  : Get or Set MQTT client
David Huang 2.1 633
Xiaoling 83.2 634 AT+UNAME : Get or Set MQTT Username
David Huang 2.1 635
Xiaoling 83.2 636 AT+PWD  :  Get or Set MQTT password
David Huang 2.1 637
Xiaoling 83.2 638 AT+PUBTOPIC :  Get or Set MQTT publish topic
David Huang 2.1 639
Xiaoling 83.2 640 AT+SUBTOPIC :  Get or Set MQTT subscription topic
David Huang 2.1 641
642
Xiaoling 48.2 643 (% style="color:blue" %)**Information**          
644
Xiaoling 83.2 645 AT+FDR :  Factory Data Reset
David Huang 2.1 646
Xiaoling 83.2 647 AT+PWORD :  Serial Access Password
David Huang 2.1 648
649
Xiaoling 48.2 650 = ​5.  FAQ =
David Huang 2.1 651
Xiaoling 48.2 652 == 5.1 ​ How to Upgrade Firmware ==
David Huang 2.1 653
654
Xiaoling 48.2 655 User can upgrade the firmware for 1) bug fix, 2) new feature release.
David Huang 2.1 656
Xiaoling 48.2 657 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]]
David Huang 2.1 658
Xiaoling 83.2 659 (% style="color:red" %)**Notice: **(% style="color:blue" %)**NMDS200** (%%)**and (% style="color:blue" %)LMDS200(%%)**(% style="color:blue" %) (%%)**share the same mother board. They use the same connection and method to update.**
David Huang 2.1 660
Edwin Chen 42.1 661
Xiaoling 48.2 662 = 6.  Trouble Shooting =
David Huang 2.1 663
Xiaoling 48.2 664 == 6.1  ​Connection problem when uploading firmware ==
David Huang 2.1 665
666
Xiaoling 48.2 667 (% style="color:blue" %)**Please see: **[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H3.3Troubleshooting>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H3.3Troubleshooting]]
Edwin Chen 42.1 668
David Huang 2.1 669
Xiaoling 48.2 670 == 6.2  AT Command input doesn't work ==
David Huang 2.1 671
672
Xiaoling 48.2 673 In the case if user can see the console output but can't type input to the device. Please check if you already include the (% style="color:green" %)**ENTER**(%%) while sending out the command. Some serial tool doesn't send (% style="color:green" %)**ENTER** (%%)while press the send key, user need to add ENTER in their string.
David Huang 2.1 674
675
Xiaoling 48.2 676 = 7. ​ Order Info =
David Huang 2.1 677
678
Xiaoling 83.4 679 Part Number:(% style="color:blue" %)** NMDS200**
David Huang 2.1 680
681
Xiaoling 48.2 682 = 8.  Packing Info =
David Huang 2.1 683
684
Xiaoling 48.2 685 (% style="color:blue" %)**Package Includes**:
David Huang 2.1 686
Xiaoling 83.2 687 * NMDS200 NB-IoT Microwave Radar Distance Sensor x 1
David Huang 2.1 688
Xiaoling 48.2 689 = 9.  Support =
David Huang 2.1 690
691
Xiaoling 48.2 692 * Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule.
David Huang 2.1 693
Xiaoling 48.2 694 * Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[support@dragino.com>>url:http://../../../../../../D:%5C%E5%B8%82%E5%9C%BA%E8%B5%84%E6%96%99%5C%E8%AF%B4%E6%98%8E%E4%B9%A6%5CLoRa%5CLT%E7%B3%BB%E5%88%97%5Csupport@dragino.com]]
David Huang 2.1 695
Xiaoling 48.2 696