Wiki source code of NLMS01-NB-IoT Leaf Moisture Sensor User Manual

Version 33.6 by Xiaoling on 2022/09/13 09:50

version	line-number	content
28.1	1	(% style="text-align:center" %)
	2	[[image:image-20220907171221-1.jpeg]]
25.1	3
28.1	4
25.1	5
28.1	6	{{toc/}}
25.1	7
28.1	8
	9
32.2	10	= 1. Introduction =
25.1	11
	12
32.2	13	== 1.1 What is NLMS01 Leaf Moisture Sensor ==
26.1	14
25.1	15
32.2	16	The Dragino NLMS01 is a (% style="color:blue" %)NB-IOT Leaf Moisture Sensor(%%) for IoT of Agriculture. It is designed to measure the leaf moisture and temperature, so to send to the platform to analyze the leaf status such as : watering, moisturizing, dew, frozen. The probe is IP67 waterproof.
25.1	17
32.2	18	NLMS01 detects leaf's(% style="color:blue" %) moisture and temperature use FDR method(%%), it senses the dielectric constant cause by liquid over the leaf surface, and cover the value to leaf moisture. The probe is design in a leaf shape to best simulate the real leaf characterizes. The probe has as density as 15 leaf vein lines per centimeter which make it can senses small drop and more accuracy.
	19
25.1	20	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.
32.2	21	\\NLMS01 supports different uplink methods include (% style="color:blue" %)TCP,MQTT,UDP and CoAP (%%)for different application requirement.
	22	\\NLMS01 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).
	23	\\To use NLMS01, user needs to check if there is NB-IoT coverage in local area and with the bands NLMS01 supports. If the local operate support it, user needs to get a (% style="color:blue" %)NB-IoT SIM card(%%) from local operator and install NLMS01 to get NB-IoT network connection.
25.1	24
32.2	25
25.1	26	[[image:image-20220907171221-2.png]]
	27
32.2	28
25.1	29	[[image:image-20220907171221-3.png]]
	30
	31
	32
32.2	33	== 1.2 Features ==
25.1	34
32.2	35
	36	* NB-IoT Bands: B1/B3/B8/B5/B20/B28 @H-FDD
	37	* Monitor Leaf moisture
	38	* Monitor Leaf temperature
	39	* Moisture and Temperature alarm function
	40	* Monitor Battery Level
	41	* Uplink on periodically
	42	* Downlink to change configure
	43	* IP66 Waterproof Enclosure
	44	* IP67 rate for the Sensor Probe
	45	* Ultra-Low Power consumption
	46	* AT Commands to change parameters
	47	* Micro SIM card slot for NB-IoT SIM
	48	* 8500mAh Battery for long term use
	49
	50	(((
	51
	52
	53
	54
26.1	55	)))
25.1	56
26.1	57	== 1.3 Specification ==
25.1	58
	59
32.2	60	(% style="color:#037691" %)Common DC Characteristics:
	61
25.1	62	* Supply Voltage: 2.1v ~~ 3.6v
	63	* Operating Temperature: -40 ~~ 85°C
	64
32.2	65	(% style="color:#037691" %)NB-IoT Spec:
	66
25.1	67	* - B1 @H-FDD: 2100MHz
	68	* - B3 @H-FDD: 1800MHz
	69	* - B8 @H-FDD: 900MHz
	70	* - B5 @H-FDD: 850MHz
	71	* - B20 @H-FDD: 800MHz
	72	* - B28 @H-FDD: 700MHz
	73
33.4	74
	75
33.6	76
33.2	77	== 1.4 Probe Specification ==
32.2	78
	79
33.2	80	(% style="color:#037691" %)Leaf Moisture: percentage of water drop over total leaf surface
25.1	81
	82	* Range 0-100%
	83	* Resolution: 0.1%
	84	* Accuracy: ±3%（0-50%）；±6%（>50%）
	85	* IP67 Protection
	86	* Length: 3.5 meters
	87
33.2	88	(% style="color:#037691" %)Leaf Temperature:
25.1	89
	90	* Range -50℃～80℃
	91	* Resolution: 0.1℃
	92	* Accuracy: <±0.5℃(-10℃～70℃)，<±1.0℃ (others)
	93	* IP67 Protection
	94	* Length: 3.5 meters
	95
33.4	96
	97
33.6	98
33.2	99	== 1.5 Applications ==
25.1	100
33.2	101
25.1	102	* Smart Agriculture
	103
33.4	104
	105
33.6	106
33.2	107	== 1.6 Pin mapping and power on ==
25.1	108
33.2	109
25.1	110	[[image:image-20220907171221-4.png]]
	111
	112	~
	113
33.2	114
26.1	115	= 2. Use NLMS01 to communicate with IoT Server =
25.1	116
33.2	117
26.1	118	== 2.1 How it works ==
25.1	119
33.2	120
25.1	121	The NLMS01 is equipped with a NB-IoT module, the pre-loaded firmware in NLMS01 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 NLMS01.
	122
	123	The diagram below shows the working flow in default firmware of NLMS01:
	124
33.2	125
25.1	126	[[image:image-20220907171221-5.png]]
	127
33.2	128
	129
27.1	130	== 2.2 Configure the NLMS01 ==
25.1	131
33.2	132
27.1	133	=== 2.2.1 Test Requirement ===
25.1	134
33.2	135
25.1	136	To use NLMS01 in your city, make sure meet below requirements:
	137
	138	* Your local operator has already distributed a NB-IoT Network there.
	139	* The local NB-IoT network used the band that NLMS01 supports.
	140	* Your operator is able to distribute the data received in their NB-IoT network to your IoT server.
	141
33.2	142	Below figure shows our testing structure. Here we have NB-IoT network coverage by China Mobile, the band they use is B8. The NLMS01 will use(% style="color:#037691" %) CoAP(120.24.4.116:5683) (%%)or raw(% style="color:#037691" %) UDP(120.24.4.116:5601) or(%%) (% style="color:#037691" %)MQTT(120.24.4.116:1883)(%%)or (% style="color:#037691" %)TCP(120.24.4.116:5600)(%%)protocol to send data to the test server
25.1	143
33.2	144
25.1	145	[[image:image-20220907171221-6.png]]
	146
33.2	147
	148
27.1	149	=== 2.2.2 Insert SIM card ===
25.1	150
33.2	151
25.1	152	Insert the NB-IoT Card get from your provider.
	153
	154	User need to take out the NB-IoT module and insert the SIM card like below:
	155
33.2	156
25.1	157	[[image:image-20220907171221-7.png]]
	158
33.2	159
	160
27.1	161	=== 2.2.3 Connect USB – TTL to NLMS01 to configure it ===
25.1	162
	163
33.2	164	User need to configure NLMS01 via serial port to set the (% style="color:#037691" %)Server Address / Uplink Topic (%%)to define where and how-to uplink packets. NLMS01 support AT Commands, user can use a USB to TTL adapter to connect to NLMS01 and use AT Commands to configure it, as below.
25.1	165
	166
33.2	167	(% style="color:blue" %)Connection:
25.1	168
33.2	169	~ (% style="background-color:yellow" %)USB TTL GND <~-~-~-~-> GND(%%)
25.1	170
33.2	171	~ (% style="background-color:yellow" %)USB TTL TXD <~-~-~-~-> UART_RXD(%%)
	172
	173	~ (% style="background-color:yellow" %)USB TTL RXD <~-~-~-~-> UART_TXD(%%)
	174
	175
25.1	176	In the PC, use below serial tool settings:
	177
33.2	178	* Baud: (% style="color:green" %)9600
	179	* Data bits: (% style="color:green" %)8(%%)
	180	* Stop bits: (% style="color:green" %)1
	181	* Parity: (% style="color:green" %)None
	182	* Flow Control: (% style="color:green" %)None
25.1	183
33.2	184	Make sure the switch is in FLASH position, then power on device by connecting the jumper on NLMS01. NLMS01 will output system info once power on as below, we can enter the (% style="color:green" %)password: 12345678(%%) to access AT Command input.
25.1	185
33.2	186	[[image:image-20220913090720-1.png]]
25.1	187
	188
33.2	189	(% style="color:red" %)Note: the valid AT Commands can be found at: (%%)[[https:~~/~~/www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0>>url:https://www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0]]
	190
	191
	192
27.1	193	=== 2.2.4 Use CoAP protocol to uplink data ===
25.1	194
	195
33.2	196	(% 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/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Set%20up%20CoAP%20Server/]]
25.1	197
	198
33.2	199	(% style="color:blue" %)Use below commands:
	200
	201	* (% style="color:#037691" %)AT+PRO=1 (%%) ~/~/ Set to use CoAP protocol to uplink
	202	* (% style="color:#037691" %)AT+SERVADDR=120.24.4.116,5683 (%%) ~/~/ to set CoAP server address and port
	203	* (% style="color:#037691" %)AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0" (%%) ~/~/ Set COAP resource path
	204
25.1	205	For parameter description, please refer to AT command set
	206
	207	[[image:image-20220907171221-9.png]]
	208
	209
33.2	210	After configure the server address and (% style="color:#037691" %)reset the device(%%) (via AT+ATZ ), NLMS01 will start to uplink sensor values to CoAP server.
	211
25.1	212	[[image:image-20220907171221-10.png]]
	213
33.2	214
	215
27.1	216	=== 2.2.5 Use UDP protocol to uplink data(Default protocol) ===
25.1	217
33.2	218
25.1	219	This feature is supported since firmware version v1.0.1
	220
33.2	221	* (% style="color:#037691" %)AT+PRO=2 (%%) ~/~/ Set to use UDP protocol to uplink
33.4	222	* (% style="color:#037691" %)AT+SERVADDR=120.24.4.116,5601 (%%) ~/~/ to set UDP server address and port
33.2	223	* (% style="color:#037691" %)AT+CFM=1 (%%) ~/~/ If the server does not respond, this command is unnecessary
25.1	224
33.2	225
33.6	226
25.1	227	[[image:image-20220907171221-11.png]]
	228
33.2	229
25.1	230	[[image:image-20220907171221-12.png]]
	231
	232
	233
33.2	234
27.1	235	=== 2.2.6 Use MQTT protocol to uplink data ===
25.1	236
33.2	237
25.1	238	This feature is supported since firmware version v110
	239
33.2	240	* (% style="color:#037691" %)AT+PRO=3 (%%) ~/~/ Set to use MQTT protocol to uplink
	241	* (% style="color:#037691" %)AT+SERVADDR=120.24.4.116,1883 (%%) ~/~/ Set MQTT server address and port
	242	* (% style="color:#037691" %)AT+CLIENT=CLIENT (%%) ~/~/ Set up the CLIENT of MQTT
	243	* (% style="color:#037691" %)AT+UNAME=UNAME (%%) ~/~/ Set the username of MQTT
	244	* (% style="color:#037691" %)AT+PWD=PWD (%%) ~/~/ Set the password of MQTT
	245	* (% style="color:#037691" %)AT+PUBTOPIC=PUB (%%) ~/~/ Set the sending topic of MQTT
	246	* (% style="color:#037691" %)AT+SUBTOPIC=SUB (%%) ~/~/ Set the subscription topic of MQTT
25.1	247
	248	[[image:image-20220907171221-13.png]]
	249
33.2	250
	251
25.1	252	[[image:image-20220907171221-14.png]]
	253
	254
	255
	256	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.
	257
33.2	258
	259
27.1	260	=== 2.2.7 Use TCP protocol to uplink data ===
25.1	261
33.2	262
25.1	263	This feature is supported since firmware version v110
	264
33.2	265	* (% style="color:#037691" %)AT+PRO=4 (%%) ~/~/ Set to use TCP protocol to uplink
	266	* (% style="color:#037691" %)AT+SERVADDR=120.24.4.116,5600 (%%) ~/~/ to set TCP server address and port
25.1	267
33.2	268
33.6	269
25.1	270	[[image:image-20220907171221-15.png]]
	271
33.2	272
	273
25.1	274	[[image:image-20220907171221-16.png]]
	275
	276
	277
33.2	278
27.1	279	=== 2.2.8 Change Update Interval ===
25.1	280
33.2	281
25.1	282	User can use below command to change the uplink interval.
	283
33.2	284	* (% style="color:#037691" %)AT+TDC=7200 (%%) ~/~/ Set Update Interval to 7200s (2 hour)
25.1	285
	286
33.6	287
33.2	288	(% style="color:red" %)NOTE: By default, the device will send an uplink message every 2 hour. Each Uplink Include 8 set of records in this 2 hour (15 minute interval / record).
	289
	290
	291
26.1	292	== 2.3 Uplink Payload ==
25.1	293
33.2	294
25.1	295	In this mode, uplink payload includes 87 bytes in total by default.
	296
	297	Each time the device uploads a data package, 8 sets of recorded data will be attached. Up to 32 sets of recorded data can be uploaded.
	298
	299
33.2	300	(% border="1" style="background-color:#ffffcc; color:green; width:1251px" %)
	301	\|(% style="width:96px" %)Size(bytes)\|(% style="width:82px" %)8\|(% style="width:42px" %)2\|(% style="width:48px" %)2\|(% style="width:124px" %)1\|(% style="width:58px" %)1\|(% style="width:82px" %)1\|(% style="width:113px" %)2\|(% style="width:134px" %)2\|(% style="width:100px" %)4\|(% style="width:137px" %)2\|(% style="width:110px" %)2\|(% style="width:122px" %)4
	302	\|(% style="width:96px" %)Value\|(% style="width:82px" %)Device ID\|(% style="width:42px" %)Ver\|(% style="width:48px" %)BAT\|(% style="width:124px" %)Signal Strength\|(% style="width:58px" %)MOD\|(% style="width:82px" %)Interrupt\|(% style="width:113px" %)Leaf moisture\|(% style="width:134px" %)Leaf Temperature\|(% style="width:100px" %)Time stamp\|(% style="width:137px" %)Leaf Temperature\|(% style="width:110px" %)Leaf moisture\|(% style="width:122px" %)Time stamp .....
	303
25.1	304	If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NLMS01 uplink data.
	305
33.2	306
25.1	307	[[image:image-20220907171221-17.png]]
	308
33.2	309
25.1	310	The payload is ASCII string, representative same HEX:
	311
30.1	312	0x(% style="color:red" %)f868411056754138(% style="color:blue" %)0064(% style="color:green" %)0c78(% style="color:red" %)17(% style="color:blue" %)01(% style="color:green" %)00(% style="color:blue" %)0225010b6315537b010b0226631550fb010e022663154d7701110225631549f1011502246315466b01190223631542e5011d022163153f62011e022163153bde011e022163153859(%%) where:
25.1	313
30.1	314	* (% style="color:red" %)Device ID: 0xf868411056754138 = f868411056754138
	315	* (% style="color:blue" %)Version: 0x0064=100=1.0.0
	316	* (% style="color:green" %)BAT: 0x0c78 = 3192 mV = 3.192V
	317	* (% style="color:red" %)Singal: 0x17 = 23
	318	* (% style="color:blue" %)Mod: 0x01 = 1
	319	* (% style="color:green" %)Interrupt: 0x00= 0
25.1	320	* Leaf moisture: 0x0225= 549 = 54.9%
	321	* Leaf Temperature:0x010B =267=26.7 °C
31.1	322	* Time stamp : 0x6315537b =1662342011 ([[Unix Epoch Time>>https://www.epochconverter.com/]])
25.1	323	* Leaf Temperature, Leaf moisture,Time stamp : 010b0226631550fb
30.1	324	* (% style="color:blue" %)8 sets of recorded data: Leaf Temperature, Leaf moisture,Time stamp : 010e022663154d77,.......
25.1	325
33.2	326
	327
33.6	328
	329
26.1	330	== 2.4 Payload Explanation and Sensor Interface ==
25.1	331
33.3	332
27.1	333	=== 2.4.1 Device ID ===
25.1	334
33.3	335
25.1	336	By default, the Device ID equal to the last 15 bits of IMEI.
	337
33.4	338	User can use (% style="color:#037691" %)AT+DEUI(%%) to set Device ID
25.1	339
33.3	340
33.4	341	(% style="color:blue" %)Example:
25.1	342
	343	AT+DEUI=868411056754138
	344
	345	The Device ID is stored in a none-erase area, Upgrade the firmware or run AT+FDR won't erase Device ID.
	346
33.3	347
	348
27.1	349	=== 2.4.2 Version Info ===
25.1	350
33.3	351
25.1	352	Specify the software version: 0x64=100, means firmware version 1.00.
	353
	354	For example: 0x00 64 : this device is NLMS01 with firmware version 1.0.0.
	355
33.3	356
	357
27.1	358	=== 2.4.3 Battery Info ===
25.1	359
33.3	360
25.1	361	Check the battery voltage for NLMS01.
	362
	363	Ex1: 0x0B45 = 2885mV
	364
	365	Ex2: 0x0B49 = 2889mV
	366
33.3	367
	368
27.1	369	=== 2.4.4 Signal Strength ===
25.1	370
33.3	371
25.1	372	NB-IoT Network signal Strength.
	373
	374
33.4	375	(% style="color:blue" %)Ex1: 0x1d = 29
	376
25.1	377	0 -113dBm or less
	378
	379	1 -111dBm
	380
	381	2...30 -109dBm... -53dBm
	382
	383	31 -51dBm or greater
	384
	385	99 Not known or not detectable
	386
33.3	387
	388
27.1	389	=== 2.4.5 Leaf moisture ===
25.1	390
33.3	391
33.4	392	Get the moisture of the (% style="color:#037691" %)Leaf(%%). The value range of the register is 300-1000(Decimal), divide this value by 100 to get the percentage of moisture in the Leaf.
25.1	393
33.4	394	For example, if the data you get from the register is (% style="color:#037691" %)__0x05 0xDC__(%%), the moisture content in the (% style="color:#037691" %)Leaf(%%) is
25.1	395
33.4	396	(% style="color:blue" %)0229(H) = 549(D) /100 = 54.9.
25.1	397
33.3	398
	399
27.1	400	=== 2.4.6 Leaf Temperature ===
25.1	401
33.3	402
33.4	403	Get the temperature in the Leaf. The value range of the register is -4000 - +800(Decimal), divide this value by 100 to get the temperature in the Leaf. For example, if the data you get from the register is (% style="color:#037691" %)__0x09 0xEC__(%%), the temperature content in the (% style="color:#037691" %)Leaf (%%)is
25.1	404
33.4	405	(% style="color:blue" %)Example:
25.1	406
33.4	407	If payload is 0105H: ((0x0105 & 0x8000)>>15 === 0),temp = 0105(H)/10 = 26.1 °C
25.1	408
33.4	409	If payload is FF7EH: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/10 = -12.9 °C
25.1	410
33.3	411
	412
27.1	413	=== 2.4.7 Timestamp ===
25.1	414
33.3	415
25.1	416	Time stamp : 0x6315537b =1662342011
	417
	418	Convert Unix timestamp to time 2022-9-5 9:40:11.
	419
33.3	420
33.4	421
27.1	422	=== 2.4.8 Digital Interrupt ===
25.1	423
33.3	424
33.4	425	Digital Interrupt refers to pin (% style="color:#037691" %)GPIO_EXTI(%%), and there are different trigger methods. When there is a trigger, the NLMS01 will send a packet to the server.
25.1	426
	427	The command is:
	428
33.4	429	(% 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]]).
25.1	430
	431	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.
	432
	433	Example:
	434
	435	0x(00): Normal uplink packet.
	436
	437	0x(01): Interrupt Uplink Packet.
	438
33.3	439
	440
27.1	441	=== 2.4.9 +5V Output ===
25.1	442
33.3	443
25.1	444	NLMS01 will enable +5V output before all sampling and disable the +5v after all sampling.
	445
	446	The 5V output time can be controlled by AT Command.
	447
33.4	448	(% style="color:blue" %)AT+5VT=1000
25.1	449
	450	Means set 5V valid time to have 1000ms. So the real 5V output will actually have 1000ms + sampling time for other sensors.
	451
	452
33.3	453
26.1	454	== 2.5 Downlink Payload ==
25.1	455
33.3	456
25.1	457	By default, NLMS01 prints the downlink payload to console port.
	458
	459	[[image:image-20220907171221-18.png]]
	460
33.3	461
33.4	462	(% style="color:blue" %)Examples:
25.1	463
	464
33.4	465	* (% style="color:#037691" %)Set TDC
	466
25.1	467	If the payload=0100003C, it means set the END Node's TDC to 0x00003C=60(S), while type code is 01.
	468
	469	Payload: 01 00 00 1E TDC=30S
	470
	471	Payload: 01 00 00 3C TDC=60S
	472
	473
33.4	474
	475	* (% style="color:#037691" %)Reset
	476
25.1	477	If payload = 0x04FF, it will reset the NLMS01
	478
	479
33.4	480
	481	* (% style="color:#037691" %)INTMOD
	482
25.1	483	Downlink Payload: 06000003, Set AT+INTMOD=3
	484
33.3	485
	486
26.1	487	== 2.6 LED Indicator ==
25.1	488
33.3	489
25.1	490	The NLMS01 has an internal LED which is to show the status of different state.
	491
	492	* When power on, NLMS01 will detect if sensor probe is connected, if probe detected, LED will blink four times. (no blinks in this step is no probe)
	493	* Then the LED will be on for 1 second means device is boot normally.
	494	* After NLMS01 join NB-IoT network. The LED will be ON for 3 seconds.
	495	* For each uplink probe, LED will be on for 500ms.
	496
	497
33.3	498
33.6	499
	500
33.3	501	== 2.7 Installation ==
	502
	503
25.1	504	NLMS01 probe has two sides. The side without words are the sense side. Please be ware when install the sensor.
	505
33.3	506
25.1	507	[[image:image-20220907171221-19.png]]
	508
	509
	510
33.3	511	== 2.8 Moisture and Temperature alarm function ==
25.1	512
33.3	513
33.4	514	(% style="color:blue" %)➢ AT Command:
33.3	515
33.4	516	(% style="color:#037691" %)AT+ HUMALARM =min,max
33.3	517
25.1	518	² When min=0, and max≠0, Alarm higher than max
	519
	520	² When min≠0, and max=0, Alarm lower than min
	521
	522	² When min≠0 and max≠0, Alarm higher than max or lower than min
	523
	524
33.4	525	(% style="color:blue" %)Example:
33.3	526
25.1	527	AT+ HUMALARM =50,60 ~/~/ Alarm when moisture lower than 50.
	528
	529	AT+ TEMPALARM=min,max
	530
	531	² When min=0, and max≠0, Alarm higher than max
	532
	533	² When min≠0, and max=0, Alarm lower than min
	534
	535	² When min≠0 and max≠0, Alarm higher than max or lower than min
	536
	537
33.4	538	(% style="color:blue" %)Example:
33.3	539
25.1	540	AT+ TEMPALARM=20,30 ~/~/ Alarm when temperature lower than 20.
	541
	542
	543
33.3	544	== 2.9 Set the number of data to be uploaded and the recording time ==
25.1	545
	546
33.4	547	(% style="color:blue" %)➢ AT Command:
25.1	548
33.4	549	* (% style="color:#037691" %)AT+TR=900 (%%) ~/~/ The unit is seconds, and the default is to record data once every 900 seconds.( The minimum can be set to 180 seconds)
	550	* (% style="color:#037691" %)AT+NOUD=8 (%%)~/~/ The device uploads 8 sets of recorded data by default. Up to 32 sets of record data can be uploaded.
25.1	551
	552
	553
33.6	554
	555
33.3	556	== 2.10 Read or Clear cached data ==
	557
	558
33.4	559	(% style="color:blue" %)➢ AT Command:
33.3	560
33.4	561	* (% style="color:#037691" %)AT+CDP (%%) ~/~/ Read cached data
	562	* (% style="color:#037691" %)AT+CDP=0 (%%) ~/~/ Clear cached data
33.3	563
	564
33.6	565
25.1	566	[[image:image-20220907171221-20.png]]
	567
	568
	569
26.1	570	== 2.11 Firmware Change Log ==
25.1	571
33.3	572
33.5	573	Download URL & Firmware Change log: [[https:~~/~~/www.dropbox.com/sh/qdc3js2iu1vlipx/AACMHI3CvVb8g7YQMrIHY673a?dl=0>>https://www.dropbox.com/sh/qdc3js2iu1vlipx/AACMHI3CvVb8g7YQMrIHY673a?dl=0]]
25.1	574
33.5	575	Upgrade Instruction: [[Upgrade Firmware>>\|\|anchor="H5.1200BHowtoUpgradeFirmware"]]
25.1	576
33.3	577
	578
26.1	579	== 2.12 Battery Analysis ==
25.1	580
33.3	581
27.1	582	=== 2.12.1 Battery Type ===
25.1	583
33.3	584
25.1	585	The NLMS01 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.
	586
	587	The battery is designed to last for several years depends on the actually use environment and update interval.
	588
	589	The battery related documents as below:
	590
	591	* [[Battery Dimension>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
	592	* [[Lithium-Thionyl Chloride Battery datasheet>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
	593	* [[Lithium-ion Battery-Capacitor datasheet>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
	594
	595	[[image:image-20220907171221-21.png]]
	596
33.3	597
	598
27.1	599	=== 2.12.2 Power consumption Analyze ===
25.1	600
33.3	601
25.1	602	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.
	603
	604	Instruction to use as below:
	605
33.4	606	(% 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/]]
25.1	607
33.4	608	(% style="color:blue" %)Step 2: (%%) Open it and choose
25.1	609
	610	* Product Model
	611	* Uplink Interval
	612	* Working Mode
	613
	614	And the Life expectation in difference case will be shown on the right.
	615
	616	[[image:image-20220907171221-22.jpeg]]
	617
33.3	618
27.1	619	=== 2.12.3 Battery Note ===
25.1	620
33.3	621
25.1	622	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.
	623
33.3	624
	625
27.1	626	=== 2.12.4 Replace the battery ===
25.1	627
33.3	628
25.1	629	The default battery pack of NLMS01 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).
	630
33.3	631
	632
26.1	633	= 3. Access NB-IoT Module =
25.1	634
33.3	635
25.1	636	Users can directly access the AT command set of the NB-IoT module.
	637
	638	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/]]
	639
33.3	640
25.1	641	[[image:image-20220907171221-23.png]]
	642
33.3	643
	644
26.1	645	= 4. Using the AT Commands =
25.1	646
33.3	647
27.1	648	== 4.1 Access AT Commands ==
25.1	649
33.3	650
25.1	651	See this link for detail: [[https:~~/~~/www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0>>url:https://www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0]]
	652
	653	AT+<CMD>? : Help on <CMD>
	654
	655	AT+<CMD> : Run <CMD>
	656
	657	AT+<CMD>=<value> : Set the value
	658
	659	AT+<CMD>=? : Get the value
	660
33.3	661
33.4	662	(% style="color:#037691" %)General Commands
25.1	663
	664	AT : Attention
	665
	666	AT? : Short Help
	667
	668	ATZ : MCU Reset
	669
	670	AT+TDC : Application Data Transmission Interval
	671
	672	AT+CFG : Print all configurations
	673
	674	AT+CFGMOD : Working mode selection
	675
	676	AT+INTMOD : Set the trigger interrupt mode
	677
	678	AT+5VT : Set extend the time of 5V power
	679
	680	AT+PRO : Choose agreement
	681
	682	AT+RXDL : Extend the sending and receiving time
	683
	684	AT+SERVADDR : Server Address
	685
32.1	686	AT+APN : Get or set the APN
	687
	688	AT+FBAND : Get or Set whether to automatically modify the frequency band
	689
	690	AT+DNSCFG : Get or Set DNS Server
	691
	692	AT+GETSENSORVALUE : Returns the current sensor measurement
	693
25.1	694	AT+TR : Get or Set record time"
	695
	696	AT+NOUD : Get or Set the number of data to be uploaded
	697
	698	AT+CDP : Read or Clear cached data
	699
	700	AT+TEMPALARM : Get or Set alarm of temp
	701
	702	AT+HUMALARM : Get or Set alarm of PH
	703
	704
33.4	705	(% style="color:#037691" %)COAP Management
25.1	706
	707	AT+URI : Resource parameters
	708
33.3	709
33.4	710	(% style="color:#037691" %)UDP Management
25.1	711
	712	AT+CFM : Upload confirmation mode (only valid for UDP)
	713
33.3	714
33.4	715	(% style="color:#037691" %)MQTT Management
25.1	716
	717	AT+CLIENT : Get or Set MQTT client
	718
	719	AT+UNAME : Get or Set MQTT Username
	720
	721	AT+PWD : Get or Set MQTT password
	722
	723	AT+PUBTOPIC : Get or Set MQTT publish topic
	724
	725	AT+SUBTOPIC : Get or Set MQTT subscription topic
	726
33.3	727
33.4	728	(% style="color:#037691" %)Information
25.1	729
	730	AT+FDR : Factory Data Reset
	731
	732	AT+PWORD : Serial Access Password
	733
33.3	734
	735
26.1	736	= 5. FAQ =
25.1	737
33.3	738
27.1	739	== 5.1 How to Upgrade Firmware ==
25.1	740
33.3	741
25.1	742	User can upgrade the firmware for 1) bug fix, 2) new feature release.
	743
	744	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>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H2.HardwareUpgradeMethodSupportList]]
	745
	746
33.4	747	(% style="color:red" %)Notice, NLMS01 and LLMS01 share the same mother board. They use the same connection and method to update.
33.3	748
	749
33.4	750
26.1	751	= 6. Trouble Shooting =
25.1	752
33.3	753
27.1	754	== 6.1 Connection problem when uploading firmware ==
25.1	755
33.3	756
25.1	757	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]]
	758
33.3	759
	760
27.1	761	== 6.2 AT Command input doesn't work ==
25.1	762
33.3	763
33.4	764	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.
25.1	765
33.3	766
	767
26.1	768	= 7. Order Info =
25.1	769
33.3	770
25.1	771	Part Number: NLMS01
	772
33.3	773
	774
26.1	775	= 8. Packing Info =
25.1	776
33.3	777
33.4	778	(% style="color:#037691" %)Package Includes:
25.1	779
	780	* NLMS01 NB-IoT Leaf Moisture Sensor x 1
	781
33.4	782	(% style="color:#037691" %)Dimension and weight:
25.1	783
	784	* Device Size: cm
	785	* Device Weight: g
	786	* Package Size / pcs : cm
	787	* Weight / pcs : g
	788
33.3	789
33.6	790
	791
26.1	792	= 9. Support =
25.1	793
33.3	794
25.1	795	* 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.
	796	* 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]]
	797
	798

Wiki source code of NLMS01-NB-IoT Leaf Moisture Sensor User Manual

Applications