Changes for page NDDS75 -- NB-IoT Distance Detect Sensor User Manual

Last modified by Bei Jinggeng on 2024/05/31 09:53

From version < 100.4 >

edited by Xiaoling
on 2022/08/22 14:38

To version < 108.8 >

edited by Xiaoling
on 2022/11/04 15:36

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)
Attachments (0 modified, 3 added, 0 removed)

Details

Page properties

Content

@@ -16,6 +16,7 @@
  = 1.  Introduction =
++
  == 1.1  What is NDDS75 Distance Detection Sensor ==
  (((
@@ -72,7 +72,6 @@
--
  == 1.3  Specification ==
@@ -81,19 +81,15 @@
  * Supply Voltage: 2.1v ~~ 3.6v
  * Operating Temperature: -40 ~~ 85°C
--
--
  (% style="color:#037691" %)**NB-IoT Spec:**
--* - B1 @H-FDD: 2100MHz
--* - B3 @H-FDD: 1800MHz
--* - B8 @H-FDD: 900MHz
--* - B5 @H-FDD: 850MHz
--* - B20 @H-FDD: 800MHz
--* - B28 @H-FDD: 700MHz
++* B1 @H-FDD: 2100MHz
++* B3 @H-FDD: 1800MHz
++* B8 @H-FDD: 900MHz
++* B5 @H-FDD: 850MHz
++* B20 @H-FDD: 800MHz
++* B28 @H-FDD: 700MHz
--
--
  (% style="color:#037691" %)**Battery:**
  * Li/SOCI2 un-chargeable battery
@@ -102,8 +102,6 @@
  * Max continuously current: 130mA
  * Max boost current: 2A, 1 second
--
--
  (% style="color:#037691" %)**Power Consumption**
  * STOP Mode: 10uA @ 3.3v
@@ -111,8 +111,6 @@
--
--
  == 1.4  Applications ==
@@ -128,7 +128,6 @@
--
  == 1.5  Pin Definitions ==
@@ -213,13 +213,13 @@
  [[image:image-20220709092052-2.png]]
--**Connection:**
++(% style="color:blue" %)**Connection:**
-- (% style="background-color:yellow" %)USB TTL GND <~-~-~-~-> GND
++ (% style="background-color:yellow" %)**USB TTL GND <~-~-~-~-> GND**
-- (% style="background-color:yellow" %)USB TTL TXD <~-~-~-~-> UART_RXD
++**~ (% style="background-color:yellow" %)USB TTL TXD <~-~-~-~-> UART_RXD(%%)**
-- (% style="background-color:yellow" %)USB TTL RXD <~-~-~-~-> UART_TXD
++**~ (% style="background-color:yellow" %)USB TTL RXD <~-~-~-~-> UART_TXD(%%)**
  In the PC, use below serial tool settings:
@@ -257,14 +257,19 @@
  (% style="color:blue" %)**AT+PRO=1**  (%%)                                             ~/~/ Set to use CoAP protocol to uplink
  )))
  * (((
--(% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5683   **  (%%)~/~/ to set CoAP server address and port
++(% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5683   **  (%%)~/~/  to set CoAP server address and port
  )))
  * (((
--(% style="color:blue" %)**AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0" ** (%%)      ~/~/Set COAP resource path
++(% style="color:blue" %)**AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0" ** (%%)      ~/~/  Set COAP resource path
++
++
++
  )))
  (((
  For parameter description, please refer to AT command set
++
++
  )))
  [[image:1657330452568-615.png]]
@@ -273,6 +273,8 @@
  (((
  After configure the server address and (% style="color:green" %)**reset the device**(%%) (via AT+ATZ ), NDDS75 will start to uplink sensor values to CoAP server.
++
++
  )))
  [[image:1657330472797-498.png]]
@@ -282,12 +282,10 @@
  === 2.2.5  Use UDP protocol to uplink data(Default protocol) ===
--* (% style="color:blue" %)**AT+PRO=2   ** (%%)        ~/~/ Set to use UDP protocol to uplink
--* (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5601   **  (%%) ~/~/ to set UDP server address and port
--* (% style="color:blue" %)**AT+CFM=1       **   (%%) ~/~/ If the server does not respond, this command is unnecessary
++* (% style="color:blue" %)**AT+PRO=2   ** (%%)        ~/~/  Set to use UDP protocol to uplink
++* (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5601   **  (%%) ~/~/  to set UDP server address and port
++* (% style="color:blue" %)**AT+CFM=1       **   (%%) ~/~/  If the server does not respond, this command is unnecessary
--
--
  [[image:1657330501006-241.png]]
@@ -298,16 +298,14 @@
  === 2.2.6  Use MQTT protocol to uplink data ===
--* (% style="color:blue" %)**AT+PRO=3   **       (%%)                                        ~/~/Set to use MQTT protocol to uplink
--* (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,1883   **   (%%)    ~/~/Set MQTT server address and port
--* (% style="color:blue" %)**AT+CLIENT=CLIENT       **                            (%%)~/~/Set up the CLIENT of MQTT
--* (% style="color:blue" %)**AT+UNAME=UNAME                                **(%%)~/~/Set the username of MQTT
--* (% style="color:blue" %)**AT+PWD=PWD                                         **(%%)~/~/Set the password of MQTT
--* (% style="color:blue" %)**AT+PUBTOPIC=NDDS75_PUB                 **(%%)~/~/Set the sending topic of MQTT
--* (% style="color:blue" %)**AT+SUBTOPIC=NDDS75_SUB          **(%%)       ~/~/Set the subscription topic of MQTT
++* (% style="color:blue" %)**AT+PRO=3   **       (%%)                                        ~/~/  Set to use MQTT protocol to uplink
++* (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,1883   **   (%%)    ~/~/  Set MQTT server address and port
++* (% style="color:blue" %)**AT+CLIENT=CLIENT       **                            (%%)~/~/  Set up the CLIENT of MQTT
++* (% style="color:blue" %)**AT+UNAME=UNAME                                **(%%)~/~/  Set the username of MQTT
++* (% style="color:blue" %)**AT+PWD=PWD                                         **(%%)~/~/  Set the password of MQTT
++* (% style="color:blue" %)**AT+PUBTOPIC=NDDS75_PUB                 **(%%)~/~/   Set the sending topic of MQTT
++* (% style="color:blue" %)**AT+SUBTOPIC=NDDS75_SUB          **(%%)       ~/~/   Set the subscription topic of MQTT
--
--
  [[image:1657249978444-674.png]]
@@ -323,11 +323,9 @@
  === 2.2.7  Use TCP protocol to uplink data ===
--* (% style="color:blue" %)**AT+PRO=4   ** (%%)                                          ~/~/ Set to use TCP protocol to uplink
--* (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5600   **(%%) ~/~/ to set TCP server address and port
++* (% style="color:blue" %)**AT+PRO=4   ** (%%)                                          ~/~/  Set to use TCP protocol to uplink
++* (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5600   **(%%) ~/~/    to set TCP server address and port
--
--
  [[image:image-20220709093918-1.png]]
@@ -340,24 +340,31 @@
  User can use below command to change the (% style="color:green" %)**uplink interval**.
--* (% style="color:blue" %)**AT+TDC=600      **  (%%)~/~/ Set Update Interval to 600s
++* (% style="color:blue" %)**AT+TDC=600      **  (%%)~/~/  Set Update Interval to 600s
  (((
++
++
++
  (% style="color:red" %)**NOTE:**
--)))
--(((
  (% style="color:red" %)**1. By default, the device will send an uplink message every 1 hour.**
++
++(% style="color:red" %)**2. When the firmware version is v1.3.2 and later firmware:**
  )))
++(% style="color:red" %)**By default, the device will send an uplink message every 2 hours. Each Uplink Include 8 set of records in this 2 hour (15 minute interval / record).**
++
  == 2.3  Uplink Payload ==
--In this mode, uplink payload includes in total 14 bytes
++=== 2.3.1  Before Firmware v1.3.2 ===
++In this mode, uplink payload includes in total 14 bytes
++
  (% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:440px" %)
  |=(% style="width: 60px;" %)(((
  **Size(bytes)**
@@ -365,7 +365,7 @@
  |(% style="width:97px" %)**Value**|(% style="width:83px" %)[[Device ID>>||anchor="H2.4.1A0A0DeviceID"]]|(% style="width:41px" %)[[Ver>>||anchor="H2.4.2A0VersionInfo"]]|(% style="width:46px" %)[[BAT>>||anchor="H2.4.3A0BatteryInfo"]]|(% style="width:123px" %)[[Signal Strength>>||anchor="H2.4.4A0SignalStrength"]]|(% style="width:120px" %)[[Distance (unit: mm)>>||anchor="H2.4.5A0Distance"]]|(% style="width:80px" %)[[Interrupt>>||anchor="H2.4.6A0DigitalInterrupt"]]
  (((
--If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NDDS751 uplink data.
++If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NDDS75 uplink data.
  )))
@@ -372,38 +372,70 @@
  [[image:1657331036973-987.png]]
--(((
++
++The payload is **ASCII** string, representative same HEX:
++
++(% style="background-color:yellow" %)**0x 724031556159 0064 0c6c 19 0292 00 **
++
++**where :**
++
++* (% style="color:#037691" %)**Device ID:**(%%) 0x724031556159 = 724031556159
++
++* (% style="color:#037691" %)**Version:**(%%)    0x0064=100=1.0.0
++
++* (% style="color:#037691" %)**BAT:** (%%)      0x0c6c = 3180 mV = 3.180V
++
++* (% style="color:#037691" %)**Signal:**(%%)   0x19 = 25
++
++* (% style="color:#037691" %)**Distance:**  (%%)0x0292= 658 mm
++
++* (% style="color:#037691" %)**Interrupt:**(%%) 0x00 = 0
++
++
++
++=== 2.3.2  Since firmware v1.3.2 ===
++
++
++In this mode, uplink payload includes 69 bytes in total by default.
++
++Each time the device uploads a data package, 8 sets of recorded data will be attached. Up to 32 sets of recorded data can be uploaded.
++
++(% border="1" style="background-color:#ffffcc; color:green; width:490px" %)
++|=(% scope="row" style="width: 60px;" %)**Size(bytes)**|(% style="width:40px" %)**8**|(% style="width:25px" %)**2**|(% style="width:25px" %)**2**|(% style="width:60px" %)**1**|(% style="width:25px" %)**1**|(% style="width:40px" %)**1**|(% style="width:40px" %)**2**|(% style="width:70px" %)**4**|(% style="width:40px" %)**2**|(% style="width:60px" %)**4**
++|=(% style="width: 95px;" %)**Value**|(% style="width:84px" %)Device ID|(% style="width:44px" %)Ver|(% style="width:48px" %)BAT|(% style="width:123px" %)Signal Strength|(% style="width:55px" %)MOD|(% style="width:80px" %)Interrupt|(% style="width:77px" %)Distance|(% style="width:94px" %)Timestamp|(% style="width:77px" %)Distance|(% style="width:116px" %)Timestamp.......
++
++If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NDDS75 uplink data.
++
++[[image:image-20220908175246-1.png]]
++
++
  The payload is ASCII string, representative same HEX:
--)))
--(((
--0x72403155615900640c6c19029200 where:
--)))
++**0x (% style="color:red" %)f867787050213317 (% style="color:blue" %)0084 (% style="color:green" %)0cf4 (% style="color:#00b0f0" %)1e (% style="color:#7030a0" %)01 (% style="color:#d60093" %)00(% style="color:#a14d07" %) 0039 (% style="color:#0020b0" %)6315537b (% style="color:#663300" %)00396319baf0 00396319ba3c 00396319b988 00396319b8d4 00396319b820 00396319b76c 00396319b6b8 00396319b604 (%%)**
--* (((
--Device ID: 0x724031556159 = 724031556159
--)))
--* (((
--Version: 0x0064=100=1.0.0
--)))
++**where:**
--* (((
--BAT: 0x0c6c = 3180 mV = 3.180V
--)))
--* (((
--Signal: 0x19 = 25
--)))
--* (((
--Distance: 0x0292= 658 mm
--)))
--* (((
--Interrupt: 0x00 = 0
++* (% style="color:#037691" %)**Device ID:**(%%) f867787050213317 = f867787050213317
++* (% style="color:#037691" %)**Version:**(%%) 0x0084=132=1.3.2
++* (% style="color:#037691" %)**BAT:**(%%)       0x0cf4 = 3316 mV = 3.316V
--
--)))
++* (% style="color:#037691" %)**Singal:**(%%)   0x1e = 30
++* (% style="color:#037691" %)**Mod:**(%%)**     **0x01 = 1
++
++* (% style="color:#037691" %)**Interrupt:**(%%) 0x00= 0
++
++* (% style="color:#037691" %)**Distance:**(%%) 0x0039= 57 = 57
++
++* (% style="color:#037691" %)**Time stamp:**(%%) 0x6315537b =1662342011  ([[Unix Epoch Time>>url:http://www.epochconverter.com/]])
++
++* (% style="color:#037691" %)**Distance,Time stamp:**(%%) 00396319baf0
++
++* (% style="color:#037691" %)**8 sets of recorded data: Distance,Time stamp :**(%%) //**00396319ba3c**//,.......
++
++
  == 2.4  Payload Explanation and Sensor Interface ==
@@ -421,7 +421,7 @@
  )))
  (((
--**Example:**
++(% style="color:blue" %)**Example :**
  )))
  (((
@@ -429,11 +429,23 @@
  )))
  (((
--The Device ID is stored in a none-erase area, Upgrade the firmware or run **AT+FDR** won't erase Device ID.
++The Device ID is stored in a none-erase area, Upgrade the firmware or run (% style="color:blue" %)**AT+FDR**(%%) won't erase Device ID.
  )))
++(% style="color:red" %)**NOTE: When the firmware version is v1.3.2 and later firmware:**
++(% style="color:red" %)**By default, the Device ID equal to the last 15 bits of IMEI.**
++
++User can use (% style="color:blue" %)**AT+DEUI**(%%) to set Device ID
++
++
++(% style="color:blue" %)**Example :**
++
++AT+DEUI=868411056754138
++
++
++
  === 2.4.2  Version Info ===
@@ -528,7 +528,7 @@
  )))
  (((
--(% style="color:blue" %)**AT+INTMOD=3 **(%%)   ~/~/(more info about INMOD please refer [[**AT Command Manual**>>url:https://www.dragino.com/downloads/downloads/NB-IoT/NBSN95/DRAGINO_NBSN95-NB_AT%20Commands_v1.1.0.pdf]])**.**
++(% style="color:blue" %)**AT+INTMOD=3 **(%%)   ~/~/  (more info about INMOD please refer [[**AT Command Manual**>>url:https://www.dragino.com/downloads/downloads/NB-IoT/NBSN95/DRAGINO_NBSN95-NB_AT%20Commands_v1.1.0.pdf]])**.**
  )))
@@ -630,9 +630,55 @@
--== 2.6  LED Indicator ==
++== 2.6  Distance alarm function(Since firmware v1.3.2) ==
++(% style="color:blue" %)** ➢ AT Command:**
++
++(% style="color:#037691" %)** AT+ LDDSALARM=min,max**
++
++² When min=0, and max≠0, Alarm higher than max
++
++² When min≠0, and max=0, Alarm lower than min
++
++² When min≠0 and max≠0, Alarm higher than max or lower than min
++
++
++(% style="color:blue" %)** Example:**
++
++**AT+ LDDSALARM=260,2000**    ~/~/ Alarm when distance lower than 260.
++
++
++
++== 2.7  Set the number of data to be uploaded and the recording time ==
++
++
++(% style="color:blue" %)** ➢ AT Command:**
++
++* (% 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)
++* (% style="color:#037691" %)** AT+NOUD=8**             (%%) ~/~/  The device uploads 8 sets of recorded data by default. Up to 32 sets of record data can be uploaded.
++
++ The diagram below explains the relationship between TR, NOUD, and TDC more clearly**:**
++
++[[image:image-20221009001114-1.png||height="687" width="955"]]
++
++
++
++== 2.8  Read or Clear cached data ==
++
++
++(% style="color:blue" %)** ➢ AT Command:**
++
++* (% style="color:#037691" %)** AT+CDP **  (%%)           ~/~/  Read cached data
++* (% style="color:#037691" %)** AT+CDP=0**  (%%)       ~/~/  Clear cached data
++
++[[image:image-20220908175333-2.png]]
++
++
++
++== 2.9  LED Indicator ==
++
++
  The NDDS75 has an internal LED which is to show the status of different state.
@@ -647,7 +647,7 @@
--== 2.7  Firmware Change Log ==
++== 2.10  Firmware Change Log ==
  (((
@@ -664,10 +664,10 @@
--== 2.8  Battery Analysis ==
++== 2.11  Battery Analysis ==
--=== 2.8.1  Battery Type ===
++=== 2.11.1  Battery Type ===
  (((
@@ -692,7 +692,7 @@
--=== 2.8.2  Power consumption Analyze ===
++=== 2.11.2  Power consumption Analyze ===
  (((
@@ -731,7 +731,7 @@
--=== 2.8.3  Battery Note ===
++=== 2.11.3  Battery Note ===
  (((
@@ -740,7 +740,7 @@
--=== 2.8.4  Replace the battery ===
++=== 2.11.4  Replace the battery ===
  (((
@@ -775,74 +775,90 @@
  See this link for detail:  [[https:~~/~~/www.dropbox.com/sh/aaq2xcl0bzfu0yd/AAAEAHRa7Io_465ds4Y7-F3aa?dl=0>>https://www.dropbox.com/sh/aaq2xcl0bzfu0yd/AAAEAHRa7Io_465ds4Y7-F3aa?dl=0]]
--AT+<CMD>?                    : Help on <CMD>
++AT+<CMD>?                    :   Help on <CMD>
--AT+<CMD>                      : Run <CMD>
++AT+<CMD>                      :   Run <CMD>
--AT+<CMD>=<value>      : Set the value
++AT+<CMD>=<value>      :   Set the value
--AT+<CMD>=?                  : Get the value
++AT+<CMD>=?                  :   Get the value
  (% style="color:#037691" %)**General Commands**(%%)
--AT                            : Attention
++AT                            :   Attention
--AT?                           : Short Help
++AT?                           :  Short Help
--ATZ                          : MCU Reset
++ATZ                          :   MCU Reset
--AT+TDC                   : Application Data Transmission Interval
++AT+TDC                   :   Application Data Transmission Interval
--AT+CFG                   : Print all configurations
++AT+CFG                   :   Print all configurations
--AT+CFGMOD           : Working mode selection
++AT+CFGMOD           :   Working mode selection
--AT+INTMOD            : Set the trigger interrupt mode
++AT+INTMOD            :   Set the trigger interrupt mode
--AT+5VT                     : Set extend the time of 5V power
++AT+5VT                     :  Set extend the time of 5V power
--AT+PRO                    : Choose agreement
++AT+PRO                    :   Choose agreement
--AT+WEIGRE              : Get weight or set weight to 0
++AT+WEIGRE              :   Get weight or set weight to 0
--AT+WEIGAP              : Get or Set the GapValue of weight
++AT+WEIGAP              :   Get or Set the GapValue of weight
--AT+RXDL                   : Extend the sending and receiving time
++AT+RXDL                   :   Extend the sending and receiving time
--AT+CNTFAC              : Get or set counting parameters
++AT+CNTFAC              :   Get or set counting parameters
--AT+SERVADDR          : Server Address
++AT+SERVADDR         :   Server Address
++AT+TR               :  Get or Set record time"
++AT+APN            :  Get or set the APN
++
++AT+FBAND       :  Get or Set whether to automatically modify the frequency band
++
++AT+DNSCFG     :  Get or Set DNS Server
++
++AT+GETSENSORVALUE   :   Returns the current sensor measurement
++
++AT+NOUD  :     Get or Set the number of data to be uploaded
++
++AT+CDP     :      Read or Clear cached data
++
++AT+LDDSALARM :   Get or Set alarm of distance
++
++
  (% style="color:#037691" %)**COAP Management**
--AT+URI            : Resource parameters
++AT+URI            :   Resource parameters
  (% style="color:#037691" %)**UDP Management**
--AT+CFM          : Upload confirmation mode (only valid for UDP)
++AT+CFM          :   Upload confirmation mode (only valid for UDP)
  (% style="color:#037691" %)**MQTT Management**
--AT+CLIENT               : Get or Set MQTT client
++AT+CLIENT         :   Get or Set MQTT client
--AT+UNAME             : Get or Set MQTT Username
++AT+UNAME        :   Get or Set MQTT Username
--AT+PWD                  : Get or Set MQTT password
++AT+PWD             :   Get or Set MQTT password
--AT+PUBTOPIC          : Get or Set MQTT publish topic
++AT+PUBTOPIC     :   Get or Set MQTT publish topic
--AT+SUBTOPIC          : Get or Set MQTT subscription topic
++AT+SUBTOPIC     :   Get or Set MQTT subscription topic
  (% style="color:#037691" %)**Information**
--AT+FDR              : Factory Data Reset
++AT+FDR              :   Factory Data Reset
--AT+PWORD       : Serial Access Password
++AT+PWORD       :   Serial Access Password
@@ -917,6 +917,7 @@
  (((
++
  (% style="color:#037691" %)**Dimension and weight**:
  * Device Size: 13.0 x 5 x 4.5 cm
@@ -937,6 +937,3 @@
  * 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.
  * 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]]
--
--
--

image-20220908175246-1.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.David

Size

...	...	@@ -1,0 +1,1 @@
	1	+55.7 KB

Content

image-20220908175333-2.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.David

Size

...	...	@@ -1,0 +1,1 @@
	1	+31.1 KB

Content

image-20221009001114-1.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.Edwin

Size

...	...	@@ -1,0 +1,1 @@
	1	+282.9 KB

Content

Changes for page NDDS75 -- NB-IoT Distance Detect Sensor User Manual

Summary

Details

Applications

Navigation