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

Version 87.5 by Xiaoling on 2023/10/23 14:21

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