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

Version 48.9 by Xiaoling on 2023/04/03 11:39

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
48.6	692	(% border="1" cellspacing="4" style="background-color:#F2F2F2; 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
48.7	874	(% border="1" cellspacing="4" style="width:510px" %)
	875	\|=(% 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
	876	\|(% style="background-color:#f2f2f2; width:157px" %)AT+TDC=?\|(% style="background-color:#f2f2f2; width:166px" %)Show current transmit Interval\|(% style="background-color:#f2f2f2" %)(((
2.2	877	30000
	878	OK
	879	the interval is 30000ms = 30s
	880	)))
48.7	881	\|(% style="background-color:#f2f2f2; width:157px" %)AT+TDC=60000\|(% style="background-color:#f2f2f2; width:166px" %)Set Transmit Interval\|(% style="background-color:#f2f2f2" %)(((
2.2	882	OK
	883	Set transmit interval to 60000ms = 60 seconds
	884	)))
	885
48.7	886
37.3	887	(% style="color:blue" %)Downlink Command: 0x01
2.2	888
37.3	889
2.2	890	Format: Command Code (0x01) followed by 3 bytes time value.
	891
37.6	892	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	893
37.6	894	* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
	895	* Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
2.2	896
48.5	897
37.3	898	== 3.2 Set Interrupt Mode ==
2.2	899
37.6	900
2.2	901	Feature, Set Interrupt mode for GPIO_EXIT.
	902
37.3	903	(% style="color:blue" %)AT Command: AT+INTMOD
2.2	904
48.8	905	(% border="1" cellspacing="4" style="width:510px" %)
	906	\|=(% 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
	907	\|(% 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	908	0
	909	OK
48.8	910	the mode is 0 =Disable Interrupt
2.2	911	)))
48.8	912	\|(% style="background-color:#f2f2f2; width:154px" %)AT+INTMOD=2\|(% style="background-color:#f2f2f2; width:196px" %)(((
2.2	913	Set Transmit Interval
43.1	914	0. (Disable Interrupt),
	915	~1. (Trigger by rising and falling edge)
	916	2. (Trigger by falling edge)
	917	3. (Trigger by rising edge)
48.8	918	)))\|(% style="background-color:#f2f2f2; width:157px" %)OK
2.2	919
48.8	920
37.3	921	(% style="color:blue" %)Downlink Command: 0x06
2.2	922
	923	Format: Command Code (0x06) followed by 3 bytes.
	924
	925	This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
	926
37.6	927	* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
	928	* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
2.2	929
48.5	930
37.3	931	== 3.3 Set the output time ==
	932
	933
2.2	934	Feature, Control the output 3V3 , 5V or 12V.
	935
37.3	936	(% style="color:blue" %)AT Command: AT+3V3T
2.2	937
48.9	938	(% border="1" cellspacing="4" style="width:474px" %)
	939	\|=(% 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
	940	\|(% 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	941	0
	942	OK
	943	)))
48.9	944	\|(% 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	945	OK
	946	default setting
	947	)))
48.9	948	\|(% 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	949	OK
	950	)))
48.9	951	\|(% 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	952	OK
	953	)))
	954
48.9	955
37.3	956	(% style="color:blue" %)AT Command: AT+5VT
2.2	957
48.9	958	(% border="1" cellspacing="4" style="width:470px" %)
	959	\|=(% 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
	960	\|(% 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	961	0
	962	OK
	963	)))
48.9	964	\|(% 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	965	OK
	966	default setting
	967	)))
48.9	968	\|(% 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	969	OK
	970	)))
48.9	971	\|(% 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	972	OK
	973	)))
	974
48.9	975
37.3	976	(% style="color:blue" %)AT Command: AT+12VT
2.2	977
48.9	978	(% border="1" cellspacing="4" style="width:443px" %)
	979	\|=(% 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
	980	\|(% 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	981	0
	982	OK
	983	)))
48.9	984	\|(% 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
	985	\|(% 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	986	OK
	987	)))
	988
37.3	989	(% style="color:blue" %)Downlink Command: 0x07
2.2	990
	991	Format: Command Code (0x07) followed by 3 bytes.
	992
	993	The first byte is which power, the second and third bytes are the time to turn on.
	994
37.3	995	* Example 1: Downlink Payload: 070101F4 ~-~--> AT+3V3T=500
	996	* Example 2: Downlink Payload: 0701FFFF ~-~--> AT+3V3T=65535
	997	* Example 3: Downlink Payload: 070203E8 ~-~--> AT+5VT=1000
	998	* Example 4: Downlink Payload: 07020000 ~-~--> AT+5VT=0
	999	* Example 5: Downlink Payload: 070301F4 ~-~--> AT+12VT=500
	1000	* Example 6: Downlink Payload: 07030000 ~-~--> AT+12VT=0
2.2	1001
48.5	1002
37.3	1003	== 3.4 Set the all data mode ==
	1004
37.5	1005
2.2	1006	Feature, Set the all data mode.
	1007
37.5	1008	(% style="color:blue" %)AT Command: AT+ALLDATAMOD
2.2	1009
37.5	1010	(% border="1" cellspacing="4" style="background-color:#f7faff; width:437px" %)
	1011	\|=Command Example\|=Function\|=Response
2.2	1012	\|AT+ALLDATAMOD=?\|Show current all data mode\|(((
	1013	0
	1014	OK
	1015	)))
	1016	\|AT+ALLDATAMOD=1\|Set all data mode is 1.\|OK
	1017
37.5	1018	(% style="color:blue" %)Downlink Command: 0xAB
2.2	1019
	1020	Format: Command Code (0xAB) followed by 1 bytes.
	1021
37.5	1022	* Example 1: Downlink Payload: AB 00 ~/~/ AT+ALLDATAMOD=0
	1023	* Example 2: Downlink Payload: AB 01 ~/~/ AT+ALLDATAMOD=1
2.2	1024
48.5	1025
37.3	1026	== 3.5 Set the splicing payload for uplink ==
	1027
37.5	1028
2.2	1029	Feature, splicing payload for uplink.
	1030
37.5	1031	(% style="color:blue" %)AT Command: AT+DATAUP
2.2	1032
37.5	1033	(% border="1" cellspacing="4" style="background-color:#f7faff; width:510px" %)
	1034	\|=(% style="width: 154px;" %)Command Example\|=(% style="width: 266px;" %)Function\|=Response
	1035	\|(% style="width:154px" %)AT+DATAUP =?\|(% style="width:266px" %)Show current splicing payload for uplink mode\|(((
2.2	1036	0
	1037	OK
	1038	)))
37.5	1039	\|(% style="width:154px" %)AT+DATAUP =0\|(% style="width:266px" %)(((
2.2	1040	Set splicing payload for uplink mode is 0.
	1041	)))\|(((
	1042	OK
	1043	)))
37.5	1044	\|(% 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
	1045	\|(% style="width:154px" %)AT+DATAUP =1,20000\|(% style="width:266px" %)(((
37.3	1046	Set splicing payload for uplink mode is 1, and the uplink interval of each splice to 20000 milliseconds.
2.2	1047	)))\|OK
	1048
37.5	1049	(% style="color:blue" %)Downlink Command: 0xAD
2.2	1050
	1051	Format: Command Code (0xAD) followed by 1 bytes or 5 bytes.
	1052
37.6	1053	* Example 1: Downlink Payload: AD 00 ~/~/ AT+DATAUP=0
	1054	* Example 2: Downlink Payload: AD 01 ~/~/ AT+DATAUP =1
	1055	* Example 3: Downlink Payload: AD 01 00 00 14 ~/~/ AT+DATAUP =1,20000
2.2	1056
	1057	This means that the interval is set to 0x000014=20S
	1058
	1059
37.3	1060	== 3.6 Set the payload version ==
2.2	1061
41.20	1062
2.2	1063	Feature, Set the payload version.
	1064
37.5	1065	(% style="color:blue" %)AT Command: AT+PAYVER
2.2	1066
37.6	1067	(% border="1" cellspacing="4" style="background-color:#f7faff; width:437px" %)
	1068	\|=(% style="width: 158px;" %)Command Example\|=(% style="width: 192px;" %)Function\|=Response
	1069	\|(% style="width:158px" %)AT+PAYVER=?\|(% style="width:192px" %)Show current payload version\|(((
2.2	1070	1
	1071	OK
	1072	)))
37.6	1073	\|(% style="width:158px" %)AT+PAYVER=5\|(% style="width:192px" %)Set payload version is 5.\|OK
2.2	1074
37.5	1075	(% style="color:blue" %)Downlink Command: 0xAE
2.2	1076
	1077	Format: Command Code (0xAE) followed by 1 bytes.
	1078
37.6	1079	* Example 1: Downlink Payload: AE 01 ~/~/ AT+PAYVER=1
	1080	* Example 2: Downlink Payload: AE 05 ~/~/ AT+PAYVER=5
2.2	1081
48.5	1082
37.3	1083	= 4. Battery & how to replace =
2.2	1084
37.3	1085	== 4.1 Battery Type ==
2.2	1086
	1087
37.5	1088	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	1089
	1090
2.2	1091	The discharge curve is not linear so can’t simply use percentage to show the battery level. Below is the battery performance.
	1092
47.1	1093	[[image:1675234124233-857.png\|\|_mstalt="295035"]]
2.2	1094
	1095
37.5	1096	Minimum Working Voltage for the SDI-12-LB:
2.2	1097
37.5	1098	SDI-12-LB: 2.45v ~~ 3.6v
2.2	1099
	1100
37.3	1101	== 4.2 Replace Battery ==
2.2	1102
37.3	1103
2.2	1104	Any battery with range 2.45 ~~ 3.6v can be a replacement. We recommend to use Li-SOCl2 Battery.
	1105
	1106	And make sure the positive and negative pins match.
	1107
	1108
37.3	1109	== 4.3 Power Consumption Analyze ==
2.2	1110
	1111
	1112	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.
	1113
	1114	Instruction to use as below:
	1115
37.3	1116	(% 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	1117
37.3	1118	(% style="color:blue" %)Step 2:(%%) Open it and choose
2.2	1119
	1120	* Product Model
	1121	* Uplink Interval
	1122	* Working Mode
	1123
	1124	And the Life expectation in difference case will be shown on the right.
	1125
	1126
47.1	1127	[[image:1675234155374-163.png\|\|_mstalt="294411"]]
2.2	1128
40.2	1129
2.2	1130	The battery related documents as below:
	1131
37.3	1132	* [[Battery Dimension>>https://www.dropbox.com/s/ox5g9njwjle7aw3/LSN50-Battery-Dimension.pdf?dl=0]],
	1133	* [[Lithium-Thionyl Chloride Battery datasheet, Tech Spec>>https://www.dropbox.com/sh/d4oyfnp8o94180o/AABQewCNSh5GPeQH86UxRgQQa?dl=0]]
	1134	* [[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	1135
47.1	1136	[[image:image-20230201145019-19.png\|\|_mstalt="453947"]]
2.2	1137
	1138
37.3	1139	=== 4.3.1 Battery Note ===
2.2	1140
	1141
	1142	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.
	1143
	1144
37.3	1145	=== 4.3.2 Replace the battery ===
2.2	1146
	1147
37.5	1148	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	1149
37.5	1150	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	1151
	1152
37.3	1153	= 5. Remote Configure device =
2.2	1154
37.3	1155	== 5.1 Connect via BLE ==
2.2	1156
	1157
37.3	1158	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	1159
	1160
37.3	1161	== 5.2 AT Command Set ==
2.2	1162
	1163
	1164
37.3	1165	= 6. OTA firmware update =
	1166
	1167
2.2	1168	Please see this link for how to do OTA firmware update.
	1169
	1170	[[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/]]
	1171
	1172
40.2	1173	= 7. FAQ =
2.2	1174
48.1	1175	== 7.1 How to use AT Command via UART to access device? ==
2.2	1176
	1177
40.2	1178	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]]
	1179
	1180
	1181	== 7.2 How to update firmware via UART port? ==
	1182
	1183
	1184	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]]
	1185
	1186
	1187	== 7.3 How to change the LoRa Frequency Bands/Region? ==
	1188
	1189
	1190	You can follow the instructions for [[how to upgrade image>>doc:Main.Firmware Upgrade Instruction for STM32 base products.WebHome]].
	1191	When downloading the images, choose the required image file for download.
	1192
	1193
	1194	= 8. Order Info =
	1195
	1196
41.20	1197	(((
40.7	1198	(% style="color:blue" %)Part Number: SDI-12-LB-XXX
41.20	1199	)))
40.7	1200
41.20	1201	(((
37.4	1202	XXX: The default frequency band
41.20	1203	)))
2.2	1204
41.20	1205	(((
40.7	1206	(% style="color:red" %)AS923(%%): LoRaWAN AS923 band
	1207	(% style="color:red" %)AU915(%%): LoRaWAN AU915 band
	1208	(% style="color:red" %)EU433(%%): LoRaWAN EU433 band
	1209	(% style="color:red" %)EU868(%%): LoRaWAN EU868 band
	1210	(% style="color:red" %)KR920(%%): LoRaWAN KR920 band
	1211	(% style="color:red" %)US915(%%): LoRaWAN US915 band
	1212	(% style="color:red" %)IN865(%%): LoRaWAN IN865 band
	1213	(% style="color:red" %)CN470(%%): LoRaWAN CN470 band
41.20	1214	)))
2.2	1215
	1216
47.2	1217
40.2	1218	= 9. Packing Info =
37.3	1219
	1220
40.7	1221	(% style="color:#037691" %)Package Includes:
2.2	1222
37.3	1223	* SDI-12-LB SDI-12 to LoRaWAN Converter x 1
2.2	1224
40.7	1225	(% style="color:#037691" %)Dimension and weight:
2.2	1226
	1227	* Device Size: cm
	1228	* Device Weight: g
	1229	* Package Size / pcs : cm
	1230	* Weight / pcs : g
	1231
48.5	1232
40.2	1233	= 10. Support =
37.3	1234
	1235
2.2	1236	* 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.
	1237
37.3	1238	* 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	1239
40.8	1240

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

Applications

Navigation