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

Version 67.2 by Xiaoling on 2022/07/08 18:09

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