Wiki source code of NDDS75 NB-IoT Distance Detect Sensor User Manual

Version 84.1 by Xiaoling on 2022/07/09 09:34

version	line-number	content
74.2	1	(% style="text-align:center" %)
	2	[[image:image-20220709085040-1.png\|\|height="542" width="524"]]
1.1	3
	4
	5
35.25	6
	7
35.4	8	Table of Contents:
1.1	9
	10
	11
	12
	13
31.17	14
65.3	15
44.2	16	= 1. Introduction =
1.1	17
67.2	18	== 1.1 What is NDDS75 Distance Detection Sensor ==
1.1	19
12.2	20	(((
35.4	21
	22
65.9	23	(((
68.2	24	The Dragino NDDS75 is a (% style="color:blue" %)NB-IoT Distance Detection Sensor(%%) for Internet of Things solution. It is designed to measure the distance between the sensor and a flat object. The distance detection sensor is a module that uses ultrasonic sensing technology for distance measurement, and temperature compensation is performed internally to improve the reliability of data.
	25	\\The NDDS75 can be applied to scenarios such as horizontal distance measurement, liquid level measurement, parking management system, object proximity and presence detection, intelligent trash can management system, robot obstacle avoidance, automatic control, sewer, bottom water level monitoring, etc. It detects the distance between the measured object and the sensor, and uploads the value via wireless to IoT Server via NB-IoT Network.
	26	\\NarrowBand-Internet of Things (NB-IoT) is a standards-based low power wide area (LPWA) technology developed to enable a wide range of new IoT devices and services. NB-IoT significantly improves the power consumption of user devices, system capacity and spectrum efficiency, especially in deep coverage.
	27	\\NDDS75 supports different uplink methods include (% style="color:blue" %)TCP, MQTT, UDP and CoAP (%%)for different application requirement.
	28	\\NDDS75 is powered by (% style="color:blue" %)8500mAh Li-SOCI2 battery(%%), It is designed for long term use up to 5 years. (Actually Battery life depends on the use environment, update period & uplink method)
	29	\\To use NDDS75, user needs to check if there is NB-IoT coverage in local area and with the bands NDDS75 supports. If the local operate support it, user needs to get a NB-IoT SIM card from local operator and install NDDS75 to get NB-IoT network connection.
65.9	30	)))
4.2	31
42.2	32
12.2	33	)))
4.2	34
12.2	35	[[image:1654503236291-817.png]]
4.2	36
	37
75.2	38	[[image:1657327959271-447.png]]
4.2	39
	40
	41
65.3	42	== 1.2 Features ==
13.3	43
75.3	44
44.2	45	* NB-IoT Bands: B1/B3/B8/B5/B20/B28 @H-FDD
75.3	46	* Ultra low power consumption
	47	* Distance Detection by Ultrasonic technology
	48	* Flat object range 280mm - 7500mm
	49	* Accuracy: ±(1cm+S*0.3%) (S: Distance)
	50	* Cable Length: 25cm
4.2	51	* AT Commands to change parameters
	52	* Uplink on periodically
	53	* Downlink to change configure
	54	* IP66 Waterproof Enclosure
44.2	55	* Micro SIM card slot for NB-IoT SIM
	56	* 8500mAh Battery for long term use
4.2	57
75.3	58
	59
44.2	60	== 1.3 Specification ==
	61
	62
	63	(% style="color:#037691" %)Common DC Characteristics:
	64
	65	* Supply Voltage: 2.1v ~~ 3.6v
	66	* Operating Temperature: -40 ~~ 85°C
	67
	68	(% style="color:#037691" %)NB-IoT Spec:
	69
	70	* - B1 @H-FDD: 2100MHz
	71	* - B3 @H-FDD: 1800MHz
	72	* - B8 @H-FDD: 900MHz
	73	* - B5 @H-FDD: 850MHz
	74	* - B20 @H-FDD: 800MHz
	75	* - B28 @H-FDD: 700MHz
	76
65.2	77
75.3	78	(% style="color:#037691" %)Battery:
4.2	79
75.3	80	* Li/SOCI2 un-chargeable battery
	81	* Capacity: 8500mAh
	82	* Self Discharge: <1% / Year @ 25°C
	83	* Max continuously current: 130mA
	84	* Max boost current: 2A, 1 second
14.2	85
4.2	86
75.3	87	(% style="color:#037691" %)Power Consumption
4.2	88
75.3	89	* STOP Mode: 10uA @ 3.3v
	90	* Max transmit power: 350mA@3.3v
	91
	92
	93
	94
44.2	95	== 1.4 Applications ==
4.2	96
75.4	97	* Smart Buildings & Home Automation
	98	* Logistics and Supply Chain Management
	99	* Smart Metering
4.2	100	* Smart Agriculture
75.4	101	* Smart Cities
	102	* Smart Factory
4.2	103
15.6	104	(% class="wikigeneratedid" id="H200B1.5FirmwareChangelog" %)
	105
4.2	106
75.4	107
	108
44.2	109	== 1.5 Pin Definitions ==
15.6	110
	111
76.2	112	[[image:1657328609906-564.png]]
4.2	113
14.3	114
	115
76.2	116
81.2	117	= 2. Use NDDS75 to communicate with IoT Server =
14.3	118
45.2	119	== 2.1 How it works ==
14.3	120
15.3	121	(((
77.2	122	The NDDS75 is equipped with a NB-IoT module, the pre-loaded firmware in NDDS75 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 NDDS75.
15.3	123	)))
4.2	124
45.2	125
15.3	126	(((
77.2	127	The diagram below shows the working flow in default firmware of NDDS75:
15.3	128	)))
4.2	129
77.2	130	(((
	131
	132	)))
4.2	133
77.2	134	[[image:1657328659945-416.png]]
	135
45.2	136	(((
	137
	138	)))
4.2	139
45.2	140
81.2	141	== 2.2 Configure the NDDS75 ==
4.2	142
48.2	143
45.4	144	=== 2.2.1 Test Requirement ===
4.2	145
65.10	146	(((
81.2	147	To use NDDS75 in your city, make sure meet below requirements:
65.10	148	)))
4.2	149
45.4	150	* Your local operator has already distributed a NB-IoT Network there.
	151	* The local NB-IoT network used the band that NSE01 supports.
	152	* Your operator is able to distribute the data received in their NB-IoT network to your IoT server.
4.2	153
48.2	154	(((
81.2	155	Below figure shows our testing structure. Here we have NB-IoT network coverage by China Mobile, the band they use is B8. The NDDS75 will use CoAP((% style="color:red" %)120.24.4.116:5683)(%%) or raw UDP((% style="color:red" %)120.24.4.116:5601)(%%) or MQTT((% style="color:red" %)120.24.4.116:1883)(%%)or TCP((% style="color:red" %)120.24.4.116:5600)(%%)protocol to send data to the test server
48.2	156	)))
4.2	157
	158
81.2	159	[[image:1657328756309-230.png]]
4.2	160
	161
	162
45.5	163	=== 2.2.2 Insert SIM card ===
4.2	164
65.11	165	(((
45.4	166	Insert the NB-IoT Card get from your provider.
65.11	167	)))
4.2	168
65.11	169	(((
45.4	170	User need to take out the NB-IoT module and insert the SIM card like below:
65.11	171	)))
4.2	172
	173
81.2	174	[[image:1657328884227-504.png]]
4.2	175
	176
48.2	177
81.2	178	=== 2.2.3 Connect USB – TTL to NDDS75 to configure it ===
4.2	179
48.2	180	(((
	181	(((
81.2	182	User need to configure NDDS75 via serial port to set the (% style="color:blue" %)Server Address / Uplink Topic (%%)to define where and how-to uplink packets. NDDS75 support AT Commands, user can use a USB to TTL adapter to connect to NDDS75 and use AT Commands to configure it, as below.
48.2	183	)))
	184	)))
19.2	185
81.2	186	[[image:image-20220709092052-2.png]]
4.2	187
48.2	188	Connection:
4.2	189
45.6	190	(% style="background-color:yellow" %)USB TTL GND <~-~-~-~-> GND
4.2	191
45.6	192	(% style="background-color:yellow" %)USB TTL TXD <~-~-~-~-> UART_RXD
4.2	193
45.6	194	(% style="background-color:yellow" %)USB TTL RXD <~-~-~-~-> UART_TXD
4.2	195
	196
45.4	197	In the PC, use below serial tool settings:
	198
57.4	199	* Baud: (% style="color:green" %)9600
48.2	200	* Data bits: (% style="color:green" %)8(%%)
	201	* Stop bits: (% style="color:green" %)1
57.4	202	* Parity: (% style="color:green" %)None
48.2	203	* Flow Control: (% style="color:green" %)None
45.4	204
48.2	205	(((
81.2	206	Make sure the switch is in FLASH position, then power on device by connecting the jumper on NDDS75. NDDS75 will output system info once power on as below, we can enter the (% style="color:green" %)password: 12345678(%%) to access AT Command input.
48.2	207	)))
45.4	208
81.2	209	[[image:1657329814315-101.png]]
45.4	210
65.12	211	(((
81.2	212	(% style="color:red" %)Note: the valid AT Commands can be found at: (%%)[[https:~~/~~/www.dragino.com/downloads/index.php?dir=NB-IoT/NDDS75/>>url:https://www.dragino.com/downloads/index.php?dir=NB-IoT/NDDS75/]]
65.12	213	)))
45.4	214
	215
	216
48.2	217	=== 2.2.4 Use CoAP protocol to uplink data ===
45.4	218
56.2	219	(% style="color:red" %)Note: if you don't have CoAP server, you can refer this link to set up one: (%%)[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Set%20up%20CoAP%20Server/>>http://wiki.dragino.com/xwiki/bin/view/Main/Set%20up%20CoAP%20Server/]]
45.4	220
	221
50.2	222	Use below commands:
45.4	223
48.2	224	* (% style="color:blue" %)AT+PRO=1 (%%) ~/~/ Set to use CoAP protocol to uplink
	225	* (% style="color:blue" %)AT+SERVADDR=120.24.4.116,5683 (%%)~/~/ to set CoAP server address and port
	226	* (% style="color:blue" %)AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0" (%%) ~/~/Set COAP resource path
45.4	227
	228	For parameter description, please refer to AT command set
	229
50.2	230	[[image:1657249793983-486.png]]
45.4	231
	232
48.2	233	After configure the server address and (% style="color:green" %)reset the device(%%) (via AT+ATZ ), NSE01 will start to uplink sensor values to CoAP server.
45.4	234
50.2	235	[[image:1657249831934-534.png]]
45.4	236
	237
50.2	238
45.6	239	=== 2.2.5 Use UDP protocol to uplink data(Default protocol) ===
45.4	240
	241	This feature is supported since firmware version v1.0.1
	242
	243
48.2	244	* (% style="color:blue" %)AT+PRO=2 (%%) ~/~/ Set to use UDP protocol to uplink
	245	* (% style="color:blue" %)AT+SERVADDR=120.24.4.116,5601 (%%) ~/~/ to set UDP server address and port
	246	* (% style="color:blue" %)AT+CFM=1 (%%) ~/~/If the server does not respond, this command is unnecessary
45.4	247
52.2	248	[[image:1657249864775-321.png]]
45.4	249
	250
52.2	251	[[image:1657249930215-289.png]]
45.4	252
	253
52.3	254
45.7	255	=== 2.2.6 Use MQTT protocol to uplink data ===
45.4	256
	257	This feature is supported since firmware version v110
	258
	259
54.3	260	* (% style="color:blue" %)AT+PRO=3 (%%) ~/~/Set to use MQTT protocol to uplink
	261	* (% style="color:blue" %)AT+SERVADDR=120.24.4.116,1883 (%%) ~/~/Set MQTT server address and port
	262	* (% style="color:blue" %)AT+CLIENT=CLIENT (%%)~/~/Set up the CLIENT of MQTT
57.2	263	* (% style="color:blue" %)AT+UNAME=UNAME (%%)~/~/Set the username of MQTT
	264	* (% style="color:blue" %)AT+PWD=PWD (%%)~/~/Set the password of MQTT
	265	* (% style="color:blue" %)AT+PUBTOPIC=NSE01_PUB (%%)~/~/Set the sending topic of MQTT
54.3	266	* (% style="color:blue" %)AT+SUBTOPIC=NSE01_SUB (%%) ~/~/Set the subscription topic of MQTT
45.4	267
54.2	268	[[image:1657249978444-674.png]]
45.4	269
54.2	270
	271	[[image:1657249990869-686.png]]
	272
45.4	273
54.3	274	(((
45.4	275	MQTT protocol has a much higher power consumption compare vs UDP / CoAP protocol. Please check the power analyze document and adjust the uplink period to a suitable interval.
54.3	276	)))
45.4	277
	278
54.3	279
45.7	280	=== 2.2.7 Use TCP protocol to uplink data ===
45.4	281
	282	This feature is supported since firmware version v110
	283
	284
56.2	285	* (% style="color:blue" %)AT+PRO=4 (%%) ~/~/ Set to use TCP protocol to uplink
48.2	286	* (% style="color:blue" %)AT+SERVADDR=120.24.4.116,5600 (%%) ~/~/ to set TCP server address and port
45.4	287
56.2	288	[[image:1657250217799-140.png]]
45.4	289
	290
56.2	291	[[image:1657250255956-604.png]]
45.4	292
	293
57.6	294
45.7	295	=== 2.2.8 Change Update Interval ===
45.4	296
48.2	297	User can use below command to change the (% style="color:green" %)uplink interval.
45.4	298
56.3	299	* (% style="color:blue" %)AT+TDC=600 (%%)~/~/ Set Update Interval to 600s
45.4	300
56.3	301	(((
48.2	302	(% style="color:red" %)NOTE:
56.3	303	)))
45.4	304
56.3	305	(((
45.7	306	(% style="color:red" %)1. By default, the device will send an uplink message every 1 hour.
56.3	307	)))
45.4	308
	309
	310
57.2	311	== 2.3 Uplink Payload ==
4.2	312
57.2	313	In this mode, uplink payload includes in total 18 bytes
32.9	314
57.2	315	(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %)
65.12	316	\|=(% style="width: 60px;" %)(((
57.2	317	Size(bytes)
65.12	318	)))\|=(% style="width: 50px;" %)6\|=(% style="width: 25px;" %)2\|=(% style="width: 25px;" %)2\|=(% style="width: 70px;" %)1\|=(% style="width: 60px;" %)2\|=(% style="width: 80px;" %)2\|=(% style="width: 90px;" %)2\|=(% style="width: 50px;" %)1
65.4	319	\|(% style="width:97px" %)Value\|(% style="width:83px" %)[[Device ID>>\|\|anchor="H2.4.1A0A0DeviceID"]]\|(% style="width:41px" %)[[Ver>>\|\|anchor="H2.4.2A0VersionInfo"]]\|(% style="width:46px" %)[[BAT>>\|\|anchor="H2.4.3A0BatteryInfo"]]\|(% style="width:123px" %)[[Signal Strength>>\|\|anchor="H2.4.4A0SignalStrength"]]\|(% style="width:108px" %)[[Soil Moisture>>\|\|anchor="H2.4.5A0SoilMoisture"]]\|(% style="width:133px" %)[[Soil Temperature>>\|\|anchor="H2.4.6A0SoilTemperature"]]\|(% style="width:159px" %)[[Soil Conductivity(EC)>>\|\|anchor="H2.4.7A0SoilConductivity28EC29"]]\|(% style="width:80px" %)[[Interrupt>>\|\|anchor="H2.4.8A0DigitalInterrupt"]]
57.2	320
65.13	321	(((
57.2	322	If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NSE01 uplink data.
65.13	323	)))
57.2	324
	325
	326	[[image:image-20220708111918-4.png]]
	327
	328
	329	The payload is ASCII string, representative same HEX:
	330
	331	0x72403155615900640c7817075e0a8c02f900 where:
	332
	333	* Device ID: 0x 724031556159 = 724031556159
	334	* Version: 0x0064=100=1.0.0
	335
	336	* BAT: 0x0c78 = 3192 mV = 3.192V
	337	* Singal: 0x17 = 23
	338	* Soil Moisture: 0x075e= 1886 = 18.86 %
	339	* Soil Temperature:0x0a8c =2700=27 °C
	340	* Soil Conductivity(EC) = 0x02f9 =761 uS /cm
	341	* Interrupt: 0x00 = 0
	342
57.3	343	== 2.4 Payload Explanation and Sensor Interface ==
4.2	344
57.7	345
57.5	346	=== 2.4.1 Device ID ===
4.2	347
65.13	348	(((
57.3	349	By default, the Device ID equal to the last 6 bytes of IMEI.
65.13	350	)))
4.2	351
65.13	352	(((
57.4	353	User can use (% style="color:blue" %)AT+DEUI(%%) to set Device ID
65.13	354	)))
4.2	355
65.13	356	(((
57.3	357	Example:
65.13	358	)))
4.2	359
65.13	360	(((
57.3	361	AT+DEUI=A84041F15612
65.13	362	)))
4.2	363
65.13	364	(((
57.3	365	The Device ID is stored in a none-erase area, Upgrade the firmware or run AT+FDR won't erase Device ID.
65.13	366	)))
22.2	367
4.2	368
	369
57.5	370	=== 2.4.2 Version Info ===
	371
65.13	372	(((
57.3	373	Specify the software version: 0x64=100, means firmware version 1.00.
65.13	374	)))
4.2	375
65.13	376	(((
57.3	377	For example: 0x00 64 : this device is NSE01 with firmware version 1.0.0.
65.13	378	)))
4.2	379
	380
57.3	381
57.5	382	=== 2.4.3 Battery Info ===
22.2	383
32.10	384	(((
4.2	385	Check the battery voltage for LSE01.
32.10	386	)))
4.2	387
32.10	388	(((
4.2	389	Ex1: 0x0B45 = 2885mV
32.10	390	)))
4.2	391
32.10	392	(((
4.2	393	Ex2: 0x0B49 = 2889mV
32.10	394	)))
4.2	395
	396
	397
57.6	398	=== 2.4.4 Signal Strength ===
4.2	399
65.13	400	(((
57.6	401	NB-IoT Network signal Strength.
65.13	402	)))
57.6	403
65.13	404	(((
57.6	405	Ex1: 0x1d = 29
65.13	406	)))
57.6	407
65.13	408	(((
57.6	409	(% style="color:blue" %)0(%%) -113dBm or less
65.13	410	)))
57.6	411
65.13	412	(((
57.6	413	(% style="color:blue" %)1(%%) -111dBm
65.13	414	)))
57.6	415
65.13	416	(((
57.6	417	(% style="color:blue" %)2...30(%%) -109dBm... -53dBm
65.13	418	)))
57.6	419
65.13	420	(((
57.6	421	(% style="color:blue" %)31 (%%) -51dBm or greater
65.13	422	)))
57.6	423
65.13	424	(((
57.6	425	(% style="color:blue" %)99 (%%) Not known or not detectable
65.13	426	)))
57.6	427
	428
	429
	430	=== 2.4.5 Soil Moisture ===
	431
32.10	432	(((
65.13	433	(((
4.2	434	Get the moisture content of the soil. The value range of the register is 0-10000(Decimal), divide this value by 100 to get the percentage of moisture in the soil.
32.10	435	)))
65.13	436	)))
4.2	437
32.10	438	(((
65.13	439	(((
57.6	440	For example, if the data you get from the register is __0x05 0xDC__, the moisture content in the soil is
32.10	441	)))
65.13	442	)))
4.2	443
32.10	444	(((
	445
	446	)))
4.2	447
32.10	448	(((
22.4	449	(% style="color:#4f81bd" %)05DC(H) = 1500(D) /100 = 15%.
32.10	450	)))
4.2	451
22.4	452
4.2	453
57.6	454	=== 2.4.6 Soil Temperature ===
22.5	455
32.11	456	(((
65.14	457	Get the temperature in the soil. The value range of the register is -4000 - +800(Decimal), divide this value by 100 to get the temperature in the soil. For example, if the data you get from the register is __0x09 0xEC__, the temperature content in the soil is
32.11	458	)))
4.2	459
32.11	460	(((
4.2	461	Example:
32.11	462	)))
4.2	463
32.11	464	(((
4.2	465	If payload is 0105H: ((0x0105 & 0x8000)>>15 === 0),temp = 0105(H)/100 = 2.61 °C
32.11	466	)))
4.2	467
32.11	468	(((
4.2	469	If payload is FF7EH: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/100 = -1.29 °C
32.11	470	)))
4.2	471
	472
	473
57.6	474	=== 2.4.7 Soil Conductivity (EC) ===
22.6	475
23.2	476	(((
	477	Obtain (% style="color:#4f81bd" %)__soluble salt concentration__(%%) in soil or (% style="color:#4f81bd" %)__soluble ion concentration in liquid fertilizer__(%%) or (% style="color:#4f81bd" %)__planting medium__(%%). The value range of the register is 0 - 20000(Decimal)( Can be greater than 20000).
	478	)))
4.2	479
23.2	480	(((
57.6	481	For example, if the data you get from the register is __0x00 0xC8__, the soil conductivity is 00C8(H) = 200(D) = 200 uS/cm.
23.2	482	)))
4.2	483
23.2	484	(((
4.2	485	Generally, the EC value of irrigation water is less than 800uS / cm.
23.2	486	)))
4.2	487
23.2	488	(((
	489
	490	)))
4.2	491
23.2	492	(((
	493
	494	)))
	495
57.6	496	=== 2.4.8 Digital Interrupt ===
23.2	497
65.15	498	(((
57.8	499	Digital Interrupt refers to pin (% style="color:blue" %)GPIO_EXTI(%%), and there are different trigger methods. When there is a trigger, the NSE01 will send a packet to the server.
65.15	500	)))
4.2	501
65.15	502	(((
57.6	503	The command is:
65.15	504	)))
4.2	505
65.15	506	(((
57.8	507	(% style="color:blue" %)AT+INTMOD=3 (%%) ~/~/(more info about INMOD please refer [[AT Command Manual>>url:https://www.dragino.com/downloads/downloads/NB-IoT/NBSN95/DRAGINO_NBSN95-NB_AT%20Commands_v1.1.0.pdf]]).
65.15	508	)))
4.2	509
	510
65.15	511	(((
65.6	512	The lower four bits of this data field shows if this packet is generated by interrupt or not. Click here for the hardware and software set up.
65.15	513	)))
4.2	514
	515
65.15	516	(((
57.6	517	Example:
65.15	518	)))
4.2	519
65.15	520	(((
57.6	521	0x(00): Normal uplink packet.
65.15	522	)))
4.2	523
65.15	524	(((
57.6	525	0x(01): Interrupt Uplink Packet.
65.15	526	)))
23.2	527
4.2	528
	529
57.6	530	=== 2.4.9 +5V Output ===
4.2	531
65.16	532	(((
57.7	533	NSE01 will enable +5V output before all sampling and disable the +5v after all sampling.
65.16	534	)))
4.2	535
57.6	536
65.16	537	(((
57.6	538	The 5V output time can be controlled by AT Command.
65.16	539	)))
57.6	540
65.16	541	(((
57.7	542	(% style="color:blue" %)AT+5VT=1000
65.16	543	)))
57.6	544
65.16	545	(((
57.6	546	Means set 5V valid time to have 1000ms. So the real 5V output will actually have 1000ms + sampling time for other sensors.
65.16	547	)))
57.6	548
	549
	550
58.2	551	== 2.5 Downlink Payload ==
4.2	552
60.2	553	By default, NSE01 prints the downlink payload to console port.
4.2	554
58.2	555	[[image:image-20220708133731-5.png]]
4.2	556
	557
32.14	558	(((
40.4	559	(% style="color:blue" %)Examples:
32.14	560	)))
4.2	561
32.14	562	(((
	563
	564	)))
4.2	565
32.14	566	* (((
40.4	567	(% style="color:blue" %)Set TDC
32.14	568	)))
4.2	569
32.14	570	(((
60.2	571	If the payload=0100003C, it means set the END Node's TDC to 0x00003C=60(S), while type code is 01.
32.14	572	)))
4.2	573
32.14	574	(((
4.2	575	Payload: 01 00 00 1E TDC=30S
32.14	576	)))
4.2	577
32.14	578	(((
4.2	579	Payload: 01 00 00 3C TDC=60S
32.14	580	)))
4.2	581
32.14	582	(((
	583
	584	)))
4.2	585
32.14	586	* (((
40.4	587	(% style="color:blue" %)Reset
32.14	588	)))
4.2	589
32.14	590	(((
60.2	591	If payload = 0x04FF, it will reset the NSE01
32.14	592	)))
4.2	593
	594
60.2	595	* (% style="color:blue" %)INTMOD
4.2	596
65.17	597	(((
60.2	598	Downlink Payload: 06000003, Set AT+INTMOD=3
65.17	599	)))
4.2	600
	601
26.2	602
60.2	603	== 2.6 LED Indicator ==
26.2	604
32.15	605	(((
60.2	606	The NSE01 has an internal LED which is to show the status of different state.
4.2	607
	608
60.2	609	* When power on, NSE01 will detect if sensor probe is connected, if probe detected, LED will blink four times. (no blinks in this step is no probe)
	610	* Then the LED will be on for 1 second means device is boot normally.
	611	* After NSE01 join NB-IoT network. The LED will be ON for 3 seconds.
	612	* For each uplink probe, LED will be on for 500ms.
32.15	613	)))
4.2	614
	615
	616
	617
60.2	618	== 2.7 Installation in Soil ==
4.2	619
60.2	620	__Measurement the soil surface__
4.2	621
65.18	622	(((
60.2	623	Choose the proper measuring position. Avoid the probe to touch rocks or hard things. Split the surface soil according to the measured deep. Keep the measured as original density. Vertical insert the probe into the soil to be measured. Make sure not shake when inserting. [[https:~~/~~/img.alicdn.com/imgextra/i3/2005165265/O1CN010rj9Oh1olPsQxrdUK_!!2005165265.jpg>>url:https://img.alicdn.com/imgextra/i3/2005165265/O1CN010rj9Oh1olPsQxrdUK_!!2005165265.jpg]]
65.18	624	)))
4.2	625
60.2	626	[[image:1657259653666-883.png]]
4.2	627
	628
60.2	629	(((
	630
35.15	631
60.2	632	(((
	633	Dig a hole with diameter > 20CM.
	634	)))
4.2	635
60.2	636	(((
	637	Horizontal insert the probe to the soil and fill the hole for long term measurement.
	638	)))
	639	)))
4.2	640
60.2	641	[[image:1654506665940-119.png]]
4.2	642
60.2	643	(((
	644
	645	)))
4.2	646
	647
60.2	648	== 2.8 Firmware Change Log ==
4.2	649
	650
60.2	651	Download URL & Firmware Change log
4.2	652
60.2	653	[[www.dragino.com/downloads/index.php?dir=NB-IoT/NSE01/Firmware/>>url:http://www.dragino.com/downloads/index.php?dir=NB-IoT/NBSN50/Firmware/]]
4.2	654
	655
65.6	656	Upgrade Instruction: [[Upgrade_Firmware>>\|\|anchor="H5.1200BHowtoUpgradeFirmware"]]
28.5	657
4.2	658
	659
60.2	660	== 2.9 Battery Analysis ==
4.2	661
60.2	662	=== 2.9.1 Battery Type ===
4.2	663
	664
65.18	665	(((
60.2	666	The NSE01 battery is a combination of an 8500mAh Li/SOCI2 Battery and a Super Capacitor. The battery is none-rechargeable battery type with a low discharge rate (<2% per year). This type of battery is commonly used in IoT devices such as water meter.
65.18	667	)))
4.2	668
	669
65.18	670	(((
62.3	671	The battery is designed to last for several years depends on the actually use environment and update interval.
65.18	672	)))
4.2	673
	674
65.18	675	(((
60.2	676	The battery related documents as below:
65.18	677	)))
4.2	678
60.2	679	* [[Battery Dimension>>http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
65.7	680	* [[Lithium-Thionyl Chloride Battery datasheet>>http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
60.2	681	* [[Lithium-ion Battery-Capacitor datasheet>>http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
4.2	682
29.2	683	(((
60.2	684	[[image:image-20220708140453-6.png]]
29.2	685	)))
4.2	686
	687
35.18	688
62.2	689	=== 2.9.2 Power consumption Analyze ===
4.2	690
62.3	691	(((
60.2	692	Dragino battery powered product are all runs in Low Power mode. We have an update battery calculator which base on the measurement of the real device. User can use this calculator to check the battery life and calculate the battery life if want to use different transmit interval.
62.3	693	)))
4.2	694
	695
62.3	696	(((
60.2	697	Instruction to use as below:
62.3	698	)))
4.2	699
62.3	700	(((
	701	(% style="color:blue" %)Step 1: (%%)Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from: [[https:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_End_Node/Battery_Analyze/>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/Battery_Analyze/]]
	702	)))
4.2	703
	704
62.3	705	(((
	706	(% style="color:blue" %)Step 2: (%%) Open it and choose
	707	)))
4.2	708
62.3	709	* (((
	710	Product Model
	711	)))
	712	* (((
	713	Uplink Interval
	714	)))
	715	* (((
	716	Working Mode
	717	)))
4.2	718
62.3	719	(((
60.2	720	And the Life expectation in difference case will be shown on the right.
62.3	721	)))
4.2	722
62.2	723	[[image:image-20220708141352-7.jpeg]]
4.2	724
	725
62.2	726
60.2	727	=== 2.9.3 Battery Note ===
4.2	728
31.6	729	(((
4.2	730	The Li-SICO battery is designed for small current / long period application. It is not good to use a high current, short period transmit method. The recommended minimum period for use of this battery is 5 minutes. If you use a shorter period time to transmit LoRa, then the battery life may be decreased.
31.3	731	)))
4.2	732
	733
	734
60.2	735	=== 2.9.4 Replace the battery ===
31.2	736
62.2	737	(((
60.2	738	The default battery pack of NSE01 includes a ER26500 plus super capacitor. If user can't find this pack locally, they can find ER26500 or equivalence without the SPC1520 capacitor, which will also work in most case. The SPC can enlarge the battery life for high frequency use (update period below 5 minutes).
62.2	739	)))
4.2	740
	741
	742
63.2	743	= 3. Access NB-IoT Module =
4.2	744
63.2	745	(((
	746	Users can directly access the AT command set of the NB-IoT module.
	747	)))
	748
	749	(((
64.2	750	The AT Command set can refer the BC35-G NB-IoT Module AT Command: [[https:~~/~~/www.dragino.com/downloads/index.php?dir=datasheet/other_vendors/BC35-G/>>url:https://www.dragino.com/downloads/index.php?dir=datasheet/other_vendors/BC35-G/]]
63.2	751	)))
	752
64.2	753	[[image:1657261278785-153.png]]
63.2	754
	755
	756
64.2	757	= 4. Using the AT Commands =
63.2	758
64.2	759	== 4.1 Access AT Commands ==
9.2	760
64.2	761	See this link for detail: [[http:~~/~~/www.dragino.com/downloads/index.php?dir=NB-IoT/NSE01/>>url:http://www.dragino.com/downloads/index.php?dir=NB-IoT/NBSN50/]]
11.4	762
4.2	763
64.2	764	AT+<CMD>? : Help on <CMD>
4.2	765
64.2	766	AT+<CMD> : Run <CMD>
4.2	767
64.2	768	AT+<CMD>=<value> : Set the value
4.2	769
64.2	770	AT+<CMD>=? : Get the value
4.2	771
	772
11.6	773	(% style="color:#037691" %)General Commands(%%)
4.2	774
64.2	775	AT : Attention
4.2	776
64.2	777	AT? : Short Help
4.2	778
64.2	779	ATZ : MCU Reset
4.2	780
64.2	781	AT+TDC : Application Data Transmission Interval
4.2	782
64.2	783	AT+CFG : Print all configurations
4.2	784
64.2	785	AT+CFGMOD : Working mode selection
4.2	786
64.2	787	AT+INTMOD : Set the trigger interrupt mode
4.2	788
64.2	789	AT+5VT : Set extend the time of 5V power
4.2	790
64.2	791	AT+PRO : Choose agreement
4.2	792
64.2	793	AT+WEIGRE : Get weight or set weight to 0
4.2	794
64.2	795	AT+WEIGAP : Get or Set the GapValue of weight
4.2	796
64.2	797	AT+RXDL : Extend the sending and receiving time
4.2	798
64.2	799	AT+CNTFAC : Get or set counting parameters
4.2	800
64.2	801	AT+SERVADDR : Server Address
4.2	802
	803
64.2	804	(% style="color:#037691" %)COAP Management
4.2	805
64.2	806	AT+URI : Resource parameters
4.2	807
	808
64.2	809	(% style="color:#037691" %)UDP Management
4.2	810
64.2	811	AT+CFM : Upload confirmation mode (only valid for UDP)
4.2	812
	813
64.2	814	(% style="color:#037691" %)MQTT Management
4.2	815
64.2	816	AT+CLIENT : Get or Set MQTT client
4.2	817
64.2	818	AT+UNAME : Get or Set MQTT Username
4.2	819
64.2	820	AT+PWD : Get or Set MQTT password
4.2	821
64.2	822	AT+PUBTOPIC : Get or Set MQTT publish topic
4.2	823
64.2	824	AT+SUBTOPIC : Get or Set MQTT subscription topic
4.2	825
	826
64.2	827	(% style="color:#037691" %)Information
4.2	828
64.2	829	AT+FDR : Factory Data Reset
4.2	830
64.2	831	AT+PWORD : Serial Access Password
4.2	832
	833
	834
64.4	835	= 5. FAQ =
4.2	836
64.4	837	== 5.1 How to Upgrade Firmware ==
6.3	838
4.2	839
31.35	840	(((
64.4	841	User can upgrade the firmware for 1) bug fix, 2) new feature release.
31.35	842	)))
4.2	843
31.35	844	(((
64.4	845	Please see this link for how to upgrade: [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H2.HardwareUpgradeMethodSupportList>>http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H2.HardwareUpgradeMethodSupportList]]
31.35	846	)))
4.2	847
31.35	848	(((
64.5	849	(% style="color:red" %)Notice, NSE01 and LSE01 share the same mother board. They use the same connection and method to update.
31.35	850	)))
4.2	851
	852
	853
65.23	854	== 5.2 Can I calibrate NSE01 to different soil types? ==
	855
	856	(((
	857	NSE01 is calibrated for saline-alkali soil and loamy soil. If users want to use it for other soil, they can calibrate the value in the IoT platform base on the value measured by saline-alkali soil and loamy soil. The formula can be found at [[this link>>https://www.dragino.com/downloads/downloads/LoRa_End_Node/LSE01/Calibrate_to_other_Soil_20220605.pdf]].
	858	)))
	859
	860
64.5	861	= 6. Trouble Shooting =
4.2	862
64.5	863	== 6.1 Connection problem when uploading firmware ==
4.9	864
4.2	865
65.20	866	(((
	867	Please see: [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H3.3Troubleshooting>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H3.3Troubleshooting]]
	868	)))
	869
64.5	870	(% class="wikigeneratedid" %)
31.29	871	(((
65.20	872
31.29	873	)))
4.2	874
	875
64.5	876	== 6.2 AT Command input doesn't work ==
4.2	877
31.30	878	(((
64.5	879	In the case if user can see the console output but can't type input to the device. Please check if you already include the (% style="color:green" %)ENTER(%%) while sending out the command. Some serial tool doesn't send (% style="color:green" %)ENTER(%%) while press the send key, user need to add ENTER in their string.
65.22	880
65.23	881
31.30	882	)))
4.2	883
	884
64.5	885	= 7. Order Info =
4.2	886
	887
64.5	888	Part Number: (% style="color:#4f81bd" %)NSE01
4.7	889
4.2	890
31.10	891	(% class="wikigeneratedid" %)
	892	(((
	893
	894	)))
	895
65.2	896	= 8. Packing Info =
4.2	897
4.3	898	(((
31.39	899
	900
31.40	901	(% style="color:#037691" %)Package Includes:
64.5	902
65.1	903	* NSE01 NB-IoT Soil Moisture & EC Sensor x 1
64.5	904	* External antenna x 1
4.3	905	)))
4.2	906
4.3	907	(((
31.40	908
	909
	910	(% style="color:#037691" %)Dimension and weight:
4.2	911
64.5	912	* Size: 195 x 125 x 55 mm
	913	* Weight: 420g
4.3	914	)))
31.11	915
64.5	916	(((
31.11	917
64.5	918
	919
	920
4.3	921	)))
4.2	922
64.5	923	= 9. Support =
4.2	924
	925	* 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.
	926	* Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[support@dragino.com>>url:http://../../../../../../D:%5C%E5%B8%82%E5%9C%BA%E8%B5%84%E6%96%99%5C%E8%AF%B4%E6%98%8E%E4%B9%A6%5CLoRa%5CLT%E7%B3%BB%E5%88%97%5Csupport@dragino.com]]

Wiki source code of NDDS75 NB-IoT Distance Detect Sensor User Manual

Applications