Wiki source code of DDS20-NB -- NB-IoT Ultrasonic Liquid Level Sensor User Manual

Version 84.8 by Xiaoling on 2023/09/11 14:57

version	line-number	content
84.2	1	(% style="text-align:center" %)
	2	[[image:image-20230911134259-1.png\|\|height="570" width="570"]]
1.1	3
	4
82.23	5	Table of Contents:
30.1	6
1.1	7	{{toc/}}
	8
	9
	10
	11
	12
	13
31.1	14	= 1. Introduction =
1.1	15
83.3	16	== 1.1 What is DDS20-NB NB-IoT Ultrasonic liquid level Sensor ==
1.1	17
39.6	18
84.3	19	The Dragino DDS20-NB is a NB-IoT Ultrasonic liquid level sensor for Internet of Things solution. It uses none-contact method to measure the height of liquid in a container without opening the container, and send IoT platform via NB-IoT network.
1.1	20
84.3	21	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	22
84.3	23	DDS20-NB uses ultrasonic sensing technology for distance measurement. DDS20-NB is of high accuracy to measure various liquid such as: toxic substances, strong acids, strong alkalis and various pure liquids in high-temperature and high-pressure airtight containers.
1.1	24
84.3	25	PS-NB-NA supports different uplink methods including MQTT, MQTTs, UDP & TCP for different application requirement, and support uplinks to various IoT Servers.
1.1	26
84.3	27	PS-NB-NA supports BLE configure and OTA update which make user easy to use.
1.1	28
84.3	29	PS-NB-NA is powered by 8500mAh Li-SOCI2 battery, it is designed for long-term use up to severa years.
1.1	30
84.3	31	PS-NB-NA has optional built-in SIM card and default IoT server connection version. Which makes it works with simple configuration.
	32
	33
84.2	34	[[image:image-20230911140426-2.png\|\|height="320" width="951"]]
1.1	35
	36
	37	== 1.2 Features ==
	38
39.6	39
70.3	40	* NB-IoT Bands: B1/B2/B3/B4/B5/B8/B12/B13/B17/B18/B19/B20/B25/B28/B66/B70/B85 @H-FDD
1.1	41	* Ultra-low power consumption
84.4	42	* Liquid Level Measurement by Ultrasonic technology
	43	* Measure through container, No need to contact Liquid
	44	* Valid level range 20mm - 2000mm
	45	* Accuracy: ±(5mm+S*0.5%) (S: Measure Value)
70.3	46	* Multiply Sampling and one uplink
	47	* Support Bluetooth v5.1 remote configure and update firmware
1.1	48	* Uplink on periodically
	49	* Downlink to change configure
84.4	50	* IP66 Waterproof Enclosure
1.1	51	* 8500mAh Battery for long term use
70.3	52	* Nano SIM card slot for NB-IoT SIM
1.1	53
	54	== 1.3 Specification ==
	55
	56
82.28	57	(% style="color:blue" %)Common DC Characteristics:
1.1	58
84.4	59	* Supply Voltage: 2.5v ~~ 3.6v
1.1	60	* Operating Temperature: -40 ~~ 85°C
	61
82.28	62	(% style="color:blue" %)NB-IoT Spec:
1.1	63
82.28	64	(% style="color:#037691" %)NB-IoT Module: BC660K-GL
1.1	65
82.29	66	(% style="color:#037691" %)Support Bands:
70.4	67
	68	* B1 @H-FDD: 2100MHz
	69	* B2 @H-FDD: 1900MHz
	70	* B3 @H-FDD: 1800MHz
	71	* B4 @H-FDD: 2100MHz
	72	* B5 @H-FDD: 860MHz
	73	* B8 @H-FDD: 900MHz
	74	* B12 @H-FDD: 720MHz
	75	* B13 @H-FDD: 740MHz
	76	* B17 @H-FDD: 730MHz
	77	* B18 @H-FDD: 870MHz
	78	* B19 @H-FDD: 870MHz
	79	* B20 @H-FDD: 790MHz
	80	* B25 @H-FDD: 1900MHz
	81	* B28 @H-FDD: 750MHz
	82	* B66 @H-FDD: 2000MHz
	83	* B70 @H-FDD: 2000MHz
	84	* B85 @H-FDD: 700MHz
	85
82.28	86	(% style="color:blue" %)Battery:
1.1	87
	88	* Li/SOCI2 un-chargeable battery
	89	* Capacity: 8500mAh
70.5	90	* Self Discharge: <1% / Year @ 25°C
1.1	91	* Max continuously current: 130mA
	92	* Max boost current: 2A, 1 second
	93
82.28	94	(% style="color:blue" %)Power Consumption
1.1	95
70.4	96	* STOP Mode: 10uA @ 3.3v
	97	* Max transmit power: 350mA@3.3v
1.1	98
84.5	99	== 1.4 Suitable Container & Liquid ==
1.1	100
	101
84.5	102	* Solid Wall container such as: steel, iron, glass, ceramics, non-foaming plastics etc.
	103	* Container shape is regular, and surface is smooth.
	104	* Container Thickness:
	105	** Pure metal material. 2~~8mm, best is 3~~5mm
	106	** Pure non metal material: <10 mm
	107	* Pure liquid without irregular deposition.
70.5	108
84.5	109	(% style="display:none" %)
73.2	110
84.5	111	== 1.5 Install DDS20-NB ==
73.2	112
84.5	113
	114	(% style="color:blue" %)Step 1(%%): Choose the installation point.
	115
	116	DDS20-NB (% style="color:red" %)MUST(%%) be installed on the container bottom middle position.
	117
	118	[[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"]]
	119
	120
	121	(((
	122	(% style="color:blue" %)Step 2(%%): Polish the installation point.
	123	)))
	124
	125	(((
	126	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.
	127	)))
	128
	129	[[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"]]
	130
	131
	132	No polish needed if the container is shine metal surface without paint or non-metal container.
	133
	134	[[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"]]
	135
	136
	137	(((
	138	(% style="color:blue" %)Step3: (%%)Test the installation point.
	139	)))
	140
	141	(((
	142	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.
	143	)))
	144
	145	(((
	146	It is necessary to put the coupling paste between the sensor and the container, otherwise DDS20-NB won't detect the liquid level.
	147	)))
	148
	149	(((
	150	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.
	151	)))
	152
	153
	154	(((
	155	(% style="color:blue" %)LED Status:
	156	)))
	157
	158	* (((
	159	Onboard LED: When power on device, the onboard LED will fast blink 4 times which means detect the sensor well.
	160	)))
	161
	162	* (((
	163	(% 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.
	164	)))
	165	* (((
	166	(% style="color:blue" %)BLUE LED(% style="color:red" %) slowly blinking(%%): Sensor detects Liquid Level, The installation point is good.
	167	)))
	168
	169	(((
	170	DDS20-NB will enter into low power mode at 30 seconds after system reset or power on, Blue LED will be off after that.
	171	)))
	172
	173
	174	(((
	175	(% 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.
	176	)))
	177
	178
	179	(((
	180	(% style="color:blue" %)Step4: (%%)Install use Epoxy ab glue.
	181	)))
	182
	183	(((
	184	Prepare Eproxy AB glue.
	185	)))
	186
	187	(((
	188	Put Eproxy AB glue in the sensor and press it hard on the container installation point.
	189	)))
	190
	191	(((
	192	Reset DDS20-NB and see if the BLUE LED is slowly blinking.
	193	)))
	194
	195	[[image:image-20230809172509-1.png]]
	196
	197	(((
	198	(% style="color:red" %)Note :(% style="color:red; display:none" %)
	199
	200	(% 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.
	201	)))
	202
	203	(((
	204	(% 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.
	205	)))
	206
	207
	208	== 1.6 Applications ==
	209
	210
	211	* Smart liquid control solution
	212
	213	* Smart liquefied gas solution
	214
	215	== 1.7 Precautions ==
	216
	217
	218	* 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.
	219
	220	* 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.
	221
	222	* 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.
	223
	224	(% style="display:none" %)
	225
	226
	227
	228	== 1.8 Sleep mode and working mode ==
	229
	230
73.2	231	(% 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.
	232
	233	(% 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.
	234
	235
84.5	236	== 1.9 Button & LEDs ==
73.2	237
	238
6.1	239	[[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675071855856-879.png]]
1.1	240
	241
14.13	242	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
80.11	243	\|=(% 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	244	\|(% style="width:167px" %)Pressing ACT between 1s < time < 3s\|(% style="width:117px" %)Send an uplink\|(% style="width:225px" %)(((
73.2	245	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	246	Meanwhile, BLE module will be active and user can connect via BLE to configure device.
	247	)))
	248	\|(% style="width:167px" %)Pressing ACT for more than 3s\|(% style="width:117px" %)Active Device\|(% style="width:225px" %)(((
73.2	249	(% 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	250	(% style="color:green" %)Green led(%%) will solidly turn on for 5 seconds after joined in network.
73.2	251	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	252	)))
6.1	253	\|(% 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	254
84.5	255	== 1.10 BLE connection ==
1.1	256
	257
84.5	258	DDS20-NB support BLE remote configure and firmware update.
1.1	259
	260
	261	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:
	262
	263	* Press button to send an uplink
	264	* Press button to active device.
	265	* Device Power on or reset.
	266
	267	If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
	268
	269
84.5	270	== 1.11 Pin Definitions & Switch ==
1.1	271
73.3	272
73.2	273	[[image:image-20230819104805-5.png]]
1.1	274
43.1	275
84.5	276	=== 1.11.1 Jumper JP2 ===
43.1	277
73.3	278
	279	Power on Device when put this jumper.
	280
	281
84.5	282	=== 1.11.2 BOOT MODE / SW1 ===
73.3	283
	284
82.31	285	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	286
82.31	287	2) (% style="color:blue" %)Flash(%%): work mode, device starts to work and send out console output for further debug
73.3	288
	289
84.5	290	=== 1.11.3 Reset Button ===
73.3	291
80.2	292
73.3	293	Press to reboot the device.
	294
1.1	295	(% style="display:none" %)
	296
	297
80.2	298	= 2. Use S31-NB to communicate with IoT Server =
1.1	299
80.2	300	== 2.1 Send data to IoT server via NB-IoT network ==
1.1	301
	302
84.6	303	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	304
	305
80.2	306	Below shows the network structure:
1.1	307
84.6	308	[[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	309
	310
84.7	311	There are two version: (% style="color:blue" %)-GE(%%) and (% style="color:blue" %)-1D(%%) version of DDS20-NB.
1.1	312
	313
84.7	314	(% 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	315
82.19	316	* 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	317
82.19	318	* 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	319
80.2	320	Below shows result of different server as a glance.
1.1	321
80.9	322	(% border="1" cellspacing="4" style="width:515px" %)
81.2	323	\|(% 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	324	\|(% 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" %)(((
	325	(% style="text-align:center" %)
	326	[[image:image-20230819113244-8.png\|\|height="183" width="367"]]
	327	)))\|(% style="width:170px" %)
	328	\|(% 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" %)(((
	329	(% style="text-align:center" %)
82.25	330	[[image:image-20230819113244-9.png\|\|height="119" width="367"]]
82.24	331	)))\|(% style="width:170px" %)
80.9	332	\|(% 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" %)
	333	\|(% 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" %)
	334	\|(% 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	335	\|(% 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" %)(((
	336	(% style="text-align:center" %)
82.25	337	[[image:image-20230819113244-10.png\|\|height="104" width="367"]]
82.24	338	)))\|(% style="width:170px" %)
	339	\|(% 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" %)(((
	340	(% style="text-align:center" %)
82.25	341	[[image:image-20230819113244-11.png\|\|height="141" width="367"]]
82.24	342	)))\|(% style="width:170px" %)
80.2	343
84.7	344	(% 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	345
	346
	347	== 2.2 Payload Types ==
	348
	349
84.7	350	To meet different server requirement, DDS20-NB supports different payload type.
1.1	351
81.2	352	Includes:
1.1	353
82.21	354	* [[General JSON format payload>>\|\|anchor="H2.2.1GeneralJsonFormat28Type3D529"]]. (Type=5)
80.7	355
82.21	356	* [[HEX format Payload>>\|\|anchor="H2.2.2HEXformatPayload28Type3D029"]]. (Type=0)
80.7	357
82.21	358	* [[ThingSpeak Format>>\|\|anchor="H2.2.4ThingSpeakPayload28Type3D129"]]. (Type=1)
80.7	359
82.21	360	* [[ThingsBoard Format>>\|\|anchor="H2.2.3ThingsBoardPayload28Type3D329"]]. (Type=3)
1.1	361
80.3	362	User can specify the payload type when choose the connection protocol. Example:
1.1	363
81.2	364	(% style="color:#037691" %)AT+PRO=2,0 (%%) ~/~/ Use UDP Connection & hex Payload
1.1	365
80.8	366	(% style="color:#037691" %)AT+PRO=2,5 (%%) ~/~/ Use UDP Connection & Json Payload
1.1	367
81.2	368	(% style="color:#037691" %)AT+PRO=3,5 (%%) ~/~/ Use MQTT Connection & Json Payload
1.1	369
	370
82.20	371	=== 2.2.1 General Json Format(Type~=5) ===
1.1	372
80.8	373
80.3	374	This is the General Json Format. As below:
1.1	375
84.7	376	(% 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	377
	378
81.2	379	(% style="color:red" %)Notice, from above payload:
1.1	380
80.3	381	* Temperature , Humidity , Battery & Signal are the value at uplink time.
1.1	382
80.4	383	* 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	384
81.2	385	=== 2.2.2 HEX format Payload(Type~=0) ===
1.1	386
	387
80.3	388	This is the HEX Format. As below:
1.1	389
80.8	390	(% style="color:#4472c4" %)f86620705346276200640cba16010000000011011801e864d49c2d011a01e364d49925011901eb64d49871011901e564d497bd011a01e664d49709011901e964d49655011a01e864d495a1011a01e864d494ed011801e864d49439
1.1	391
81.2	392	[[image:1692424009971-458.png]]
6.1	393
1.1	394
80.4	395	(% style="color:blue" %)Version:
1.1	396
80.3	397	These bytes include the hardware and software version.
1.1	398
84.8	399	(% style="color:#037691" %)Higher byte:(%%) Specify Sensor Model: 0x00 for DDS20-NB
1.1	400
80.4	401	(% style="color:#037691" %)Lower byte:(%%) Specify the software version: 0x64=100, means firmware version 100
1.1	402
	403
81.2	404	(% style="color:blue" %)BAT (Battery Info):
1.1	405
80.3	406	Ex1: 0x0CBA = 3258mV
1.1	407
	408
80.4	409	(% style="color:blue" %)Signal Strength:
1.1	410
80.3	411	NB-IoT Network signal Strength.
1.1	412
80.3	413	Ex1: 0x16 = 22
1.1	414
80.3	415	0 -113dBm or less
1.1	416
80.3	417	1 -111dBm
1.1	418
80.3	419	2...30 -109dBm... -53dBm
1.1	420
80.3	421	31 -51dBm or greater
1.1	422
80.3	423	99 Not known or not detectable
1.1	424
	425
80.4	426	(% style="color:blue" %)TimeStamp:
1.1	427
80.3	428	Unit TimeStamp Example: 64d49439(H) = 1691653177(D)
1.1	429
80.3	430	Put the decimal value into this link(https:~/~/www.epochconverter.com/) to get the time.
1.1	431
	432
81.2	433	=== 2.2.3 ThingsBoard Payload(Type~=3) ===
1.1	434
80.8	435
80.3	436	Type3 payload special design for ThingsBoard, it will also configure other default server to ThingsBoard.
1.1	437
80.8	438	(% style="color:#4472c4" %){"IMEI":866207053462762,"temperature":29.2,"humidity":54.2,"battery":3.27,"signal":24}
46.1	439
1.1	440
81.2	441	=== 2.2.4 ThingSpeak Payload(Type~=1) ===
1.1	442
80.8	443
80.3	444	This payload meets ThingSpeak platform requirement. It includes only four fields. Form 1~~4 are:
1.1	445
80.3	446	Temperature, Humidity, Battery & Signal. This payload type only valid for ThingsSpeak Platform
14.22	447
80.3	448	As below:
1.1	449
80.8	450	(% style="color:#4472c4" %)field1=27.9&field2=49.9&field3=3.23&field4=28
1.1	451
10.1	452
80.4	453	== 2.3 Test Uplink and Change Update Interval ==
1.1	454
	455
80.4	456	By default, Sensor will send uplinks (% style="color:blue" %)every 2 hours(%%) & AT+NOUD=8
1.1	457
80.4	458	User can use below commands to change the (% style="color:blue" %)uplink interval.
1.1	459
82.2	460	(% style="color:#037691" %)AT+TDC=600 (%%) ~/~/ Set Update Interval to 600s
1.1	461
80.3	462	User can also push the button for more than 1 seconds to activate an uplink.
1.1	463
	464
80.4	465	== 2.4 Multi-Samplings and One uplink ==
39.5	466
80.4	467
84.8	468	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	469
82.6	470	* (% 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	471
82.12	472	* (% 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	473
80.3	474	The diagram below explains the relationship between TR, NOUD, and TDC more clearly:
1.1	475
82.2	476	[[image:1692424376354-959.png]]
1.1	477
	478
80.4	479	== 2.5 Humidity and Temperature alarm function ==
1.1	480
80.5	481
80.3	482	On each sampling define by AT+TR ( default 900s or 15 minutes), when the value exceed the range, it will trigger an Alarm and immediately sends a uplink.
39.5	483
1.1	484
80.4	485	(% style="color:blue" %)AT Commands:
1.1	486
80.4	487	(% style="color:#037691" %)AT+ SHHUM=min,max
1.1	488
82.6	489	Example: AT+ SHHUM=50,80 ~/~/ Alarm when humidity lower than 50 or higher than 80.
1.1	490
	491
80.4	492	(% style="color:#037691" %)AT+ SHTEMP=min,max
1.1	493
82.6	494	Example: AT+ SHTEMP=20,30 ~/~/ Alarm when temperature lower than 20 or higher than 30
1.1	495
	496
80.4	497	(% style="color:red" %)Notice:
1.1	498
80.4	499	* To disable Alarm, user can set min and max to same value , such as (% style="color:#037691" %)AT+SHTEMP=0,0.
1.1	500
80.4	501	* If user only want to send only min or max, user can set the alarm to a value that device won’t reach. For example: (% style="color:#037691" %)AT+SHTEMP=-80,0.
1.1	502
80.5	503	== 2.6 Trggier an uplink by external interrupt ==
	504
	505
80.3	506	S31-NB has an external trigger interrupt function. Users can use the PB15 pin to trigger the upload of data packets.
55.1	507
80.5	508	(% style="color:blue" %)AT command:
46.1	509
82.6	510	* (% style="color:#037691" %)AT+INTMOD (%%) ~/~/ Set the trigger interrupt mode
46.1	511
82.6	512	* (% style="color:#037691" %)AT+INTMOD=0 (%%) ~/~/ Disable Interrupt
1.1	513
82.6	514	* (% style="color:#037691" %)AT+INTMOD=1 (%%) ~/~/ Trigger by rising and falling edge
80.5	515
82.6	516	* (% style="color:#037691" %)AT+INTMOD=2 (%%) ~/~/ Trigger by falling edge
80.5	517
82.6	518	* (% style="color:#037691" %)AT+INTMOD=3 (%%) ~/~/ Trigger by rising edge
80.5	519
80.6	520	= 3. Configure S31x-NB =
1.1	521
16.4	522	== 3.1 Configure Methods ==
1.1	523
	524
80.6	525	S31x-NB supports below configure method:
1.1	526
	527	* AT Command via Bluetooth Connection (Recommended): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
80.6	528
11.1	529	* 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	530
82.8	531	== 3.2 AT Commands Set ==
1.1	532
	533
82.8	534	AT+<CMD>? : Help on <CMD>
1.1	535
82.8	536	AT+<CMD> : Run <CMD>
1.1	537
82.8	538	AT+<CMD>=<value> : Set the value
1.1	539
82.8	540	AT+<CMD>=? : Get the value
1.1	541
	542
82.10	543	(% style="color:blue" %)General Commands
1.1	544
82.8	545	AT : Attention
1.1	546
82.9	547	AT? : Short Help
1.1	548
82.9	549	ATZ : MCU Reset
1.1	550
82.9	551	AT+TDC : Application Data Transmission Interval
1.1	552
82.9	553	AT+CFG : Print all configurations
1.1	554
82.8	555	AT+CFGMOD : Working mode selection
1.1	556
82.9	557	AT+DEUI : Get or set the Device ID
1.1	558
82.8	559	AT+INTMOD : Set the trigger interrupt mode
1.1	560
82.8	561	AT+5VT : Set extend the time of 5V power
1.1	562
82.8	563	AT+PRO : Choose agreement
1.1	564
82.9	565	AT+RXDL : Extend the sending and receiving time
1.1	566
82.9	567	AT+DNSCFG : Get or Set DNS Server
1.1	568
82.8	569	AT+GETSENSORVALUE : Returns the current sensor measurement
1.1	570
82.9	571	AT+NOUD : Get or Set the number of data to be uploaded
1.1	572
82.8	573	AT+CDP : Read or Clear cached data
1.1	574
82.9	575	AT+SHTEMP: Get or Set alarm of temp
1.1	576
82.9	577	AT+SHHUM: Get or Set alarm of moisture
1.1	578
82.9	579	AT+SERVADDR : Server Address
1.1	580
82.9	581
82.10	582	(% style="color:blue" %)UDP Management
1.1	583
82.9	584	AT+CFM : Upload confirmation mode (only valid for UDP)
1.1	585
39.6	586
82.10	587	(% style="color:blue" %)MQTT Management
1.1	588
82.8	589	AT+CLIENT : Get or Set MQTT client
1.1	590
82.8	591	AT+UNAME : Get or Set MQTT Username
1.1	592
82.8	593	AT+PWD : Get or Set MQTT password
1.1	594
82.9	595	AT+PUBTOPIC : Get or Set MQTT publish topic
1.1	596
82.9	597	AT+SUBTOPIC : Get or Set MQTT subscription topic
1.1	598
	599
82.10	600	(% style="color:blue" %)Information
1.1	601
82.9	602	AT+FDR : Factory Data Reset
1.1	603
82.9	604	AT+PWORD : Serial Access Password
1.1	605
82.9	606	AT+LDATA : Get the last upload data
39.6	607
82.9	608	AT+CDP : Read or Clear cached data
1.1	609
82.9	610
16.4	611	= 4. Battery & Power Consumption =
14.45	612
1.1	613
82.11	614	S31x-NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
1.1	615
	616	[[Battery Info & Power Consumption Analyze>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
	617
	618
82.11	619	= 5. Firmware update =
1.1	620
	621
82.11	622	User can change device firmware to::
1.1	623
13.1	624	* Update with new features.
82.11	625
13.1	626	* Fix bugs.
1.1	627
82.13	628	Firmware and changelog can be downloaded from : [[Firmware download link>>https://www.dropbox.com/sh/fhb3uyl4gt6clru/AAAiZVTFcxrfE1JOOyfcgO9ha?dl=0]]
1.1	629
31.1	630	Methods to Update Firmware:
1.1	631
82.12	632	* (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	633
64.2	634	* 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	635
31.1	636	= 6. FAQ =
1.1	637
82.15	638	== 6.1 How can I access t BC660K-GL AT Commands? ==
1.1	639
	640
82.15	641	User can access to BC660K-GL directly and send AT Commands.
1.1	642
82.15	643	[[See BC660K-GL AT Command set>>url:https://www.dropbox.com/sh/5f6ssda5fum8rvs/AABT68l8ZzWOvZ5eg2qwOoFda?dl=0]]
1.1	644
	645
82.15	646	= 7. Order Info =
1.1	647
	648
82.15	649	Part Number: (% style="color:blue" %)S31-NB-XX / S31B-NB-XX
1.1	650
82.15	651	(% style="color:red" %)XX(%%):
1.1	652
82.15	653	* (% style="color:#037691" %)GE(%%): General version ( Exclude SIM card)
1.1	654
82.15	655	* (% style="color:#037691" %)1D(%%): with 1NCE* 10 years 500MB SIM card and Pre-configure to DataCake server
1.1	656
82.31	657	(% 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	658
	659
31.1	660	= 8. Packing Info =
1.1	661
39.6	662
39.1	663	(% style="color:#037691" %)Package Includes:
1.1	664
82.16	665	* S31-NB or S31-NB NB-IoT Sensor Node x 1
1.1	666
82.16	667	* External antenna x 1
	668
39.1	669	(% style="color:#037691" %)Dimension and weight:
1.1	670
82.24	671	* Device Size: 13.0 x 5 x 4.5 cm
1.1	672
82.24	673	* Device Weight: 150g
1.1	674
82.24	675	* Package Size / pcs : 14.0 x 8x 5 cm
1.1	676
82.24	677	* Weight / pcs : 180g
1.1	678
31.1	679	= 9. Support =
1.1	680
	681
31.1	682	* 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	683
	684	* 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	685
80.9	686	(% style="display:none" %) (%%)

Wiki source code of DDS20-NB -- NB-IoT Ultrasonic Liquid Level Sensor User Manual

Applications