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

Version 48.5 by Xiaoling on 2023/04/03 11:12

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

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

Applications

Navigation