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

Version 38.5 by Xiaoling on 2022/10/25 16:22

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