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

Version 65.7 by Xiaoling on 2022/07/08 15:24

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