Wiki source code of SDI-12-LB -- SDI-12 to LoRaWAN Converter User Manual

Version 41.20 by Xiaoling on 2023/02/01 17:20

version	line-number	content
40.7	1	(% style="text-align:center" %)
	2	[[image:image-20230131183542-1.jpeg\|\|height="694" width="694"]]
2.2	3
	4	Table of Contents：
	5
40.7	6	{{toc/}}
2.2	7
	8
	9
	10
	11
	12
	13
	14
	15
	16
	17
	18
	19
9.2	20	= 1. Introduction =
2.2	21
9.2	22	== 1.1 What is SDI-12 to LoRaWAN Converter ==
2.2	23
	24
41.13	25	(((
40.2	26	The Dragino (% style="color:blue" %)SDI-12-LB(%%) is a (% style="color:blue" %)SDI-12 to LoRaWAN Converter (%%)designed for Smart Agriculture solution.
41.13	27	)))
9.2	28
41.13	29	(((
2.2	30	SDI-12 (Serial Digital Interface at 1200 baud) is an asynchronous [[serial communications>>url:https://en.wikipedia.org/wiki/Serial_communication]] protocol for intelligent sensors that monitor environment data. SDI-12 protocol is widely used in Agriculture sensor and Weather Station sensors.
41.13	31	)))
2.2	32
41.13	33	(((
37.8	34	SDI-12-LB has SDI-12 interface and support 12v output to power external SDI-12 sensor. It can get the environment data from SDI-12 sensor and sends out the data via LoRaWAN wireless protocol.
41.13	35	)))
2.2	36
41.13	37	(((
37.8	38	The LoRa wireless technology used in SDI-12-LB allows device to send data and reach extremely long ranges at low data-rates. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current consumption.
41.13	39	)))
2.2	40
41.13	41	(((
40.2	42	SDI-12-LB is powered by (% style="color:blue" %)8500mAh Li-SOCI2 battery(%%), it is designed for long term use up to 5 years.
41.13	43	)))
2.2	44
41.13	45	(((
37.8	46	Each SDI-12-LB is pre-load with a set of unique keys for LoRaWAN registrations, register these keys to local LoRaWAN server and it will auto connect after power on.
41.13	47	)))
2.2	48
	49
40.7	50	[[image:image-20230201084414-1.png\|\|height="464" width="1108"]]
2.2	51
	52
9.2	53	== 1.2 Features ==
	54
	55
2.2	56	* LoRaWAN 1.0.3 Class A
	57	* Ultra-low power consumption
	58	* Controllable 5v and 12v output to power external sensor
	59	* SDI-12 Protocol to connect to SDI-12 Sensor
	60	* Monitor Battery Level
	61	* Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865
	62	* Support Bluetooth v5.1 and LoRaWAN remote configure.
	63	* Support wireless OTA update firmware
	64	* Uplink on periodically
	65	* Downlink to change configure
	66	* 8500mAh Battery for long term use
	67
41.20	68
	69
9.2	70	== 1.3 Specification ==
2.2	71
	72
40.2	73	(% style="color:#037691" %)Micro Controller:
2.2	74
	75	* MCU: 48Mhz ARM
	76	* Flash: 256KB
	77	* RAM: 64KB
	78
40.2	79	(% style="color:#037691" %)Common DC Characteristics:
2.2	80
	81	* Supply Voltage: 2.5v ~~ 3.6v
	82	* Operating Temperature: -40 ~~ 85°C
	83
40.2	84	(% style="color:#037691" %)LoRa Spec:
2.2	85
	86	* Frequency Range, Band 1 (HF): 862 ~~ 1020 Mhz
	87	* Max +22 dBm constant RF output vs.
	88	* RX sensitivity: down to -139 dBm.
	89	* Excellent blocking immunity
	90
40.2	91	(% style="color:#037691" %)Current Input Measuring :
2.2	92
	93	* Range: 0 ~~ 20mA
	94	* Accuracy: 0.02mA
	95	* Resolution: 0.001mA
	96
40.2	97	(% style="color:#037691" %)Voltage Input Measuring:
2.2	98
	99	* Range: 0 ~~ 30v
	100	* Accuracy: 0.02v
	101	* Resolution: 0.001v
	102
40.2	103	(% style="color:#037691" %)Battery:
2.2	104
	105	* Li/SOCI2 un-chargeable battery
	106	* Capacity: 8500mAh
	107	* Self-Discharge: <1% / Year @ 25°C
	108	* Max continuously current: 130mA
	109	* Max boost current: 2A, 1 second
	110
40.2	111	(% style="color:#037691" %)Power Consumption
2.2	112
	113	* Sleep Mode: 5uA @ 3.3v
	114	* LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
	115
41.20	116
	117
9.2	118	== 1.4 Connect to SDI-12 Sensor ==
2.2	119
	120
	121
40.7	122	[[image:1675212538524-889.png]]
2.2	123
	124
9.2	125	== 1.5 Sleep mode and working mode ==
2.2	126
	127
40.2	128	(% style="color:blue" %)Deep Sleep Mode: (%%)Sensor doesn't have any LoRaWAN activate. This mode is used for storage and shipping to save battery life.
2.2	129
40.2	130	(% style="color:blue" %)Working Mode: (%%)In this mode, Sensor will work as LoRaWAN Sensor to Join LoRaWAN network and send out sensor data to server. Between each sampling/tx/rx periodically, sensor will be in IDLE mode), in IDLE mode, sensor has the same power consumption as Deep Sleep mode.
2.2	131
	132
9.2	133	== 1.6 Button & LEDs ==
2.2	134
	135
40.7	136	[[image:1675212633011-651.png]]
2.2	137
	138
9.2	139	(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
41.14	140	\|=(% style="width: 167px;" %)Behavior on ACT\|=(% style="width: 109px;" %)Function\|=(% style="width: 231px;" %)Action
	141	\|(% style="width:167px" %)Pressing ACT between 1s < time < 3s\|(% style="width:109px" %)Send an uplink\|(% style="width:231px" %)(((
9.2	142	If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)blue led (%%)will blink once.
2.2	143	Meanwhile, BLE module will be active and user can connect via BLE to configure device.
	144	)))
41.14	145	\|(% style="width:167px" %)Pressing ACT for more than 3s\|(% style="width:109px" %)Active Device\|(% style="width:231px" %)(((
9.2	146	(% style="color:green" %)Green led(%%) will fast blink 5 times, device will enter (% style="color:#037691" %)OTA mode(%%) for 3 seconds. And then start to JOIN LoRaWAN network.
	147	(% style="color:green" %)Green led(%%) will solidly turn on for 5 seconds after joined in network.
2.2	148	Once sensor is active, BLE module will be active and user can connect via BLE to configure device, no matter if device join or not join LoRaWAN network.
	149	)))
41.14	150	\|(% style="width:167px" %)Fast press ACT 5 times.\|(% style="width:109px" %)Deactivate Device\|(% style="width:231px" %)(% style="color:red" %)Red led(%%) will solid on for 5 seconds. Means PS-LB is in Deep Sleep Mode.
2.2	151
41.20	152
	153
9.2	154	== 1.7 Pin Mapping ==
2.2	155
	156
40.7	157	[[image:1675213198663-754.png]]
2.2	158
	159
9.2	160	== 1.8 BLE connection ==
2.2	161
9.2	162
2.2	163	SDI-12-LB support BLE remote configure.
	164
	165	BLE can be used to configure the parameter of sensor or see the console output from sensor. BLE will be only activate on below case:
	166
	167	* Press button to send an uplink
	168	* Press button to active device.
	169	* Device Power on or reset.
	170
	171	If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
	172
	173
9.2	174	== 1.9 Mechanical ==
2.2	175
	176
40.7	177	[[image:image-20230201090139-2.png]]
2.2	178
40.7	179	[[image:image-20230201090139-3.png]]
2.2	180
40.7	181	[[image:image-20230201090139-4.png]]
2.2	182
	183
19.2	184	= 2. Configure SDI-12 to connect to LoRaWAN network =
9.2	185
19.2	186	== 2.1 How it works ==
9.2	187
	188
40.2	189	The SDI-12-LB is configured as (% style="color:#037691" %)LoRaWAN OTAA Class A(%%) mode by default. It has OTAA keys to join LoRaWAN network. To connect a local LoRaWAN network, you need to input the OTAA keys in the LoRaWAN IoT server and activate the SDI-12-LB. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes.
9.2	190
2.2	191
19.2	192	== 2.2 Quick guide to connect to LoRaWAN server (OTAA) ==
2.2	193
	194
	195	Following is an example for how to join the [[TTN v3 LoRaWAN Network>>url:https://console.cloud.thethings.network/]]. Below is the network structure; we use the [[LPS8v2>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/228-lps8v2.html]] as a LoRaWAN gateway in this example.
	196
	197
40.7	198	[[image:image-20230201090528-5.png\|\|height="465" width="1111"]]
2.2	199
	200
	201	The LPS8V2 is already set to connected to [[TTN network >>url:https://console.cloud.thethings.network/]], so what we need to now is configure the TTN server.
	202
	203
40.2	204	(% style="color:blue" %)Step 1(%%): Create a device in TTN with the OTAA keys from SDI-12-LB.
2.2	205
	206	Each SDI-12-LB is shipped with a sticker with the default device EUI as below:
	207
	208
41.2	209	[[image:image-20230201152430-20.jpeg]]
2.2	210
	211
	212	You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
	213
	214
40.2	215	(% style="color:blue" %)Register the device
2.2	216
40.7	217	[[image:1675213652444-622.png]]
2.2	218
	219
40.2	220	(% style="color:blue" %)Add APP EUI and DEV EUI
2.2	221
	222
40.7	223	[[image:1675213661769-223.png]]
2.2	224
	225
40.2	226	(% style="color:blue" %)Add APP EUI in the application
2.2	227
	228
40.7	229	[[image:1675213675852-577.png]]
2.2	230
	231
40.2	232	(% style="color:blue" %)Add APP KEY
2.2	233
40.7	234	[[image:1675213686734-883.png]]
2.2	235
	236
40.2	237	(% style="color:blue" %)Step 2(%%): Activate on SDI-12-LB
2.2	238
	239
	240	Press the button for 5 seconds to activate the SDI-12-LB.
	241
40.2	242	(% style="color:green" %)Green led(%%) will fast blink 5 times, device will enter (% style="color:blue" %)OTA mode (%%)for 3 seconds. And then start to JOIN LoRaWAN network. (% style="color:green" %)Green led(%%) will solidly turn on for 5 seconds after joined in network.
2.2	243
	244
40.7	245	[[image:1675213704414-644.png]]
2.2	246
	247
19.2	248	== 2.3 SDI-12 Related Commands ==
2.2	249
	250
19.2	251	User need to configure SDI-12-LB to communicate with SDI-12 sensors otherwise the uplink payload will only include a few bytes.
2.2	252
	253
29.2	254	=== 2.3.1 Basic SDI-12 debug command ===
2.2	255
	256
	257	User can run some basic SDI-12 command to debug the connection to the SDI-12 sensor. These commands can be sent via AT Command or LoRaWAN downlink command.
	258
	259	If SDI-12 sensor return value after get these commands, //SDI-12-LB// will uplink the return on FPORT=100, otherwise, if there is no response from SDI-12 sensor. //SDI-12-LB// will uplink NULL (0x 4E 55 4C 4C) to server.
	260
	261	The following is the display information on the serial port and the server.
	262
	263
40.7	264	[[image:image-20230201091027-6.png]]
2.2	265
19.2	266
40.7	267	[[image:image-20230201091027-7.png\|\|height="261" width="1179"]]
19.2	268
	269
41.4	270
40.2	271	==== (% style="color:blue" %)al! ~-~- Get SDI-12 sensor Identification(%%) ====
19.2	272
	273
2.2	274	* AT Command: AT+ADDRI=aa
	275	* LoRaWAN Downlink(prefix 0xAA00): AA 00 aa
	276
40.2	277	(% style="color:#037691" %)Parameter: (%%)aa: ASCII value of SDI-12 sensor address in downlink or HEX value in AT Command)
2.2	278
41.4	279	(% style="color:blue" %)Example : (%%)AT+ADDRI=0 ( Equal to downlink: 0x AA 00 30)
2.2	280
	281
	282	The following is the display information on the serial port and the server.
	283
	284
40.7	285	[[image:image-20230201091257-8.png]]
2.2	286
	287
40.7	288	[[image:image-20230201091257-9.png\|\|height="225" width="1242"]]
19.2	289
	290
40.2	291	==== (% style="color:blue" %)aM!,aMC!, aM1!- aM9!, aMC1!- aMC9!(%%) ====
2.2	292
	293
40.2	294	(% style="color:red" %)aM! (%%): Start Non-Concurrent Measurement
2.2	295
40.2	296	(% style="color:red" %)aMC! (%%): Start Non-Concurrent Measurement – Request CRC
2.2	297
40.2	298	(% style="color:red" %)aM1!- aM9! (%%): Additional Measurements
2.2	299
40.2	300	(% style="color:red" %)aMC1!- aMC9!(%%) : Additional Measurements – Request CRC
2.2	301
27.2	302
2.2	303	* AT Command : AT+ADDRM=0,1,0,1
37.10	304
2.2	305	* LoRaWAN Downlink(prefix 0xAA01): 0xAA 01 30 01 00 01
	306
	307	Downlink：AA 01 aa bb cc dd
	308
40.2	309	(% style="color:#037691" %)aa(%%): SDI-12 sensor address.
2.2	310
40.2	311	(% style="color:#037691" %)bb(%%): 0: no CRC, 1: request CRC
2.2	312
40.2	313	(% style="color:#037691" %)cc(%%): 1-9: Additional Measurement, 0: no additional measurement
2.2	314
41.5	315	(% style="color:#037691" %)dd(%%): delay (in second) to send (% style="color:#037691" %)__aD0!__(%%) to get return.
2.2	316
	317
	318	The following is the display information on the serial port and the server.
	319
	320
40.7	321	[[image:image-20230201091630-10.png]]
2.2	322
	323
40.7	324	[[image:image-20230201091630-11.png\|\|height="247" width="1165"]]
2.2	325
	326
	327
40.2	328	==== (% style="color:blue" %)aC!, aCC!, aC1!- aC9!, aCC1!- aCC9! (%%) ====
2.2	329
	330
40.2	331	(% style="color:red" %)aC!(%%) : Start Concurrent Measurement
2.2	332
40.2	333	(% style="color:red" %)aCC! (%%): Start Concurrent Measurement – Request CRC
2.2	334
40.2	335	(% style="color:red" %)aC1!- aC9!(%%) : Start Additional Concurrent Measurements
27.2	336
40.2	337	(% style="color:red" %)aCC1!- aCC9!(%%) : Start Additional Concurrent Measurements – Request CRC
27.2	338
	339
2.2	340	* AT Command : AT+ADDRC=0,1,0,1
	341
	342	* LoRaWAN Downlink(0xAA02): 0xAA 02 30 01 00 01
	343
	344	Downlink: AA 02 aa bb cc dd
	345
40.2	346	(% style="color:#037691" %)aa(%%): SDI-12 sensor address.
2.2	347
40.2	348	(% style="color:#037691" %)bb(%%): 0: no CRC, 1: request CRC
2.2	349
40.2	350	(% style="color:#037691" %)cc(%%): 1-9: Additional Measurement, 0: no additional measurement
2.2	351
41.5	352	(% style="color:#037691" %)dd(%%): delay (in second) to send (% style="color:#037691" %)__aD0!__(%%)__ __to get return.
2.2	353
	354
	355	The following is the display information on the serial port and the server.
	356
	357
40.7	358	[[image:image-20230201091954-12.png]]
2.2	359
	360
40.7	361	[[image:image-20230201091954-13.png\|\|height="203" width="1117"]]
2.2	362
27.2	363
	364
	365
40.2	366	==== (% style="color:blue" %)aR0!- aR9!, aRC0!- aRC9!(%%) ====
27.2	367
37.10	368
2.2	369	Start Continuous Measurement
	370
	371	Start Continuous Measurement – Request CRC
	372
	373
	374	* AT Command : AT+ADDRR=0,1,0,1
	375	* LoRaWAN Downlink (0xAA 03): 0xAA 03 30 01 00 01
	376
	377	Downlink: AA 03 aa bb cc dd
	378
40.2	379	(% style="color:#037691" %)aa(%%): SDI-12 sensor address.
2.2	380
40.2	381	(% style="color:#037691" %)bb(%%): 0: no CRC, 1: request CRC
2.2	382
40.2	383	(% style="color:#037691" %)cc(%%): 1-9: Additional Measurement, 0: no additional measurement
2.2	384
41.5	385	(% style="color:#037691" %)dd(%%): delay (in second) to send (% style="color:#037691" %)__aD0!__(%%) to get return.
2.2	386
	387
	388	The following is the display information on the serial port and the server.
	389
	390
40.7	391	[[image:image-20230201092208-14.png]]
2.2	392
27.2	393
40.7	394	[[image:image-20230201092208-15.png\|\|height="214" width="1140"]]
27.2	395
	396
37.2	397	=== 2.3.2 Advance SDI-12 Debug command ===
27.2	398
	399
2.2	400	This command can be used to debug all SDI-12 command.
	401
	402
	403	LoRaWAN Downlink: A8 aa xx xx xx xx bb cc
	404
40.2	405	(% style="color:#037691" %)aa (%%): total SDI-12 command length
2.2	406
40.2	407	(% style="color:#037691" %)xx (%%): SDI-12 command
2.2	408
40.2	409	(% style="color:#037691" %)bb (%%): Delay to wait for return
2.2	410
40.2	411	(% style="color:#037691" %)cc (%%): 0: don't uplink return to LoRaWAN, 1: Uplink return to LoRaWAN on FPORT=100
2.2	412
	413
40.2	414	(% style="color:blue" %)Example: (%%) AT+CFGDEV =0RC0!,1
2.2	415
40.2	416	(% style="color:#037691" %)0RC0! (%%): SDI-12 Command,
2.2	417
40.2	418	(% style="color:#037691" %)1 (%%): Delay 1 second. ( 0: 810 mini-second)
2.2	419
	420	Equal Downlink: 0xA8 05 30 52 43 30 21 01 01
	421
	422
	423	The following is the display information on the serial port and the server.
	424
	425
40.7	426	[[image:image-20230201092355-16.png]]
2.2	427
	428
40.7	429	[[image:image-20230201092355-17.png\|\|height="426" width="1135"]]
27.2	430
29.2	431
	432	=== 2.3.3 Convert ASCII to String ===
	433
	434
2.2	435	This command is used to convert between ASCII and String format.
	436
	437	AT+CONVFORM ( Max length: 80 bytes)
	438
	439
40.2	440	(% style="color:blue" %)Example:
2.2	441
29.2	442	1) AT+CONVFORM=0, string Convert String from String to ASCII
2.2	443
40.7	444	[[image:1675214845056-885.png]]
2.2	445
	446
29.2	447	2) AT+CONVFORM=1, ASCII Convert ASCII to String.
2.2	448
40.7	449	[[image:1675214856590-846.png]]
2.2	450
29.2	451
	452	=== 2.3.4 Define periodically SDI-12 commands and uplink. ===
	453
	454
2.2	455	AT+COMMANDx & AT+DATACUTx
	456
	457	User can define max 15 SDI-12 Commands (AT+COMMAND1 ~~ AT+COMMANDF). On each uplink period (TDC time, default 20 minutes), SDI-12-LB will send these SDI-12 commands and wait for return from SDI-12 sensors. SDI-12-LB will then combine these returns and uplink via LoRaWAN.
	458
	459
40.2	460	* (% style="color:blue" %)AT Command:
2.2	461
40.2	462	(% style="color:#037691" %)AT+COMMANDx=var1,var2,var3,var4.
2.2	463
40.2	464	(% style="color:red" %)var1(%%): SDI-12 command , for example: 0RC0!
2.2	465
40.2	466	(% style="color:red" %)var2(%%): Wait timeout for return. (unit: second)
2.2	467
40.2	468	(% style="color:red" %)var3(%%): Whether to send //addrD0!// to get return after var2 timeout. 0: Don't Send //addrD0! //; 1: Send //addrD0!//.
2.2	469
40.2	470	(% style="color:red" %)var4(%%): validation check for return. If return invalid, SDI-12-LB will resend this command. Max 2 retries.
2.2	471
40.2	472	(% style="color:red" %)0 (%%) No validation check;
2.2	473
40.2	474	(% style="color:red" %)1 (%%) Check if return chars are printable char(0x20 ~~ 0x7E);
2.2	475
41.5	476	(% style="color:red" %)2(%%) Check if there is return from SDI-12 sensor
2.2	477
40.2	478	(% style="color:red" %)3 (%%) Check if return pass CRC check ( SDI-12 command var1 must include CRC request);
2.2	479
	480
40.2	481	Each AT+COMMANDx is followed by a (% style="color:blue" %)AT+DATACUT(%%) command. AT+DATACUT command is used to take the useful string from the SDI-12 sensor so the final payload will have the minimum length to uplink.
2.2	482
	483
40.2	484	(% style="color:blue" %)AT+DATACUTx(%%) : This command defines how to handle the return from AT+COMMANDx, max return length is 100 bytes.
2.2	485
29.2	486	(% border="1" style="background-color:#f7faff; width:436px" %)
	487	\|(% style="width:433px" %)(((
35.2	488	AT+DATACUTx=a,b,c
2.2	489
29.2	490	a: length for the return of AT+COMMAND
2.2	491
37.11	492	b: 1: grab valid value by byte, max 6 bytes. 2: grab valid value by bytes section, max 3 sections.
2.2	493
29.2	494	c: define the position for valid value.
2.2	495	)))
	496
35.2	497	For example, if return from AT+COMMAND1 is “013METER TER12 112T12-00024895” , Below AT+DATACUT1 will get different result to combine payload:
2.2	498
	499
35.2	500	(% border="1" cellspacing="4" style="background-color:#f7faff; width:510px" %)
41.15	501	\|=(% style="width: 164px;" %)AT+DATACUT1 value\|=(% style="width: 344px;" %)Final Result to combine Payload
	502	\|(% style="width:164px" %)34,1,1+2+3\|(% style="width:344px" %)0D 00 01 30 31 33
	503	\|(% style="width:164px" %)34,2,1~~8+12~~16\|(% style="width:344px" %)0D 00 01 30 31 33 4D 45 54 45 52 54 45 52 31 32
	504	\|(% style="width:164px" %)34,2,1~~34\|(% style="width:344px" %)0D 00 01 30 31 33 4D 45 54 45 52 20 20 20 54 45 52 31 32 20 31 31 32 54 31 32 2D 30 30 30 32 34 38 39 35 0D 0A
2.2	505
40.2	506	* (% style="color:blue" %) Downlink Payload:
2.2	507
40.2	508	(% style="color:blue" %)0xAF(%%) downlink command can be used to set AT+COMMANDx or AT+DATACUTx.
2.2	509
	510
40.2	511	(% style="color:red" %)Note : if user use AT+COMMANDx to add a new command, he also need to send AT+DATACUTx downlink.
2.2	512
	513
40.2	514	Format: (% style="color:#037691" %)AF MM NN LL XX XX XX XX YY(%%)
2.2	515
	516	Where:
	517
40.2	518	* (% style="color:#037691" %)MM (%%): the AT+COMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
	519	* (% style="color:#037691" %)NN (%%): 1: set the AT+DATACUT value ; 2: set the AT+DATACUT value.
	520	* (% style="color:#037691" %)LL (%%): The length of AT+COMMAND or AT+DATACUT command
	521	* (% style="color:#037691" %)XX XX XX XX (%%): AT+COMMAND or AT+DATACUT command
	522	* (% style="color:#037691" %)YY (%%): If YY=0, RS485-LN will execute the downlink command without uplink; if YY=1, RS485-LN will execute an uplink after got this command.
2.2	523
40.2	524	(% style="color:blue" %)Example:
2.2	525
40.7	526	[[image:image-20230201094129-18.png]]
2.2	527
	528
41.16	529
40.2	530	(% style="color:blue" %)Clear SDI12 Command
2.2	531
	532	The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them.
	533
	534
40.2	535	* (% style="color:#037691" %)AT Command:
2.2	536
40.2	537	(% style="color:#4f81bd" %)AT+CMDEAR=mm,nn (%%) mm: start position of erase ,nn: stop position of erase
2.2	538
	539
	540	Etc. AT+CMDEAR=1,10 means erase AT+COMMAND1/AT+DATACUT1 to AT+COMMAND10/AT+DATACUT10
	541
	542
40.2	543	* (% style="color:#037691" %) Downlink Payload:
2.2	544
40.2	545	(% style="color:#4f81bd" %)0x09 aa bb(%%) same as AT+CMDEAR=aa,bb
2.2	546
	547
	548
40.2	549	(% style="color:blue" %)command combination
2.2	550
	551	Below shows a screen shot how the results combines together to a uplink payload.
	552
40.7	553	[[image:1675215745275-920.png]]
2.2	554
	555
35.2	556	If user don't want to use DATACUT for some command, he simply want to uplink all returns. AT+ALLDATAMOD can be set to 1.
2.2	557
40.2	558	(% style="color:blue" %)AT+ALLDATAMOD(%%) will simply get all return and don't do CRC check as result for SDI-12 command. AT+DATACUTx command has higher priority, if AT+DATACUTx has been set, AT+ALLDATAMOD will be ignore for this SDI-12 command.
2.2	559
	560
41.7	561	(% style="color:#4f81bd" %)For example: (%%) as below photo, AT+ALLDATAMOD=1, but AT+DATACUT1 has been set, AT+DATACUT1 will be still effect the result.
2.2	562
	563
40.7	564	[[image:1675215782925-448.png]]
2.2	565
	566
40.2	567	If AT+ALLDATAMOD=1, (% style="color:#4f81bd" %)FX,X(%%) will be added in the payload, FX specify which command is used and X specify the length of return. for example in above screen, F1 05 means the return is from AT+COMMAND1 and the return is 5 bytes.
2.2	568
	569
	570
41.17	571	(% style="color:blue" %)Compose Uplink
2.2	572
40.2	573	(% style="color:#4f81bd" %)AT+DATAUP=0
2.2	574
41.8	575	Compose the uplink payload with value returns in sequence and send with __A SIGNLE UPLINK__.
2.2	576
41.8	577	Final Payload is __Battery Info+PAYVER + VALID Value from RETURN1 + Valid Value from RETURN2 + … + RETURNx__
2.2	578
	579	Where PAYVER is defined by AT+PAYVER, below is an example screen shot.
	580
	581
40.7	582	[[image:1675215828102-844.png]]
2.2	583
	584
40.2	585	(% style="color:#4f81bd" %)AT+DATAUP=1
2.2	586
41.8	587	Compose the uplink payload with value returns in sequence and send with __Multiply UPLINKs__.
2.2	588
41.8	589	Final Payload is __Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA__
2.2	590
	591	1. Battery Info (2 bytes): Battery voltage
	592	1. PAYVER (1 byte): Defined by AT+PAYVER
	593	1. PAYLOAD COUNT (1 byte): Total how many uplinks of this sampling.
	594	1. PAYLOAD# (1 byte): Number of this uplink. (from 0,1,2,3…,to PAYLOAD COUNT)
	595	1. DATA: Valid value: max 6 bytes(US915 version here, Notice*!) for each uplink so each uplink <= 11 bytes. For the last uplink, DATA will might less than 6 bytes
	596
40.7	597	[[image:1675215848113-696.png]]
2.2	598
	599
40.2	600	(% style="color:red" %)Notice: the Max bytes is according to the max support bytes in different Frequency Bands for lowest SF. As below:
2.2	601
35.2	602	* For AU915/AS923 bands, if UplinkDwell time=0, max 51 bytes for each uplink ( so 51 -5 = 46 max valid date)
	603	* For AU915/AS923 bands, if UplinkDwell time=1, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date).
	604	* For US915 band, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date).
	605	* For all other bands: max 51 bytes for each uplink ( so 51 -5 = 46 max valid date).
2.2	606
40.2	607	(% style="color:red" %)When AT+DATAUP=1, the maximum number of segments is 15, and the maximum total number of bytes is 1500;
2.2	608
40.2	609	(% style="color:red" %)When AT+DATAUP=1 and AT+ADR=0, the maximum number of bytes of each payload is determined by the DR value.
2.2	610
	611
40.7	612	== 2.4 Uplink Payload ==
2.2	613
	614
	615	Uplink payloads have two types:
	616
	617	* Distance Value: Use FPORT=2
	618	* Other control commands: Use other FPORT fields.
	619
	620	The application server should parse the correct value based on FPORT settings.
	621
	622
37.2	623	=== 2.4.1 Device Payload, FPORT~=5 ===
2.2	624
37.2	625
2.2	626	Include device configure status. Once SDI-12-LB Joined the network, it will uplink this message to the server.
	627
	628	Users can also use the downlink command(0x26 01) to ask SDI-12-LB to resend this uplink.
	629
41.17	630	(% border="1" cellspacing="4" style="background-color:#f7faff; width:420px" %)
35.2	631	\|(% colspan="6" style="width:434px" %)Device Status (FPORT=5)
41.17	632	\|(% style="width:114px" %)Size(bytes)\|(% style="width:39px" %)1\|(% style="width:80px" %)2\|(% style="width:89px" %)1\|(% style="width:59px" %)1\|(% style="width:37px" %)2
	633	\|(% style="width:114px" %)Value\|(% style="width:39px" %)Sensor Model\|(% style="width:80px" %)Firmware Version\|(% style="width:89px" %)Frequency Band\|(% style="width:59px" %)Sub-band\|(% style="width:37px" %)BAT
2.2	634
	635	Example parse in TTNv3
	636
40.7	637	[[image:1675215946738-635.png]]
2.2	638
37.2	639
40.2	640	(% style="color:#037691" %)Sensor Model(%%): For SDI-12-LB, this value is 0x17
2.2	641
40.2	642	(% style="color:#037691" %)Firmware Version(%%): 0x0100, Means: v1.0.0 version
2.2	643
40.2	644	(% style="color:#037691" %)Frequency Band:
2.2	645
	646	*0x01: EU868
	647
	648	*0x02: US915
	649
	650	*0x03: IN865
	651
	652	*0x04: AU915
	653
	654	*0x05: KZ865
	655
	656	*0x06: RU864
	657
	658	*0x07: AS923
	659
	660	*0x08: AS923-1
	661
	662	*0x09: AS923-2
	663
	664	*0x0a: AS923-3
	665
	666	*0x0b: CN470
	667
	668	*0x0c: EU433
	669
	670	*0x0d: KR920
	671
	672	*0x0e: MA869
	673
	674
40.2	675	(% style="color:#037691" %)Sub-Band:
2.2	676
	677	AU915 and US915:value 0x00 ~~ 0x08
	678
	679	CN470: value 0x0B ~~ 0x0C
	680
	681	Other Bands: Always 0x00
	682
	683
40.2	684	(% style="color:#037691" %)Battery Info:
2.2	685
	686	Check the battery voltage.
	687
	688	Ex1: 0x0B45 = 2885mV
	689
	690	Ex2: 0x0B49 = 2889mV
	691
	692
37.2	693	=== 2.4.2 Uplink Payload, FPORT~=2 ===
2.2	694
37.2	695
2.2	696	There are different cases for uplink. See below
	697
	698	* SDI-12 Debug Command return: FPORT=100
	699
	700	* Periodically Uplink: FPORT=2
	701
41.18	702	(% border="1" cellspacing="4" style="background-color:#f7faff; width:500px" %)
41.19	703	\|=(% style="width: 90px;" %)(((
37.2	704	Size(bytes)
41.19	705	)))\|=(% style="width: 80px;" %)2\|=(% style="width: 90px;" %)1\|=(% style="width: 240px;" %)Length depends on the return from the commands
37.2	706	\|(% style="width:93px" %)Value\|(% style="width:83px" %)(((
2.2	707	Battery(mV)
	708	&
	709	Interrupt_Flag
41.18	710	)))\|(% style="width:91px" %)[[PAYLOAD_VER>>\|\|anchor="H3.6Setthepayloadversion"]]\|(% style="width:212px" %)(((
37.2	711	If the valid payload is too long and exceed the maximum support.
2.2	712	Payload length in server,server will show payload not provided in the LoRaWAN server.
	713	)))
	714
40.7	715	[[image:1675216282284-923.png]]
2.2	716
	717
37.2	718	=== 2.4.3 Battery Info ===
2.2	719
	720
	721	Check the battery voltage for SDI-12-LB.
	722
	723	Ex1: 0x0B45 = 2885mV
	724
	725	Ex2: 0x0B49 = 2889mV
	726
	727
37.2	728	=== 2.4.4 Interrupt Pin ===
2.2	729
37.2	730
40.2	731	This data field shows if this packet is generated by (% style="color:#037691" %)Interrupt Pin(%%) or not. [[Click here>>\|\|anchor="H3.2SetInterruptMode"]] for the hardware and software set up. Note: The Internet Pin is a separate pin in the screw terminal. See [[pin mapping>>\|\|anchor="H1.7PinMapping"]].
2.2	732
37.2	733	Example:
2.2	734
	735	Ex1: 0x0B45:0x0B&0x80= 0x00 Normal uplink packet.
	736
	737	Ex2: 0x8B49:0x8B&0x80= 0x80 Interrupt Uplink Packet.
	738
	739
37.2	740	=== 2.4.5 Payload version ===
2.2	741
	742
	743
37.2	744	=== 2.4.6 Decode payload in The Things Network ===
2.2	745
	746
	747	While using TTN network, you can add the payload format to decode the payload.
	748
40.7	749	[[image:1675216779406-595.png]]
2.2	750
	751
	752	There is no fix payload decoder in LoRaWAN server because the SDI-12 sensors returns are different. User need to write the decoder themselves for their case.
	753
37.2	754	SDI-12-LB TTN Payload Decoder: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>url:https://github.com/dragino/dragino-end-node-decoder]]
2.2	755
	756
37.3	757	== 2.5 Uplink Interval ==
2.2	758
	759
	760	The SDI-12-LB by default uplink the sensor data every 20 minutes. User can change this interval by AT Command or LoRaWAN Downlink Command. See this link:
	761
40.2	762	[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/#H4.1ChangeUplinkInterval>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/#H4.1ChangeUplinkInterval]]]]
2.2	763
	764
37.3	765	== 2.6 Frequency Plans ==
2.2	766
	767
37.3	768	The SDI-12-LB uses OTAA mode and below frequency plans by default. If user want to use it with different frequency plan, please refer the AT command sets.
2.2	769
37.3	770	[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
2.2	771
	772
37.3	773	== 2.7 Firmware Change Log ==
	774
	775
2.2	776	Firmware download link:
	777
41.9	778	[[https:~~/~~/www.dropbox.com/sh/qrbgbikb109lkiv/AACBR-v_ZhZAMengcY7Nsa1ja?dl=0>>https://www.dropbox.com/sh/qrbgbikb109lkiv/AACBR-v_ZhZAMengcY7Nsa1ja?dl=0]]
2.2	779
	780
37.3	781	= 3. Configure SDI-12-LB via AT Command or LoRaWAN Downlink =
2.2	782
	783
	784	Use can configure SDI-12-LB via AT Command or LoRaWAN Downlink.
	785
40.8	786	* AT Command Connection: See [[FAQ>>\|\|anchor="H7.FAQ"]].
37.3	787	* LoRaWAN Downlink instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
2.2	788
	789	There are two kinds of commands to configure SDI-12-LB, they are:
	790
40.7	791	* (% style="color:blue" %)General Commands.
2.2	792
	793	These commands are to configure:
	794
	795	* General system settings like: uplink interval.
	796	* LoRaWAN protocol & radio related command.
	797
	798	They are same for all Dragino Device which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:
	799
40.2	800	[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/]]
2.2	801
	802
40.7	803	* (% style="color:blue" %)Commands special design for SDI-12-LB
2.2	804
	805	These commands only valid for SDI-12-LB, as below:
	806
	807
37.3	808	== 3.1 Set Transmit Interval Time ==
2.2	809
	810
	811	Feature: Change LoRaWAN End Node Transmit Interval.
	812
37.3	813	(% style="color:blue" %)AT Command: AT+TDC
2.2	814
37.3	815	(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
	816	\|=(% style="width: 156px;" %)Command Example\|=(% style="width: 137px;" %)Function\|=Response
	817	\|(% style="width:156px" %)AT+TDC=?\|(% style="width:137px" %)Show current transmit Interval\|(((
2.2	818	30000
	819	OK
	820	the interval is 30000ms = 30s
	821	)))
37.3	822	\|(% style="width:156px" %)AT+TDC=60000\|(% style="width:137px" %)Set Transmit Interval\|(((
2.2	823	OK
	824	Set transmit interval to 60000ms = 60 seconds
	825	)))
	826
37.3	827	(% style="color:blue" %)Downlink Command: 0x01
2.2	828
37.3	829
2.2	830	Format: Command Code (0x01) followed by 3 bytes time value.
	831
37.6	832	If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
2.2	833
37.6	834	* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
	835	* Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
2.2	836
41.20	837
	838
37.3	839	== 3.2 Set Interrupt Mode ==
2.2	840
37.6	841
2.2	842	Feature, Set Interrupt mode for GPIO_EXIT.
	843
37.3	844	(% style="color:blue" %)AT Command: AT+INTMOD
2.2	845
37.3	846	(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
37.6	847	\|=(% style="width: 156px;" %)Command Example\|=(% style="width: 187px;" %)Function\|=(% style="width: 165px;" %)Response
	848	\|(% style="width:156px" %)AT+INTMOD=?\|(% style="width:187px" %)Show current interrupt mode\|(% style="width:165px" %)(((
2.2	849	0
	850	OK
	851	the mode is 0 = No interruption
	852	)))
37.6	853	\|(% style="width:156px" %)AT+INTMOD=2\|(% style="width:187px" %)(((
2.2	854	Set Transmit Interval
37.3	855	~1. (Disable Interrupt),
	856	2. (Trigger by rising and falling edge)
	857	3. (Trigger by falling edge)
	858	4. (Trigger by rising edge)
37.6	859	)))\|(% style="width:165px" %)OK
2.2	860
37.3	861	(% style="color:blue" %)Downlink Command: 0x06
2.2	862
	863	Format: Command Code (0x06) followed by 3 bytes.
	864
	865	This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
	866
37.6	867	* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
	868	* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
2.2	869
41.20	870
	871
37.3	872	== 3.3 Set the output time ==
	873
	874
2.2	875	Feature, Control the output 3V3 , 5V or 12V.
	876
37.3	877	(% style="color:blue" %)AT Command: AT+3V3T
2.2	878
37.3	879	(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:474px" %)
	880	\|=(% style="width: 154px;" %)Command Example\|=(% style="width: 201px;" %)Function\|=(% style="width: 116px;" %)Response
	881	\|(% style="width:154px" %)AT+3V3T=?\|(% style="width:201px" %)Show 3V3 open time.\|(% style="width:116px" %)(((
2.2	882	0
	883	OK
	884	)))
37.3	885	\|(% style="width:154px" %)AT+3V3T=0\|(% style="width:201px" %)Normally open 3V3 power supply.\|(% style="width:116px" %)(((
2.2	886	OK
	887	default setting
	888	)))
37.3	889	\|(% style="width:154px" %)AT+3V3T=1000\|(% style="width:201px" %)Close after a delay of 1000 milliseconds.\|(% style="width:116px" %)(((
2.2	890	OK
	891	)))
37.3	892	\|(% style="width:154px" %)AT+3V3T=65535\|(% style="width:201px" %)Normally closed 3V3 power supply.\|(% style="width:116px" %)(((
2.2	893	OK
	894	)))
	895
37.3	896	(% style="color:blue" %)AT Command: AT+5VT
2.2	897
37.3	898	(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:470px" %)
	899	\|=(% style="width: 155px;" %)Command Example\|=(% style="width: 196px;" %)Function\|=(% style="width: 114px;" %)Response
	900	\|(% style="width:155px" %)AT+5VT=?\|(% style="width:196px" %)Show 5V open time.\|(% style="width:114px" %)(((
2.2	901	0
	902	OK
	903	)))
37.3	904	\|(% style="width:155px" %)AT+5VT=0\|(% style="width:196px" %)Normally closed 5V power supply.\|(% style="width:114px" %)(((
2.2	905	OK
	906	default setting
	907	)))
37.3	908	\|(% style="width:155px" %)AT+5VT=1000\|(% style="width:196px" %)Close after a delay of 1000 milliseconds.\|(% style="width:114px" %)(((
2.2	909	OK
	910	)))
37.3	911	\|(% style="width:155px" %)AT+5VT=65535\|(% style="width:196px" %)Normally open 5V power supply.\|(% style="width:114px" %)(((
2.2	912	OK
	913	)))
	914
37.3	915	(% style="color:blue" %)AT Command: AT+12VT
2.2	916
37.3	917	(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:443px" %)
	918	\|=(% style="width: 156px;" %)Command Example\|=(% style="width: 199px;" %)Function\|=(% style="width: 83px;" %)Response
	919	\|(% style="width:156px" %)AT+12VT=?\|(% style="width:199px" %)Show 12V open time.\|(% style="width:83px" %)(((
2.2	920	0
	921	OK
	922	)))
37.3	923	\|(% style="width:156px" %)AT+12VT=0\|(% style="width:199px" %)Normally closed 12V power supply.\|(% style="width:83px" %)OK
	924	\|(% style="width:156px" %)AT+12VT=500\|(% style="width:199px" %)Close after a delay of 500 milliseconds.\|(% style="width:83px" %)(((
2.2	925	OK
	926	)))
	927
37.3	928	(% style="color:blue" %)Downlink Command: 0x07
2.2	929
	930	Format: Command Code (0x07) followed by 3 bytes.
	931
	932	The first byte is which power, the second and third bytes are the time to turn on.
	933
37.3	934	* Example 1: Downlink Payload: 070101F4 ~-~--> AT+3V3T=500
	935	* Example 2: Downlink Payload: 0701FFFF ~-~--> AT+3V3T=65535
	936	* Example 3: Downlink Payload: 070203E8 ~-~--> AT+5VT=1000
	937	* Example 4: Downlink Payload: 07020000 ~-~--> AT+5VT=0
	938	* Example 5: Downlink Payload: 070301F4 ~-~--> AT+12VT=500
	939	* Example 6: Downlink Payload: 07030000 ~-~--> AT+12VT=0
2.2	940
41.20	941
	942
37.3	943	== 3.4 Set the all data mode ==
	944
37.5	945
2.2	946	Feature, Set the all data mode.
	947
37.5	948	(% style="color:blue" %)AT Command: AT+ALLDATAMOD
2.2	949
37.5	950	(% border="1" cellspacing="4" style="background-color:#f7faff; width:437px" %)
	951	\|=Command Example\|=Function\|=Response
2.2	952	\|AT+ALLDATAMOD=?\|Show current all data mode\|(((
	953	0
	954	OK
	955	)))
	956	\|AT+ALLDATAMOD=1\|Set all data mode is 1.\|OK
	957
37.5	958	(% style="color:blue" %)Downlink Command: 0xAB
2.2	959
	960	Format: Command Code (0xAB) followed by 1 bytes.
	961
37.5	962	* Example 1: Downlink Payload: AB 00 ~/~/ AT+ALLDATAMOD=0
	963	* Example 2: Downlink Payload: AB 01 ~/~/ AT+ALLDATAMOD=1
2.2	964
41.20	965
	966
37.3	967	== 3.5 Set the splicing payload for uplink ==
	968
37.5	969
2.2	970	Feature, splicing payload for uplink.
	971
37.5	972	(% style="color:blue" %)AT Command: AT+DATAUP
2.2	973
37.5	974	(% border="1" cellspacing="4" style="background-color:#f7faff; width:510px" %)
	975	\|=(% style="width: 154px;" %)Command Example\|=(% style="width: 266px;" %)Function\|=Response
	976	\|(% style="width:154px" %)AT+DATAUP =?\|(% style="width:266px" %)Show current splicing payload for uplink mode\|(((
2.2	977	0
	978	OK
	979	)))
37.5	980	\|(% style="width:154px" %)AT+DATAUP =0\|(% style="width:266px" %)(((
2.2	981	Set splicing payload for uplink mode is 0.
	982	)))\|(((
	983	OK
	984	)))
37.5	985	\|(% style="width:154px" %)AT+DATAUP =1\|(% style="width:266px" %)Set splicing payload for uplink mode is 1 , and the each splice uplink is sent sequentially.\|OK
	986	\|(% style="width:154px" %)AT+DATAUP =1,20000\|(% style="width:266px" %)(((
37.3	987	Set splicing payload for uplink mode is 1, and the uplink interval of each splice to 20000 milliseconds.
2.2	988	)))\|OK
	989
37.5	990	(% style="color:blue" %)Downlink Command: 0xAD
2.2	991
	992	Format: Command Code (0xAD) followed by 1 bytes or 5 bytes.
	993
37.6	994	* Example 1: Downlink Payload: AD 00 ~/~/ AT+DATAUP=0
	995	* Example 2: Downlink Payload: AD 01 ~/~/ AT+DATAUP =1
	996	* Example 3: Downlink Payload: AD 01 00 00 14 ~/~/ AT+DATAUP =1,20000
2.2	997
	998	This means that the interval is set to 0x000014=20S
	999
	1000
37.3	1001	== 3.6 Set the payload version ==
2.2	1002
41.20	1003
2.2	1004	Feature, Set the payload version.
	1005
37.5	1006	(% style="color:blue" %)AT Command: AT+PAYVER
2.2	1007
37.6	1008	(% border="1" cellspacing="4" style="background-color:#f7faff; width:437px" %)
	1009	\|=(% style="width: 158px;" %)Command Example\|=(% style="width: 192px;" %)Function\|=Response
	1010	\|(% style="width:158px" %)AT+PAYVER=?\|(% style="width:192px" %)Show current payload version\|(((
2.2	1011	1
	1012	OK
	1013	)))
37.6	1014	\|(% style="width:158px" %)AT+PAYVER=5\|(% style="width:192px" %)Set payload version is 5.\|OK
2.2	1015
37.5	1016	(% style="color:blue" %)Downlink Command: 0xAE
2.2	1017
	1018	Format: Command Code (0xAE) followed by 1 bytes.
	1019
37.6	1020	* Example 1: Downlink Payload: AE 01 ~/~/ AT+PAYVER=1
	1021	* Example 2: Downlink Payload: AE 05 ~/~/ AT+PAYVER=5
2.2	1022
41.20	1023
	1024
37.3	1025	= 4. Battery & how to replace =
2.2	1026
37.3	1027	== 4.1 Battery Type ==
2.2	1028
	1029
37.5	1030	SDI-12-LB is equipped with a [[8500mAH ER26500 Li-SOCI2 battery>>https://www.dropbox.com/sh/w9l2oa3ytpculph/AAAPtt-apH4lYfCj-2Y6lHvQa?dl=0]]. The battery is un-rechargeable battery with low discharge rate targeting for 8~~10 years use. This type of battery is commonly used in IoT target for long-term running, such as water meter.
37.3	1031
	1032
2.2	1033	The discharge curve is not linear so can’t simply use percentage to show the battery level. Below is the battery performance.
	1034
40.7	1035	[[image:1675234124233-857.png]]
2.2	1036
	1037
37.5	1038	Minimum Working Voltage for the SDI-12-LB:
2.2	1039
37.5	1040	SDI-12-LB: 2.45v ~~ 3.6v
2.2	1041
	1042
37.3	1043	== 4.2 Replace Battery ==
2.2	1044
37.3	1045
2.2	1046	Any battery with range 2.45 ~~ 3.6v can be a replacement. We recommend to use Li-SOCl2 Battery.
	1047
	1048	And make sure the positive and negative pins match.
	1049
	1050
37.3	1051	== 4.3 Power Consumption Analyze ==
2.2	1052
	1053
	1054	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.
	1055
	1056	Instruction to use as below:
	1057
37.3	1058	(% style="color:blue" %)Step 1:(%%) Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from: [[https:~~/~~/www.dropbox.com/sh/zwex6i331j5oeq2/AACIMf9f_v2qsJ39CuMQ5Py_a?dl=0>>https://www.dropbox.com/sh/zwex6i331j5oeq2/AACIMf9f_v2qsJ39CuMQ5Py_a?dl=0]]
2.2	1059
37.3	1060	(% style="color:blue" %)Step 2:(%%) Open it and choose
2.2	1061
	1062	* Product Model
	1063	* Uplink Interval
	1064	* Working Mode
	1065
	1066	And the Life expectation in difference case will be shown on the right.
	1067
	1068
40.7	1069	[[image:1675234155374-163.png]]
2.2	1070
40.2	1071
2.2	1072	The battery related documents as below:
	1073
37.3	1074	* [[Battery Dimension>>https://www.dropbox.com/s/ox5g9njwjle7aw3/LSN50-Battery-Dimension.pdf?dl=0]],
	1075	* [[Lithium-Thionyl Chloride Battery datasheet, Tech Spec>>https://www.dropbox.com/sh/d4oyfnp8o94180o/AABQewCNSh5GPeQH86UxRgQQa?dl=0]]
	1076	* [[Lithium-ion Battery-Capacitor datasheet>>https://www.dropbox.com/s/791gjes2lcbfi1p/SPC_1520_datasheet.jpg?dl=0]], [[Tech Spec>>https://www.dropbox.com/s/4pkepr9qqqvtzf2/SPC1520%20Technical%20Specification20171123.pdf?dl=0]]
2.2	1077
40.7	1078	[[image:image-20230201145019-19.png]]
2.2	1079
	1080
37.3	1081	=== 4.3.1 Battery Note ===
2.2	1082
	1083
	1084	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.
	1085
	1086
37.3	1087	=== 4.3.2 Replace the battery ===
2.2	1088
	1089
37.5	1090	You can change the battery in the SDI-12-LB.The type of battery is not limited as long as the output is between 3v to 3.6v. On the main board, there is a diode (D1) between the battery and the main circuit. If you need to use a battery with less than 3.3v, please remove the D1 and shortcut the two pads of it so there won't be voltage drop between battery and main board.
2.2	1091
37.5	1092	The default battery pack of SDI-12-LB includes a ER26500 plus super capacitor. If user can't find this pack locally, they can find ER26500 or equivalence, which will also work in most case. The SPC can enlarge the battery life for high frequency use (update period below 5 minutes)
2.2	1093
	1094
37.3	1095	= 5. Remote Configure device =
2.2	1096
37.3	1097	== 5.1 Connect via BLE ==
2.2	1098
	1099
37.3	1100	Please see this instruction for how to configure via BLE: [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]]
2.2	1101
	1102
37.3	1103	== 5.2 AT Command Set ==
2.2	1104
	1105
	1106
37.3	1107	= 6. OTA firmware update =
	1108
	1109
2.2	1110	Please see this link for how to do OTA firmware update.
	1111
	1112	[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]
	1113
	1114
40.2	1115	= 7. FAQ =
2.2	1116
40.2	1117	== 7.1 How to use AT Command to access device? ==
2.2	1118
	1119
40.2	1120	See: [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware]]
	1121
	1122
	1123	== 7.2 How to update firmware via UART port? ==
	1124
	1125
	1126	See: [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware]]
	1127
	1128
	1129	== 7.3 How to change the LoRa Frequency Bands/Region? ==
	1130
	1131
	1132	You can follow the instructions for [[how to upgrade image>>doc:Main.Firmware Upgrade Instruction for STM32 base products.WebHome]].
	1133	When downloading the images, choose the required image file for download.
	1134
	1135
	1136	= 8. Order Info =
	1137
	1138
41.20	1139	(((
40.7	1140	(% style="color:blue" %)Part Number: SDI-12-LB-XXX
41.20	1141	)))
40.7	1142
41.20	1143	(((
37.4	1144	XXX: The default frequency band
41.20	1145	)))
2.2	1146
41.20	1147	(((
40.7	1148	(% style="color:red" %)AS923(%%): LoRaWAN AS923 band
	1149	(% style="color:red" %)AU915(%%): LoRaWAN AU915 band
	1150	(% style="color:red" %)EU433(%%): LoRaWAN EU433 band
	1151	(% style="color:red" %)EU868(%%): LoRaWAN EU868 band
	1152	(% style="color:red" %)KR920(%%): LoRaWAN KR920 band
	1153	(% style="color:red" %)US915(%%): LoRaWAN US915 band
	1154	(% style="color:red" %)IN865(%%): LoRaWAN IN865 band
	1155	(% style="color:red" %)CN470(%%): LoRaWAN CN470 band
41.20	1156	)))
2.2	1157
	1158
40.2	1159	= 9. Packing Info =
37.3	1160
	1161
40.7	1162	(% style="color:#037691" %)Package Includes:
2.2	1163
37.3	1164	* SDI-12-LB SDI-12 to LoRaWAN Converter x 1
2.2	1165
40.7	1166	(% style="color:#037691" %)Dimension and weight:
2.2	1167
	1168	* Device Size: cm
	1169	* Device Weight: g
	1170	* Package Size / pcs : cm
	1171	* Weight / pcs : g
	1172
41.20	1173
	1174
40.2	1175	= 10. Support =
37.3	1176
	1177
2.2	1178	* 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.
	1179
37.3	1180	* 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]]
2.2	1181
40.8	1182

Wiki source code of SDI-12-LB -- SDI-12 to LoRaWAN Converter User Manual

Applications

Navigation