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

Version 44.2 by Xiaoling on 2023/02/24 09:16

version	line-number	content
40.7	1	(% style="text-align:center" %)
	2	[[image:image-20230131183542-1.jpeg\|\|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
40.7	50	[[image:image-20230201084414-1.png\|\|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
44.2	68
	69
9.2	70	== 1.3 Specification ==
2.2	71
	72
40.2	73	(% style="color:#037691" %)Micro Controller:
2.2	74
	75	* MCU: 48Mhz ARM
	76	* Flash: 256KB
	77	* RAM: 64KB
	78
40.2	79	(% style="color:#037691" %)Common DC Characteristics:
2.2	80
	81	* Supply Voltage: 2.5v ~~ 3.6v
	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
44.2	116
	117
9.2	118	== 1.4 Connect to SDI-12 Sensor ==
2.2	119
	120
	121
40.7	122	[[image:1675212538524-889.png]]
2.2	123
	124
9.2	125	== 1.5 Sleep mode and working mode ==
2.2	126
	127
40.2	128	(% style="color:blue" %)Deep Sleep Mode: (%%)Sensor doesn't have any LoRaWAN activate. This mode is used for storage and shipping to save battery life.
2.2	129
40.2	130	(% style="color:blue" %)Working Mode: (%%)In this mode, Sensor will work as LoRaWAN Sensor to Join LoRaWAN network and send out sensor data to server. Between each sampling/tx/rx periodically, sensor will be in IDLE mode), in IDLE mode, sensor has the same power consumption as Deep Sleep mode.
2.2	131
	132
9.2	133	== 1.6 Button & LEDs ==
2.2	134
	135
40.7	136	[[image:1675212633011-651.png]]
2.2	137
	138
9.2	139	(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
41.14	140	\|=(% style="width: 167px;" %)Behavior on ACT\|=(% style="width: 109px;" %)Function\|=(% style="width: 231px;" %)Action
	141	\|(% style="width:167px" %)Pressing ACT between 1s < time < 3s\|(% style="width:109px" %)Send an uplink\|(% style="width:231px" %)(((
9.2	142	If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)blue led (%%)will blink once.
2.2	143	Meanwhile, BLE module will be active and user can connect via BLE to configure device.
	144	)))
41.14	145	\|(% style="width:167px" %)Pressing ACT for more than 3s\|(% style="width:109px" %)Active Device\|(% style="width:231px" %)(((
9.2	146	(% style="color:green" %)Green led(%%) will fast blink 5 times, device will enter (% style="color:#037691" %)OTA mode(%%) for 3 seconds. And then start to JOIN LoRaWAN network.
	147	(% style="color:green" %)Green led(%%) will solidly turn on for 5 seconds after joined in network.
2.2	148	Once sensor is active, BLE module will be active and user can connect via BLE to configure device, no matter if device join or not join LoRaWAN network.
	149	)))
43.1	150	\|(% style="width:167px" %)Fast press ACT 5 times.\|(% style="width:109px" %)Deactivate Device\|(% style="width:231px" %)(% style="color:red" %)Red led(%%) will solid on for 5 seconds. Means SDI-12-LB is in Deep Sleep Mode.
2.2	151
44.2	152
	153
9.2	154	== 1.7 Pin Mapping ==
2.2	155
	156
40.7	157	[[image:1675213198663-754.png]]
2.2	158
	159
9.2	160	== 1.8 BLE connection ==
2.2	161
9.2	162
2.2	163	SDI-12-LB support BLE remote configure.
	164
	165	BLE can be used to configure the parameter of sensor or see the console output from sensor. BLE will be only activate on below case:
	166
	167	* Press button to send an uplink
	168	* Press button to active device.
	169	* Device Power on or reset.
	170
	171	If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
	172
	173
9.2	174	== 1.9 Mechanical ==
2.2	175
	176
40.7	177	[[image:image-20230201090139-2.png]]
2.2	178
40.7	179	[[image:image-20230201090139-3.png]]
2.2	180
40.7	181	[[image:image-20230201090139-4.png]]
2.2	182
	183
19.2	184	= 2. Configure SDI-12 to connect to LoRaWAN network =
9.2	185
19.2	186	== 2.1 How it works ==
9.2	187
	188
40.2	189	The SDI-12-LB is configured as (% style="color:#037691" %)LoRaWAN OTAA Class A(%%) mode by default. It has OTAA keys to join LoRaWAN network. To connect a local LoRaWAN network, you need to input the OTAA keys in the LoRaWAN IoT server and activate the SDI-12-LB. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes.
9.2	190
2.2	191
19.2	192	== 2.2 Quick guide to connect to LoRaWAN server (OTAA) ==
2.2	193
	194
	195	Following is an example for how to join the [[TTN v3 LoRaWAN Network>>url:https://console.cloud.thethings.network/]]. Below is the network structure; we use the [[LPS8v2>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/228-lps8v2.html]] as a LoRaWAN gateway in this example.
	196
	197
40.7	198	[[image:image-20230201090528-5.png\|\|height="465" width="1111"]]
2.2	199
	200
	201	The LPS8V2 is already set to connected to [[TTN network >>url:https://console.cloud.thethings.network/]], so what we need to now is configure the TTN server.
	202
	203
40.2	204	(% style="color:blue" %)Step 1(%%): Create a device in TTN with the OTAA keys from SDI-12-LB.
2.2	205
	206	Each SDI-12-LB is shipped with a sticker with the default device EUI as below:
	207
	208
41.2	209	[[image:image-20230201152430-20.jpeg]]
2.2	210
	211
	212	You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
	213
	214
40.2	215	(% style="color:blue" %)Register the device
2.2	216
40.7	217	[[image:1675213652444-622.png]]
2.2	218
	219
40.2	220	(% style="color:blue" %)Add APP EUI and DEV EUI
2.2	221
	222
40.7	223	[[image:1675213661769-223.png]]
2.2	224
	225
40.2	226	(% style="color:blue" %)Add APP EUI in the application
2.2	227
	228
40.7	229	[[image:1675213675852-577.png]]
2.2	230
	231
40.2	232	(% style="color:blue" %)Add APP KEY
2.2	233
40.7	234	[[image:1675213686734-883.png]]
2.2	235
	236
40.2	237	(% style="color:blue" %)Step 2(%%): Activate on SDI-12-LB
2.2	238
	239
	240	Press the button for 5 seconds to activate the SDI-12-LB.
	241
40.2	242	(% 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	243
	244
40.7	245	[[image:1675213704414-644.png]]
2.2	246
	247
19.2	248	== 2.3 SDI-12 Related Commands ==
2.2	249
	250
19.2	251	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	252
	253
29.2	254	=== 2.3.1 Basic SDI-12 debug command ===
2.2	255
	256
	257	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.
	258
	259	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.
	260
	261	The following is the display information on the serial port and the server.
	262
	263
40.7	264	[[image:image-20230201091027-6.png]]
2.2	265
19.2	266
40.7	267	[[image:image-20230201091027-7.png\|\|height="261" width="1179"]]
19.2	268
	269
41.4	270
40.2	271	==== (% style="color:blue" %)al! ~-~- Get SDI-12 sensor Identification(%%) ====
19.2	272
	273
2.2	274	* AT Command: AT+ADDRI=aa
	275	* LoRaWAN Downlink(prefix 0xAA00): AA 00 aa
	276
40.2	277	(% style="color:#037691" %)Parameter: (%%)aa: ASCII value of SDI-12 sensor address in downlink or HEX value in AT Command)
2.2	278
41.4	279	(% style="color:blue" %)Example : (%%)AT+ADDRI=0 ( Equal to downlink: 0x AA 00 30)
2.2	280
	281
	282	The following is the display information on the serial port and the server.
	283
	284
40.7	285	[[image:image-20230201091257-8.png]]
2.2	286
	287
40.7	288	[[image:image-20230201091257-9.png\|\|height="225" width="1242"]]
19.2	289
	290
40.2	291	==== (% style="color:blue" %)aM!,aMC!, aM1!- aM9!, aMC1!- aMC9!(%%) ====
2.2	292
	293
40.2	294	(% style="color:red" %)aM! (%%): Start Non-Concurrent Measurement
2.2	295
40.2	296	(% style="color:red" %)aMC! (%%): Start Non-Concurrent Measurement – Request CRC
2.2	297
40.2	298	(% style="color:red" %)aM1!- aM9! (%%): Additional Measurements
2.2	299
40.2	300	(% style="color:red" %)aMC1!- aMC9!(%%) : Additional Measurements – Request CRC
2.2	301
27.2	302
2.2	303	* AT Command : AT+ADDRM=0,1,0,1
37.10	304
2.2	305	* LoRaWAN Downlink(prefix 0xAA01): 0xAA 01 30 01 00 01
	306
	307	Downlink：AA 01 aa bb cc dd
	308
40.2	309	(% style="color:#037691" %)aa(%%): SDI-12 sensor address.
2.2	310
40.2	311	(% style="color:#037691" %)bb(%%): 0: no CRC, 1: request CRC
2.2	312
40.2	313	(% style="color:#037691" %)cc(%%): 1-9: Additional Measurement, 0: no additional measurement
2.2	314
41.5	315	(% style="color:#037691" %)dd(%%): delay (in second) to send (% style="color:#037691" %)__aD0!__(%%) to get return.
2.2	316
	317
	318	The following is the display information on the serial port and the server.
	319
	320
40.7	321	[[image:image-20230201091630-10.png]]
2.2	322
	323
40.7	324	[[image:image-20230201091630-11.png\|\|height="247" width="1165"]]
2.2	325
	326
	327
40.2	328	==== (% style="color:blue" %)aC!, aCC!, aC1!- aC9!, aCC1!- aCC9! (%%) ====
2.2	329
	330
40.2	331	(% style="color:red" %)aC!(%%) : Start Concurrent Measurement
2.2	332
40.2	333	(% style="color:red" %)aCC! (%%): Start Concurrent Measurement – Request CRC
2.2	334
40.2	335	(% style="color:red" %)aC1!- aC9!(%%) : Start Additional Concurrent Measurements
27.2	336
40.2	337	(% style="color:red" %)aCC1!- aCC9!(%%) : Start Additional Concurrent Measurements – Request CRC
27.2	338
	339
2.2	340	* AT Command : AT+ADDRC=0,1,0,1
	341
	342	* LoRaWAN Downlink(0xAA02): 0xAA 02 30 01 00 01
	343
	344	Downlink: AA 02 aa bb cc dd
	345
40.2	346	(% style="color:#037691" %)aa(%%): SDI-12 sensor address.
2.2	347
40.2	348	(% style="color:#037691" %)bb(%%): 0: no CRC, 1: request CRC
2.2	349
40.2	350	(% style="color:#037691" %)cc(%%): 1-9: Additional Measurement, 0: no additional measurement
2.2	351
41.5	352	(% style="color:#037691" %)dd(%%): delay (in second) to send (% style="color:#037691" %)__aD0!__(%%)__ __to get return.
2.2	353
	354
	355	The following is the display information on the serial port and the server.
	356
	357
40.7	358	[[image:image-20230201091954-12.png]]
2.2	359
	360
40.7	361	[[image:image-20230201091954-13.png\|\|height="203" width="1117"]]
2.2	362
27.2	363
	364
	365
40.2	366	==== (% style="color:blue" %)aR0!- aR9!, aRC0!- aRC9!(%%) ====
27.2	367
37.10	368
2.2	369	Start Continuous Measurement
	370
	371	Start Continuous Measurement – Request CRC
	372
	373
	374	* AT Command : AT+ADDRR=0,1,0,1
	375	* LoRaWAN Downlink (0xAA 03): 0xAA 03 30 01 00 01
	376
	377	Downlink: AA 03 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
40.7	391	[[image:image-20230201092208-14.png]]
2.2	392
27.2	393
40.7	394	[[image:image-20230201092208-15.png\|\|height="214" width="1140"]]
27.2	395
	396
37.2	397	=== 2.3.2 Advance SDI-12 Debug command ===
27.2	398
	399
2.2	400	This command can be used to debug all SDI-12 command.
	401
	402
	403	LoRaWAN Downlink: A8 aa xx xx xx xx bb cc
	404
40.2	405	(% style="color:#037691" %)aa (%%): total SDI-12 command length
2.2	406
40.2	407	(% style="color:#037691" %)xx (%%): SDI-12 command
2.2	408
40.2	409	(% style="color:#037691" %)bb (%%): Delay to wait for return
2.2	410
40.2	411	(% style="color:#037691" %)cc (%%): 0: don't uplink return to LoRaWAN, 1: Uplink return to LoRaWAN on FPORT=100
2.2	412
	413
40.2	414	(% style="color:blue" %)Example: (%%) AT+CFGDEV =0RC0!,1
2.2	415
40.2	416	(% style="color:#037691" %)0RC0! (%%): SDI-12 Command,
2.2	417
40.2	418	(% style="color:#037691" %)1 (%%): Delay 1 second. ( 0: 810 mini-second)
2.2	419
	420	Equal Downlink: 0xA8 05 30 52 43 30 21 01 01
	421
	422
	423	The following is the display information on the serial port and the server.
	424
	425
40.7	426	[[image:image-20230201092355-16.png]]
2.2	427
	428
40.7	429	[[image:image-20230201092355-17.png\|\|height="426" width="1135"]]
27.2	430
29.2	431
	432	=== 2.3.3 Convert ASCII to String ===
	433
	434
2.2	435	This command is used to convert between ASCII and String format.
	436
	437	AT+CONVFORM ( Max length: 80 bytes)
	438
	439
40.2	440	(% style="color:blue" %)Example:
2.2	441
29.2	442	1) AT+CONVFORM=0, string Convert String from String to ASCII
2.2	443
40.7	444	[[image:1675214845056-885.png]]
2.2	445
	446
29.2	447	2) AT+CONVFORM=1, ASCII Convert ASCII to String.
2.2	448
40.7	449	[[image:1675214856590-846.png]]
2.2	450
29.2	451
	452	=== 2.3.4 Define periodically SDI-12 commands and uplink. ===
	453
	454
2.2	455	AT+COMMANDx & AT+DATACUTx
	456
	457	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.
	458
	459
40.2	460	* (% style="color:blue" %)AT Command:
2.2	461
40.2	462	(% style="color:#037691" %)AT+COMMANDx=var1,var2,var3,var4.
2.2	463
40.2	464	(% style="color:red" %)var1(%%): SDI-12 command , for example: 0RC0!
2.2	465
40.2	466	(% style="color:red" %)var2(%%): Wait timeout for return. (unit: second)
2.2	467
40.2	468	(% style="color:red" %)var3(%%): Whether to send //addrD0!// to get return after var2 timeout. 0: Don't Send //addrD0! //; 1: Send //addrD0!//.
2.2	469
44.1	470	(% style="color:red" %)var4(%%): validation check for return. If return invalid, SDI-12-LB will resend this command. Max 3 retries.
2.2	471
40.2	472	(% style="color:red" %)0 (%%) No validation check;
2.2	473
40.2	474	(% style="color:red" %)1 (%%) Check if return chars are printable char(0x20 ~~ 0x7E);
2.2	475
41.5	476	(% style="color:red" %)2(%%) Check if there is return from SDI-12 sensor
2.2	477
40.2	478	(% style="color:red" %)3 (%%) Check if return pass CRC check ( SDI-12 command var1 must include CRC request);
2.2	479
	480
40.2	481	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	482
	483
40.2	484	(% style="color:blue" %)AT+DATACUTx(%%) : This command defines how to handle the return from AT+COMMANDx, max return length is 100 bytes.
2.2	485
29.2	486	(% border="1" style="background-color:#f7faff; width:436px" %)
	487	\|(% style="width:433px" %)(((
35.2	488	AT+DATACUTx=a,b,c
2.2	489
29.2	490	a: length for the return of AT+COMMAND
2.2	491
37.11	492	b: 1: grab valid value by byte, max 6 bytes. 2: grab valid value by bytes section, max 3 sections.
2.2	493
29.2	494	c: define the position for valid value.
2.2	495	)))
	496
43.1	497	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	498
	499
35.2	500	(% border="1" cellspacing="4" style="background-color:#f7faff; width:510px" %)
41.15	501	\|=(% style="width: 164px;" %)AT+DATACUT1 value\|=(% style="width: 344px;" %)Final Result to combine Payload
	502	\|(% style="width:164px" %)34,1,1+2+3\|(% style="width:344px" %)0D 00 01 30 31 33
	503	\|(% style="width:164px" %)34,2,1~~8+12~~16\|(% style="width:344px" %)0D 00 01 30 31 33 4D 45 54 45 52 54 45 52 31 32
	504	\|(% style="width:164px" %)34,2,1~~34\|(% style="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	505
40.2	506	* (% style="color:blue" %) Downlink Payload:
2.2	507
40.2	508	(% style="color:blue" %)0xAF(%%) downlink command can be used to set AT+COMMANDx or AT+DATACUTx.
2.2	509
	510
40.2	511	(% style="color:red" %)Note : if user use AT+COMMANDx to add a new command, he also need to send AT+DATACUTx downlink.
2.2	512
	513
40.2	514	Format: (% style="color:#037691" %)AF MM NN LL XX XX XX XX YY(%%)
2.2	515
	516	Where:
	517
40.2	518	* (% style="color:#037691" %)MM (%%): the AT+COMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
43.1	519	* (% style="color:#037691" %)NN (%%): 1: set the AT+COMMAND value ; 2: set the AT+DATACUT value.
40.2	520	* (% style="color:#037691" %)LL (%%): The length of AT+COMMAND or AT+DATACUT command
	521	* (% style="color:#037691" %)XX XX XX XX (%%): AT+COMMAND or AT+DATACUT command
43.1	522	* (% 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	523
40.2	524	(% style="color:blue" %)Example:
2.2	525
40.7	526	[[image:image-20230201094129-18.png]]
2.2	527
	528
41.16	529
40.2	530	(% style="color:blue" %)Clear SDI12 Command
2.2	531
	532	The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them.
	533
	534
40.2	535	* (% style="color:#037691" %)AT Command:
2.2	536
40.2	537	(% style="color:#4f81bd" %)AT+CMDEAR=mm,nn (%%) mm: start position of erase ,nn: stop position of erase
2.2	538
	539
	540	Etc. AT+CMDEAR=1,10 means erase AT+COMMAND1/AT+DATACUT1 to AT+COMMAND10/AT+DATACUT10
	541
	542
40.2	543	* (% style="color:#037691" %) Downlink Payload:
2.2	544
40.2	545	(% style="color:#4f81bd" %)0x09 aa bb(%%) same as AT+CMDEAR=aa,bb
2.2	546
	547
	548
40.2	549	(% style="color:blue" %)command combination
2.2	550
	551	Below shows a screen shot how the results combines together to a uplink payload.
	552
40.7	553	[[image:1675215745275-920.png]]
2.2	554
	555
35.2	556	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	557
40.2	558	(% 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	559
	560
41.7	561	(% 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	562
	563
40.7	564	[[image:1675215782925-448.png]]
2.2	565
	566
40.2	567	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	568
	569
	570
41.17	571	(% style="color:blue" %)Compose Uplink
2.2	572
40.2	573	(% style="color:#4f81bd" %)AT+DATAUP=0
2.2	574
41.8	575	Compose the uplink payload with value returns in sequence and send with __A SIGNLE UPLINK__.
2.2	576
41.8	577	Final Payload is __Battery Info+PAYVER + VALID Value from RETURN1 + Valid Value from RETURN2 + … + RETURNx__
2.2	578
	579	Where PAYVER is defined by AT+PAYVER, below is an example screen shot.
	580
	581
40.7	582	[[image:1675215828102-844.png]]
2.2	583
	584
40.2	585	(% style="color:#4f81bd" %)AT+DATAUP=1
2.2	586
41.8	587	Compose the uplink payload with value returns in sequence and send with __Multiply UPLINKs__.
2.2	588
41.8	589	Final Payload is __Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA__
2.2	590
	591	1. Battery Info (2 bytes): Battery voltage
	592	1. PAYVER (1 byte): Defined by AT+PAYVER
	593	1. PAYLOAD COUNT (1 byte): Total how many uplinks of this sampling.
	594	1. PAYLOAD# (1 byte): Number of this uplink. (from 0,1,2,3…,to PAYLOAD COUNT)
	595	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
	596
40.7	597	[[image:1675215848113-696.png]]
2.2	598
	599
40.2	600	(% 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	601
35.2	602	* For AU915/AS923 bands, if UplinkDwell time=0, max 51 bytes for each uplink ( so 51 -5 = 46 max valid date)
	603	* For AU915/AS923 bands, if UplinkDwell time=1, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date).
	604	* For US915 band, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date).
	605	* For all other bands: max 51 bytes for each uplink ( so 51 -5 = 46 max valid date).
2.2	606
40.2	607	(% 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	608
40.2	609	(% 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	610
	611
40.7	612	== 2.4 Uplink Payload ==
2.2	613
37.2	614	=== 2.4.1 Device Payload, FPORT~=5 ===
2.2	615
37.2	616
2.2	617	Include device configure status. Once SDI-12-LB Joined the network, it will uplink this message to the server.
	618
	619	Users can also use the downlink command(0x26 01) to ask SDI-12-LB to resend this uplink.
	620
41.17	621	(% border="1" cellspacing="4" style="background-color:#f7faff; width:420px" %)
35.2	622	\|(% colspan="6" style="width:434px" %)Device Status (FPORT=5)
41.17	623	\|(% style="width:114px" %)Size(bytes)\|(% style="width:39px" %)1\|(% style="width:80px" %)2\|(% style="width:89px" %)1\|(% style="width:59px" %)1\|(% style="width:37px" %)2
	624	\|(% style="width:114px" %)Value\|(% style="width:39px" %)Sensor Model\|(% style="width:80px" %)Firmware Version\|(% style="width:89px" %)Frequency Band\|(% style="width:59px" %)Sub-band\|(% style="width:37px" %)BAT
2.2	625
	626	Example parse in TTNv3
	627
40.7	628	[[image:1675215946738-635.png]]
2.2	629
37.2	630
40.2	631	(% style="color:#037691" %)Sensor Model(%%): For SDI-12-LB, this value is 0x17
2.2	632
40.2	633	(% style="color:#037691" %)Firmware Version(%%): 0x0100, Means: v1.0.0 version
2.2	634
40.2	635	(% style="color:#037691" %)Frequency Band:
2.2	636
	637	*0x01: EU868
	638
	639	*0x02: US915
	640
	641	*0x03: IN865
	642
	643	*0x04: AU915
	644
	645	*0x05: KZ865
	646
	647	*0x06: RU864
	648
	649	*0x07: AS923
	650
	651	*0x08: AS923-1
	652
	653	*0x09: AS923-2
	654
	655	*0x0a: AS923-3
	656
	657	*0x0b: CN470
	658
	659	*0x0c: EU433
	660
	661	*0x0d: KR920
	662
	663	*0x0e: MA869
	664
	665
40.2	666	(% style="color:#037691" %)Sub-Band:
2.2	667
	668	AU915 and US915:value 0x00 ~~ 0x08
	669
	670	CN470: value 0x0B ~~ 0x0C
	671
	672	Other Bands: Always 0x00
	673
	674
40.2	675	(% style="color:#037691" %)Battery Info:
2.2	676
	677	Check the battery voltage.
	678
	679	Ex1: 0x0B45 = 2885mV
	680
	681	Ex2: 0x0B49 = 2889mV
	682
	683
37.2	684	=== 2.4.2 Uplink Payload, FPORT~=2 ===
2.2	685
37.2	686
2.2	687	There are different cases for uplink. See below
	688
	689	* SDI-12 Debug Command return: FPORT=100
	690
	691	* Periodically Uplink: FPORT=2
	692
41.18	693	(% border="1" cellspacing="4" style="background-color:#f7faff; width:500px" %)
41.19	694	\|=(% style="width: 90px;" %)(((
37.2	695	Size(bytes)
41.19	696	)))\|=(% style="width: 80px;" %)2\|=(% style="width: 90px;" %)1\|=(% style="width: 240px;" %)Length depends on the return from the commands
37.2	697	\|(% style="width:93px" %)Value\|(% style="width:83px" %)(((
2.2	698	Battery(mV)
	699	&
	700	Interrupt_Flag
41.18	701	)))\|(% style="width:91px" %)[[PAYLOAD_VER>>\|\|anchor="H3.6Setthepayloadversion"]]\|(% style="width:212px" %)(((
37.2	702	If the valid payload is too long and exceed the maximum support.
2.2	703	Payload length in server,server will show payload not provided in the LoRaWAN server.
	704	)))
	705
40.7	706	[[image:1675216282284-923.png]]
2.2	707
	708
37.2	709	=== 2.4.3 Battery Info ===
2.2	710
	711
	712	Check the battery voltage for SDI-12-LB.
	713
	714	Ex1: 0x0B45 = 2885mV
	715
	716	Ex2: 0x0B49 = 2889mV
	717
	718
37.2	719	=== 2.4.4 Interrupt Pin ===
2.2	720
37.2	721
40.2	722	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	723
37.2	724	Example:
2.2	725
	726	Ex1: 0x0B45:0x0B&0x80= 0x00 Normal uplink packet.
	727
	728	Ex2: 0x8B49:0x8B&0x80= 0x80 Interrupt Uplink Packet.
	729
	730
37.2	731	=== 2.4.5 Payload version ===
2.2	732
43.1	733	The version number of the payload, mainly used for decoding. The default is 01.
2.2	734
	735
37.2	736	=== 2.4.6 Decode payload in The Things Network ===
2.2	737
	738
	739	While using TTN network, you can add the payload format to decode the payload.
	740
40.7	741	[[image:1675216779406-595.png]]
2.2	742
	743
	744	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.
	745
37.2	746	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	747
	748
37.3	749	== 2.5 Uplink Interval ==
2.2	750
	751
	752	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:
	753
44.2	754	[[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	755
	756
43.1	757	== 2.6 Examples To Set SDI commands. ==
2.2	758
43.1	759	=== 2.6.1 Examples 1 ===
2.2	760
44.2	761
43.1	762	COM port and SDI-12 sensor communication converted to SDI-12-LB and SDI-12 sensor communication.
	763
	764	[[image:image-20230222143809-1.png\|\|height="564" width="729"]]
	765
	766
44.2	767	(% 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	768
44.2	769	a. Send the first command and get the first reply：
43.1	770
44.2	771	(% style="color:#037691" %)AT+COMMANDx=1I!,0,0,1
43.1	772
44.2	773	b. Send the second command and get the second reply：
43.1	774
44.2	775	(% style="color:#037691" %)AT+COMMANDx=2I!,0,0,1
43.1	776
44.2	777	c. Send the third command and get the third reply：
43.1	778
44.2	779	(% style="color:#037691" %)AT+COMMANDx=3I!,0,0,1
43.1	780
44.2	781	d. Send the fourth command and get the fourth reply：
43.1	782
44.2	783	(% style="color:#037691" %)AT+COMMANDx=4I!,0,0,1
43.1	784
44.2	785	e. Send the fifth command plus the sixth command, get the sixth reply：
43.1	786
44.2	787	(% style="color:#037691" %)AT+COMMANDx=1M!,2,1,1
43.1	788
44.2	789	f. Send the seventh command plus the eighth command, get the eighth reply：
43.1	790
44.2	791	(% style="color:#037691" %)AT+COMMANDx=2M!,2,1,1
43.1	792
44.2	793	g. Send the ninth command plus the tenth command, get the tenth reply：
43.1	794
44.2	795	(% style="color:#037691" %)AT+COMMANDx=3M!,1,1,1
43.1	796
44.2	797	h. Send the eleventh command plus the twelfth command, get the twelfth reply：
43.1	798
44.2	799	(% style="color:#037691" %)AT+COMMANDx=4M!,1,1,1
43.1	800
	801
44.2	802	(% 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	803
44.2	804	a. The first reply, all 34 characters: ”113TRUEBNERSMT100038220303182331<CR><LF>”
43.1	805
44.2	806	Cut out all characters: (% style="color:#037691" %)AT+ALLDATAMOD=1 or AT+DATACUTx=34,2,1~~34;
	807
43.1	808	b. The sixth reply, all 31 characters：”1+19210+1.04+0.00+22.49+11.75<CR><LF>”
	809
44.2	810	Cut out all characters: (% style="color:#037691" %)AT+ALLDATAMOD=1 or AT+DATACUTx=31,2,1~~31;
43.1	811
	812	c. The eighth reply, all 31 characters：”2+18990+1.08+0.00+22.24+11.80<CR><LF>”
	813
44.2	814	Cut out all characters: (% style="color:#037691" %)AT+ALLDATAMOD=1 or AT+DATACUTx=31,2,1~~31;
43.1	815
	816	d. The tenth reply, all 15 characters：”3-2919.8+24.0<CR><LF>”
	817
44.2	818	Cut out all characters: (% style="color:#037691" %)AT+ALLDATAMOD=1 or AT+DATACUTx=15,2,1~~15;
43.1	819
	820	e. The twelfth reply, all 25 characters：”4+30.8+22.84+4.7+954.38<CR><LF>”
	821
44.2	822	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	823
	824
	825	== 2.7 Frequency Plans ==
	826
	827
37.3	828	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	829
37.3	830	[[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	831
	832
43.1	833	== 2.8 Firmware Change Log ==
37.3	834
	835
2.2	836	Firmware download link:
	837
41.9	838	[[https:~~/~~/www.dropbox.com/sh/qrbgbikb109lkiv/AACBR-v_ZhZAMengcY7Nsa1ja?dl=0>>https://www.dropbox.com/sh/qrbgbikb109lkiv/AACBR-v_ZhZAMengcY7Nsa1ja?dl=0]]
2.2	839
	840
37.3	841	= 3. Configure SDI-12-LB via AT Command or LoRaWAN Downlink =
2.2	842
	843
	844	Use can configure SDI-12-LB via AT Command or LoRaWAN Downlink.
	845
40.8	846	* AT Command Connection: See [[FAQ>>\|\|anchor="H7.FAQ"]].
37.3	847	* LoRaWAN Downlink instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
2.2	848
	849	There are two kinds of commands to configure SDI-12-LB, they are:
	850
40.7	851	* (% style="color:blue" %)General Commands.
2.2	852
	853	These commands are to configure:
	854
	855	* General system settings like: uplink interval.
	856	* LoRaWAN protocol & radio related command.
	857
	858	They are same for all Dragino Device which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:
	859
40.2	860	[[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	861
	862
40.7	863	* (% style="color:blue" %)Commands special design for SDI-12-LB
2.2	864
	865	These commands only valid for SDI-12-LB, as below:
	866
	867
43.1	868	== 3.1 Set Transmit Interval Time ==
2.2	869
	870
	871	Feature: Change LoRaWAN End Node Transmit Interval.
	872
37.3	873	(% style="color:blue" %)AT Command: AT+TDC
2.2	874
37.3	875	(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
	876	\|=(% style="width: 156px;" %)Command Example\|=(% style="width: 137px;" %)Function\|=Response
	877	\|(% style="width:156px" %)AT+TDC=?\|(% style="width:137px" %)Show current transmit Interval\|(((
2.2	878	30000
	879	OK
	880	the interval is 30000ms = 30s
	881	)))
37.3	882	\|(% style="width:156px" %)AT+TDC=60000\|(% style="width:137px" %)Set Transmit Interval\|(((
2.2	883	OK
	884	Set transmit interval to 60000ms = 60 seconds
	885	)))
	886
37.3	887	(% style="color:blue" %)Downlink Command: 0x01
2.2	888
37.3	889
2.2	890	Format: Command Code (0x01) followed by 3 bytes time value.
	891
37.6	892	If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
2.2	893
37.6	894	* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
	895	* Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
2.2	896
44.2	897
	898
37.3	899	== 3.2 Set Interrupt Mode ==
2.2	900
37.6	901
2.2	902	Feature, Set Interrupt mode for GPIO_EXIT.
	903
37.3	904	(% style="color:blue" %)AT Command: AT+INTMOD
2.2	905
37.3	906	(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
37.6	907	\|=(% style="width: 156px;" %)Command Example\|=(% style="width: 187px;" %)Function\|=(% style="width: 165px;" %)Response
	908	\|(% style="width:156px" %)AT+INTMOD=?\|(% style="width:187px" %)Show current interrupt mode\|(% style="width:165px" %)(((
2.2	909	0
	910	OK
43.1	911	the mode is 0 = Disable Interrupt
2.2	912	)))
37.6	913	\|(% style="width:156px" %)AT+INTMOD=2\|(% style="width:187px" %)(((
2.2	914	Set Transmit Interval
43.1	915	0. (Disable Interrupt),
	916	~1. (Trigger by rising and falling edge)
	917	2. (Trigger by falling edge)
	918	3. (Trigger by rising edge)
37.6	919	)))\|(% style="width:165px" %)OK
2.2	920
37.3	921	(% style="color:blue" %)Downlink Command: 0x06
2.2	922
	923	Format: Command Code (0x06) followed by 3 bytes.
	924
	925	This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
	926
37.6	927	* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
	928	* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
2.2	929
44.2	930
	931
37.3	932	== 3.3 Set the output time ==
	933
	934
2.2	935	Feature, Control the output 3V3 , 5V or 12V.
	936
37.3	937	(% style="color:blue" %)AT Command: AT+3V3T
2.2	938
37.3	939	(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:474px" %)
	940	\|=(% style="width: 154px;" %)Command Example\|=(% style="width: 201px;" %)Function\|=(% style="width: 116px;" %)Response
	941	\|(% style="width:154px" %)AT+3V3T=?\|(% style="width:201px" %)Show 3V3 open time.\|(% style="width:116px" %)(((
2.2	942	0
	943	OK
	944	)))
37.3	945	\|(% style="width:154px" %)AT+3V3T=0\|(% style="width:201px" %)Normally open 3V3 power supply.\|(% style="width:116px" %)(((
2.2	946	OK
	947	default setting
	948	)))
37.3	949	\|(% style="width:154px" %)AT+3V3T=1000\|(% style="width:201px" %)Close after a delay of 1000 milliseconds.\|(% style="width:116px" %)(((
2.2	950	OK
	951	)))
37.3	952	\|(% style="width:154px" %)AT+3V3T=65535\|(% style="width:201px" %)Normally closed 3V3 power supply.\|(% style="width:116px" %)(((
2.2	953	OK
	954	)))
	955
37.3	956	(% style="color:blue" %)AT Command: AT+5VT
2.2	957
37.3	958	(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:470px" %)
	959	\|=(% style="width: 155px;" %)Command Example\|=(% style="width: 196px;" %)Function\|=(% style="width: 114px;" %)Response
	960	\|(% style="width:155px" %)AT+5VT=?\|(% style="width:196px" %)Show 5V open time.\|(% style="width:114px" %)(((
2.2	961	0
	962	OK
	963	)))
37.3	964	\|(% style="width:155px" %)AT+5VT=0\|(% style="width:196px" %)Normally closed 5V power supply.\|(% style="width:114px" %)(((
2.2	965	OK
	966	default setting
	967	)))
37.3	968	\|(% style="width:155px" %)AT+5VT=1000\|(% style="width:196px" %)Close after a delay of 1000 milliseconds.\|(% style="width:114px" %)(((
2.2	969	OK
	970	)))
37.3	971	\|(% style="width:155px" %)AT+5VT=65535\|(% style="width:196px" %)Normally open 5V power supply.\|(% style="width:114px" %)(((
2.2	972	OK
	973	)))
	974
37.3	975	(% style="color:blue" %)AT Command: AT+12VT
2.2	976
37.3	977	(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:443px" %)
	978	\|=(% style="width: 156px;" %)Command Example\|=(% style="width: 199px;" %)Function\|=(% style="width: 83px;" %)Response
	979	\|(% style="width:156px" %)AT+12VT=?\|(% style="width:199px" %)Show 12V open time.\|(% style="width:83px" %)(((
2.2	980	0
	981	OK
	982	)))
37.3	983	\|(% style="width:156px" %)AT+12VT=0\|(% style="width:199px" %)Normally closed 12V power supply.\|(% style="width:83px" %)OK
	984	\|(% style="width:156px" %)AT+12VT=500\|(% style="width:199px" %)Close after a delay of 500 milliseconds.\|(% style="width:83px" %)(((
2.2	985	OK
	986	)))
	987
37.3	988	(% style="color:blue" %)Downlink Command: 0x07
2.2	989
	990	Format: Command Code (0x07) followed by 3 bytes.
	991
	992	The first byte is which power, the second and third bytes are the time to turn on.
	993
37.3	994	* Example 1: Downlink Payload: 070101F4 ~-~--> AT+3V3T=500
	995	* Example 2: Downlink Payload: 0701FFFF ~-~--> AT+3V3T=65535
	996	* Example 3: Downlink Payload: 070203E8 ~-~--> AT+5VT=1000
	997	* Example 4: Downlink Payload: 07020000 ~-~--> AT+5VT=0
	998	* Example 5: Downlink Payload: 070301F4 ~-~--> AT+12VT=500
	999	* Example 6: Downlink Payload: 07030000 ~-~--> AT+12VT=0
2.2	1000
44.2	1001
	1002
37.3	1003	== 3.4 Set the all data mode ==
	1004
37.5	1005
2.2	1006	Feature, Set the all data mode.
	1007
37.5	1008	(% style="color:blue" %)AT Command: AT+ALLDATAMOD
2.2	1009
37.5	1010	(% border="1" cellspacing="4" style="background-color:#f7faff; width:437px" %)
	1011	\|=Command Example\|=Function\|=Response
2.2	1012	\|AT+ALLDATAMOD=?\|Show current all data mode\|(((
	1013	0
	1014	OK
	1015	)))
	1016	\|AT+ALLDATAMOD=1\|Set all data mode is 1.\|OK
	1017
37.5	1018	(% style="color:blue" %)Downlink Command: 0xAB
2.2	1019
	1020	Format: Command Code (0xAB) followed by 1 bytes.
	1021
37.5	1022	* Example 1: Downlink Payload: AB 00 ~/~/ AT+ALLDATAMOD=0
	1023	* Example 2: Downlink Payload: AB 01 ~/~/ AT+ALLDATAMOD=1
2.2	1024
44.2	1025
	1026
37.3	1027	== 3.5 Set the splicing payload for uplink ==
	1028
37.5	1029
2.2	1030	Feature, splicing payload for uplink.
	1031
37.5	1032	(% style="color:blue" %)AT Command: AT+DATAUP
2.2	1033
37.5	1034	(% border="1" cellspacing="4" style="background-color:#f7faff; width:510px" %)
	1035	\|=(% style="width: 154px;" %)Command Example\|=(% style="width: 266px;" %)Function\|=Response
	1036	\|(% style="width:154px" %)AT+DATAUP =?\|(% style="width:266px" %)Show current splicing payload for uplink mode\|(((
2.2	1037	0
	1038	OK
	1039	)))
37.5	1040	\|(% style="width:154px" %)AT+DATAUP =0\|(% style="width:266px" %)(((
2.2	1041	Set splicing payload for uplink mode is 0.
	1042	)))\|(((
	1043	OK
	1044	)))
37.5	1045	\|(% style="width:154px" %)AT+DATAUP =1\|(% style="width:266px" %)Set splicing payload for uplink mode is 1 , and the each splice uplink is sent sequentially.\|OK
	1046	\|(% style="width:154px" %)AT+DATAUP =1,20000\|(% style="width:266px" %)(((
37.3	1047	Set splicing payload for uplink mode is 1, and the uplink interval of each splice to 20000 milliseconds.
2.2	1048	)))\|OK
	1049
37.5	1050	(% style="color:blue" %)Downlink Command: 0xAD
2.2	1051
	1052	Format: Command Code (0xAD) followed by 1 bytes or 5 bytes.
	1053
37.6	1054	* Example 1: Downlink Payload: AD 00 ~/~/ AT+DATAUP=0
	1055	* Example 2: Downlink Payload: AD 01 ~/~/ AT+DATAUP =1
	1056	* Example 3: Downlink Payload: AD 01 00 00 14 ~/~/ AT+DATAUP =1,20000
2.2	1057
	1058	This means that the interval is set to 0x000014=20S
	1059
	1060
37.3	1061	== 3.6 Set the payload version ==
2.2	1062
41.20	1063
2.2	1064	Feature, Set the payload version.
	1065
37.5	1066	(% style="color:blue" %)AT Command: AT+PAYVER
2.2	1067
37.6	1068	(% border="1" cellspacing="4" style="background-color:#f7faff; width:437px" %)
	1069	\|=(% style="width: 158px;" %)Command Example\|=(% style="width: 192px;" %)Function\|=Response
	1070	\|(% style="width:158px" %)AT+PAYVER=?\|(% style="width:192px" %)Show current payload version\|(((
2.2	1071	1
	1072	OK
	1073	)))
37.6	1074	\|(% style="width:158px" %)AT+PAYVER=5\|(% style="width:192px" %)Set payload version is 5.\|OK
2.2	1075
37.5	1076	(% style="color:blue" %)Downlink Command: 0xAE
2.2	1077
	1078	Format: Command Code (0xAE) followed by 1 bytes.
	1079
37.6	1080	* Example 1: Downlink Payload: AE 01 ~/~/ AT+PAYVER=1
	1081	* Example 2: Downlink Payload: AE 05 ~/~/ AT+PAYVER=5
2.2	1082
44.2	1083
	1084
37.3	1085	= 4. Battery & how to replace =
2.2	1086
37.3	1087	== 4.1 Battery Type ==
2.2	1088
	1089
37.5	1090	SDI-12-LB is equipped with a [[8500mAH ER26500 Li-SOCI2 battery>>https://www.dropbox.com/sh/w9l2oa3ytpculph/AAAPtt-apH4lYfCj-2Y6lHvQa?dl=0]]. The battery is un-rechargeable battery with low discharge rate targeting for 8~~10 years use. This type of battery is commonly used in IoT target for long-term running, such as water meter.
37.3	1091
	1092
2.2	1093	The discharge curve is not linear so can’t simply use percentage to show the battery level. Below is the battery performance.
	1094
40.7	1095	[[image:1675234124233-857.png]]
2.2	1096
	1097
37.5	1098	Minimum Working Voltage for the SDI-12-LB:
2.2	1099
37.5	1100	SDI-12-LB: 2.45v ~~ 3.6v
2.2	1101
	1102
37.3	1103	== 4.2 Replace Battery ==
2.2	1104
37.3	1105
2.2	1106	Any battery with range 2.45 ~~ 3.6v can be a replacement. We recommend to use Li-SOCl2 Battery.
	1107
	1108	And make sure the positive and negative pins match.
	1109
	1110
37.3	1111	== 4.3 Power Consumption Analyze ==
2.2	1112
	1113
	1114	Dragino Battery powered product are all runs in Low Power mode. We have an update battery calculator which base on the measurement of the real device. User can use this calculator to check the battery life and calculate the battery life if want to use different transmit interval.
	1115
	1116	Instruction to use as below:
	1117
37.3	1118	(% style="color:blue" %)Step 1:(%%) Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from: [[https:~~/~~/www.dropbox.com/sh/zwex6i331j5oeq2/AACIMf9f_v2qsJ39CuMQ5Py_a?dl=0>>https://www.dropbox.com/sh/zwex6i331j5oeq2/AACIMf9f_v2qsJ39CuMQ5Py_a?dl=0]]
2.2	1119
37.3	1120	(% style="color:blue" %)Step 2:(%%) Open it and choose
2.2	1121
	1122	* Product Model
	1123	* Uplink Interval
	1124	* Working Mode
	1125
	1126	And the Life expectation in difference case will be shown on the right.
	1127
	1128
40.7	1129	[[image:1675234155374-163.png]]
2.2	1130
40.2	1131
2.2	1132	The battery related documents as below:
	1133
37.3	1134	* [[Battery Dimension>>https://www.dropbox.com/s/ox5g9njwjle7aw3/LSN50-Battery-Dimension.pdf?dl=0]],
	1135	* [[Lithium-Thionyl Chloride Battery datasheet, Tech Spec>>https://www.dropbox.com/sh/d4oyfnp8o94180o/AABQewCNSh5GPeQH86UxRgQQa?dl=0]]
	1136	* [[Lithium-ion Battery-Capacitor datasheet>>https://www.dropbox.com/s/791gjes2lcbfi1p/SPC_1520_datasheet.jpg?dl=0]], [[Tech Spec>>https://www.dropbox.com/s/4pkepr9qqqvtzf2/SPC1520%20Technical%20Specification20171123.pdf?dl=0]]
2.2	1137
40.7	1138	[[image:image-20230201145019-19.png]]
2.2	1139
	1140
37.3	1141	=== 4.3.1 Battery Note ===
2.2	1142
	1143
	1144	The Li-SICO battery is designed for small current / long period application. It is not good to use a high current, short period transmit method. The recommended minimum period for use of this battery is 5 minutes. If you use a shorter period time to transmit LoRa, then the battery life may be decreased.
	1145
	1146
37.3	1147	=== 4.3.2 Replace the battery ===
2.2	1148
	1149
37.5	1150	You can change the battery in the SDI-12-LB.The type of battery is not limited as long as the output is between 3v to 3.6v. On the main board, there is a diode (D1) between the battery and the main circuit. If you need to use a battery with less than 3.3v, please remove the D1 and shortcut the two pads of it so there won't be voltage drop between battery and main board.
2.2	1151
37.5	1152	The default battery pack of SDI-12-LB includes a ER26500 plus super capacitor. If user can't find this pack locally, they can find ER26500 or equivalence, which will also work in most case. The SPC can enlarge the battery life for high frequency use (update period below 5 minutes)
2.2	1153
	1154
37.3	1155	= 5. Remote Configure device =
2.2	1156
37.3	1157	== 5.1 Connect via BLE ==
2.2	1158
	1159
37.3	1160	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	1161
	1162
37.3	1163	== 5.2 AT Command Set ==
2.2	1164
	1165
	1166
37.3	1167	= 6. OTA firmware update =
	1168
	1169
2.2	1170	Please see this link for how to do OTA firmware update.
	1171
	1172	[[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/]]
	1173
	1174
40.2	1175	= 7. FAQ =
2.2	1176
40.2	1177	== 7.1 How to use AT Command to access device? ==
2.2	1178
	1179
40.2	1180	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]]
	1181
	1182
	1183	== 7.2 How to update firmware via UART port? ==
	1184
	1185
	1186	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]]
	1187
	1188
	1189	== 7.3 How to change the LoRa Frequency Bands/Region? ==
	1190
	1191
	1192	You can follow the instructions for [[how to upgrade image>>doc:Main.Firmware Upgrade Instruction for STM32 base products.WebHome]].
	1193	When downloading the images, choose the required image file for download.
	1194
	1195
	1196	= 8. Order Info =
	1197
	1198
41.20	1199	(((
40.7	1200	(% style="color:blue" %)Part Number: SDI-12-LB-XXX
41.20	1201	)))
40.7	1202
41.20	1203	(((
37.4	1204	XXX: The default frequency band
41.20	1205	)))
2.2	1206
41.20	1207	(((
40.7	1208	(% style="color:red" %)AS923(%%): LoRaWAN AS923 band
	1209	(% style="color:red" %)AU915(%%): LoRaWAN AU915 band
	1210	(% style="color:red" %)EU433(%%): LoRaWAN EU433 band
	1211	(% style="color:red" %)EU868(%%): LoRaWAN EU868 band
	1212	(% style="color:red" %)KR920(%%): LoRaWAN KR920 band
	1213	(% style="color:red" %)US915(%%): LoRaWAN US915 band
	1214	(% style="color:red" %)IN865(%%): LoRaWAN IN865 band
	1215	(% style="color:red" %)CN470(%%): LoRaWAN CN470 band
41.20	1216	)))
2.2	1217
	1218
40.2	1219	= 9. Packing Info =
37.3	1220
	1221
40.7	1222	(% style="color:#037691" %)Package Includes:
2.2	1223
37.3	1224	* SDI-12-LB SDI-12 to LoRaWAN Converter x 1
2.2	1225
40.7	1226	(% style="color:#037691" %)Dimension and weight:
2.2	1227
	1228	* Device Size: cm
	1229	* Device Weight: g
	1230	* Package Size / pcs : cm
	1231	* Weight / pcs : g
	1232
44.2	1233
	1234
40.2	1235	= 10. Support =
37.3	1236
	1237
2.2	1238	* 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.
	1239
37.3	1240	* Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[support@dragino.com>>url:http://../../../../../../D:%5C%E5%B8%82%E5%9C%BA%E8%B5%84%E6%96%99%5C%E8%AF%B4%E6%98%8E%E4%B9%A6%5CLoRa%5CLT%E7%B3%BB%E5%88%97%5Csupport@dragino.com]]
2.2	1241
40.8	1242

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

Applications

Navigation