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

Version 87.3 by Xiaoling on 2023/06/30 10:28

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
87.2	68
	69
9.2	70	== 1.3 Specification ==
2.2	71
	72
40.2	73	(% style="color:#037691" %)Micro Controller:
2.2	74
	75	* MCU: 48Mhz ARM
	76	* Flash: 256KB
	77	* RAM: 64KB
	78
40.2	79	(% style="color:#037691" %)Common DC Characteristics:
2.2	80
	81	* Supply Voltage: 2.5v ~~ 3.6v
87.2	82	* Support current: 5V 300mA, 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
87.3	117
	118
9.2	119	== 1.4 Connect to SDI-12 Sensor ==
2.2	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.21	139	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
48.3	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
87.3	152
	153
9.2	154	== 1.7 Pin Mapping ==
2.2	155
	156
47.1	157	[[image:1675213198663-754.png\|\|_mstalt="297167"]]
2.2	158
	159
9.2	160	== 1.8 BLE connection ==
2.2	161
9.2	162
2.2	163	SDI-12-LB support BLE remote configure.
	164
	165	BLE can be used to configure the parameter of sensor or see the console output from sensor. BLE will be only activate on below case:
	166
	167	* Press button to send an uplink
	168	* Press button to active device.
	169	* Device Power on or reset.
	170
	171	If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
	172
	173
9.2	174	== 1.9 Mechanical ==
2.2	175
	176
47.1	177	[[image:image-20230201090139-2.png\|\|_mstalt="428623"]]
2.2	178
47.1	179	[[image:image-20230201090139-3.png\|\|_mstalt="428987"]]
2.2	180
47.1	181	[[image:image-20230201090139-4.png\|\|_mstalt="429351"]]
2.2	182
	183
19.2	184	= 2. Configure SDI-12 to connect to LoRaWAN network =
9.2	185
19.2	186	== 2.1 How it works ==
9.2	187
	188
40.2	189	The SDI-12-LB is configured as (% style="color:#037691" %)LoRaWAN OTAA Class A(%%) mode by default. It has OTAA keys to join LoRaWAN network. To connect a local LoRaWAN network, you need to input the OTAA keys in the LoRaWAN IoT server and activate the SDI-12-LB. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes.
9.2	190
2.2	191
19.2	192	== 2.2 Quick guide to connect to LoRaWAN server (OTAA) ==
2.2	193
	194
	195	Following is an example for how to join the [[TTN v3 LoRaWAN Network>>url:https://console.cloud.thethings.network/]]. Below is the network structure; we use the [[LPS8v2>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/228-lps8v2.html]] as a LoRaWAN gateway in this example.
	196
	197
47.1	198	[[image:image-20230201090528-5.png\|\|_mstalt="430300" height="465" width="1111"]]
2.2	199
	200
	201	The LPS8V2 is already set to connected to [[TTN network >>url:https://console.cloud.thethings.network/]], so what we need to now is configure the TTN server.
	202
	203
40.2	204	(% style="color:blue" %)Step 1(%%): Create a device in TTN with the OTAA keys from SDI-12-LB.
2.2	205
	206	Each SDI-12-LB is shipped with a sticker with the default device EUI as below:
	207
49.3	208	[[image:image-20230426084456-1.png\|\|height="241" width="519"]]
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
40.2	364	==== (% style="color:blue" %)aR0!- aR9!, aRC0!- aRC9!(%%) ====
27.2	365
37.10	366
2.2	367	Start Continuous Measurement
	368
	369	Start Continuous Measurement – Request CRC
	370
	371
	372	* AT Command : AT+ADDRR=0,1,0,1
	373	* LoRaWAN Downlink (0xAA 03): 0xAA 03 30 01 00 01
	374
	375	Downlink: AA 03 aa bb cc dd
	376
40.2	377	(% style="color:#037691" %)aa(%%): SDI-12 sensor address.
2.2	378
40.2	379	(% style="color:#037691" %)bb(%%): 0: no CRC, 1: request CRC
2.2	380
40.2	381	(% style="color:#037691" %)cc(%%): 1-9: Additional Measurement, 0: no additional measurement
2.2	382
41.5	383	(% style="color:#037691" %)dd(%%): delay (in second) to send (% style="color:#037691" %)__aD0!__(%%) to get return.
2.2	384
	385
	386	The following is the display information on the serial port and the server.
	387
	388
47.1	389	[[image:image-20230201092208-14.png\|\|_mstalt="452283"]]
2.2	390
27.2	391
47.1	392	[[image:image-20230201092208-15.png\|\|_mstalt="452660" height="214" width="1140"]]
27.2	393
	394
37.2	395	=== 2.3.2 Advance SDI-12 Debug command ===
27.2	396
	397
2.2	398	This command can be used to debug all SDI-12 command.
	399
	400
73.1	401	LoRaWAN Downlink: A8 aa xx xx xx xx bb cc dd
2.2	402
40.2	403	(% style="color:#037691" %)aa (%%): total SDI-12 command length
2.2	404
40.2	405	(% style="color:#037691" %)xx (%%): SDI-12 command
2.2	406
40.2	407	(% style="color:#037691" %)bb (%%): Delay to wait for return
2.2	408
40.2	409	(% style="color:#037691" %)cc (%%): 0: don't uplink return to LoRaWAN, 1: Uplink return to LoRaWAN on FPORT=100
2.2	410
73.1	411	(% style="color:#037691" %)dd: (%%) 0: Do not use aD0! command access, 1: use aD0! command access.
2.2	412
	413
73.1	414	(% style="color:blue" %)Example1: (%%) AT+CFGDEV =0RC0!,1
	415
40.2	416	(% style="color:#037691" %)0RC0! (%%): SDI-12 Command,
2.2	417
40.2	418	(% style="color:#037691" %)1 (%%): Delay 1 second. ( 0: 810 mini-second)
2.2	419
	420	Equal Downlink: 0xA8 05 30 52 43 30 21 01 01
	421
	422
	423	The following is the display information on the serial port and the server.
	424
	425
47.1	426	[[image:image-20230201092355-16.png\|\|_mstalt="453960"]]
2.2	427
	428
47.1	429	[[image:image-20230201092355-17.png\|\|_mstalt="454337" height="426" width="1135"]]
27.2	430
29.2	431
87.1	432	(% style="color:blue" %)Example2: (%%) AT+CFGDEV =0M!,1,1
73.1	433
	434	(% style="color:#037691" %)0M! (%%): SDI-12 Command,
	435
	436	(% style="color:#037691" %)1 (%%): Delay 1 second. ( 0: 810 mini-second)
	437
87.3	438	(% style="color:#037691" %)1 (%%): Use aD0! command access.
73.1	439
	440	Equal Downlink: 0xA8 03 30 4D 21 01 01 01
	441
	442
86.1	443	The following is the display information on the serial port and the server.
	444
	445
	446	[[image:image-20230628091055-1.png\|\|height="368" width="462"]]
	447
	448	[[image:image-20230628091130-2.png\|\|height="258" width="879"]]
	449
	450
29.2	451	=== 2.3.3 Convert ASCII to String ===
	452
	453
2.2	454	This command is used to convert between ASCII and String format.
	455
	456	AT+CONVFORM ( Max length: 80 bytes)
	457
	458
40.2	459	(% style="color:blue" %)Example:
2.2	460
29.2	461	1) AT+CONVFORM=0, string Convert String from String to ASCII
2.2	462
47.1	463	[[image:1675214845056-885.png\|\|_mstalt="297622"]]
2.2	464
	465
29.2	466	2) AT+CONVFORM=1, ASCII Convert ASCII to String.
2.2	467
47.1	468	[[image:1675214856590-846.png\|\|_mstalt="297739"]]
2.2	469
29.2	470
	471	=== 2.3.4 Define periodically SDI-12 commands and uplink. ===
	472
	473
2.2	474	AT+COMMANDx & AT+DATACUTx
	475
	476	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.
	477
	478
40.2	479	* (% style="color:blue" %)AT Command:
2.2	480
40.2	481	(% style="color:#037691" %)AT+COMMANDx=var1,var2,var3,var4.
2.2	482
40.2	483	(% style="color:red" %)var1(%%): SDI-12 command , for example: 0RC0!
2.2	484
40.2	485	(% style="color:red" %)var2(%%): Wait timeout for return. (unit: second)
2.2	486
40.2	487	(% style="color:red" %)var3(%%): Whether to send //addrD0!// to get return after var2 timeout. 0: Don't Send //addrD0! //; 1: Send //addrD0!//.
2.2	488
44.1	489	(% style="color:red" %)var4(%%): validation check for return. If return invalid, SDI-12-LB will resend this command. Max 3 retries.
2.2	490
40.2	491	(% style="color:red" %)0 (%%) No validation check;
2.2	492
40.2	493	(% style="color:red" %)1 (%%) Check if return chars are printable char(0x20 ~~ 0x7E);
2.2	494
41.5	495	(% style="color:red" %)2(%%) Check if there is return from SDI-12 sensor
2.2	496
40.2	497	(% style="color:red" %)3 (%%) Check if return pass CRC check ( SDI-12 command var1 must include CRC request);
2.2	498
	499
40.2	500	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	501
	502
40.2	503	(% style="color:blue" %)AT+DATACUTx(%%) : This command defines how to handle the return from AT+COMMANDx, max return length is 100 bytes.
2.2	504
48.4	505	(% border="1" style="width:436px" %)
48.16	506	\|(% style="background-color:#f2f2f2; width:433px" %)(((
	507	(% style="color:#0070c0" %)AT+DATACUTx=a,b,c
2.2	508
29.2	509	a: length for the return of AT+COMMAND
2.2	510
37.11	511	b: 1: grab valid value by byte, max 6 bytes. 2: grab valid value by bytes section, max 3 sections.
2.2	512
29.2	513	c: define the position for valid value.
2.2	514	)))
	515
43.1	516	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	517
	518
48.21	519	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
48.4	520	\|=(% 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.16	521	\|(% style="background-color:#f2f2f2; width:164px" %)34,1,1+2+3\|(% style="background-color:#f2f2f2; width:344px" %)0D 00 01 30 31 33
	522	\|(% style="background-color:#f2f2f2; width:164px" %)34,2,1~~8+12~~16\|(% style="background-color:#f2f2f2; width:344px" %)0D 00 01 30 31 33 4D 45 54 45 52 54 45 52 31 32
	523	\|(% style="background-color:#f2f2f2; width:164px" %)34,2,1~~34\|(% style="background-color:#f2f2f2; width:344px" %)0D 00 01 30 31 33 4D 45 54 45 52 20 20 20 54 45 52 31 32 20 31 31 32 54 31 32 2D 30 30 30 32 34 38 39 35 0D 0A
2.2	524
40.2	525	* (% style="color:blue" %) Downlink Payload:
2.2	526
40.2	527	(% style="color:blue" %)0xAF(%%) downlink command can be used to set AT+COMMANDx or AT+DATACUTx.
2.2	528
	529
40.2	530	(% style="color:red" %)Note : if user use AT+COMMANDx to add a new command, he also need to send AT+DATACUTx downlink.
2.2	531
	532
40.2	533	Format: (% style="color:#037691" %)AF MM NN LL XX XX XX XX YY(%%)
2.2	534
	535	Where:
	536
40.2	537	* (% style="color:#037691" %)MM (%%): the AT+COMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
43.1	538	* (% style="color:#037691" %)NN (%%): 1: set the AT+COMMAND value ; 2: set the AT+DATACUT value.
40.2	539	* (% style="color:#037691" %)LL (%%): The length of AT+COMMAND or AT+DATACUT command
	540	* (% style="color:#037691" %)XX XX XX XX (%%): AT+COMMAND or AT+DATACUT command
43.1	541	* (% 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	542
40.2	543	(% style="color:blue" %)Example:
2.2	544
47.1	545	[[image:image-20230201094129-18.png\|\|_mstalt="455065"]]
2.2	546
	547
41.16	548
40.2	549	(% style="color:blue" %)Clear SDI12 Command
2.2	550
	551	The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them.
	552
	553
40.2	554	* (% style="color:#037691" %)AT Command:
2.2	555
40.2	556	(% style="color:#4f81bd" %)AT+CMDEAR=mm,nn (%%) mm: start position of erase ,nn: stop position of erase
2.2	557
	558
	559	Etc. AT+CMDEAR=1,10 means erase AT+COMMAND1/AT+DATACUT1 to AT+COMMAND10/AT+DATACUT10
	560
	561
40.2	562	* (% style="color:#037691" %) Downlink Payload:
2.2	563
40.2	564	(% style="color:#4f81bd" %)0x09 aa bb(%%) same as AT+CMDEAR=aa,bb
2.2	565
	566
	567
40.2	568	(% style="color:blue" %)command combination
2.2	569
	570	Below shows a screen shot how the results combines together to a uplink payload.
	571
47.1	572	[[image:1675215745275-920.png\|\|_mstalt="295334"]]
2.2	573
	574
35.2	575	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	576
40.2	577	(% 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	578
	579
41.7	580	(% 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	581
	582
47.1	583	[[image:1675215782925-448.png\|\|_mstalt="297466"]]
2.2	584
	585
40.2	586	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	587
	588
	589
41.17	590	(% style="color:blue" %)Compose Uplink
2.2	591
40.2	592	(% style="color:#4f81bd" %)AT+DATAUP=0
2.2	593
41.8	594	Compose the uplink payload with value returns in sequence and send with __A SIGNLE UPLINK__.
2.2	595
41.8	596	Final Payload is __Battery Info+PAYVER + VALID Value from RETURN1 + Valid Value from RETURN2 + … + RETURNx__
2.2	597
	598	Where PAYVER is defined by AT+PAYVER, below is an example screen shot.
	599
	600
47.1	601	[[image:1675215828102-844.png\|\|_mstalt="294645"]]
2.2	602
	603
40.2	604	(% style="color:#4f81bd" %)AT+DATAUP=1
2.2	605
41.8	606	Compose the uplink payload with value returns in sequence and send with __Multiply UPLINKs__.
2.2	607
41.8	608	Final Payload is __Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA__
2.2	609
	610	1. Battery Info (2 bytes): Battery voltage
	611	1. PAYVER (1 byte): Defined by AT+PAYVER
	612	1. PAYLOAD COUNT (1 byte): Total how many uplinks of this sampling.
	613	1. PAYLOAD# (1 byte): Number of this uplink. (from 0,1,2,3…,to PAYLOAD COUNT)
	614	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
	615
47.1	616	[[image:1675215848113-696.png\|\|_mstalt="296998"]]
2.2	617
	618
40.2	619	(% 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	620
35.2	621	* For AU915/AS923 bands, if UplinkDwell time=0, max 51 bytes for each uplink ( so 51 -5 = 46 max valid date)
	622	* For AU915/AS923 bands, if UplinkDwell time=1, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date).
	623	* For US915 band, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date).
	624	* For all other bands: max 51 bytes for each uplink ( so 51 -5 = 46 max valid date).
2.2	625
40.2	626	(% 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	627
40.2	628	(% 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	629
	630
40.7	631	== 2.4 Uplink Payload ==
2.2	632
37.2	633	=== 2.4.1 Device Payload, FPORT~=5 ===
2.2	634
37.2	635
2.2	636	Include device configure status. Once SDI-12-LB Joined the network, it will uplink this message to the server.
	637
	638	Users can also use the downlink command(0x26 01) to ask SDI-12-LB to resend this uplink.
	639
48.21	640	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
48.5	641	\|(% colspan="6" style="background-color:#d9e2f3; color:#0070c0" %)Device Status (FPORT=5)
	642	\|(% 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
	643	\|(% 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	644
	645	Example parse in TTNv3
	646
47.1	647	[[image:1675215946738-635.png\|\|_mstalt="297778"]]
2.2	648
37.2	649
40.2	650	(% style="color:#037691" %)Sensor Model(%%): For SDI-12-LB, this value is 0x17
2.2	651
40.2	652	(% style="color:#037691" %)Firmware Version(%%): 0x0100, Means: v1.0.0 version
2.2	653
40.2	654	(% style="color:#037691" %)Frequency Band:
2.2	655
73.2	656	0x01: EU868
2.2	657
73.2	658	0x02: US915
2.2	659
73.2	660	0x03: IN865
2.2	661
73.2	662	0x04: AU915
2.2	663
73.2	664	0x05: KZ865
2.2	665
73.2	666	0x06: RU864
2.2	667
73.2	668	0x07: AS923
2.2	669
73.2	670	0x08: AS923-1
2.2	671
73.2	672	0x09: AS923-2
2.2	673
73.2	674	0x0a: AS923-3
2.2	675
73.2	676	0x0b: CN470
2.2	677
73.2	678	0x0c: EU433
2.2	679
73.2	680	0x0d: KR920
2.2	681
73.2	682	0x0e: MA869
2.2	683
	684
40.2	685	(% style="color:#037691" %)Sub-Band:
2.2	686
	687	AU915 and US915:value 0x00 ~~ 0x08
	688
	689	CN470: value 0x0B ~~ 0x0C
	690
	691	Other Bands: Always 0x00
	692
	693
40.2	694	(% style="color:#037691" %)Battery Info:
2.2	695
	696	Check the battery voltage.
	697
	698	Ex1: 0x0B45 = 2885mV
	699
	700	Ex2: 0x0B49 = 2889mV
	701
	702
37.2	703	=== 2.4.2 Uplink Payload, FPORT~=2 ===
2.2	704
37.2	705
2.2	706	There are different cases for uplink. See below
	707
	708	* SDI-12 Debug Command return: FPORT=100
	709
	710	* Periodically Uplink: FPORT=2
	711
48.16	712	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
73.2	713	\|=(% style="width: 90px;background-color:#D9E2F3;color:#0070C0" %)(((
37.2	714	Size(bytes)
73.2	715	)))\|=(% style="width: 80px;background-color:#D9E2F3;color:#0070C0" %)2\|=(% style="width: 90px;background-color:#D9E2F3;color:#0070C0" %)1\|=(% style="width: 240px;background-color:#D9E2F3;color:#0070C0" %)Length depends on the return from the commands
37.2	716	\|(% style="width:93px" %)Value\|(% style="width:83px" %)(((
2.2	717	Battery(mV)
	718	&
	719	Interrupt_Flag
41.18	720	)))\|(% style="width:91px" %)[[PAYLOAD_VER>>\|\|anchor="H3.6Setthepayloadversion"]]\|(% style="width:212px" %)(((
37.2	721	If the valid payload is too long and exceed the maximum support.
2.2	722	Payload length in server,server will show payload not provided in the LoRaWAN server.
	723	)))
	724
47.1	725	[[image:1675216282284-923.png\|\|_mstalt="295633"]]
2.2	726
	727
37.2	728	=== 2.4.3 Battery Info ===
2.2	729
	730
	731	Check the battery voltage for SDI-12-LB.
	732
	733	Ex1: 0x0B45 = 2885mV
	734
	735	Ex2: 0x0B49 = 2889mV
	736
	737
37.2	738	=== 2.4.4 Interrupt Pin ===
2.2	739
37.2	740
40.2	741	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	742
37.2	743	Example:
2.2	744
	745	Ex1: 0x0B45:0x0B&0x80= 0x00 Normal uplink packet.
	746
	747	Ex2: 0x8B49:0x8B&0x80= 0x80 Interrupt Uplink Packet.
	748
	749
37.2	750	=== 2.4.5 Payload version ===
2.2	751
49.3	752
43.1	753	The version number of the payload, mainly used for decoding. The default is 01.
2.2	754
	755
37.2	756	=== 2.4.6 Decode payload in The Things Network ===
2.2	757
	758
	759	While using TTN network, you can add the payload format to decode the payload.
	760
47.1	761	[[image:1675216779406-595.png\|\|_mstalt="298376"]]
2.2	762
	763
	764	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.
	765
37.2	766	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	767
	768
37.3	769	== 2.5 Uplink Interval ==
2.2	770
	771
	772	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:
	773
44.2	774	[[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	775
	776
56.1	777	== 2.6 Examples To Set SDI commands ==
2.2	778
56.1	779	=== 2.6.1 Examples 1 ~-~- General Example ===
2.2	780
44.2	781
43.1	782	COM port and SDI-12 sensor communication converted to SDI-12-LB and SDI-12 sensor communication.
	783
47.1	784	[[image:image-20230222143809-1.png\|\|_mstalt="429962" height="564" width="729"]]
43.1	785
	786
44.2	787	(% 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	788
44.2	789	a. Send the first command and get the first reply：
43.1	790
44.2	791	(% style="color:#037691" %)AT+COMMANDx=1I!,0,0,1
43.1	792
44.2	793	b. Send the second command and get the second reply：
43.1	794
44.2	795	(% style="color:#037691" %)AT+COMMANDx=2I!,0,0,1
43.1	796
44.2	797	c. Send the third command and get the third reply：
43.1	798
44.2	799	(% style="color:#037691" %)AT+COMMANDx=3I!,0,0,1
43.1	800
44.2	801	d. Send the fourth command and get the fourth reply：
43.1	802
44.2	803	(% style="color:#037691" %)AT+COMMANDx=4I!,0,0,1
43.1	804
44.2	805	e. Send the fifth command plus the sixth command, get the sixth reply：
43.1	806
44.2	807	(% style="color:#037691" %)AT+COMMANDx=1M!,2,1,1
43.1	808
44.2	809	f. Send the seventh command plus the eighth command, get the eighth reply：
43.1	810
44.2	811	(% style="color:#037691" %)AT+COMMANDx=2M!,2,1,1
43.1	812
44.2	813	g. Send the ninth command plus the tenth command, get the tenth reply：
43.1	814
44.2	815	(% style="color:#037691" %)AT+COMMANDx=3M!,1,1,1
43.1	816
44.2	817	h. Send the eleventh command plus the twelfth command, get the twelfth reply：
43.1	818
44.2	819	(% style="color:#037691" %)AT+COMMANDx=4M!,1,1,1
43.1	820
	821
44.2	822	(% 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	823
44.2	824	a. The first reply, all 34 characters: ”113TRUEBNERSMT100038220303182331<CR><LF>”
43.1	825
47.1	826	Cut out all characters: (% _mstmutation="1" style="color:#037691" %)AT+ALLDATAMOD=1 or AT+DATACUTx=34,2,1~~34(% style="color:#037691" %);
44.2	827
43.1	828	b. The sixth reply, all 31 characters：”1+19210+1.04+0.00+22.49+11.75<CR><LF>”
	829
47.1	830	Cut out all characters: (% _mstmutation="1" style="color:#037691" %)AT+ALLDATAMOD=1 or AT+DATACUTx=31,2,1~~31(% style="color:#037691" %);
43.1	831
	832	c. The eighth reply, all 31 characters：”2+18990+1.08+0.00+22.24+11.80<CR><LF>”
	833
47.1	834	Cut out all characters: (% _mstmutation="1" style="color:#037691" %)AT+ALLDATAMOD=1 or AT+DATACUTx=31,2,1~~31(% style="color:#037691" %);
43.1	835
	836	d. The tenth reply, all 15 characters：”3-2919.8+24.0<CR><LF>”
	837
47.1	838	Cut out all characters: (% _mstmutation="1" style="color:#037691" %)AT+ALLDATAMOD=1 or AT+DATACUTx=15,2,1~~15(% style="color:#037691" %);
43.1	839
	840	e. The twelfth reply, all 25 characters：”4+30.8+22.84+4.7+954.38<CR><LF>”
	841
44.2	842	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	843
	844
71.1	845	=== 2.6.2 Example 2 ~-~- Connect to Hygrovue10 ===
56.1	846
	847	==== 2.6.2.1 Reference Manual and Command ====
	848
72.2	849
56.1	850	* [[Hygrovue10 Product Page>>https://www.campbellsci.com/hygrovue10]]
72.2	851
56.1	852	* Commands to be used in PC and output.
	853
72.2	854	~1. check device address
56.1	855
72.2	856	2. change device address
56.1	857
72.2	858	3. check device ID
56.1	859
72.2	860	4. start measure
56.1	861
72.2	862	5. Get Meausre result
56.1	863
	864	[[image:image-20230603120209-2.png\|\|height="281" width="267"]]
	865
	866
	867	==== 2.6.2.2 Hardware Connection to SDI-12-LB ====
	868
72.2	869
56.1	870	[[image:image-20230603120515-3.png]]
	871
	872
	873	==== 2.6.2.3 Commands set in SDI-12-LB and uplink payload ====
	874
72.2	875
56.1	876	[[image:image-20230603120648-4.png]]
	877
	878	[[image:image-20230603120726-5.png]]
	879
	880
72.2	881	Data in TTN:
	882
56.1	883	[[image:image-20230603120859-6.png\|\|height="118" width="1285"]]
	884
	885
71.1	886	=== (% id="cke_bm_1172015S" style="display:none" %) (%%)2.6.3 Example 3 ~-~- Connect to SIL-400 ===
56.1	887
71.1	888	==== 2.6.3.1 Reference Manual and Command ====
56.1	889
72.2	890
71.1	891	* [[SIL-400 Product Page>>https://www.apogeeinstruments.com/sil-411-commercial-grade-sdi-12-digital-output-standard-field-of-view-infrared-radiometer-sensor/]]
72.2	892
71.1	893	* Commands to be used in PC and output.
	894
72.2	895	~1. check device address
71.1	896
72.2	897	2. change device address
71.1	898
72.2	899	3. check device ID
71.1	900
72.2	901	4. start measure
71.1	902
72.2	903	5. Get Meausre result
71.1	904
	905	[[image:image-20230603121606-7.png\|\|height="242" width="307"]]
	906
	907
	908	==== 2.6.3.2 Hardware Connection to SDI-12-LB ====
	909
72.3	910
71.1	911	[[image:image-20230603121643-8.png\|\|height="442" width="656"]]
	912
	913
	914	==== 2.6.3.3 Commands set in SDI-12-LB and uplink payload ====
	915
72.3	916
71.1	917	[[image:image-20230603121721-9.png]]
	918
83.1	919	[[image:image-20230628090323-1.png\|\|height="414" width="694"]]
71.1	920
	921	Data in TTN:
	922
	923	[[image:image-20230603121826-11.png\|\|height="155" width="1104"]]
	924
	925
	926
	927	=== (% id="cke_bm_1172015S" style="display:none" %) (%%)2.6.4 Example 4 ~-~- Connect to TEROS-12 ===
	928
	929	==== 2.6.4.1 Reference Manual and Command ====
	930
72.3	931
71.1	932	* [[TEROS-12 Product Page>>https://www.metergroup.com/en/meter-environment/products/teros-12-soil-moisture-sensor]]
72.3	933
71.1	934	* Commands to be used in PC and output.
	935
	936	1.check device address
	937
	938	2.change device address
	939
	940	3.check device ID
	941
	942	4.start measure
	943
	944	5.Get Meausre result
	945
	946	[[image:image-20230603122248-16.png\|\|height="196" width="198"]]
	947
	948
	949	==== 2.6.4.2 Hardware Connection to SDI-12-LB ====
	950
72.3	951
71.1	952	[[image:image-20230603122212-15.png\|\|height="502" width="667"]]
	953
	954
	955	==== 2.6.4.3 Commands set in SDI-12-LB and uplink payload ====
	956
73.4	957
71.1	958	[[image:image-20230603122040-12.png]]
	959
	960	[[image:image-20230603122109-13.png\|\|height="469" width="762"]]
	961
	962
72.3	963	Data in TTN:
	964
71.1	965	[[image:image-20230603122139-14.png\|\|height="148" width="1128"]]
	966
	967
72.1	968	=== (% id="cke_bm_1489640S" style="display:none" %) (% id="cke_bm_1172015S" style="display:none" %) (%%)2.6.5 Example 5 ~-~- Connect to SIL-400/TEROS-12 & Hygrovue10 ===
71.1	969
72.1	970	==== 2.6.5.1 Important Notice! ====
71.1	971
72.3	972
71.1	973	* The product page and reference command see above example 2,3,4
72.3	974
71.1	975	* All of these SDI-12 sensors use the same address (address 0) by default. So we need to change their address to different address, by using aAb! command. See above example.
72.3	976
71.1	977	* The sensor needs to be powered to a steady statue. So the 12VT time need to be set to the maximum stable time for the sensors. in this example, it is 13 seconds.
72.3	978
71.1	979	* If these SDI-12 sensors are powered by external power source. It will add 300uA in the total current in SDI-12-LB.
	980
87.3	981
	982
72.1	983	==== 2.6.5.2 Hardware Connection to SDI-12-LB ====
71.1	984
72.3	985
71.1	986	[[image:image-20230603122508-17.png\|\|height="526" width="742"]]
	987
	988
72.1	989	==== 2.6.5.3 Commands set in SDI-12-LB and uplink payload ====
71.1	990
72.3	991
71.1	992	[[image:image-20230603122549-18.png]]
	993
	994	[[image:image-20230603122623-19.png\|\|height="483" width="1121"]]
	995
	996
72.3	997	Data in TTN:
	998
71.1	999	[[image:image-20230603122719-20.png\|\|height="151" width="1179"]]
	1000
	1001
81.1	1002	=== (% id="cke_bm_4783S" style="display:none" %) (%%)2.6.6 Example 6 ~-~- Connect to ENTELECHY-EP_SDI-12 ===
	1003
	1004	==== 2.6.4.1 Reference Manual and Command ====
	1005
	1006
	1007	* [[https:~~/~~/enviroprosoilprobes.com/wp-content/uploads/2019/11/ENTELECHY-EP_SDI-12-Commands.pdf>>url:https://enviroprosoilprobes.com/wp-content/uploads/2019/11/ENTELECHY-EP_SDI-12-Commands.pdf]]
	1008
	1009	* Commands to be used in PC and output.
	1010
	1011	1.check device address
	1012
	1013	2.change device address
	1014
	1015	3.check device ID
	1016
	1017	4.start measure
	1018
	1019	5.Get Meausre result
	1020
	1021
	1022	[[image:image-20230627174559-3.png]]
	1023
87.3	1024
81.1	1025	==== 2.6.4.2 Hardware Connection to SDI-12-LB ====
	1026
87.3	1027
81.1	1028	[[image:image-20230627174446-2.png]]
	1029
	1030
	1031
	1032	==== 2.6.4.3 Commands set in SDI-12-LB and uplink payload ====
	1033
	1034
	1035	[[image:image-20230627175513-4.png\|\|height="596" width="576"]]
	1036
	1037	[[image:image-20230627175736-5.png\|\|height="429" width="693"]]
	1038
	1039
	1040	Data in TTN:
	1041
	1042	[[image:image-20230627180303-6.png\|\|height="292" width="1171"]]
	1043
87.3	1044
43.1	1045	== 2.7 Frequency Plans ==
	1046
	1047
37.3	1048	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	1049
37.3	1050	[[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	1051
	1052
43.1	1053	== 2.8 Firmware Change Log ==
37.3	1054
	1055
2.2	1056	Firmware download link:
	1057
41.9	1058	[[https:~~/~~/www.dropbox.com/sh/qrbgbikb109lkiv/AACBR-v_ZhZAMengcY7Nsa1ja?dl=0>>https://www.dropbox.com/sh/qrbgbikb109lkiv/AACBR-v_ZhZAMengcY7Nsa1ja?dl=0]]
2.2	1059
	1060
37.3	1061	= 3. Configure SDI-12-LB via AT Command or LoRaWAN Downlink =
2.2	1062
	1063
	1064	Use can configure SDI-12-LB via AT Command or LoRaWAN Downlink.
	1065
40.8	1066	* AT Command Connection: See [[FAQ>>\|\|anchor="H7.FAQ"]].
37.3	1067	* LoRaWAN Downlink instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
2.2	1068
	1069	There are two kinds of commands to configure SDI-12-LB, they are:
	1070
40.7	1071	* (% style="color:blue" %)General Commands.
2.2	1072
	1073	These commands are to configure:
	1074
	1075	* General system settings like: uplink interval.
	1076	* LoRaWAN protocol & radio related command.
	1077
	1078	They are same for all Dragino Device which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:
	1079
40.2	1080	[[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	1081
	1082
40.7	1083	* (% style="color:blue" %)Commands special design for SDI-12-LB
2.2	1084
	1085	These commands only valid for SDI-12-LB, as below:
	1086
	1087
43.1	1088	== 3.1 Set Transmit Interval Time ==
2.2	1089
	1090
	1091	Feature: Change LoRaWAN End Node Transmit Interval.
	1092
37.3	1093	(% style="color:blue" %)AT Command: AT+TDC
2.2	1094
48.21	1095	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
48.7	1096	\|=(% 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
	1097	\|(% style="background-color:#f2f2f2; width:157px" %)AT+TDC=?\|(% style="background-color:#f2f2f2; width:166px" %)Show current transmit Interval\|(% style="background-color:#f2f2f2" %)(((
2.2	1098	30000
	1099	OK
	1100	the interval is 30000ms = 30s
	1101	)))
48.7	1102	\|(% style="background-color:#f2f2f2; width:157px" %)AT+TDC=60000\|(% style="background-color:#f2f2f2; width:166px" %)Set Transmit Interval\|(% style="background-color:#f2f2f2" %)(((
2.2	1103	OK
	1104	Set transmit interval to 60000ms = 60 seconds
	1105	)))
	1106
37.3	1107	(% style="color:blue" %)Downlink Command: 0x01
2.2	1108
	1109	Format: Command Code (0x01) followed by 3 bytes time value.
	1110
37.6	1111	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	1112
37.6	1113	* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
	1114	* Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
2.2	1115
87.3	1116
	1117
37.3	1118	== 3.2 Set Interrupt Mode ==
2.2	1119
37.6	1120
2.2	1121	Feature, Set Interrupt mode for GPIO_EXIT.
	1122
37.3	1123	(% style="color:blue" %)AT Command: AT+INTMOD
2.2	1124
48.21	1125	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
48.8	1126	\|=(% 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
	1127	\|(% 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	1128	0
	1129	OK
48.8	1130	the mode is 0 =Disable Interrupt
2.2	1131	)))
48.8	1132	\|(% style="background-color:#f2f2f2; width:154px" %)AT+INTMOD=2\|(% style="background-color:#f2f2f2; width:196px" %)(((
2.2	1133	Set Transmit Interval
43.1	1134	0. (Disable Interrupt),
	1135	~1. (Trigger by rising and falling edge)
	1136	2. (Trigger by falling edge)
	1137	3. (Trigger by rising edge)
48.8	1138	)))\|(% style="background-color:#f2f2f2; width:157px" %)OK
2.2	1139
37.3	1140	(% style="color:blue" %)Downlink Command: 0x06
2.2	1141
	1142	Format: Command Code (0x06) followed by 3 bytes.
	1143
	1144	This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
	1145
37.6	1146	* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
	1147	* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
2.2	1148
87.3	1149
	1150
37.3	1151	== 3.3 Set the output time ==
	1152
	1153
2.2	1154	Feature, Control the output 3V3 , 5V or 12V.
	1155
37.3	1156	(% style="color:blue" %)AT Command: AT+3V3T
2.2	1157
48.21	1158	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:474px" %)
48.9	1159	\|=(% 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
	1160	\|(% 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	1161	0
	1162	OK
	1163	)))
48.9	1164	\|(% 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	1165	OK
	1166	default setting
	1167	)))
48.9	1168	\|(% 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	1169	OK
	1170	)))
48.9	1171	\|(% 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	1172	OK
	1173	)))
	1174
37.3	1175	(% style="color:blue" %)AT Command: AT+5VT
2.2	1176
48.21	1177	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:470px" %)
48.9	1178	\|=(% 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
	1179	\|(% 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	1180	0
	1181	OK
	1182	)))
48.9	1183	\|(% 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	1184	OK
	1185	default setting
	1186	)))
48.9	1187	\|(% 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	1188	OK
	1189	)))
48.9	1190	\|(% 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	1191	OK
	1192	)))
	1193
73.1	1194	(% style="color:blue" %)AT Command: AT+12VT
2.2	1195
73.1	1196	(% style="color:blue" %)（The v1.2 version is enabled for 1 second by default, and the version below v1.2 is disabled by default）
	1197
48.21	1198	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:443px" %)
48.9	1199	\|=(% 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
	1200	\|(% 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	1201	0
	1202	OK
	1203	)))
48.9	1204	\|(% 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
	1205	\|(% 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	1206	OK
	1207	)))
	1208
37.3	1209	(% style="color:blue" %)Downlink Command: 0x07
2.2	1210
	1211	Format: Command Code (0x07) followed by 3 bytes.
	1212
	1213	The first byte is which power, the second and third bytes are the time to turn on.
	1214
37.3	1215	* Example 1: Downlink Payload: 070101F4 ~-~--> AT+3V3T=500
	1216	* Example 2: Downlink Payload: 0701FFFF ~-~--> AT+3V3T=65535
	1217	* Example 3: Downlink Payload: 070203E8 ~-~--> AT+5VT=1000
	1218	* Example 4: Downlink Payload: 07020000 ~-~--> AT+5VT=0
	1219	* Example 5: Downlink Payload: 070301F4 ~-~--> AT+12VT=500
	1220	* Example 6: Downlink Payload: 07030000 ~-~--> AT+12VT=0
2.2	1221
87.3	1222
	1223
37.3	1224	== 3.4 Set the all data mode ==
	1225
37.5	1226
2.2	1227	Feature, Set the all data mode.
	1228
37.5	1229	(% style="color:blue" %)AT Command: AT+ALLDATAMOD
2.2	1230
48.21	1231	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:437px" %)
48.11	1232	\|=(% style="background-color:#D9E2F3;color:#0070C0" %)Command Example\|=(% style="background-color:#D9E2F3;color:#0070C0" %)Function\|=(% style="background-color:#D9E2F3;color:#0070C0" %)Response
48.16	1233	\|(% style="background-color:#f2f2f2" %)AT+ALLDATAMOD=?\|(% style="background-color:#f2f2f2" %)Show current all data mode\|(% style="background-color:#f2f2f2" %)(((
2.2	1234	0
	1235	OK
	1236	)))
48.16	1237	\|(% style="background-color:#f2f2f2" %)AT+ALLDATAMOD=1\|(% style="background-color:#f2f2f2" %)Set all data mode is 1.\|(% style="background-color:#f2f2f2" %)OK
2.2	1238
37.5	1239	(% style="color:blue" %)Downlink Command: 0xAB
2.2	1240
	1241	Format: Command Code (0xAB) followed by 1 bytes.
	1242
37.5	1243	* Example 1: Downlink Payload: AB 00 ~/~/ AT+ALLDATAMOD=0
	1244	* Example 2: Downlink Payload: AB 01 ~/~/ AT+ALLDATAMOD=1
2.2	1245
87.3	1246
	1247
37.3	1248	== 3.5 Set the splicing payload for uplink ==
	1249
37.5	1250
2.2	1251	Feature, splicing payload for uplink.
	1252
37.5	1253	(% style="color:blue" %)AT Command: AT+DATAUP
2.2	1254
48.21	1255	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
48.12	1256	\|=(% style="width: 154px;background-color:#D9E2F3;color:#0070C0" %)Command Example\|=(% style="width: 266px;background-color:#D9E2F3;color:#0070C0" %)Function\|=(% style="background-color:#D9E2F3;color:#0070C0" %)Response
48.16	1257	\|(% style="background-color:#f2f2f2; width:154px" %)AT+DATAUP =?\|(% style="background-color:#f2f2f2; width:266px" %)Show current splicing payload for uplink mode\|(% style="background-color:#f2f2f2" %)(((
2.2	1258	0
	1259	OK
	1260	)))
48.16	1261	\|(% style="background-color:#f2f2f2; width:154px" %)AT+DATAUP =0\|(% style="background-color:#f2f2f2; width:266px" %)(((
2.2	1262	Set splicing payload for uplink mode is 0.
48.16	1263	)))\|(% style="background-color:#f2f2f2" %)(((
2.2	1264	OK
	1265	)))
48.16	1266	\|(% style="background-color:#f2f2f2; width:154px" %)AT+DATAUP =1\|(% style="background-color:#f2f2f2; width:266px" %)Set splicing payload for uplink mode is 1 , and the each splice uplink is sent sequentially.\|(% style="background-color:#f2f2f2" %)OK
	1267	\|(% style="background-color:#f2f2f2; width:154px" %)AT+DATAUP =1,20000\|(% style="background-color:#f2f2f2; width:266px" %)(((
37.3	1268	Set splicing payload for uplink mode is 1, and the uplink interval of each splice to 20000 milliseconds.
48.16	1269	)))\|(% style="background-color:#f2f2f2" %)OK
2.2	1270
37.5	1271	(% style="color:blue" %)Downlink Command: 0xAD
2.2	1272
	1273	Format: Command Code (0xAD) followed by 1 bytes or 5 bytes.
	1274
37.6	1275	* Example 1: Downlink Payload: AD 00 ~/~/ AT+DATAUP=0
	1276	* Example 2: Downlink Payload: AD 01 ~/~/ AT+DATAUP =1
	1277	* Example 3: Downlink Payload: AD 01 00 00 14 ~/~/ AT+DATAUP =1,20000
2.2	1278
	1279	This means that the interval is set to 0x000014=20S
	1280
	1281
37.3	1282	== 3.6 Set the payload version ==
2.2	1283
41.20	1284
2.2	1285	Feature, Set the payload version.
	1286
37.5	1287	(% style="color:blue" %)AT Command: AT+PAYVER
2.2	1288
48.21	1289	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:437px" %)
48.13	1290	\|=(% style="width: 158px;background-color:#D9E2F3;color:#0070C0" %)Command Example\|=(% style="width: 192px;background-color:#D9E2F3;color:#0070C0" %)Function\|=(% style="background-color:#D9E2F3;color:#0070C0" %)Response
48.16	1291	\|(% style="background-color:#f2f2f2; width:158px" %)AT+PAYVER=?\|(% style="background-color:#f2f2f2; width:192px" %)Show current payload version\|(% style="background-color:#f2f2f2" %)(((
2.2	1292	1
	1293	OK
	1294	)))
48.16	1295	\|(% style="background-color:#f2f2f2; width:158px" %)AT+PAYVER=5\|(% style="background-color:#f2f2f2; width:192px" %)Set payload version is 5.\|(% style="background-color:#f2f2f2" %)OK
2.2	1296
37.5	1297	(% style="color:blue" %)Downlink Command: 0xAE
2.2	1298
	1299	Format: Command Code (0xAE) followed by 1 bytes.
	1300
37.6	1301	* Example 1: Downlink Payload: AE 01 ~/~/ AT+PAYVER=1
	1302	* Example 2: Downlink Payload: AE 05 ~/~/ AT+PAYVER=5
2.2	1303
87.3	1304
	1305
48.14	1306	= 4. Battery & Power Consumption =
2.2	1307
48.16	1308
48.15	1309	SDI-12-LB uses ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
2.2	1310
48.16	1311	[[Battery Info & Power Consumption Analyze>>url:http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
37.3	1312
	1313
	1314	= 5. Remote Configure device =
2.2	1315
37.3	1316	== 5.1 Connect via BLE ==
2.2	1317
	1318
37.3	1319	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	1320
	1321
37.3	1322	== 5.2 AT Command Set ==
2.2	1323
	1324
	1325
37.3	1326	= 6. OTA firmware update =
	1327
	1328
2.2	1329	Please see this link for how to do OTA firmware update.
	1330
	1331	[[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/]]
	1332
	1333
40.2	1334	= 7. FAQ =
2.2	1335
48.1	1336	== 7.1 How to use AT Command via UART to access device? ==
2.2	1337
	1338
40.2	1339	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]]
	1340
	1341
	1342	== 7.2 How to update firmware via UART port? ==
	1343
	1344
	1345	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]]
	1346
	1347
	1348	== 7.3 How to change the LoRa Frequency Bands/Region? ==
	1349
	1350
	1351	You can follow the instructions for [[how to upgrade image>>doc:Main.Firmware Upgrade Instruction for STM32 base products.WebHome]].
	1352	When downloading the images, choose the required image file for download.
	1353
	1354
	1355	= 8. Order Info =
	1356
	1357
41.20	1358	(((
40.7	1359	(% style="color:blue" %)Part Number: SDI-12-LB-XXX
41.20	1360	)))
40.7	1361
41.20	1362	(((
73.4	1363	(% style="color:blue" %)XXX(%%): The default frequency band
41.20	1364	)))
2.2	1365
41.20	1366	(((
40.7	1367	(% style="color:red" %)AS923(%%): LoRaWAN AS923 band
	1368	(% style="color:red" %)AU915(%%): LoRaWAN AU915 band
	1369	(% style="color:red" %)EU433(%%): LoRaWAN EU433 band
	1370	(% style="color:red" %)EU868(%%): LoRaWAN EU868 band
	1371	(% style="color:red" %)KR920(%%): LoRaWAN KR920 band
	1372	(% style="color:red" %)US915(%%): LoRaWAN US915 band
	1373	(% style="color:red" %)IN865(%%): LoRaWAN IN865 band
	1374	(% style="color:red" %)CN470(%%): LoRaWAN CN470 band
41.20	1375	)))
2.2	1376
	1377
40.2	1378	= 9. Packing Info =
37.3	1379
	1380
40.7	1381	(% style="color:#037691" %)Package Includes:
2.2	1382
37.3	1383	* SDI-12-LB SDI-12 to LoRaWAN Converter x 1
2.2	1384
40.7	1385	(% style="color:#037691" %)Dimension and weight:
2.2	1386
	1387	* Device Size: cm
	1388	* Device Weight: g
	1389	* Package Size / pcs : cm
	1390	* Weight / pcs : g
	1391
87.3	1392
	1393
40.2	1394	= 10. Support =
37.3	1395
	1396
2.2	1397	* 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.
	1398
37.3	1399	* 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]]

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

Applications

Navigation