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

Version 33.5 by Xiaoling on 2022/09/13 09:48

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

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

Applications