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

Version 130.1 by Xiaoling on 2025/03/29 13:38

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