Wiki source code of NSE01 - NB-IoT Soil Moisture & EC Sensor User Manual

Version 65.4 by Xiaoling on 2022/07/08 15:09

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

Applications

Navigation