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

Version 33.11 by Xiaoling on 2022/09/23 18:05

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

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

Applications