Wiki source code of SW3L-NB -- NB-IoT Flow Sensor User Manual

Version 100.4 by Xiaoling on 2023/10/10 09:13

version	line-number	content
84.2	1	(% style="text-align:center" %)
100.2	2	[[image:image-20231010090810-1.png\|\|height="518" width="839"]]
1.1	3
	4
85.2	5
	6
	7
	8
	9
	10
82.23	11	Table of Contents:
30.1	12
1.1	13	{{toc/}}
	14
	15
	16
	17
	18
	19
31.1	20	= 1. Introduction =
1.1	21
100.3	22	== 1.1 What is SW3L-NB NB-IoT Flow Sensor ==
1.1	23
39.6	24
100.4	25	The Dragino SW3L-NB is a (% style="color:blue" %)NB-IoT Flow Sensor(%%). It detects water flow volume and uplink to IoT server via NB-IoT network. User can use this to (% style="color:blue" %)monitor the water usage for buildings.
1.1	26
100.4	27	The SW3L-NB will send water flow volume every 20 minutes. It can also detect the (% style="color:blue" %)water flow status and send Alarm(%%), to avoid the waste for water usage such as broken toilet case.
1.1	28
100.4	29	SW3L-NB is designed for both indoor and outdoor use. It has a weatherproof enclosure and industrial level battery to (% style="color:blue" %)work in low to high temperatures.
1.1	30
100.3	31	SW3L-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	32
100.3	33	SW3L-NB (% style="color:blue" %)supports BLE configure (%%)and(% style="color:blue" %) OTA update(%%) which make user easy to use.
1.1	34
100.3	35	SW3L-NB is powered by (% style="color:blue" %)8500mAh Li-SOCI2 battery(%%), it is designed for long-term use up to several years.
1.1	36
100.3	37	SW3L-NB has optional built-in SIM card and default IoT server connection version. Which makes it works with simple configuration.
	38
86.2	39	[[image:image-20230912102813-2.png\|\|height="320" width="923"]]
1.1	40
	41
	42	== 1.2 Features ==
	43
39.6	44
70.3	45	* NB-IoT Bands: B1/B2/B3/B4/B5/B8/B12/B13/B17/B18/B19/B20/B25/B28/B66/B70/B85 @H-FDD
1.1	46	* Ultra-low power consumption
86.4	47	* Distance Detection by Ultrasonic technology
	48	* Flat object range 30mm - 4500mm
	49	* Accuracy: ±(1cm+S*0.3%) (S: Distance)
	50	* Measure Angle: 60°
70.3	51	* Multiply Sampling and one uplink
	52	* Support Bluetooth v5.1 remote configure and update firmware
1.1	53	* Uplink on periodically
	54	* Downlink to change configure
84.4	55	* IP66 Waterproof Enclosure
1.1	56	* 8500mAh Battery for long term use
70.3	57	* Nano SIM card slot for NB-IoT SIM
1.1	58
	59	== 1.3 Specification ==
	60
	61
82.28	62	(% style="color:blue" %)Common DC Characteristics:
1.1	63
84.4	64	* Supply Voltage: 2.5v ~~ 3.6v
1.1	65	* Operating Temperature: -40 ~~ 85°C
	66
82.28	67	(% style="color:blue" %)NB-IoT Spec:
1.1	68
82.28	69	(% style="color:#037691" %)NB-IoT Module: BC660K-GL
1.1	70
82.29	71	(% style="color:#037691" %)Support Bands:
70.4	72
	73	* B1 @H-FDD: 2100MHz
	74	* B2 @H-FDD: 1900MHz
	75	* B3 @H-FDD: 1800MHz
	76	* B4 @H-FDD: 2100MHz
	77	* B5 @H-FDD: 860MHz
	78	* B8 @H-FDD: 900MHz
	79	* B12 @H-FDD: 720MHz
	80	* B13 @H-FDD: 740MHz
	81	* B17 @H-FDD: 730MHz
	82	* B18 @H-FDD: 870MHz
	83	* B19 @H-FDD: 870MHz
	84	* B20 @H-FDD: 790MHz
	85	* B25 @H-FDD: 1900MHz
	86	* B28 @H-FDD: 750MHz
	87	* B66 @H-FDD: 2000MHz
	88	* B70 @H-FDD: 2000MHz
	89	* B85 @H-FDD: 700MHz
	90
82.28	91	(% style="color:blue" %)Battery:
1.1	92
	93	* Li/SOCI2 un-chargeable battery
	94	* Capacity: 8500mAh
70.5	95	* Self Discharge: <1% / Year @ 25°C
1.1	96	* Max continuously current: 130mA
	97	* Max boost current: 2A, 1 second
	98
82.28	99	(% style="color:blue" %)Power Consumption
1.1	100
70.4	101	* STOP Mode: 10uA @ 3.3v
	102	* Max transmit power: 350mA@3.3v
1.1	103
86.5	104	== 1.4 Rated environmental conditions ==
1.1	105
	106
86.5	107	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:500px" %)
	108	\|(% style="background-color:#4f81bd; color:white; width:163px" %)Item\|(% style="background-color:#4f81bd; color:white; width:90px" %)Minimum value\|(% style="background-color:#4f81bd; color:white; width:70px" %)Typical value\|(% style="background-color:#4f81bd; color:white; width:87px" %)Maximum value\|(% style="background-color:#4f81bd; color:white; width:40px" %)Unit\|(% style="background-color:#4f81bd; color:white; width:50px" %)Remarks
	109	\|(% style="width:174px" %)Storage temperature\|(% style="width:86px" %)-25\|(% style="width:66px" %)25\|(% style="width:90px" %)80\|(% style="width:48px" %)℃\|(% style="width:203px" %)
	110	\|(% style="width:174px" %)Storage humidity\|(% style="width:86px" %) \|(% style="width:66px" %)65%\|(% style="width:90px" %)90%\|(% style="width:48px" %)RH\|(% style="width:203px" %)(1)
	111	\|(% style="width:174px" %)Operating temperature\|(% style="width:86px" %)-15\|(% style="width:66px" %)25\|(% style="width:90px" %)60\|(% style="width:48px" %)℃\|(% style="width:203px" %)
	112	\|(% style="width:174px" %)Working humidity\|(% style="width:86px" %)(((
	113
70.5	114
86.5	115
	116	)))\|(% style="width:66px" %)65%\|(% style="width:90px" %)80%\|(% style="width:48px" %)RH\|(% style="width:203px" %)(1)
73.2	117
84.5	118	(((
86.5	119	(% style="color:red" %)Remarks: (1) a. When the ambient temperature is 0-39 ℃, the maximum humidity is 90% (non-condensing);
84.5	120
86.5	121	(% style="color:red" %) b. When the ambient temperature is 40-50 ℃, the highest humidity is the highest humidity in the natural world at the current temperature (no condensation)
84.5	122
86.5	123
84.5	124	)))
	125
86.5	126	== 1.5 Effective measurement range Reference beam pattern ==
84.5	127
	128
86.5	129	(% style="color:blue" %)1. The tested object is a white cylindrical tube made of PVC, with a height of 100cm and a diameter of 7.5cm.
84.5	130
86.5	131	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654852253176-749.png?rev=1.1\|\|alt="1654852253176-749.png"]]
84.5	132
	133
86.5	134	(% style="color:blue" %)*2. The object to be tested is a "corrugated cardboard box" perpendicular to the central axis of 0 °, and the length width is 60cm * 50cm.**
84.5	135
86.5	136	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654852175653-550.png?rev=1.1\|\|alt="1654852175653-550.png"]]
84.5	137
	138
	139	== 1.6 Applications ==
	140
	141
86.5	142	* Horizontal distance measurement
	143	* Liquid level measurement
	144	* Parking management system
	145	* Object proximity and presence detection
	146	* Intelligent trash can management system
	147	* Robot obstacle avoidance
	148	* Automatic control
	149	* Sewer
	150	* Bottom water level monitoring
84.5	151
86.5	152	== 1.7 Sleep mode and working mode ==
84.5	153
	154
99.3	155	(% style="color:blue" %)Deep Sleep Mode: (%%)Sensor doesn't have any NB-IoT activate. This mode is used for storage and shipping to save battery life.
73.2	156
99.3	157	(% style="color:blue" %)Working Mode: (%%)In this mode, Sensor will work as NB-IoT Sensor to Join NB-IoT 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.
73.2	158
	159
86.5	160	== 1.8 Button & LEDs ==
73.2	161
	162
6.1	163	[[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675071855856-879.png]]
1.1	164
	165
14.13	166	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
80.11	167	\|=(% 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	168	\|(% style="width:167px" %)Pressing ACT between 1s < time < 3s\|(% style="width:117px" %)Send an uplink\|(% style="width:225px" %)(((
73.2	169	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	170	Meanwhile, BLE module will be active and user can connect via BLE to configure device.
	171	)))
	172	\|(% style="width:167px" %)Pressing ACT for more than 3s\|(% style="width:117px" %)Active Device\|(% style="width:225px" %)(((
73.2	173	(% 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	174	(% style="color:green" %)Green led(%%) will solidly turn on for 5 seconds after joined in network.
73.2	175	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	176	)))
6.1	177	\|(% 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	178
86.6	179	== 1.9 BLE connection ==
1.1	180
	181
86.7	182	DDS45-NB support BLE remote configure and firmware update.
1.1	183
	184
	185	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:
	186
	187	* Press button to send an uplink
	188	* Press button to active device.
	189	* Device Power on or reset.
	190
	191	If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
	192
	193
86.6	194	== 1.10 Pin Definitions & Switch ==
1.1	195
73.3	196
73.2	197	[[image:image-20230819104805-5.png]]
1.1	198
43.1	199
86.6	200	=== 1.10.1 Jumper JP2 ===
43.1	201
73.3	202
	203	Power on Device when put this jumper.
	204
	205
86.6	206	=== 1.10.2 BOOT MODE / SW1 ===
73.3	207
	208
82.31	209	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	210
82.31	211	2) (% style="color:blue" %)Flash(%%): work mode, device starts to work and send out console output for further debug
73.3	212
	213
86.6	214	=== 1.10.3 Reset Button ===
73.3	215
80.2	216
73.3	217	Press to reboot the device.
	218
1.1	219	(% style="display:none" %)
	220
	221
86.6	222	== 1.11 Mechanical ==
84.14	223
	224	[[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"]]
	225
	226	[[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"]]
	227
	228	[[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"]]
	229
	230
	231	(% style="color:blue" %)Probe Mechanical:
	232
86.6	233	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS45%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654915562090-396.png?rev=1.1\|\|alt="1654915562090-396.png"]]
84.14	234
	235
	236
86.6	237	= 2. Use DDS45-NB to communicate with IoT Server =
1.1	238
80.2	239	== 2.1 Send data to IoT server via NB-IoT network ==
1.1	240
	241
86.6	242	The DDS45-NB is equipped with a NB-IoT module, the pre-loaded firmware in DDS45-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 DDS45-NB.
1.1	243
	244
80.2	245	Below shows the network structure:
1.1	246
86.3	247	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DDS45-NB_NB-IoT_Distance_Detection_Sensor_User_Manual/WebHome/image-20230912102813-2.png?width=923&height=320&rev=1.1\|\|alt="image-20230912102813-2.png"]]
1.1	248
	249
86.3	250	There are two version: (% style="color:blue" %)-GE(%%) and (% style="color:blue" %)-1D(%%) version of DDS45-NB.
1.1	251
	252
86.7	253	(% 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 DDS45-NB send data to IoT server.
1.1	254
82.19	255	* 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	256
82.19	257	* 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	258
80.2	259	Below shows result of different server as a glance.
1.1	260
80.9	261	(% border="1" cellspacing="4" style="width:515px" %)
81.2	262	\|(% 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	263	\|(% 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" %)(((
	264	(% style="text-align:center" %)
	265	[[image:image-20230819113244-8.png\|\|height="183" width="367"]]
	266	)))\|(% style="width:170px" %)
	267	\|(% 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" %)(((
	268	(% style="text-align:center" %)
82.25	269	[[image:image-20230819113244-9.png\|\|height="119" width="367"]]
82.24	270	)))\|(% style="width:170px" %)
80.9	271	\|(% 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" %)
	272	\|(% 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" %)
	273	\|(% 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	274	\|(% 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" %)(((
	275	(% style="text-align:center" %)
82.25	276	[[image:image-20230819113244-10.png\|\|height="104" width="367"]]
82.24	277	)))\|(% style="width:170px" %)
	278	\|(% 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" %)(((
	279	(% style="text-align:center" %)
82.25	280	[[image:image-20230819113244-11.png\|\|height="141" width="367"]]
82.24	281	)))\|(% style="width:170px" %)
80.2	282
86.7	283	(% 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 DDS45-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	284
	285
	286	== 2.2 Payload Types ==
	287
	288
86.7	289	To meet different server requirement, DDS45-NB supports different payload type.
1.1	290
81.2	291	Includes:
1.1	292
82.21	293	* [[General JSON format payload>>\|\|anchor="H2.2.1GeneralJsonFormat28Type3D529"]]. (Type=5)
80.7	294
82.21	295	* [[HEX format Payload>>\|\|anchor="H2.2.2HEXformatPayload28Type3D029"]]. (Type=0)
80.7	296
82.21	297	* [[ThingSpeak Format>>\|\|anchor="H2.2.4ThingSpeakPayload28Type3D129"]]. (Type=1)
80.7	298
82.21	299	* [[ThingsBoard Format>>\|\|anchor="H2.2.3ThingsBoardPayload28Type3D329"]]. (Type=3)
1.1	300
80.3	301	User can specify the payload type when choose the connection protocol. Example:
1.1	302
81.2	303	(% style="color:#037691" %)AT+PRO=2,0 (%%) ~/~/ Use UDP Connection & hex Payload
1.1	304
80.8	305	(% style="color:#037691" %)AT+PRO=2,5 (%%) ~/~/ Use UDP Connection & Json Payload
1.1	306
81.2	307	(% style="color:#037691" %)AT+PRO=3,5 (%%) ~/~/ Use MQTT Connection & Json Payload
1.1	308
	309
82.20	310	=== 2.2.1 General Json Format(Type~=5) ===
1.1	311
80.8	312
80.3	313	This is the General Json Format. As below:
1.1	314
90.1	315	(% style="color:#4472c4" %){"IMEI":"866207058378443","Model":"DDS45-NB","distance":217,"battery":3.54,"signal":24,"1":{221,2023/09/20 09:47:01},"2":{0,2023/09/20 09:15:04},"3":{0,2023/09/20 09:00:04},"4":{0,2023/09/20 08:45:03},"5":{0,2023/09/20 08:30:03},"6":{0,2023/09/20 08:15:03},"7":{0,2023/09/20 08:00:04},"8":{0,2023/09/20 07:45:04}}
1.1	316
	317
92.1	318	[[image:image-20230920175015-3.png\|\|height="613" width="890"]]
90.1	319
	320
81.2	321	(% style="color:red" %)Notice, from above payload:
1.1	322
90.2	323	* Distance , Battery & Signal are the value at uplink time.
1.1	324
90.2	325	* 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): Distance, Sampling time.
1.1	326
81.2	327	=== 2.2.2 HEX format Payload(Type~=0) ===
1.1	328
	329
80.3	330	This is the HEX Format. As below:
1.1	331
88.2	332	(% style="color:#4472c4" %)f8662070583784430b640dda15010003a4650abc400000650ab8180000650ab4940000650ab10f0000650aad8b0000650aaa070000650aa6840000650aa3000000650a9308
1.1	333
90.1	334	[[image:image-20230920172200-1.png\|\|height="191" width="1047"]]
6.1	335
1.1	336
88.2	337	If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NB sensor uplink data.
	338
92.1	339	[[image:image-20230920173352-2.png\|\|height="636" width="919"]]
88.2	340
88.3	341
80.4	342	(% style="color:blue" %)Version:
1.1	343
80.3	344	These bytes include the hardware and software version.
1.1	345
88.3	346	(% style="color:#037691" %)Higher byte:(%%) Specify Sensor Model: 0x0b for DDS45-NB
1.1	347
88.3	348	(% style="color:#037691" %)Lower byte:(%%) Specify the software version: 0x64=100, means firmware version 1.0.0
1.1	349
	350
81.2	351	(% style="color:blue" %)BAT (Battery Info):
1.1	352
88.3	353	Ex1: 0x0dda = 3546mV
1.1	354
	355
80.4	356	(% style="color:blue" %)Signal Strength:
1.1	357
80.3	358	NB-IoT Network signal Strength.
1.1	359
88.3	360	Ex1: 0x15 = 21
1.1	361
80.3	362	0 -113dBm or less
1.1	363
80.3	364	1 -111dBm
1.1	365
80.3	366	2...30 -109dBm... -53dBm
1.1	367
80.3	368	31 -51dBm or greater
1.1	369
80.3	370	99 Not known or not detectable
1.1	371
	372
88.3	373	(% style="color:blue" %)Distance:
1.1	374
88.3	375	Ex1: 0x03a4 = 932 mm
1.1	376
	377
88.3	378	(% style="color:blue" %)Timestamp:
1.1	379
88.3	380	Unit Timestamp Example: 650abc40(H) = 1695202368(D)
	381
	382	Put the decimal value into this link([[https:~~/~~/www.epochconverter.com)>>https://www.epochconverter.com]]) to get the time.
	383
	384
81.2	385	=== 2.2.3 ThingsBoard Payload(Type~=3) ===
1.1	386
80.8	387
80.3	388	Type3 payload special design for ThingsBoard, it will also configure other default server to ThingsBoard.
1.1	389
99.1	390	(% style="color:#4472c4" %) {"IMEI": "866207058378443","Model": "DDS45-NB","distance": 502,"battery": 3.57,"signal": 23}
46.1	391
99.1	392	[[image:image-20230922094043-2.png\|\|height="558" width="851"]]
1.1	393
99.1	394
	395	=== ===
	396
81.2	397	=== 2.2.4 ThingSpeak Payload(Type~=1) ===
1.1	398
80.8	399
93.2	400	This payload meets ThingSpeak platform requirement. It includes only four fields. Form 1~~3 are:
1.1	401
90.2	402	Distance, Battery & Signal. This payload type only valid for ThingsSpeak Platform
14.22	403
80.3	404	As below:
1.1	405
92.1	406	(% style="color:#4472c4" %)field1=Distance value&field2=Battery value&field3=Singal value
1.1	407
92.1	408	[[image:image-20230921104741-1.png\|\|height="565" width="826"]]
84.24	409
92.1	410
84.15	411	== 2.3 Uplink Payload ==
10.1	412
1.1	413
84.15	414	(((
86.7	415	DDS45-NB will uplink payload via LoRaWAN with below payload format:
84.15	416	)))
1.1	417
84.15	418	(((
93.3	419	Uplink payload includes in total 21 bytes.
84.15	420	)))
	421
	422	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
93.3	423	\|=(% style="width: 95px; background-color:#4F81BD;color:white" %)Size(bytes)\|=(% style="width: 61px; background-color:#4F81BD;color:white" %)8\|=(% 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: rgb(79, 129, 189); color: white; width: 49px;" %)1\|=(% style="background-color: rgb(79, 129, 189); color: white; width: 79px;" %)1\|=(% style="background-color:#4F81BD;color:white" %)2\|=(% style="background-color:#4F81BD;color:white" %)4
	424	\|(% style="width:95px" %)Value\|(% style="width:61px" %)f+IMEI\|(% style="width:61px" %)Ver\|(% style="width:61px" %)[[BAT>>\|\|anchor="H2.3.1A0BatteryInfo"]]\|(% style="width:61px" %)(((
	425	Singal
84.15	426
93.3	427	Strength
94.2	428	)))\|(% style="width:49px" %)Mod\|(% style="width:79px" %)[[Digital Interrupt >>\|\|anchor="H2.3.2A0Interrupt"]]\|(% style="width:61px" %)[[Distance>>\|\|anchor="H2.3.3A0Distance"]](unit: mm)\|(% style="width:61px" %)(((
	429	Timestamp
93.3	430
94.2	431
	432	)))
	433
	434	If the cache upload mechanism is turned on, you will receive the payload shown in the figure below.
	435
	436	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:512px" %)
	437	\|(% style="width:115px" %)Frame header\|(% style="width:118px" %)Frame data(1)\|(% style="width:116px" %)Frame data(2)\|(% style="width:39px" %)F…\|(% style="width:117px" %)Frame data(X)
	438
93.3	439	=== ===
	440
84.20	441	=== 2.3.1 Battery Info ===
84.15	442
	443
86.7	444	Check the battery voltage for DDS45-NB.
84.15	445
	446	Ex1: 0x0B45 = 2885mV
	447
	448	Ex2: 0x0B49 = 2889mV
	449
	450
93.3	451	=== 2.3.2 Interrupt ===
84.15	452
	453
84.16	454	This data field shows if this packet is generated by interrupt or not.
84.15	455
	456	Example:
	457
	458	0x00: Normal uplink packet.
	459
	460	0x01: Interrupt Uplink Packet.
	461
	462
93.3	463	=== 2.3.3 Distance ===
84.15	464
	465
93.3	466	(((
	467	Get the distance. Flat object range 30mm - 4500mm.
	468	)))
84.15	469
93.3	470	(((
	471	For example, if the data you get from the register is 0x0B 0x05, the distance between the sensor and the measured object is(% style="color:#4472c4" %)
84.15	472
93.3	473	(% style="color:blue" %)0B05(H) = 2821 (D) = 2821 mm.
	474	)))
84.15	475
93.3	476	* If the sensor value is 0x0000, it means system doesn't detect ultrasonic sensor.
84.15	477
93.3	478	* If the sensor value lower than 0x001E (30mm), the sensor value will be 0x00.
84.15	479
	480	(((
	481
	482	)))
	483
	484	== 2.4 Test Uplink and Change Update Interval ==
	485
	486
80.4	487	By default, Sensor will send uplinks (% style="color:blue" %)every 2 hours(%%) & AT+NOUD=8
1.1	488
80.4	489	User can use below commands to change the (% style="color:blue" %)uplink interval.
1.1	490
82.2	491	(% style="color:#037691" %)AT+TDC=600 (%%) ~/~/ Set Update Interval to 600s
1.1	492
80.3	493	User can also push the button for more than 1 seconds to activate an uplink.
1.1	494
	495
84.15	496	== 2.5 Multi-Samplings and One uplink ==
39.5	497
80.4	498
90.2	499	To save battery life, DDS45-NB will sample Distance 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	500
82.6	501	* (% 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	502
82.12	503	* (% 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	504
80.3	505	The diagram below explains the relationship between TR, NOUD, and TDC more clearly:
1.1	506
82.2	507	[[image:1692424376354-959.png]]
1.1	508
	509
84.15	510	== 2.6 Trggier an uplink by external interrupt ==
1.1	511
80.5	512
86.7	513	DDS45-NB has an external trigger interrupt function. Users can use the PB15 pin to trigger the upload of data packets.
39.5	514
80.5	515	(% style="color:blue" %)AT command:
46.1	516
82.6	517	* (% style="color:#037691" %)AT+INTMOD (%%) ~/~/ Set the trigger interrupt mode
46.1	518
82.6	519	* (% style="color:#037691" %)AT+INTMOD=0 (%%) ~/~/ Disable Interrupt
1.1	520
82.6	521	* (% style="color:#037691" %)AT+INTMOD=1 (%%) ~/~/ Trigger by rising and falling edge
80.5	522
82.6	523	* (% style="color:#037691" %)AT+INTMOD=2 (%%) ~/~/ Trigger by falling edge
80.5	524
82.6	525	* (% style="color:#037691" %)AT+INTMOD=3 (%%) ~/~/ Trigger by rising edge
80.5	526
86.7	527	= 3. Configure DDS45-NB =
1.1	528
16.4	529	== 3.1 Configure Methods ==
1.1	530
	531
86.7	532	DDS45-NB supports below configure method:
1.1	533
	534	* AT Command via Bluetooth Connection (Recommended): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
80.6	535
11.1	536	* 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	537
82.8	538	== 3.2 AT Commands Set ==
1.1	539
	540
82.8	541	AT+<CMD>? : Help on <CMD>
1.1	542
82.8	543	AT+<CMD> : Run <CMD>
1.1	544
82.8	545	AT+<CMD>=<value> : Set the value
1.1	546
82.8	547	AT+<CMD>=? : Get the value
1.1	548
	549
82.10	550	(% style="color:blue" %)General Commands
1.1	551
82.8	552	AT : Attention
1.1	553
82.9	554	AT? : Short Help
1.1	555
82.9	556	ATZ : MCU Reset
1.1	557
82.9	558	AT+TDC : Application Data Transmission Interval
1.1	559
82.9	560	AT+CFG : Print all configurations
1.1	561
82.8	562	AT+CFGMOD : Working mode selection
1.1	563
82.9	564	AT+DEUI : Get or set the Device ID
1.1	565
82.8	566	AT+INTMOD : Set the trigger interrupt mode
1.1	567
82.8	568	AT+5VT : Set extend the time of 5V power
1.1	569
82.8	570	AT+PRO : Choose agreement
1.1	571
82.9	572	AT+RXDL : Extend the sending and receiving time
1.1	573
82.9	574	AT+DNSCFG : Get or Set DNS Server
1.1	575
82.8	576	AT+GETSENSORVALUE : Returns the current sensor measurement
1.1	577
82.9	578	AT+NOUD : Get or Set the number of data to be uploaded
1.1	579
82.8	580	AT+CDP : Read or Clear cached data
1.1	581
82.9	582	AT+SHTEMP: Get or Set alarm of temp
1.1	583
82.9	584	AT+SHHUM: Get or Set alarm of moisture
1.1	585
82.9	586	AT+SERVADDR : Server Address
1.1	587
82.9	588
82.10	589	(% style="color:blue" %)UDP Management
1.1	590
82.9	591	AT+CFM : Upload confirmation mode (only valid for UDP)
1.1	592
39.6	593
82.10	594	(% style="color:blue" %)MQTT Management
1.1	595
82.8	596	AT+CLIENT : Get or Set MQTT client
1.1	597
82.8	598	AT+UNAME : Get or Set MQTT Username
1.1	599
82.8	600	AT+PWD : Get or Set MQTT password
1.1	601
82.9	602	AT+PUBTOPIC : Get or Set MQTT publish topic
1.1	603
82.9	604	AT+SUBTOPIC : Get or Set MQTT subscription topic
1.1	605
	606
82.10	607	(% style="color:blue" %)Information
1.1	608
82.9	609	AT+FDR : Factory Data Reset
1.1	610
82.9	611	AT+PWORD : Serial Access Password
1.1	612
82.9	613	AT+LDATA : Get the last upload data
39.6	614
82.9	615	AT+CDP : Read or Clear cached data
1.1	616
82.9	617
16.4	618	= 4. Battery & Power Consumption =
14.45	619
1.1	620
86.7	621	DDS45-NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
1.1	622
	623	[[Battery Info & Power Consumption Analyze>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
	624
	625
82.11	626	= 5. Firmware update =
1.1	627
	628
82.11	629	User can change device firmware to::
1.1	630
13.1	631	* Update with new features.
82.11	632
13.1	633	* Fix bugs.
1.1	634
86.10	635	Firmware and changelog can be downloaded from : [[Firmware download link>>https://www.dropbox.com/sh/l0bszumyrmil3yv/AAAg8LYGeAgDsD_ycCnweD72a?dl=0]]
1.1	636
31.1	637	Methods to Update Firmware:
1.1	638
82.12	639	* (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	640
64.2	641	* 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	642
31.1	643	= 6. FAQ =
1.1	644
82.15	645	== 6.1 How can I access t BC660K-GL AT Commands? ==
1.1	646
	647
82.15	648	User can access to BC660K-GL directly and send AT Commands.
1.1	649
82.15	650	[[See BC660K-GL AT Command set>>url:https://www.dropbox.com/sh/5f6ssda5fum8rvs/AABT68l8ZzWOvZ5eg2qwOoFda?dl=0]]
1.1	651
	652
86.7	653	== 6.2 Can I use DDS45-NB in condensation environment? ==
1.1	654
	655
86.7	656	DDS45-NB is not suitable to be used in condensation environment. Condensation on the DDS45-NB probe will affect the reading and always got 0.
84.16	657
	658
86.7	659	= 7. Trouble Shooting =
84.24	660
86.7	661	== 7.1 Why does the sensor reading show 0 or "No sensor" ==
84.16	662
86.7	663
	664	~1. The measurement object is very close to the sensor, but in the blind spot of the sensor.
	665
	666	2. Sensor wiring is disconnected
	667
	668	3. Not using the correct decoder
	669
	670
	671	== 7.2 Abnormal readings The gap between multiple readings is too large or the gap between the readings and the actual value is too large ==
	672
	673
	674	1) Please check if there is something on the probe affecting its measurement (condensed water, volatile oil, etc.)
	675
	676	2) Does it change with temperature, temperature will affect its measurement
	677
	678	3) If abnormal data occurs, you can turn on DEBUG mode, Please use downlink or AT COMMAN to enter DEBUG mode.
	679
	680	downlink command: (% style="color:blue" %)F1 01(%%), AT command: (% style="color:blue" %)AT+DDEBUG=1
	681
	682	4) After entering the debug mode, it will send 20 pieces of data at a time, and you can send its uplink to us for analysis
	683
	684	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/image-20230113135125-2.png?width=1057&height=136&rev=1.1\|\|alt="image-20230113135125-2.png"]]
	685
	686
	687	Its original payload will be longer than other data. Even though it is being parsed, it can be seen that it is abnormal data.
	688
	689	Please send the data to us for check.
	690
	691
84.16	692	= 8. Order Info =
	693
	694
86.7	695	Part Number: (% style="color:blue" %)DDS45-NB-XX
1.1	696
82.15	697	(% style="color:red" %)XX(%%):
1.1	698
82.15	699	* (% style="color:#037691" %)GE(%%): General version ( Exclude SIM card)
1.1	700
82.15	701	* (% style="color:#037691" %)1D(%%): with 1NCE* 10 years 500MB SIM card and Pre-configure to DataCake server
1.1	702
82.31	703	(% 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	704
	705
84.16	706	= 9. Packing Info =
1.1	707
39.6	708
39.1	709	(% style="color:#037691" %)Package Includes:
1.1	710
86.12	711	* DDS45-NB NB-IoT Distance Detection sensor x 1
1.1	712
82.16	713	* External antenna x 1
	714
39.1	715	(% style="color:#037691" %)Dimension and weight:
1.1	716
82.24	717	* Device Size: 13.0 x 5 x 4.5 cm
1.1	718
82.24	719	* Device Weight: 150g
1.1	720
82.24	721	* Package Size / pcs : 14.0 x 8x 5 cm
1.1	722
82.24	723	* Weight / pcs : 180g
1.1	724
84.16	725	= 10. Support =
1.1	726
	727
31.1	728	* 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	729
	730	* 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	731
80.9	732	(% style="display:none" %) (%%)

Wiki source code of SW3L-NB -- NB-IoT Flow Sensor User Manual

Applications