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

Version 48.12 by Xiaoling on 2023/04/03 11:56

version	line-number	content
40.7	1	(% style="text-align:center" %)
47.1	2	[[image:image-20230131183542-1.jpeg\|\|_mstalt="470678" 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
47.1	50	[[image:image-20230201084414-1.png\|\|_mstalt="427765" 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
43.1	58	* Controllable 3.3v, 5v and 12v output to power external sensor
2.2	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
9.2	68	== 1.3 Specification ==
2.2	69
	70
40.2	71	(% style="color:#037691" %)Micro Controller:
2.2	72
	73	* MCU: 48Mhz ARM
	74	* Flash: 256KB
	75	* RAM: 64KB
	76
40.2	77	(% style="color:#037691" %)Common DC Characteristics:
2.2	78
	79	* Supply Voltage: 2.5v ~~ 3.6v
45.1	80	* Support current: 5V 300mA
	81	12V 100mA
2.2	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
9.2	116	== 1.4 Connect to SDI-12 Sensor ==
2.2	117
	118
	119
47.1	120	[[image:1675212538524-889.png\|\|_mstalt="298272"]]
2.2	121
	122
9.2	123	== 1.5 Sleep mode and working mode ==
2.2	124
	125
40.2	126	(% 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	127
40.2	128	(% 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	129
	130
9.2	131	== 1.6 Button & LEDs ==
2.2	132
	133
47.1	134	[[image:1675212633011-651.png\|\|_mstalt="291538"]]
2.2	135
	136
48.3	137	(% border="1" cellspacing="4" style="width:510px" %)
	138	\|=(% style="width: 167px;background-color:#D9E2F3;color:#0070C0" %)Behavior on ACT\|=(% style="width: 117px;background-color:#D9E2F3;color:#0070C0" %)Function\|=(% style="width: 225px;background-color:#D9E2F3;color:#0070C0" %)Action
	139	\|(% style="background-color:#f2f2f2; width:167px" %)Pressing ACT between 1s < time < 3s\|(% style="background-color:#f2f2f2; width:117px" %)Send an uplink\|(% style="background-color:#f2f2f2; width:225px" %)(((
9.2	140	If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)blue led (%%)will blink once.
2.2	141	Meanwhile, BLE module will be active and user can connect via BLE to configure device.
	142	)))
48.3	143	\|(% style="background-color:#f2f2f2; width:167px" %)Pressing ACT for more than 3s\|(% style="background-color:#f2f2f2; width:117px" %)Active Device\|(% style="background-color:#f2f2f2; width:225px" %)(((
	144	(% style="background-color:#f2f2f2; 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.
	145	(% style="background-color:#f2f2f2; color:green" %)Green led(%%) will solidly turn on for 5 seconds after joined in network.
2.2	146	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.
	147	)))
48.3	148	\|(% style="background-color:#f2f2f2; width:167px" %)Fast press ACT 5 times.\|(% style="background-color:#f2f2f2; width:117px" %)Deactivate Device\|(% style="background-color:#f2f2f2; width:225px" %)(% style="color:red" %)Red led(%%) will solid on for 5 seconds. Means PS-LB-NA is in Deep Sleep Mode.
2.2	149
9.2	150	== 1.7 Pin Mapping ==
2.2	151
	152
47.1	153	[[image:1675213198663-754.png\|\|_mstalt="297167"]]
2.2	154
	155
9.2	156	== 1.8 BLE connection ==
2.2	157
9.2	158
2.2	159	SDI-12-LB support BLE remote configure.
	160
	161	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:
	162
	163	* Press button to send an uplink
	164	* Press button to active device.
	165	* Device Power on or reset.
	166
	167	If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
	168
	169
9.2	170	== 1.9 Mechanical ==
2.2	171
	172
47.1	173	[[image:image-20230201090139-2.png\|\|_mstalt="428623"]]
2.2	174
47.1	175	[[image:image-20230201090139-3.png\|\|_mstalt="428987"]]
2.2	176
47.1	177	[[image:image-20230201090139-4.png\|\|_mstalt="429351"]]
2.2	178
	179
19.2	180	= 2. Configure SDI-12 to connect to LoRaWAN network =
9.2	181
19.2	182	== 2.1 How it works ==
9.2	183
	184
40.2	185	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	186
2.2	187
19.2	188	== 2.2 Quick guide to connect to LoRaWAN server (OTAA) ==
2.2	189
	190
	191	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.
	192
	193
47.1	194	[[image:image-20230201090528-5.png\|\|_mstalt="430300" height="465" width="1111"]]
2.2	195
	196
	197	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.
	198
	199
40.2	200	(% style="color:blue" %)Step 1(%%): Create a device in TTN with the OTAA keys from SDI-12-LB.
2.2	201
	202	Each SDI-12-LB is shipped with a sticker with the default device EUI as below:
	203
	204
47.1	205	[[image:image-20230201152430-20.jpeg\|\|_mstalt="492245"]]
2.2	206
	207
	208	You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
	209
	210
40.2	211	(% style="color:blue" %)Register the device
2.2	212
47.1	213	[[image:1675213652444-622.png\|\|_mstalt="293657"]]
2.2	214
	215
40.2	216	(% style="color:blue" %)Add APP EUI and DEV EUI
2.2	217
	218
47.1	219	[[image:1675213661769-223.png\|\|_mstalt="295217"]]
2.2	220
	221
40.2	222	(% style="color:blue" %)Add APP EUI in the application
2.2	223
	224
47.1	225	[[image:1675213675852-577.png\|\|_mstalt="297947"]]
2.2	226
	227
40.2	228	(% style="color:blue" %)Add APP KEY
2.2	229
47.1	230	[[image:1675213686734-883.png\|\|_mstalt="298064"]]
2.2	231
	232
40.2	233	(% style="color:blue" %)Step 2(%%): Activate on SDI-12-LB
2.2	234
	235
	236	Press the button for 5 seconds to activate the SDI-12-LB.
	237
40.2	238	(% 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	239
	240
47.1	241	[[image:1675213704414-644.png\|\|_mstalt="293748"]]
2.2	242
	243
19.2	244	== 2.3 SDI-12 Related Commands ==
2.2	245
	246
19.2	247	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	248
	249
29.2	250	=== 2.3.1 Basic SDI-12 debug command ===
2.2	251
	252
	253	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.
	254
	255	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.
	256
	257	The following is the display information on the serial port and the server.
	258
	259
47.1	260	[[image:image-20230201091027-6.png\|\|_mstalt="429065"]]
2.2	261
19.2	262
47.1	263	[[image:image-20230201091027-7.png\|\|_mstalt="429429" height="261" width="1179"]]
19.2	264
	265
41.4	266
40.2	267	==== (% style="color:blue" %)al! ~-~- Get SDI-12 sensor Identification(%%) ====
19.2	268
	269
2.2	270	* AT Command: AT+ADDRI=aa
	271	* LoRaWAN Downlink(prefix 0xAA00): AA 00 aa
	272
40.2	273	(% style="color:#037691" %)Parameter: (%%)aa: ASCII value of SDI-12 sensor address in downlink or HEX value in AT Command)
2.2	274
41.4	275	(% style="color:blue" %)Example : (%%)AT+ADDRI=0 ( Equal to downlink: 0x AA 00 30)
2.2	276
	277
	278	The following is the display information on the serial port and the server.
	279
	280
47.1	281	[[image:image-20230201091257-8.png\|\|_mstalt="431392"]]
2.2	282
	283
47.1	284	[[image:image-20230201091257-9.png\|\|_mstalt="431756" height="225" width="1242"]]
19.2	285
	286
40.2	287	==== (% style="color:blue" %)aM!,aMC!, aM1!- aM9!, aMC1!- aMC9!(%%) ====
2.2	288
	289
40.2	290	(% style="color:red" %)aM! (%%): Start Non-Concurrent Measurement
2.2	291
40.2	292	(% style="color:red" %)aMC! (%%): Start Non-Concurrent Measurement – Request CRC
2.2	293
40.2	294	(% style="color:red" %)aM1!- aM9! (%%): Additional Measurements
2.2	295
40.2	296	(% style="color:red" %)aMC1!- aMC9!(%%) : Additional Measurements – Request CRC
2.2	297
27.2	298
2.2	299	* AT Command : AT+ADDRM=0,1,0,1
37.10	300
2.2	301	* LoRaWAN Downlink(prefix 0xAA01): 0xAA 01 30 01 00 01
	302
	303	Downlink：AA 01 aa bb cc dd
	304
40.2	305	(% style="color:#037691" %)aa(%%): SDI-12 sensor address.
2.2	306
40.2	307	(% style="color:#037691" %)bb(%%): 0: no CRC, 1: request CRC
2.2	308
40.2	309	(% style="color:#037691" %)cc(%%): 1-9: Additional Measurement, 0: no additional measurement
2.2	310
41.5	311	(% style="color:#037691" %)dd(%%): delay (in second) to send (% style="color:#037691" %)__aD0!__(%%) to get return.
2.2	312
	313
	314	The following is the display information on the serial port and the server.
	315
	316
47.1	317	[[image:image-20230201091630-10.png\|\|_mstalt="449995"]]
2.2	318
	319
47.1	320	[[image:image-20230201091630-11.png\|\|_mstalt="450372" height="247" width="1165"]]
2.2	321
	322
	323
40.2	324	==== (% style="color:blue" %)aC!, aCC!, aC1!- aC9!, aCC1!- aCC9! (%%) ====
2.2	325
	326
40.2	327	(% style="color:red" %)aC!(%%) : Start Concurrent Measurement
2.2	328
40.2	329	(% style="color:red" %)aCC! (%%): Start Concurrent Measurement – Request CRC
2.2	330
40.2	331	(% style="color:red" %)aC1!- aC9!(%%) : Start Additional Concurrent Measurements
27.2	332
40.2	333	(% style="color:red" %)aCC1!- aCC9!(%%) : Start Additional Concurrent Measurements – Request CRC
27.2	334
	335
2.2	336	* AT Command : AT+ADDRC=0,1,0,1
	337
	338	* LoRaWAN Downlink(0xAA02): 0xAA 02 30 01 00 01
	339
	340	Downlink: AA 02 aa bb cc dd
	341
40.2	342	(% style="color:#037691" %)aa(%%): SDI-12 sensor address.
2.2	343
40.2	344	(% style="color:#037691" %)bb(%%): 0: no CRC, 1: request CRC
2.2	345
40.2	346	(% style="color:#037691" %)cc(%%): 1-9: Additional Measurement, 0: no additional measurement
2.2	347
41.5	348	(% style="color:#037691" %)dd(%%): delay (in second) to send (% style="color:#037691" %)__aD0!__(%%)__ __to get return.
2.2	349
	350
	351	The following is the display information on the serial port and the server.
	352
	353
47.1	354	[[image:image-20230201091954-12.png\|\|_mstalt="453687"]]
2.2	355
	356
47.1	357	[[image:image-20230201091954-13.png\|\|_mstalt="454064" height="203" width="1117"]]
2.2	358
27.2	359
	360
	361
40.2	362	==== (% style="color:blue" %)aR0!- aR9!, aRC0!- aRC9!(%%) ====
27.2	363
37.10	364
2.2	365	Start Continuous Measurement
	366
	367	Start Continuous Measurement – Request CRC
	368
	369
	370	* AT Command : AT+ADDRR=0,1,0,1
	371	* LoRaWAN Downlink (0xAA 03): 0xAA 03 30 01 00 01
	372
	373	Downlink: AA 03 aa bb cc dd
	374
40.2	375	(% style="color:#037691" %)aa(%%): SDI-12 sensor address.
2.2	376
40.2	377	(% style="color:#037691" %)bb(%%): 0: no CRC, 1: request CRC
2.2	378
40.2	379	(% style="color:#037691" %)cc(%%): 1-9: Additional Measurement, 0: no additional measurement
2.2	380
41.5	381	(% style="color:#037691" %)dd(%%): delay (in second) to send (% style="color:#037691" %)__aD0!__(%%) to get return.
2.2	382
	383
	384	The following is the display information on the serial port and the server.
	385
	386
47.1	387	[[image:image-20230201092208-14.png\|\|_mstalt="452283"]]
2.2	388
27.2	389
47.1	390	[[image:image-20230201092208-15.png\|\|_mstalt="452660" height="214" width="1140"]]
27.2	391
	392
37.2	393	=== 2.3.2 Advance SDI-12 Debug command ===
27.2	394
	395
2.2	396	This command can be used to debug all SDI-12 command.
	397
	398
	399	LoRaWAN Downlink: A8 aa xx xx xx xx bb cc
	400
40.2	401	(% style="color:#037691" %)aa (%%): total SDI-12 command length
2.2	402
40.2	403	(% style="color:#037691" %)xx (%%): SDI-12 command
2.2	404
40.2	405	(% style="color:#037691" %)bb (%%): Delay to wait for return
2.2	406
40.2	407	(% style="color:#037691" %)cc (%%): 0: don't uplink return to LoRaWAN, 1: Uplink return to LoRaWAN on FPORT=100
2.2	408
	409
40.2	410	(% style="color:blue" %)Example: (%%) AT+CFGDEV =0RC0!,1
2.2	411
40.2	412	(% style="color:#037691" %)0RC0! (%%): SDI-12 Command,
2.2	413
40.2	414	(% style="color:#037691" %)1 (%%): Delay 1 second. ( 0: 810 mini-second)
2.2	415
	416	Equal Downlink: 0xA8 05 30 52 43 30 21 01 01
	417
	418
	419	The following is the display information on the serial port and the server.
	420
	421
47.1	422	[[image:image-20230201092355-16.png\|\|_mstalt="453960"]]
2.2	423
	424
47.1	425	[[image:image-20230201092355-17.png\|\|_mstalt="454337" height="426" width="1135"]]
27.2	426
29.2	427
	428	=== 2.3.3 Convert ASCII to String ===
	429
	430
2.2	431	This command is used to convert between ASCII and String format.
	432
	433	AT+CONVFORM ( Max length: 80 bytes)
	434
	435
40.2	436	(% style="color:blue" %)Example:
2.2	437
29.2	438	1) AT+CONVFORM=0, string Convert String from String to ASCII
2.2	439
47.1	440	[[image:1675214845056-885.png\|\|_mstalt="297622"]]
2.2	441
	442
29.2	443	2) AT+CONVFORM=1, ASCII Convert ASCII to String.
2.2	444
47.1	445	[[image:1675214856590-846.png\|\|_mstalt="297739"]]
2.2	446
29.2	447
	448	=== 2.3.4 Define periodically SDI-12 commands and uplink. ===
	449
	450
2.2	451	AT+COMMANDx & AT+DATACUTx
	452
	453	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.
	454
	455
40.2	456	* (% style="color:blue" %)AT Command:
2.2	457
40.2	458	(% style="color:#037691" %)AT+COMMANDx=var1,var2,var3,var4.
2.2	459
40.2	460	(% style="color:red" %)var1(%%): SDI-12 command , for example: 0RC0!
2.2	461
40.2	462	(% style="color:red" %)var2(%%): Wait timeout for return. (unit: second)
2.2	463
40.2	464	(% style="color:red" %)var3(%%): Whether to send //addrD0!// to get return after var2 timeout. 0: Don't Send //addrD0! //; 1: Send //addrD0!//.
2.2	465
44.1	466	(% style="color:red" %)var4(%%): validation check for return. If return invalid, SDI-12-LB will resend this command. Max 3 retries.
2.2	467
40.2	468	(% style="color:red" %)0 (%%) No validation check;
2.2	469
40.2	470	(% style="color:red" %)1 (%%) Check if return chars are printable char(0x20 ~~ 0x7E);
2.2	471
41.5	472	(% style="color:red" %)2(%%) Check if there is return from SDI-12 sensor
2.2	473
40.2	474	(% style="color:red" %)3 (%%) Check if return pass CRC check ( SDI-12 command var1 must include CRC request);
2.2	475
	476
40.2	477	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	478
	479
40.2	480	(% style="color:blue" %)AT+DATACUTx(%%) : This command defines how to handle the return from AT+COMMANDx, max return length is 100 bytes.
2.2	481
48.4	482	(% border="1" style="width:436px" %)
48.10	483	\|(% style="background-color:#f2f2f2; width:433px" %)(((
	484	(% style="color:#0070c0" %)AT+DATACUTx=a,b,c
2.2	485
29.2	486	a: length for the return of AT+COMMAND
2.2	487
37.11	488	b: 1: grab valid value by byte, max 6 bytes. 2: grab valid value by bytes section, max 3 sections.
2.2	489
29.2	490	c: define the position for valid value.
2.2	491	)))
	492
43.1	493	For example, if return from AT+COMMAND1 is “013METER TER12 112T12-00024895<CR><LF>” , Below AT+DATACUT1 will get different result to combine payload:
2.2	494
	495
48.4	496	(% border="1" cellspacing="4" style="width:510px" %)
	497	\|=(% style="width: 164px;background-color:#D9E2F3;color:#0070C0" %)AT+DATACUT1 value\|=(% style="width: 344px;background-color:#D9E2F3;color:#0070C0" %)Final Result to combine Payload
48.10	498	\|(% style="background-color:#f2f2f2; width:164px" %)34,1,1+2+3\|(% style="background-color:#f2f2f2; width:344px" %)0D 00 01 30 31 33
	499	\|(% style="background-color:#f2f2f2; width:164px" %)34,2,1~~8+12~~16\|(% style="background-color:#f2f2f2; width:344px" %)0D 00 01 30 31 33 4D 45 54 45 52 54 45 52 31 32
	500	\|(% style="background-color:#f2f2f2; width:164px" %)34,2,1~~34\|(% style="background-color:#f2f2f2; 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	501
40.2	502	* (% style="color:blue" %) Downlink Payload:
2.2	503
40.2	504	(% style="color:blue" %)0xAF(%%) downlink command can be used to set AT+COMMANDx or AT+DATACUTx.
2.2	505
	506
40.2	507	(% style="color:red" %)Note : if user use AT+COMMANDx to add a new command, he also need to send AT+DATACUTx downlink.
2.2	508
	509
40.2	510	Format: (% style="color:#037691" %)AF MM NN LL XX XX XX XX YY(%%)
2.2	511
	512	Where:
	513
40.2	514	* (% style="color:#037691" %)MM (%%): the AT+COMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
43.1	515	* (% style="color:#037691" %)NN (%%): 1: set the AT+COMMAND value ; 2: set the AT+DATACUT value.
40.2	516	* (% style="color:#037691" %)LL (%%): The length of AT+COMMAND or AT+DATACUT command
	517	* (% style="color:#037691" %)XX XX XX XX (%%): AT+COMMAND or AT+DATACUT command
43.1	518	* (% style="color:#037691" %)YY (%%): If YY=0, SDI-12-LB will execute the downlink command without uplink; if YY=1, SDI-12-LB will execute an uplink after got this command.
2.2	519
40.2	520	(% style="color:blue" %)Example:
2.2	521
47.1	522	[[image:image-20230201094129-18.png\|\|_mstalt="455065"]]
2.2	523
	524
41.16	525
40.2	526	(% style="color:blue" %)Clear SDI12 Command
2.2	527
	528	The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them.
	529
	530
40.2	531	* (% style="color:#037691" %)AT Command:
2.2	532
40.2	533	(% style="color:#4f81bd" %)AT+CMDEAR=mm,nn (%%) mm: start position of erase ,nn: stop position of erase
2.2	534
	535
	536	Etc. AT+CMDEAR=1,10 means erase AT+COMMAND1/AT+DATACUT1 to AT+COMMAND10/AT+DATACUT10
	537
	538
40.2	539	* (% style="color:#037691" %) Downlink Payload:
2.2	540
40.2	541	(% style="color:#4f81bd" %)0x09 aa bb(%%) same as AT+CMDEAR=aa,bb
2.2	542
	543
	544
40.2	545	(% style="color:blue" %)command combination
2.2	546
	547	Below shows a screen shot how the results combines together to a uplink payload.
	548
47.1	549	[[image:1675215745275-920.png\|\|_mstalt="295334"]]
2.2	550
	551
35.2	552	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	553
40.2	554	(% 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	555
	556
41.7	557	(% 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	558
	559
47.1	560	[[image:1675215782925-448.png\|\|_mstalt="297466"]]
2.2	561
	562
40.2	563	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	564
	565
	566
41.17	567	(% style="color:blue" %)Compose Uplink
2.2	568
40.2	569	(% style="color:#4f81bd" %)AT+DATAUP=0
2.2	570
41.8	571	Compose the uplink payload with value returns in sequence and send with __A SIGNLE UPLINK__.
2.2	572
41.8	573	Final Payload is __Battery Info+PAYVER + VALID Value from RETURN1 + Valid Value from RETURN2 + … + RETURNx__
2.2	574
	575	Where PAYVER is defined by AT+PAYVER, below is an example screen shot.
	576
	577
47.1	578	[[image:1675215828102-844.png\|\|_mstalt="294645"]]
2.2	579
	580
40.2	581	(% style="color:#4f81bd" %)AT+DATAUP=1
2.2	582
41.8	583	Compose the uplink payload with value returns in sequence and send with __Multiply UPLINKs__.
2.2	584
41.8	585	Final Payload is __Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA__
2.2	586
	587	1. Battery Info (2 bytes): Battery voltage
	588	1. PAYVER (1 byte): Defined by AT+PAYVER
	589	1. PAYLOAD COUNT (1 byte): Total how many uplinks of this sampling.
	590	1. PAYLOAD# (1 byte): Number of this uplink. (from 0,1,2,3…,to PAYLOAD COUNT)
	591	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
	592
47.1	593	[[image:1675215848113-696.png\|\|_mstalt="296998"]]
2.2	594
	595
40.2	596	(% 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	597
35.2	598	* For AU915/AS923 bands, if UplinkDwell time=0, max 51 bytes for each uplink ( so 51 -5 = 46 max valid date)
	599	* For AU915/AS923 bands, if UplinkDwell time=1, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date).
	600	* For US915 band, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date).
	601	* For all other bands: max 51 bytes for each uplink ( so 51 -5 = 46 max valid date).
2.2	602
40.2	603	(% 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	604
40.2	605	(% 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	606
	607
40.7	608	== 2.4 Uplink Payload ==
2.2	609
37.2	610	=== 2.4.1 Device Payload, FPORT~=5 ===
2.2	611
37.2	612
2.2	613	Include device configure status. Once SDI-12-LB Joined the network, it will uplink this message to the server.
	614
	615	Users can also use the downlink command(0x26 01) to ask SDI-12-LB to resend this uplink.
	616
48.5	617	(% border="1" cellspacing="4" style="width:510px" %)
	618	\|(% colspan="6" style="background-color:#d9e2f3; color:#0070c0" %)Device Status (FPORT=5)
	619	\|(% style="background-color:#f2f2f2; width:103px" %)Size (bytes)\|(% style="background-color:#f2f2f2; width:72px" %)1\|(% style="background-color:#f2f2f2" %)2\|(% style="background-color:#f2f2f2; width:91px" %)1\|(% style="background-color:#f2f2f2; width:86px" %)1\|(% style="background-color:#f2f2f2; width:44px" %)2
	620	\|(% style="background-color:#f2f2f2; width:103px" %)Value\|(% style="background-color:#f2f2f2; width:72px" %)Sensor Model\|(% style="background-color:#f2f2f2" %)Firmware Version\|(% style="background-color:#f2f2f2; width:91px" %)Frequency Band\|(% style="background-color:#f2f2f2; width:86px" %)Sub-band\|(% style="background-color:#f2f2f2; width:44px" %)BAT
2.2	621
	622	Example parse in TTNv3
	623
47.1	624	[[image:1675215946738-635.png\|\|_mstalt="297778"]]
2.2	625
37.2	626
40.2	627	(% style="color:#037691" %)Sensor Model(%%): For SDI-12-LB, this value is 0x17
2.2	628
40.2	629	(% style="color:#037691" %)Firmware Version(%%): 0x0100, Means: v1.0.0 version
2.2	630
40.2	631	(% style="color:#037691" %)Frequency Band:
2.2	632
	633	*0x01: EU868
	634
	635	*0x02: US915
	636
	637	*0x03: IN865
	638
	639	*0x04: AU915
	640
	641	*0x05: KZ865
	642
	643	*0x06: RU864
	644
	645	*0x07: AS923
	646
	647	*0x08: AS923-1
	648
	649	*0x09: AS923-2
	650
	651	*0x0a: AS923-3
	652
	653	*0x0b: CN470
	654
	655	*0x0c: EU433
	656
	657	*0x0d: KR920
	658
	659	*0x0e: MA869
	660
	661
40.2	662	(% style="color:#037691" %)Sub-Band:
2.2	663
	664	AU915 and US915:value 0x00 ~~ 0x08
	665
	666	CN470: value 0x0B ~~ 0x0C
	667
	668	Other Bands: Always 0x00
	669
	670
40.2	671	(% style="color:#037691" %)Battery Info:
2.2	672
	673	Check the battery voltage.
	674
	675	Ex1: 0x0B45 = 2885mV
	676
	677	Ex2: 0x0B49 = 2889mV
	678
	679
37.2	680	=== 2.4.2 Uplink Payload, FPORT~=2 ===
2.2	681
37.2	682
2.2	683	There are different cases for uplink. See below
	684
	685	* SDI-12 Debug Command return: FPORT=100
	686
	687	* Periodically Uplink: FPORT=2
	688
48.10	689	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
41.19	690	\|=(% style="width: 90px;" %)(((
37.2	691	Size(bytes)
41.19	692	)))\|=(% style="width: 80px;" %)2\|=(% style="width: 90px;" %)1\|=(% style="width: 240px;" %)Length depends on the return from the commands
37.2	693	\|(% style="width:93px" %)Value\|(% style="width:83px" %)(((
2.2	694	Battery(mV)
	695	&
	696	Interrupt_Flag
41.18	697	)))\|(% style="width:91px" %)[[PAYLOAD_VER>>\|\|anchor="H3.6Setthepayloadversion"]]\|(% style="width:212px" %)(((
37.2	698	If the valid payload is too long and exceed the maximum support.
2.2	699	Payload length in server,server will show payload not provided in the LoRaWAN server.
	700	)))
	701
47.1	702	[[image:1675216282284-923.png\|\|_mstalt="295633"]]
2.2	703
	704
37.2	705	=== 2.4.3 Battery Info ===
2.2	706
	707
	708	Check the battery voltage for SDI-12-LB.
	709
	710	Ex1: 0x0B45 = 2885mV
	711
	712	Ex2: 0x0B49 = 2889mV
	713
	714
37.2	715	=== 2.4.4 Interrupt Pin ===
2.2	716
37.2	717
40.2	718	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	719
37.2	720	Example:
2.2	721
	722	Ex1: 0x0B45:0x0B&0x80= 0x00 Normal uplink packet.
	723
	724	Ex2: 0x8B49:0x8B&0x80= 0x80 Interrupt Uplink Packet.
	725
	726
37.2	727	=== 2.4.5 Payload version ===
2.2	728
43.1	729	The version number of the payload, mainly used for decoding. The default is 01.
2.2	730
	731
37.2	732	=== 2.4.6 Decode payload in The Things Network ===
2.2	733
	734
	735	While using TTN network, you can add the payload format to decode the payload.
	736
47.1	737	[[image:1675216779406-595.png\|\|_mstalt="298376"]]
2.2	738
	739
	740	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.
	741
37.2	742	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	743
	744
37.3	745	== 2.5 Uplink Interval ==
2.2	746
	747
	748	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:
	749
44.2	750	[[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	751
	752
43.1	753	== 2.6 Examples To Set SDI commands. ==
2.2	754
43.1	755	=== 2.6.1 Examples 1 ===
2.2	756
44.2	757
43.1	758	COM port and SDI-12 sensor communication converted to SDI-12-LB and SDI-12 sensor communication.
	759
47.1	760	[[image:image-20230222143809-1.png\|\|_mstalt="429962" height="564" width="729"]]
43.1	761
	762
44.2	763	(% style="color:blue" %)1) The AT+COMMANDx command is applied to the red arrow part, and sends the SDI12 command to the SDI12 sensor:
43.1	764
44.2	765	a. Send the first command and get the first reply：
43.1	766
44.2	767	(% style="color:#037691" %)AT+COMMANDx=1I!,0,0,1
43.1	768
44.2	769	b. Send the second command and get the second reply：
43.1	770
44.2	771	(% style="color:#037691" %)AT+COMMANDx=2I!,0,0,1
43.1	772
44.2	773	c. Send the third command and get the third reply：
43.1	774
44.2	775	(% style="color:#037691" %)AT+COMMANDx=3I!,0,0,1
43.1	776
44.2	777	d. Send the fourth command and get the fourth reply：
43.1	778
44.2	779	(% style="color:#037691" %)AT+COMMANDx=4I!,0,0,1
43.1	780
44.2	781	e. Send the fifth command plus the sixth command, get the sixth reply：
43.1	782
44.2	783	(% style="color:#037691" %)AT+COMMANDx=1M!,2,1,1
43.1	784
44.2	785	f. Send the seventh command plus the eighth command, get the eighth reply：
43.1	786
44.2	787	(% style="color:#037691" %)AT+COMMANDx=2M!,2,1,1
43.1	788
44.2	789	g. Send the ninth command plus the tenth command, get the tenth reply：
43.1	790
44.2	791	(% style="color:#037691" %)AT+COMMANDx=3M!,1,1,1
43.1	792
44.2	793	h. Send the eleventh command plus the twelfth command, get the twelfth reply：
43.1	794
44.2	795	(% style="color:#037691" %)AT+COMMANDx=4M!,1,1,1
43.1	796
	797
44.2	798	(% style="color:blue" %)2) The AT+DATACUTx command is applied to the green arrow part, receiving and cut out data from the SDI12 sensor：
43.1	799
44.2	800	a. The first reply, all 34 characters: ”113TRUEBNERSMT100038220303182331<CR><LF>”
43.1	801
47.1	802	Cut out all characters: (% _mstmutation="1" style="color:#037691" %)AT+ALLDATAMOD=1 or AT+DATACUTx=34,2,1~~34(% style="color:#037691" %);
44.2	803
43.1	804	b. The sixth reply, all 31 characters：”1+19210+1.04+0.00+22.49+11.75<CR><LF>”
	805
47.1	806	Cut out all characters: (% _mstmutation="1" style="color:#037691" %)AT+ALLDATAMOD=1 or AT+DATACUTx=31,2,1~~31(% style="color:#037691" %);
43.1	807
	808	c. The eighth reply, all 31 characters：”2+18990+1.08+0.00+22.24+11.80<CR><LF>”
	809
47.1	810	Cut out all characters: (% _mstmutation="1" style="color:#037691" %)AT+ALLDATAMOD=1 or AT+DATACUTx=31,2,1~~31(% style="color:#037691" %);
43.1	811
	812	d. The tenth reply, all 15 characters：”3-2919.8+24.0<CR><LF>”
	813
47.1	814	Cut out all characters: (% _mstmutation="1" style="color:#037691" %)AT+ALLDATAMOD=1 or AT+DATACUTx=15,2,1~~15(% style="color:#037691" %);
43.1	815
	816	e. The twelfth reply, all 25 characters：”4+30.8+22.84+4.7+954.38<CR><LF>”
	817
44.2	818	Partial cut, the cut sensor address and the first two parameters：(% style="color:#037691" %)AT+DATACUTx=25,2,1~~12, cut out the character field ” 4+30.8+22.84”.
43.1	819
	820
	821	== 2.7 Frequency Plans ==
	822
	823
37.3	824	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	825
37.3	826	[[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	827
	828
43.1	829	== 2.8 Firmware Change Log ==
37.3	830
	831
2.2	832	Firmware download link:
	833
41.9	834	[[https:~~/~~/www.dropbox.com/sh/qrbgbikb109lkiv/AACBR-v_ZhZAMengcY7Nsa1ja?dl=0>>https://www.dropbox.com/sh/qrbgbikb109lkiv/AACBR-v_ZhZAMengcY7Nsa1ja?dl=0]]
2.2	835
	836
37.3	837	= 3. Configure SDI-12-LB via AT Command or LoRaWAN Downlink =
2.2	838
	839
	840	Use can configure SDI-12-LB via AT Command or LoRaWAN Downlink.
	841
40.8	842	* AT Command Connection: See [[FAQ>>\|\|anchor="H7.FAQ"]].
37.3	843	* LoRaWAN Downlink instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
2.2	844
	845	There are two kinds of commands to configure SDI-12-LB, they are:
	846
40.7	847	* (% style="color:blue" %)General Commands.
2.2	848
	849	These commands are to configure:
	850
	851	* General system settings like: uplink interval.
	852	* LoRaWAN protocol & radio related command.
	853
	854	They are same for all Dragino Device which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:
	855
40.2	856	[[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	857
	858
40.7	859	* (% style="color:blue" %)Commands special design for SDI-12-LB
2.2	860
	861	These commands only valid for SDI-12-LB, as below:
	862
	863
43.1	864	== 3.1 Set Transmit Interval Time ==
2.2	865
	866
	867	Feature: Change LoRaWAN End Node Transmit Interval.
	868
37.3	869	(% style="color:blue" %)AT Command: AT+TDC
2.2	870
48.7	871	(% border="1" cellspacing="4" style="width:510px" %)
	872	\|=(% style="width: 160px; background-color: rgb(217, 226, 243); color: rgb(0, 112, 192);" %)Command Example\|=(% style="width: 160px; background-color: rgb(217, 226, 243); color: rgb(0, 112, 192);" %)Function\|=(% style="width: 190px;background-color:#D9E2F3;color:#0070C0" %)Response
	873	\|(% style="background-color:#f2f2f2; width:157px" %)AT+TDC=?\|(% style="background-color:#f2f2f2; width:166px" %)Show current transmit Interval\|(% style="background-color:#f2f2f2" %)(((
2.2	874	30000
	875	OK
	876	the interval is 30000ms = 30s
	877	)))
48.7	878	\|(% style="background-color:#f2f2f2; width:157px" %)AT+TDC=60000\|(% style="background-color:#f2f2f2; width:166px" %)Set Transmit Interval\|(% style="background-color:#f2f2f2" %)(((
2.2	879	OK
	880	Set transmit interval to 60000ms = 60 seconds
	881	)))
	882
37.3	883	(% style="color:blue" %)Downlink Command: 0x01
2.2	884
37.3	885
2.2	886	Format: Command Code (0x01) followed by 3 bytes time value.
	887
37.6	888	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	889
37.6	890	* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
	891	* Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
2.2	892
37.3	893	== 3.2 Set Interrupt Mode ==
2.2	894
37.6	895
2.2	896	Feature, Set Interrupt mode for GPIO_EXIT.
	897
37.3	898	(% style="color:blue" %)AT Command: AT+INTMOD
2.2	899
48.8	900	(% border="1" cellspacing="4" style="width:510px" %)
	901	\|=(% style="width: 154px;background-color:#D9E2F3;color:#0070C0" %)Command Example\|=(% style="width: 196px;background-color:#D9E2F3;color:#0070C0" %)Function\|=(% style="width: 157px;background-color:#D9E2F3;color:#0070C0" %)Response
	902	\|(% style="background-color:#f2f2f2; width:154px" %)AT+INTMOD=?\|(% style="background-color:#f2f2f2; width:196px" %)Show current interrupt mode\|(% style="background-color:#f2f2f2; width:157px" %)(((
2.2	903	0
	904	OK
48.8	905	the mode is 0 =Disable Interrupt
2.2	906	)))
48.8	907	\|(% style="background-color:#f2f2f2; width:154px" %)AT+INTMOD=2\|(% style="background-color:#f2f2f2; width:196px" %)(((
2.2	908	Set Transmit Interval
43.1	909	0. (Disable Interrupt),
	910	~1. (Trigger by rising and falling edge)
	911	2. (Trigger by falling edge)
	912	3. (Trigger by rising edge)
48.8	913	)))\|(% style="background-color:#f2f2f2; width:157px" %)OK
2.2	914
37.3	915	(% style="color:blue" %)Downlink Command: 0x06
2.2	916
	917	Format: Command Code (0x06) followed by 3 bytes.
	918
	919	This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
	920
37.6	921	* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
	922	* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
2.2	923
37.3	924	== 3.3 Set the output time ==
	925
	926
2.2	927	Feature, Control the output 3V3 , 5V or 12V.
	928
37.3	929	(% style="color:blue" %)AT Command: AT+3V3T
2.2	930
48.9	931	(% border="1" cellspacing="4" style="width:474px" %)
	932	\|=(% style="width: 154px;background-color:#D9E2F3;color:#0070C0" %)Command Example\|=(% style="width: 201px;background-color:#D9E2F3;color:#0070C0" %)Function\|=(% style="width: 116px;background-color:#D9E2F3;color:#0070C0" %)Response
	933	\|(% style="background-color:#f2f2f2; width:154px" %)AT+3V3T=?\|(% style="background-color:#f2f2f2; width:201px" %)Show 3V3 open time.\|(% style="background-color:#f2f2f2; width:116px" %)(((
2.2	934	0
	935	OK
	936	)))
48.9	937	\|(% style="background-color:#f2f2f2; width:154px" %)AT+3V3T=0\|(% style="background-color:#f2f2f2; width:201px" %)Normally open 3V3 power supply.\|(% style="background-color:#f2f2f2; width:116px" %)(((
2.2	938	OK
	939	default setting
	940	)))
48.9	941	\|(% style="background-color:#f2f2f2; width:154px" %)AT+3V3T=1000\|(% style="background-color:#f2f2f2; width:201px" %)Close after a delay of 1000 milliseconds.\|(% style="background-color:#f2f2f2; width:116px" %)(((
2.2	942	OK
	943	)))
48.9	944	\|(% style="background-color:#f2f2f2; width:154px" %)AT+3V3T=65535\|(% style="background-color:#f2f2f2; width:201px" %)Normally closed 3V3 power supply.\|(% style="background-color:#f2f2f2; width:116px" %)(((
2.2	945	OK
	946	)))
	947
37.3	948	(% style="color:blue" %)AT Command: AT+5VT
2.2	949
48.9	950	(% border="1" cellspacing="4" style="width:470px" %)
	951	\|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)Command Example\|=(% style="width: 196px;background-color:#D9E2F3;color:#0070C0" %)Function\|=(% style="width: 114px;background-color:#D9E2F3;color:#0070C0" %)Response
	952	\|(% style="background-color:#f2f2f2; width:155px" %)AT+5VT=?\|(% style="background-color:#f2f2f2; width:196px" %)Show 5V open time.\|(% style="background-color:#f2f2f2; width:114px" %)(((
2.2	953	0
	954	OK
	955	)))
48.9	956	\|(% style="background-color:#f2f2f2; width:155px" %)AT+5VT=0\|(% style="background-color:#f2f2f2; width:196px" %)Normally closed 5V power supply.\|(% style="background-color:#f2f2f2; width:114px" %)(((
2.2	957	OK
	958	default setting
	959	)))
48.9	960	\|(% style="background-color:#f2f2f2; width:155px" %)AT+5VT=1000\|(% style="background-color:#f2f2f2; width:196px" %)Close after a delay of 1000 milliseconds.\|(% style="background-color:#f2f2f2; width:114px" %)(((
2.2	961	OK
	962	)))
48.9	963	\|(% style="background-color:#f2f2f2; width:155px" %)AT+5VT=65535\|(% style="background-color:#f2f2f2; width:196px" %)Normally open 5V power supply.\|(% style="background-color:#f2f2f2; width:114px" %)(((
2.2	964	OK
	965	)))
	966
37.3	967	(% style="color:blue" %)AT Command: AT+12VT
2.2	968
48.9	969	(% border="1" cellspacing="4" style="width:443px" %)
	970	\|=(% style="width: 156px;background-color:#D9E2F3;color:#0070C0" %)Command Example\|=(% style="width: 199px;background-color:#D9E2F3;color:#0070C0" %)Function\|=(% style="width: 83px;background-color:#D9E2F3;color:#0070C0" %)Response
	971	\|(% style="background-color:#f2f2f2; width:156px" %)AT+12VT=?\|(% style="background-color:#f2f2f2; width:199px" %)Show 12V open time.\|(% style="background-color:#f2f2f2; width:83px" %)(((
2.2	972	0
	973	OK
	974	)))
48.9	975	\|(% style="background-color:#f2f2f2; width:156px" %)AT+12VT=0\|(% style="background-color:#f2f2f2; width:199px" %)Normally closed 12V power supply.\|(% style="background-color:#f2f2f2; width:83px" %)OK
	976	\|(% style="background-color:#f2f2f2; width:156px" %)AT+12VT=500\|(% style="background-color:#f2f2f2; width:199px" %)Close after a delay of 500 milliseconds.\|(% style="background-color:#f2f2f2; width:83px" %)(((
2.2	977	OK
	978	)))
	979
37.3	980	(% style="color:blue" %)Downlink Command: 0x07
2.2	981
	982	Format: Command Code (0x07) followed by 3 bytes.
	983
	984	The first byte is which power, the second and third bytes are the time to turn on.
	985
37.3	986	* Example 1: Downlink Payload: 070101F4 ~-~--> AT+3V3T=500
	987	* Example 2: Downlink Payload: 0701FFFF ~-~--> AT+3V3T=65535
	988	* Example 3: Downlink Payload: 070203E8 ~-~--> AT+5VT=1000
	989	* Example 4: Downlink Payload: 07020000 ~-~--> AT+5VT=0
	990	* Example 5: Downlink Payload: 070301F4 ~-~--> AT+12VT=500
	991	* Example 6: Downlink Payload: 07030000 ~-~--> AT+12VT=0
2.2	992
37.3	993	== 3.4 Set the all data mode ==
	994
37.5	995
2.2	996	Feature, Set the all data mode.
	997
37.5	998	(% style="color:blue" %)AT Command: AT+ALLDATAMOD
2.2	999
48.11	1000	(% border="1" cellspacing="4" style="width:437px" %)
	1001	\|=(% style="background-color:#D9E2F3;color:#0070C0" %)Command Example\|=(% style="background-color:#D9E2F3;color:#0070C0" %)Function\|=(% style="background-color:#D9E2F3;color:#0070C0" %)Response
	1002	\|(% style="background-color:#f2f2f2" %)AT+ALLDATAMOD=?\|(% style="background-color:#f2f2f2" %)Show current all data mode\|(% style="background-color:#f2f2f2" %)(((
2.2	1003	0
	1004	OK
	1005	)))
48.11	1006	\|(% style="background-color:#f2f2f2" %)AT+ALLDATAMOD=1\|(% style="background-color:#f2f2f2" %)Set all data mode is 1.\|(% style="background-color:#f2f2f2" %)OK
2.2	1007
37.5	1008	(% style="color:blue" %)Downlink Command: 0xAB
2.2	1009
	1010	Format: Command Code (0xAB) followed by 1 bytes.
	1011
37.5	1012	* Example 1: Downlink Payload: AB 00 ~/~/ AT+ALLDATAMOD=0
	1013	* Example 2: Downlink Payload: AB 01 ~/~/ AT+ALLDATAMOD=1
2.2	1014
37.3	1015	== 3.5 Set the splicing payload for uplink ==
	1016
37.5	1017
2.2	1018	Feature, splicing payload for uplink.
	1019
37.5	1020	(% style="color:blue" %)AT Command: AT+DATAUP
2.2	1021
48.12	1022	(% border="1" cellspacing="4" style="width:510px" %)
	1023	\|=(% style="width: 154px;background-color:#D9E2F3;color:#0070C0" %)Command Example\|=(% style="width: 266px;background-color:#D9E2F3;color:#0070C0" %)Function\|=(% style="background-color:#D9E2F3;color:#0070C0" %)Response
	1024	\|(% style="background-color:#f2f2f2; width:154px" %)AT+DATAUP =?\|(% style="background-color:#f2f2f2; width:266px" %)Show current splicing payload for uplink mode\|(% style="background-color:#f2f2f2" %)(((
2.2	1025	0
	1026	OK
	1027	)))
48.12	1028	\|(% style="background-color:#f2f2f2; width:154px" %)AT+DATAUP =0\|(% style="background-color:#f2f2f2; width:266px" %)(((
2.2	1029	Set splicing payload for uplink mode is 0.
48.12	1030	)))\|(% style="background-color:#f2f2f2" %)(((
2.2	1031	OK
	1032	)))
48.12	1033	\|(% style="background-color:#f2f2f2; width:154px" %)AT+DATAUP =1\|(% style="background-color:#f2f2f2; width:266px" %)Set splicing payload for uplink mode is 1 , and the each splice uplink is sent sequentially.\|(% style="background-color:#f2f2f2" %)OK
	1034	\|(% style="background-color:#f2f2f2; width:154px" %)AT+DATAUP =1,20000\|(% style="background-color:#f2f2f2; width:266px" %)(((
37.3	1035	Set splicing payload for uplink mode is 1, and the uplink interval of each splice to 20000 milliseconds.
48.12	1036	)))\|(% style="background-color:#f2f2f2" %)OK
2.2	1037
37.5	1038	(% style="color:blue" %)Downlink Command: 0xAD
2.2	1039
	1040	Format: Command Code (0xAD) followed by 1 bytes or 5 bytes.
	1041
37.6	1042	* Example 1: Downlink Payload: AD 00 ~/~/ AT+DATAUP=0
	1043	* Example 2: Downlink Payload: AD 01 ~/~/ AT+DATAUP =1
	1044	* Example 3: Downlink Payload: AD 01 00 00 14 ~/~/ AT+DATAUP =1,20000
2.2	1045
	1046	This means that the interval is set to 0x000014=20S
	1047
	1048
37.3	1049	== 3.6 Set the payload version ==
2.2	1050
41.20	1051
2.2	1052	Feature, Set the payload version.
	1053
37.5	1054	(% style="color:blue" %)AT Command: AT+PAYVER
2.2	1055
37.6	1056	(% border="1" cellspacing="4" style="background-color:#f7faff; width:437px" %)
	1057	\|=(% style="width: 158px;" %)Command Example\|=(% style="width: 192px;" %)Function\|=Response
	1058	\|(% style="width:158px" %)AT+PAYVER=?\|(% style="width:192px" %)Show current payload version\|(((
2.2	1059	1
	1060	OK
	1061	)))
37.6	1062	\|(% style="width:158px" %)AT+PAYVER=5\|(% style="width:192px" %)Set payload version is 5.\|OK
2.2	1063
37.5	1064	(% style="color:blue" %)Downlink Command: 0xAE
2.2	1065
	1066	Format: Command Code (0xAE) followed by 1 bytes.
	1067
37.6	1068	* Example 1: Downlink Payload: AE 01 ~/~/ AT+PAYVER=1
	1069	* Example 2: Downlink Payload: AE 05 ~/~/ AT+PAYVER=5
2.2	1070
37.3	1071	= 4. Battery & how to replace =
2.2	1072
37.3	1073	== 4.1 Battery Type ==
2.2	1074
	1075
37.5	1076	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	1077
	1078
2.2	1079	The discharge curve is not linear so can’t simply use percentage to show the battery level. Below is the battery performance.
	1080
47.1	1081	[[image:1675234124233-857.png\|\|_mstalt="295035"]]
2.2	1082
	1083
37.5	1084	Minimum Working Voltage for the SDI-12-LB:
2.2	1085
37.5	1086	SDI-12-LB: 2.45v ~~ 3.6v
2.2	1087
	1088
37.3	1089	== 4.2 Replace Battery ==
2.2	1090
37.3	1091
2.2	1092	Any battery with range 2.45 ~~ 3.6v can be a replacement. We recommend to use Li-SOCl2 Battery.
	1093
	1094	And make sure the positive and negative pins match.
	1095
	1096
37.3	1097	== 4.3 Power Consumption Analyze ==
2.2	1098
	1099
	1100	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.
	1101
	1102	Instruction to use as below:
	1103
37.3	1104	(% 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	1105
37.3	1106	(% style="color:blue" %)Step 2:(%%) Open it and choose
2.2	1107
	1108	* Product Model
	1109	* Uplink Interval
	1110	* Working Mode
	1111
	1112	And the Life expectation in difference case will be shown on the right.
	1113
	1114
47.1	1115	[[image:1675234155374-163.png\|\|_mstalt="294411"]]
2.2	1116
40.2	1117
2.2	1118	The battery related documents as below:
	1119
37.3	1120	* [[Battery Dimension>>https://www.dropbox.com/s/ox5g9njwjle7aw3/LSN50-Battery-Dimension.pdf?dl=0]],
	1121	* [[Lithium-Thionyl Chloride Battery datasheet, Tech Spec>>https://www.dropbox.com/sh/d4oyfnp8o94180o/AABQewCNSh5GPeQH86UxRgQQa?dl=0]]
	1122	* [[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	1123
47.1	1124	[[image:image-20230201145019-19.png\|\|_mstalt="453947"]]
2.2	1125
	1126
37.3	1127	=== 4.3.1 Battery Note ===
2.2	1128
	1129
	1130	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.
	1131
	1132
37.3	1133	=== 4.3.2 Replace the battery ===
2.2	1134
	1135
37.5	1136	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	1137
37.5	1138	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	1139
	1140
37.3	1141	= 5. Remote Configure device =
2.2	1142
37.3	1143	== 5.1 Connect via BLE ==
2.2	1144
	1145
37.3	1146	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	1147
	1148
37.3	1149	== 5.2 AT Command Set ==
2.2	1150
	1151
	1152
37.3	1153	= 6. OTA firmware update =
	1154
	1155
2.2	1156	Please see this link for how to do OTA firmware update.
	1157
	1158	[[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/]]
	1159
	1160
40.2	1161	= 7. FAQ =
2.2	1162
48.1	1163	== 7.1 How to use AT Command via UART to access device? ==
2.2	1164
	1165
40.2	1166	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]]
	1167
	1168
	1169	== 7.2 How to update firmware via UART port? ==
	1170
	1171
	1172	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]]
	1173
	1174
	1175	== 7.3 How to change the LoRa Frequency Bands/Region? ==
	1176
	1177
	1178	You can follow the instructions for [[how to upgrade image>>doc:Main.Firmware Upgrade Instruction for STM32 base products.WebHome]].
	1179	When downloading the images, choose the required image file for download.
	1180
	1181
	1182	= 8. Order Info =
	1183
	1184
41.20	1185	(((
40.7	1186	(% style="color:blue" %)Part Number: SDI-12-LB-XXX
41.20	1187	)))
40.7	1188
41.20	1189	(((
37.4	1190	XXX: The default frequency band
41.20	1191	)))
2.2	1192
41.20	1193	(((
40.7	1194	(% style="color:red" %)AS923(%%): LoRaWAN AS923 band
	1195	(% style="color:red" %)AU915(%%): LoRaWAN AU915 band
	1196	(% style="color:red" %)EU433(%%): LoRaWAN EU433 band
	1197	(% style="color:red" %)EU868(%%): LoRaWAN EU868 band
	1198	(% style="color:red" %)KR920(%%): LoRaWAN KR920 band
	1199	(% style="color:red" %)US915(%%): LoRaWAN US915 band
	1200	(% style="color:red" %)IN865(%%): LoRaWAN IN865 band
	1201	(% style="color:red" %)CN470(%%): LoRaWAN CN470 band
41.20	1202	)))
2.2	1203
	1204
47.2	1205
40.2	1206	= 9. Packing Info =
37.3	1207
	1208
40.7	1209	(% style="color:#037691" %)Package Includes:
2.2	1210
37.3	1211	* SDI-12-LB SDI-12 to LoRaWAN Converter x 1
2.2	1212
40.7	1213	(% style="color:#037691" %)Dimension and weight:
2.2	1214
	1215	* Device Size: cm
	1216	* Device Weight: g
	1217	* Package Size / pcs : cm
	1218	* Weight / pcs : g
	1219
40.2	1220	= 10. Support =
37.3	1221
	1222
2.2	1223	* 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.
	1224
37.3	1225	* 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	1226
40.8	1227

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

Applications

Navigation