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

Version 38.11 by Xiaoling on 2022/10/25 16:33

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

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

Applications