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

Version 75.4 by Xiaoling on 2022/07/09 09:02

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