Wiki source code of DDS45-NB -- NB-IoT Distance Detection Sensor User Manual

Version 85.3 by Xiaoling on 2023/09/12 08:59

version	line-number	content
84.2	1	(% style="text-align:center" %)
85.2	2	[[image:image-20230912085600-1.png\|\|height="519" width="731"]]
1.1	3
	4
85.2	5
	6
	7
	8
	9
	10
	11
82.23	12	Table of Contents:
30.1	13
1.1	14	{{toc/}}
	15
	16
	17
	18
	19
	20
31.1	21	= 1. Introduction =
1.1	22
85.3	23	== 1.1 What is DDS45-NB NB-IoT Distance Detection Sensor ==
1.1	24
39.6	25
84.12	26	The Dragino DDS20-NB is a (% style="color:blue" %)NB-IoT Ultrasonic liquid level sensor(%%) for Internet of Things solution. It uses (% style="color:blue" %)none-contact method (%%)to measure the (% style="color:blue" %)height of liquid(%%) in a container without opening the container, and send IoT platform via NB-IoT network.
1.1	27
84.3	28	The DDS20-NB sensor is installed directly below the container to detect the height of the liquid level. User doesn't need to open a hole on the container to be tested. The none-contact measurement makes the measurement safety, easier and possible for some strict situation.
1.1	29
84.12	30	DDS20-NB uses (% style="color:blue" %)ultrasonic sensing technology(%%) for distance measurement. DDS20-NB is of high accuracy to measure various liquid such as: (% style="color:blue" %)toxic substances, strong acids, strong alkalis(%%) and (% style="color:blue" %)various pure liquids(%%) in high-temperature and high-pressure airtight containers.
1.1	31
84.12	32	DDS20-NB supports different uplink methods including (% style="color:blue" %)MQTT, MQTTs, UDP & TCP(%%) for different application requirement, and support uplinks to various IoT Servers.
1.1	33
84.12	34	DDS20-NB (% style="color:blue" %)supports BLE configure (%%)and(% style="color:blue" %) OTA update(%%) which make user easy to use.
1.1	35
84.12	36	DDS20-NB is powered by (% style="color:blue" %)8500mAh Li-SOCI2 battery(%%), it is designed for long-term use up to severa years.
1.1	37
84.11	38	DDS20-NB has optional built-in SIM card and default IoT server connection version. Which makes it works with simple configuration.
84.3	39
	40
84.2	41	[[image:image-20230911140426-2.png\|\|height="320" width="951"]]
1.1	42
	43
	44	== 1.2 Features ==
	45
39.6	46
70.3	47	* NB-IoT Bands: B1/B2/B3/B4/B5/B8/B12/B13/B17/B18/B19/B20/B25/B28/B66/B70/B85 @H-FDD
1.1	48	* Ultra-low power consumption
84.4	49	* Liquid Level Measurement by Ultrasonic technology
	50	* Measure through container, No need to contact Liquid
	51	* Valid level range 20mm - 2000mm
	52	* Accuracy: ±(5mm+S*0.5%) (S: Measure Value)
70.3	53	* Multiply Sampling and one uplink
	54	* Support Bluetooth v5.1 remote configure and update firmware
1.1	55	* Uplink on periodically
	56	* Downlink to change configure
84.4	57	* IP66 Waterproof Enclosure
1.1	58	* 8500mAh Battery for long term use
70.3	59	* Nano SIM card slot for NB-IoT SIM
1.1	60
84.25	61
1.1	62	== 1.3 Specification ==
	63
	64
82.28	65	(% style="color:blue" %)Common DC Characteristics:
1.1	66
84.4	67	* Supply Voltage: 2.5v ~~ 3.6v
1.1	68	* Operating Temperature: -40 ~~ 85°C
	69
82.28	70	(% style="color:blue" %)NB-IoT Spec:
1.1	71
82.28	72	(% style="color:#037691" %)NB-IoT Module: BC660K-GL
1.1	73
82.29	74	(% style="color:#037691" %)Support Bands:
70.4	75
	76	* B1 @H-FDD: 2100MHz
	77	* B2 @H-FDD: 1900MHz
	78	* B3 @H-FDD: 1800MHz
	79	* B4 @H-FDD: 2100MHz
	80	* B5 @H-FDD: 860MHz
	81	* B8 @H-FDD: 900MHz
	82	* B12 @H-FDD: 720MHz
	83	* B13 @H-FDD: 740MHz
	84	* B17 @H-FDD: 730MHz
	85	* B18 @H-FDD: 870MHz
	86	* B19 @H-FDD: 870MHz
	87	* B20 @H-FDD: 790MHz
	88	* B25 @H-FDD: 1900MHz
	89	* B28 @H-FDD: 750MHz
	90	* B66 @H-FDD: 2000MHz
	91	* B70 @H-FDD: 2000MHz
	92	* B85 @H-FDD: 700MHz
	93
82.28	94	(% style="color:blue" %)Battery:
1.1	95
	96	* Li/SOCI2 un-chargeable battery
	97	* Capacity: 8500mAh
70.5	98	* Self Discharge: <1% / Year @ 25°C
1.1	99	* Max continuously current: 130mA
	100	* Max boost current: 2A, 1 second
	101
82.28	102	(% style="color:blue" %)Power Consumption
1.1	103
70.4	104	* STOP Mode: 10uA @ 3.3v
	105	* Max transmit power: 350mA@3.3v
1.1	106
84.25	107
84.5	108	== 1.4 Suitable Container & Liquid ==
1.1	109
	110
84.5	111	* Solid Wall container such as: steel, iron, glass, ceramics, non-foaming plastics etc.
	112	* Container shape is regular, and surface is smooth.
	113	* Container Thickness:
	114	** Pure metal material. 2~~8mm, best is 3~~5mm
	115	** Pure non metal material: <10 mm
	116	* Pure liquid without irregular deposition.
70.5	117
84.25	118
84.5	119	(% style="display:none" %)
73.2	120
84.5	121	== 1.5 Install DDS20-NB ==
73.2	122
84.5	123
	124	(% style="color:blue" %)Step 1(%%): Choose the installation point.
	125
	126	DDS20-NB (% style="color:red" %)MUST(%%) be installed on the container bottom middle position.
	127
	128	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS20%20-%20LoRaWAN%20Liquid%20Level%20Sensor%20User%20Manual/WebHome/image-20220615091045-3.png?rev=1.1\|\|alt="image-20220615091045-3.png"]]
	129
	130
	131	(((
	132	(% style="color:blue" %)Step 2(%%): Polish the installation point.
	133	)))
	134
	135	(((
	136	For Metal Surface with paint, it is important to polish the surface, first use crude sand paper to polish the paint level , then use exquisite sand paper to polish the metal level to make it shine & smooth.
	137	)))
	138
	139	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DDS20-LB_LoRaWAN_Ultrasonic_Liquid_Level_Sensor_User_Manual/WebHome/image-20230613143052-5.png?rev=1.1\|\|alt="image-20230613143052-5.png"]]
	140
	141
	142	No polish needed if the container is shine metal surface without paint or non-metal container.
	143
	144	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DDS20-LB_LoRaWAN_Ultrasonic_Liquid_Level_Sensor_User_Manual/WebHome/image-20230613143125-6.png?rev=1.1\|\|alt="image-20230613143125-6.png"]]
	145
	146
	147	(((
	148	(% style="color:blue" %)Step3: (%%)Test the installation point.
	149	)))
	150
	151	(((
	152	Power on DDS20-NB, check if the blue LED is on, If the blue LED is on, means the sensor works. Then put ultrasonic coupling paste on the sensor and put it tightly on the installation point.
	153	)))
	154
	155	(((
	156	It is necessary to put the coupling paste between the sensor and the container, otherwise DDS20-NB won't detect the liquid level.
	157	)))
	158
	159	(((
	160	After paste the DDS20-NB well, power on DDS20-NB. In the first 30 seconds of booting, device will check the sensors status and BLUE LED will show the status as below. After 30 seconds, BLUE LED will be off to save battery life.
	161	)))
	162
	163
	164	(((
	165	(% style="color:blue" %)LED Status:
	166	)))
	167
	168	* (((
	169	Onboard LED: When power on device, the onboard LED will fast blink 4 times which means detect the sensor well.
	170	)))
	171
	172	* (((
	173	(% style="color:blue" %)BLUE LED(% style="color:red" %) always ON(%%): Sensor is power on but doesn't detect liquid. There is problem in installation point.
	174	)))
	175	* (((
	176	(% style="color:blue" %)BLUE LED(% style="color:red" %) slowly blinking(%%): Sensor detects Liquid Level, The installation point is good.
	177	)))
	178
	179	(((
	180	DDS20-NB will enter into low power mode at 30 seconds after system reset or power on, Blue LED will be off after that.
	181	)))
	182
	183
	184	(((
	185	(% style="color:red" %)Note :(%%) (% style="color:blue" %)Ultrasonic coupling paste(%%)(% style="color:blue" %) (%%) is subjected in most shipping way. So the default package doesn't include it and user needs to purchase locally.
	186	)))
	187
	188
	189	(((
	190	(% style="color:blue" %)Step4: (%%)Install use Epoxy ab glue.
	191	)))
	192
	193	(((
	194	Prepare Eproxy AB glue.
	195	)))
	196
	197	(((
	198	Put Eproxy AB glue in the sensor and press it hard on the container installation point.
	199	)))
	200
	201	(((
	202	Reset DDS20-NB and see if the BLUE LED is slowly blinking.
	203	)))
	204
84.24	205	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DDS20-LB_LoRaWAN_Ultrasonic_Liquid_Level_Sensor_User_Manual/WebHome/image-20230809172509-1.png?rev=1.1\|\|alt="image-20230809172509-1.png"]]
84.5	206
	207	(((
	208	(% style="color:red" %)Note :(% style="color:red; display:none" %)
	209
	210	(% style="color:red" %)1:(%%) (% style="color:blue" %)Eproxy AB glue(%%) needs 3~~ 5 minutes to stable attached. we can use other glue material to keep it in the position.
	211	)))
	212
	213	(((
	214	(% style="color:red" %)2:(%%) (% style="color:blue" %)Eproxy AB glue(%%) is subjected in most shipping way. So the default package doesn't include it and user needs to purchase locally.
	215	)))
	216
	217
	218	== 1.6 Applications ==
	219
	220
	221	* Smart liquid control solution
	222
	223	* Smart liquefied gas solution
	224
84.24	225
84.5	226	== 1.7 Precautions ==
	227
	228
	229	* At room temperature, containers of different materials, such as steel, glass, iron, ceramics, non-foamed plastics and other dense materials, have different detection blind areas and detection limit heights.
	230
	231	* For containers of the same material at room temperature, the detection blind zone and detection limit height are also different for the thickness of the container.
	232
	233	* When the detected liquid level exceeds the effective detection value of the sensor, and the liquid level of the liquid to be measured shakes or tilts, the detected liquid height is unstable.
	234
	235	(% style="display:none" %)
	236
	237
	238
	239	== 1.8 Sleep mode and working mode ==
	240
	241
73.2	242	(% style="color:blue" %)Deep Sleep Mode: (%%)Sensor doesn't have any LoRaWAN activate. This mode is used for storage and shipping to save battery life.
	243
	244	(% style="color:blue" %)Working Mode: (%%)In this mode, Sensor will work as LoRaWAN Sensor to Join LoRaWAN network and send out sensor data to server. Between each sampling/tx/rx periodically, sensor will be in IDLE mode), in IDLE mode, sensor has the same power consumption as Deep Sleep mode.
	245
	246
84.5	247	== 1.9 Button & LEDs ==
73.2	248
	249
6.1	250	[[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675071855856-879.png]]
1.1	251
	252
14.13	253	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
80.11	254	\|=(% style="width: 167px;background-color:#4F81BD;color:white" %)Behavior on ACT\|=(% style="width: 117px;background-color:#4F81BD;color:white" %)Function\|=(% style="width:225px;background-color:#4F81BD;color:white" %)Action
1.1	255	\|(% style="width:167px" %)Pressing ACT between 1s < time < 3s\|(% style="width:117px" %)Send an uplink\|(% style="width:225px" %)(((
73.2	256	If sensor has already attached to NB-IoT network, sensor will send an uplink packet, (% style="color:blue" %)blue led (%%)will blink once.
1.1	257	Meanwhile, BLE module will be active and user can connect via BLE to configure device.
	258	)))
	259	\|(% style="width:167px" %)Pressing ACT for more than 3s\|(% style="width:117px" %)Active Device\|(% style="width:225px" %)(((
73.2	260	(% style="color:green" %)Green led(%%) will fast blink 5 times, device will enter (% style="color:#037691" %)OTA mode(%%) for 3 seconds. And then start to attach NB-IoT network.
1.1	261	(% style="color:green" %)Green led(%%) will solidly turn on for 5 seconds after joined in network.
73.2	262	Once sensor is active, BLE module will be active and user can connect via BLE to configure device, no matter if device attach NB-IoT network or not.
1.1	263	)))
6.1	264	\|(% style="width:167px" %)Fast press ACT 5 times.\|(% style="width:117px" %)Deactivate Device\|(% style="width:225px" %)(% style="color:red" %)Red led(%%) will solid on for 5 seconds. Means device is in Deep Sleep Mode.
1.1	265
84.24	266
84.5	267	== 1.10 BLE connection ==
1.1	268
	269
84.5	270	DDS20-NB support BLE remote configure and firmware update.
1.1	271
	272
	273	BLE can be used to configure the parameter of sensor or see the console output from sensor. BLE will be only activate on below case:
	274
	275	* Press button to send an uplink
	276	* Press button to active device.
	277	* Device Power on or reset.
	278
	279	If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
	280
	281
84.5	282	== 1.11 Pin Definitions & Switch ==
1.1	283
73.3	284
73.2	285	[[image:image-20230819104805-5.png]]
1.1	286
43.1	287
84.5	288	=== 1.11.1 Jumper JP2 ===
43.1	289
73.3	290
	291	Power on Device when put this jumper.
	292
	293
84.5	294	=== 1.11.2 BOOT MODE / SW1 ===
73.3	295
	296
82.31	297	1) (% style="color:blue" %)ISP(%%): upgrade mode, device won't have any signal in this mode. but ready for upgrade firmware. LED won't work. Firmware won't run.
73.3	298
82.31	299	2) (% style="color:blue" %)Flash(%%): work mode, device starts to work and send out console output for further debug
73.3	300
	301
84.5	302	=== 1.11.3 Reset Button ===
73.3	303
80.2	304
73.3	305	Press to reboot the device.
	306
1.1	307	(% style="display:none" %)
	308
	309
84.14	310	== 1.12 Mechanical ==
	311
	312
	313	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual/WebHome/1675143884058-338.png?rev=1.1\|\|alt="1675143884058-338.png"]]
	314
	315	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual/WebHome/1675143899218-599.png?rev=1.1\|\|alt="1675143899218-599.png"]]
	316
	317	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual/WebHome/1675143909447-639.png?rev=1.1\|\|alt="1675143909447-639.png"]]
	318
	319
	320	(% style="color:blue" %)Probe Mechanical:
	321
	322	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS20%20-%20LoRaWAN%20Liquid%20Level%20Sensor%20User%20Manual/WebHome/image-20220615090910-1.png?rev=1.1\|\|alt="image-20220615090910-1.png"]]
	323
	324	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS20%20-%20LoRaWAN%20Liquid%20Level%20Sensor%20User%20Manual/WebHome/image-20220615090910-2.png?rev=1.1\|\|alt="image-20220615090910-2.png"]]
	325
	326
84.13	327	= 2. Use DDS20-NB to communicate with IoT Server =
1.1	328
80.2	329	== 2.1 Send data to IoT server via NB-IoT network ==
1.1	330
	331
84.6	332	The DDS20-NB is equipped with a NB-IoT module, the pre-loaded firmware in DDS20-NB will get environment data from sensors and send the value to local NB-IoT network via the NB-IoT module. The NB-IoT network will forward this value to IoT server via the protocol defined by DDS20-NB.
1.1	333
	334
80.2	335	Below shows the network structure:
1.1	336
84.6	337	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DDS20-NB_NB-IoT_Ultrasonic_Liquid_Level_Sensor_User_Manual/WebHome/image-20230911140426-2.png?width=951&height=320&rev=1.1\|\|alt="image-20230911140426-2.png"]]
1.1	338
	339
84.7	340	There are two version: (% style="color:blue" %)-GE(%%) and (% style="color:blue" %)-1D(%%) version of DDS20-NB.
1.1	341
	342
84.7	343	(% style="color:blue" %)GE Version(%%): This version doesn't include SIM card or point to any IoT server. User needs to use AT Commands to configure below two steps to set DDS20-NB send data to IoT server.
1.1	344
82.19	345	* Install NB-IoT SIM card and configure APN. See instruction of [[Attach Network>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H2.AttachNetwork]].
80.4	346
82.19	347	* Set up sensor to point to IoT Server. See instruction of [[Configure to Connect Different Servers>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.Configuretoconnecttodifferentservers]].
1.1	348
80.2	349	Below shows result of different server as a glance.
1.1	350
80.9	351	(% border="1" cellspacing="4" style="width:515px" %)
81.2	352	\|(% style="background-color:#4f81bd; color:white; width:100px" %)Servers\|(% style="background-color:#4f81bd; color:white; width:300px" %)Dash Board\|(% style="background-color:#4f81bd; color:white; width:115px" %)Comments
82.24	353	\|(% style="width:127px" %)[[Node-Red>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.5A0Node-RedA028viaA0MQTT29]]\|(% style="width:385px" %)(((
	354	(% style="text-align:center" %)
	355	[[image:image-20230819113244-8.png\|\|height="183" width="367"]]
	356	)))\|(% style="width:170px" %)
	357	\|(% style="width:127px" %)[[DataCake>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.4Datacake]]\|(% style="width:385px" %)(((
	358	(% style="text-align:center" %)
82.25	359	[[image:image-20230819113244-9.png\|\|height="119" width="367"]]
82.24	360	)))\|(% style="width:170px" %)
80.9	361	\|(% style="width:127px" %)[[Tago.IO>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.7A0Tago.ioA028viaA0MQTT29]]\|(% style="width:385px" %) \|(% style="width:170px" %)
	362	\|(% style="width:127px" %)[[General UDP>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.1GeneralA0UDPA0Connection]]\|(% style="width:385px" %)Raw Payload. Need Developer to design Dash Board\|(% style="width:170px" %)
	363	\|(% style="width:127px" %)[[General MQTT>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.2GeneralA0MQTTA0Connection]]\|(% style="width:385px" %)Raw Payload. Need Developer to design Dash Board\|(% style="width:170px" %)
82.24	364	\|(% style="width:127px" %)[[ThingSpeak>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.3A0ThingSpeakA028viaA0MQTT29]]\|(% style="width:385px" %)(((
	365	(% style="text-align:center" %)
82.25	366	[[image:image-20230819113244-10.png\|\|height="104" width="367"]]
82.24	367	)))\|(% style="width:170px" %)
	368	\|(% style="width:127px" %)[[ThingsBoard>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.6A0ThingsBoard.CloudA028viaA0MQTT29]]\|(% style="width:385px" %)(((
	369	(% style="text-align:center" %)
82.25	370	[[image:image-20230819113244-11.png\|\|height="141" width="367"]]
82.24	371	)))\|(% style="width:170px" %)
80.2	372
84.7	373	(% style="color:blue" %)1D Version(%%): This version has 1NCE SIM card pre-installed and configure to send value to DataCake. User Just need to select the sensor type in DataCake and Activate DDS20-NB and user will be able to see data in DataCake. See here for [[DataCake Config Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.4Datacake]].
80.2	374
	375
	376	== 2.2 Payload Types ==
	377
	378
84.7	379	To meet different server requirement, DDS20-NB supports different payload type.
1.1	380
81.2	381	Includes:
1.1	382
82.21	383	* [[General JSON format payload>>\|\|anchor="H2.2.1GeneralJsonFormat28Type3D529"]]. (Type=5)
80.7	384
82.21	385	* [[HEX format Payload>>\|\|anchor="H2.2.2HEXformatPayload28Type3D029"]]. (Type=0)
80.7	386
82.21	387	* [[ThingSpeak Format>>\|\|anchor="H2.2.4ThingSpeakPayload28Type3D129"]]. (Type=1)
80.7	388
82.21	389	* [[ThingsBoard Format>>\|\|anchor="H2.2.3ThingsBoardPayload28Type3D329"]]. (Type=3)
1.1	390
80.3	391	User can specify the payload type when choose the connection protocol. Example:
1.1	392
81.2	393	(% style="color:#037691" %)AT+PRO=2,0 (%%) ~/~/ Use UDP Connection & hex Payload
1.1	394
80.8	395	(% style="color:#037691" %)AT+PRO=2,5 (%%) ~/~/ Use UDP Connection & Json Payload
1.1	396
81.2	397	(% style="color:#037691" %)AT+PRO=3,5 (%%) ~/~/ Use MQTT Connection & Json Payload
1.1	398
	399
82.20	400	=== 2.2.1 General Json Format(Type~=5) ===
1.1	401
80.8	402
80.3	403	This is the General Json Format. As below:
1.1	404
84.7	405	(% style="color:#4472c4" %){"IMEI":866207053462762,"temperature":29.2,"humidity":54.2,"battery":3.27,"signal":24,"Model":DDS20-NB, "1":{28.2,48.3,2023/08/10 08:00:37},"2":{28.1,49.1,2023/08/10 07:57:37},"3":{28.1,48.5,2023/08/10 07:54:37},"4":{28.2,48.6,2023/08/10 07:51:37},"5":{28.1,48.9,2023/08/10 07:48:37},"6":{28.2,48.8,2023/08/10 07:45:37},"7":{28.2,48.8,2023/08/10 07:42:37},"8":{28.0,48.8,2023/08/10 07:39:37}}
1.1	406
	407
81.2	408	(% style="color:red" %)Notice, from above payload:
1.1	409
80.3	410	* Temperature , Humidity , Battery & Signal are the value at uplink time.
1.1	411
80.4	412	* Json entry 1 ~~ 8 are the last 1 ~~ 8 sampling data as specify by (% style="color:#037691" %)AT+NOUD=8 (%%)Command. Each entry includes (from left to right): Temperature, Humidity, Sampling time.
1.1	413
84.24	414
81.2	415	=== 2.2.2 HEX format Payload(Type~=0) ===
1.1	416
	417
80.3	418	This is the HEX Format. As below:
1.1	419
80.8	420	(% style="color:#4472c4" %)f86620705346276200640cba16010000000011011801e864d49c2d011a01e364d49925011901eb64d49871011901e564d497bd011a01e664d49709011901e964d49655011a01e864d495a1011a01e864d494ed011801e864d49439
1.1	421
81.2	422	[[image:1692424009971-458.png]]
6.1	423
1.1	424
80.4	425	(% style="color:blue" %)Version:
1.1	426
80.3	427	These bytes include the hardware and software version.
1.1	428
84.8	429	(% style="color:#037691" %)Higher byte:(%%) Specify Sensor Model: 0x00 for DDS20-NB
1.1	430
80.4	431	(% style="color:#037691" %)Lower byte:(%%) Specify the software version: 0x64=100, means firmware version 100
1.1	432
	433
81.2	434	(% style="color:blue" %)BAT (Battery Info):
1.1	435
80.3	436	Ex1: 0x0CBA = 3258mV
1.1	437
	438
80.4	439	(% style="color:blue" %)Signal Strength:
1.1	440
80.3	441	NB-IoT Network signal Strength.
1.1	442
80.3	443	Ex1: 0x16 = 22
1.1	444
80.3	445	0 -113dBm or less
1.1	446
80.3	447	1 -111dBm
1.1	448
80.3	449	2...30 -109dBm... -53dBm
1.1	450
80.3	451	31 -51dBm or greater
1.1	452
80.3	453	99 Not known or not detectable
1.1	454
	455
80.4	456	(% style="color:blue" %)TimeStamp:
1.1	457
80.3	458	Unit TimeStamp Example: 64d49439(H) = 1691653177(D)
1.1	459
80.3	460	Put the decimal value into this link(https:~/~/www.epochconverter.com/) to get the time.
1.1	461
	462
81.2	463	=== 2.2.3 ThingsBoard Payload(Type~=3) ===
1.1	464
80.8	465
80.3	466	Type3 payload special design for ThingsBoard, it will also configure other default server to ThingsBoard.
1.1	467
80.8	468	(% style="color:#4472c4" %){"IMEI":866207053462762,"temperature":29.2,"humidity":54.2,"battery":3.27,"signal":24}
46.1	469
1.1	470
81.2	471	=== 2.2.4 ThingSpeak Payload(Type~=1) ===
1.1	472
80.8	473
80.3	474	This payload meets ThingSpeak platform requirement. It includes only four fields. Form 1~~4 are:
1.1	475
80.3	476	Temperature, Humidity, Battery & Signal. This payload type only valid for ThingsSpeak Platform
14.22	477
80.3	478	As below:
1.1	479
80.8	480	(% style="color:#4472c4" %)field1=27.9&field2=49.9&field3=3.23&field4=28
1.1	481
84.24	482
84.15	483	== 2.3 Uplink Payload ==
10.1	484
1.1	485
84.15	486	(((
84.18	487	DDS20-NB will uplink payload via LoRaWAN with below payload format:
84.15	488	)))
1.1	489
84.15	490	(((
	491	Uplink payload includes in total 8 bytes.
	492	)))
	493
	494	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
84.17	495	\|=(% style="width: 95px; background-color:#4F81BD;color:white" %)Size(bytes)\|=(% style="width: 61px; background-color:#4F81BD;color:white" %)2\|=(% style="background-color:#4F81BD;color:white" %)2\|=(% style="background-color:#4F81BD;color:white" %)1\|=(% style="background-color:#4F81BD;color:white" %)2\|=(% style="background-color:#4F81BD;color:white" %)1
84.21	496	\|(% style="width:95px" %)Value\|(% style="width:61px" %)[[BAT>>\|\|anchor="H2.3.1A0BatteryInfo"]]\|(((
	497	[[Distance>>\|\|anchor="H2.3.2A0Distance"]]
84.15	498	(unit: mm)
84.21	499	)))\|[[Digital Interrupt (Optional)>>\|\|anchor="H2.3.3A0InterruptPin"]]\|(((
	500	[[Temperature (Optional)>>\|\|anchor="H2.3.4A0DS18B20Temperaturesensor"]]
	501	)))\|[[Sensor Flag>>\|\|anchor="H2.3.5A0SensorFlag"]]
84.15	502
84.17	503	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DDS20-LB_LoRaWAN_Ultrasonic_Liquid_Level_Sensor_User_Manual/WebHome/%E5%BE%AE%E4%BF%A1%E6%88%AA%E5%9B%BE_20230702135733.png?width=964&height=215&rev=1.1\|\|alt="微信截图_20230702135733.png"]]
84.15	504
	505
84.20	506	=== 2.3.1 Battery Info ===
84.15	507
	508
84.18	509	Check the battery voltage for DDS20-NB.
84.15	510
	511	Ex1: 0x0B45 = 2885mV
	512
	513	Ex2: 0x0B49 = 2889mV
	514
	515
84.20	516	=== 2.3.2 Distance ===
84.15	517
	518
	519	(((
	520	Get the distance. Flat object range 20mm - 2000mm.
	521	)))
	522
	523	(((
	524	For example, if the data you get from the register is 0x06 0x05, the distance between the sensor and the measured object is(% style="color:#4472c4" %)
	525
	526	(% style="color:blue" %)0605(H) = 1541 (D) = 1541 mm.
	527	)))
	528
	529	* If the sensor value is 0x0000, it means system doesn't detect ultrasonic sensor.
	530
	531	* If the sensor value lower than 0x0014 (20mm), the sensor value will be invalid.
	532
84.24	533
84.20	534	=== 2.3.3 Interrupt Pin ===
84.15	535
	536
84.16	537	This data field shows if this packet is generated by interrupt or not.
84.15	538
	539	Example:
	540
	541	0x00: Normal uplink packet.
	542
	543	0x01: Interrupt Uplink Packet.
	544
	545
84.20	546	=== 2.3.4 DS18B20 Temperature sensor ===
84.15	547
	548
	549	This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature.
	550
	551	Example:
	552
	553	If payload is: 0105H: (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree
	554
	555	If payload is: FF3FH : (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
	556
	557
84.20	558	=== 2.3.5 Sensor Flag ===
84.15	559
	560
	561	(((
	562	0x01: Detect Ultrasonic Sensor
	563	)))
	564
	565	(((
	566	0x00: No Ultrasonic Sensor
	567
	568
	569	)))
	570
	571	== 2.4 Test Uplink and Change Update Interval ==
	572
	573
80.4	574	By default, Sensor will send uplinks (% style="color:blue" %)every 2 hours(%%) & AT+NOUD=8
1.1	575
80.4	576	User can use below commands to change the (% style="color:blue" %)uplink interval.
1.1	577
82.2	578	(% style="color:#037691" %)AT+TDC=600 (%%) ~/~/ Set Update Interval to 600s
1.1	579
80.3	580	User can also push the button for more than 1 seconds to activate an uplink.
1.1	581
	582
84.15	583	== 2.5 Multi-Samplings and One uplink ==
39.5	584
80.4	585
84.8	586	To save battery life, DDS20-NB will sample temperature & humidity data every 15 minutes and send one uplink every 2 hours. So each uplink it will include 8 stored data + 1 real-time data. They are defined by:
1.1	587
82.6	588	* (% style="color:#037691" %)AT+TR=900 (%%) ~/~/ The unit is seconds, and the default is to record data once every 900 seconds (15 minutes, the minimum can be set to 180 seconds)
1.1	589
82.12	590	* (% 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.
1.1	591
80.3	592	The diagram below explains the relationship between TR, NOUD, and TDC more clearly:
1.1	593
82.2	594	[[image:1692424376354-959.png]]
1.1	595
	596
84.15	597	== 2.6 Trggier an uplink by external interrupt ==
1.1	598
80.5	599
84.9	600	DDS20-NB has an external trigger interrupt function. Users can use the PB15 pin to trigger the upload of data packets.
39.5	601
80.5	602	(% style="color:blue" %)AT command:
46.1	603
82.6	604	* (% style="color:#037691" %)AT+INTMOD (%%) ~/~/ Set the trigger interrupt mode
46.1	605
82.6	606	* (% style="color:#037691" %)AT+INTMOD=0 (%%) ~/~/ Disable Interrupt
1.1	607
82.6	608	* (% style="color:#037691" %)AT+INTMOD=1 (%%) ~/~/ Trigger by rising and falling edge
80.5	609
82.6	610	* (% style="color:#037691" %)AT+INTMOD=2 (%%) ~/~/ Trigger by falling edge
80.5	611
82.6	612	* (% style="color:#037691" %)AT+INTMOD=3 (%%) ~/~/ Trigger by rising edge
80.5	613
84.24	614
84.9	615	= 3. Configure DDS20-NB =
1.1	616
16.4	617	== 3.1 Configure Methods ==
1.1	618
	619
84.9	620	DDS20-NB supports below configure method:
1.1	621
	622	* AT Command via Bluetooth Connection (Recommended): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
80.6	623
11.1	624	* AT Command via UART Connection : See [[UART Connection>>http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H2.3UARTConnectionforSN50v3basemotherboard]].
80.6	625
84.24	626
82.8	627	== 3.2 AT Commands Set ==
1.1	628
	629
82.8	630	AT+<CMD>? : Help on <CMD>
1.1	631
82.8	632	AT+<CMD> : Run <CMD>
1.1	633
82.8	634	AT+<CMD>=<value> : Set the value
1.1	635
82.8	636	AT+<CMD>=? : Get the value
1.1	637
	638
82.10	639	(% style="color:blue" %)General Commands
1.1	640
82.8	641	AT : Attention
1.1	642
82.9	643	AT? : Short Help
1.1	644
82.9	645	ATZ : MCU Reset
1.1	646
82.9	647	AT+TDC : Application Data Transmission Interval
1.1	648
82.9	649	AT+CFG : Print all configurations
1.1	650
82.8	651	AT+CFGMOD : Working mode selection
1.1	652
82.9	653	AT+DEUI : Get or set the Device ID
1.1	654
82.8	655	AT+INTMOD : Set the trigger interrupt mode
1.1	656
82.8	657	AT+5VT : Set extend the time of 5V power
1.1	658
82.8	659	AT+PRO : Choose agreement
1.1	660
82.9	661	AT+RXDL : Extend the sending and receiving time
1.1	662
82.9	663	AT+DNSCFG : Get or Set DNS Server
1.1	664
82.8	665	AT+GETSENSORVALUE : Returns the current sensor measurement
1.1	666
82.9	667	AT+NOUD : Get or Set the number of data to be uploaded
1.1	668
82.8	669	AT+CDP : Read or Clear cached data
1.1	670
82.9	671	AT+SHTEMP: Get or Set alarm of temp
1.1	672
82.9	673	AT+SHHUM: Get or Set alarm of moisture
1.1	674
82.9	675	AT+SERVADDR : Server Address
1.1	676
82.9	677
82.10	678	(% style="color:blue" %)UDP Management
1.1	679
82.9	680	AT+CFM : Upload confirmation mode (only valid for UDP)
1.1	681
39.6	682
82.10	683	(% style="color:blue" %)MQTT Management
1.1	684
82.8	685	AT+CLIENT : Get or Set MQTT client
1.1	686
82.8	687	AT+UNAME : Get or Set MQTT Username
1.1	688
82.8	689	AT+PWD : Get or Set MQTT password
1.1	690
82.9	691	AT+PUBTOPIC : Get or Set MQTT publish topic
1.1	692
82.9	693	AT+SUBTOPIC : Get or Set MQTT subscription topic
1.1	694
	695
82.10	696	(% style="color:blue" %)Information
1.1	697
82.9	698	AT+FDR : Factory Data Reset
1.1	699
82.9	700	AT+PWORD : Serial Access Password
1.1	701
82.9	702	AT+LDATA : Get the last upload data
39.6	703
82.9	704	AT+CDP : Read or Clear cached data
1.1	705
82.9	706
16.4	707	= 4. Battery & Power Consumption =
14.45	708
1.1	709
84.9	710	DDS20-NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
1.1	711
	712	[[Battery Info & Power Consumption Analyze>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
	713
	714
82.11	715	= 5. Firmware update =
1.1	716
	717
82.11	718	User can change device firmware to::
1.1	719
13.1	720	* Update with new features.
82.11	721
13.1	722	* Fix bugs.
1.1	723
84.22	724	Firmware and changelog can be downloaded from : [[Firmware download link>>https://www.dropbox.com/sh/nyzeu0lf0amcaek/AAC6UZrqyTcAyJgXOH7l9F9Ka?dl=0]]
1.1	725
31.1	726	Methods to Update Firmware:
1.1	727
82.12	728	* (Recommended way) OTA firmware update via BLE: [[Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/BLE_Firmware_Update_NB_Sensors_BC660K-GL/]].
82.14	729
64.2	730	* Update through UART TTL interface : [[Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware]].
1.1	731
84.24	732
31.1	733	= 6. FAQ =
1.1	734
82.15	735	== 6.1 How can I access t BC660K-GL AT Commands? ==
1.1	736
	737
82.15	738	User can access to BC660K-GL directly and send AT Commands.
1.1	739
82.15	740	[[See BC660K-GL AT Command set>>url:https://www.dropbox.com/sh/5f6ssda5fum8rvs/AABT68l8ZzWOvZ5eg2qwOoFda?dl=0]]
1.1	741
	742
84.16	743	= 7. Trouble Shooting =
1.1	744
84.16	745	== 7.1 Why i always see 0x0000 or 0 for the distance value? ==
1.1	746
84.16	747
	748	(((
84.18	749	DDS20-NB has a strict [[installation requirement>>\|\|anchor="H1.5A0InstallDDS20-NB"]]. Please make sure the installation method exactly follows up with the installation requirement. Otherwise, the reading might be always 0x00.
84.16	750
	751	If you have followed the instruction requirement exactly but still see the 0x00 reading issue, please. please double-check the decoder, you can check the raw payload to verify.
84.24	752
	753
84.16	754	)))
	755
	756	= 8. Order Info =
	757
	758
84.9	759	Part Number: (% style="color:blue" %)DDS20-NB-XX
1.1	760
82.15	761	(% style="color:red" %)XX(%%):
1.1	762
82.15	763	* (% style="color:#037691" %)GE(%%): General version ( Exclude SIM card)
1.1	764
82.15	765	* (% style="color:#037691" %)1D(%%): with 1NCE* 10 years 500MB SIM card and Pre-configure to DataCake server
1.1	766
82.31	767	(% style="color:#037691" %)1NCE SIM Card NB-IoT network coverage(%%): Austria, Belgium, Bulgaria, Croatia, Czech Republic, Denmark, Finland, Germany, Great Britain, Greece, Hungary, Ireland, Italy, Latvia, Malta, Netherlands, Norway, Puerto Rico, Russia, Slovak , Republic, Slovenia, Spain, Sweden, Switzerland, Taiwan, USA, US Virgin Islands
1.1	768
	769
84.16	770	= 9. Packing Info =
1.1	771
39.6	772
39.1	773	(% style="color:#037691" %)Package Includes:
1.1	774
84.10	775	* DDS20-NB NB-IoT Ultrasonic liquid level sensor x 1
1.1	776
82.16	777	* External antenna x 1
	778
39.1	779	(% style="color:#037691" %)Dimension and weight:
1.1	780
82.24	781	* Device Size: 13.0 x 5 x 4.5 cm
1.1	782
82.24	783	* Device Weight: 150g
1.1	784
82.24	785	* Package Size / pcs : 14.0 x 8x 5 cm
1.1	786
82.24	787	* Weight / pcs : 180g
1.1	788
84.24	789
84.16	790	= 10. Support =
1.1	791
	792
31.1	793	* 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.
39.6	794
	795	* 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.cc>>mailto:Support@dragino.cc]].
75.2	796
80.9	797	(% style="display:none" %) (%%)

Wiki source code of DDS45-NB -- NB-IoT Distance Detection Sensor User Manual

Applications