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

Version 38.9 by Xiaoling on 2022/10/25 16:27

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

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

Applications