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

Version 87.17 by Xiaoling on 2024/01/03 16:48

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

Applications

Navigation