1. Manuals
  2. Brands
  3. Dragino Manuals
  4. Media Converter
  5. SDI-12-LB
  6. User manual

Dragino SDI-12-LB User Manual

Sdi-12 to lorawan converter
Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
 (/xwiki/bin/view/Main/)  / Home (/xwiki/bin/view/Main/) 
/ User Manual for LoRaWAN End Nodes (/xwiki/bin/view
/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/) 
/ SDI-12-LB -- SDI-12 to LoRaWAN Converter User Manual (/xwiki/bin/view
/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SDI-12-LB%20--%20SDI-
12%20to%20LoRaWAN%20Converter%20User%20Manual/) 
SDI-12-LB -- SDI-12 to LoRaWAN
Converter User Manual
Last modified by Xiaoling (/xwiki/bin/view/XWiki/Xiaoling) on 2023/02/24 09:16

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the SDI-12-LB and is the answer not in the manual?

Questions and answers

Related Manuals for Dragino SDI-12-LB

Summary of Contents for Dragino SDI-12-LB

  • Page 1  (/xwiki/bin/view/Main/)  / Home (/xwiki/bin/view/Main/)  / User Manual for LoRaWAN End Nodes (/xwiki/bin/view /Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/)  / SDI-12-LB -- SDI-12 to LoRaWAN Converter User Manual (/xwiki/bin/view /Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SDI-12-LB%20--%20SDI- 12%20to%20LoRaWAN%20Converter%20User%20Manual/)  SDI-12-LB -- SDI-12 to LoRaWAN Converter User Manual Last modified by Xiaoling (/xwiki/bin/view/XWiki/Xiaoling) on 2023/02/24 09:16...

  • Page 2: Table Of Contents

    Table of Contents： • 1. Introduction ◦ 1.1 What is SDI-12 to LoRaWAN Converter ◦ 1.2 Features ◦ 1.3 Specification ◦ 1.4 Connect to SDI-12 Sensor ◦ 1.5 Sleep mode and working mode ◦ 1.6 Button & LEDs ◦ 1.7 Pin Mapping ◦...
  • Page 3 ◦ 2.6 Examples To Set SDI commands. ▪ 2.6.1 Examples 1 ◦ 2.7 Frequency Plans ◦ 2.8 Firmware Change Log • 3. Configure SDI-12-LB via AT Command or LoRaWAN Downlink ◦ 3.1 Set Transmit Interval Time ◦ 3.2 Set Interrupt Mode ◦ 3.3 Set the output time ◦...

  • Page 4: Introduction

    SDI-12-LB is powered by 8500mAh Li-SOCI2 battery, it is designed for long term use up to 5 years. Each SDI-12-LB is pre-load with a set of unique keys for LoRaWAN registrations, register these keys to...

  • Page 5: Features

    1.2 Features • LoRaWAN 1.0.3 Class A • Ultra-low power consumption • Controllable 3.3v, 5v and 12v output to power external sensor • SDI-12 Protocol to connect to SDI-12 Sensor • Monitor Battery Level • Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865 • Support Bluetooth v5.1 and LoRaWAN remote configure. •...

  • Page 6: Connect To Sdi-12 Sensor

    • Li/SOCI2 un-chargeable battery • Capacity: 8500mAh • Self-Discharge: <1% / Year @ 25°C • Max continuously current: 130mA • Max boost current: 2A, 1 second Power Consumption • Sleep Mode: 5uA @ 3.3v • LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm 1.4 Connect to SDI-12 Sensor...

  • Page 7: Sleep Mode And Working Mode

    1.5 Sleep mode and working mode Deep Sleep Mode: Sensor doesn't have any LoRaWAN activate. This mode is used for storage and shipping to save battery life. Working Mode: In this mode, Sensor will work as LoRaWAN Sensor to Join LoRaWAN network and send out sensor data to server.

  • Page 8: Pin Mapping

    BLE to configure device, no matter if device join or not join LoRaWAN network. Fast press ACT 5 times. Deactivate Red led will solid on for 5 Device seconds. Means SDI-12-LB is in Deep Sleep Mode. 1.7 Pin Mapping...

  • Page 9: Ble Connection

    1.8 BLE connection SDI-12-LB support BLE remote configure. 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: • Press button to send an uplink •...

  • Page 10: Configure Sdi-12 To Connect To Lorawan Network

    2.1 How it works The SDI-12-LB is configured as 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.
  • Page 11 Step 1: Create a device in TTN with the OTAA keys from SDI-12-LB. Each SDI-12-LB is shipped with a sticker with the default device EUI as below: You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:...
  • Page 12 Register the device Add APP EUI and DEV EUI...
  • Page 13 Add APP EUI in the application...
  • Page 14 Add APP KEY...
  • Page 15 Green led will fast blink 5 times, device will enter OTA mode for 3 seconds. And then start to JOIN LoRaWAN network. Green led will solidly turn on for 5 seconds after joined in network. 2.3 SDI-12 Related Commands User need to configure SDI-12-LB to communicate with SDI-12 sensors otherwise the uplink payload will only include a few bytes.
  • Page 16 AT Command or LoRaWAN downlink command. 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.
  • Page 17 aM!,aMC!, aM1!- aM9!, aMC1!- aMC9! aM! : Start Non-Concurrent Measurement aMC! : Start Non-Concurrent Measurement – Request CRC aM1!- aM9! : Additional Measurements aMC1!- aMC9! : Additional Measurements – Request CRC • AT Command : AT+ADDRM=0,1,0,1  • LoRaWAN Downlink(prefix 0xAA01): 0xAA 01 30 01 00 01 Downlink：AA 01 aa bb cc dd aa: SDI-12 sensor address.
  • Page 18 aC!, aCC!,  aC1!- aC9!,  aCC1!- aCC9!  aC! : Start Concurrent Measurement aCC! : Start Concurrent Measurement – Request CRC aC1!- aC9! : Start Additional Concurrent Measurements aCC1!- aCC9! : Start Additional Concurrent Measurements – Request CRC • AT Command : AT+ADDRC=0,1,0,1   •...
  • Page 19 The following is the display information on the serial port and the server. aR0!- aR9!,  aRC0!- aRC9! Start Continuous Measurement Start Continuous Measurement – Request CRC • AT Command : AT+ADDRR=0,1,0,1   • LoRaWAN Downlink (0xAA 03): 0xAA 03 30 01 00 01 Downlink: AA 03 aa bb cc dd ...
  • Page 20 2.3.2 Advance SDI-12 Debug command This command can be used to debug all SDI-12 command. LoRaWAN Downlink: A8 aa xx xx xx xx bb cc aa : total SDI-12 command length xx : SDI-12 command bb : Delay to wait for return cc : 0: don't uplink return to LoRaWAN, 1: Uplink return to LoRaWAN on FPORT=100 Example: ...
  • Page 21 2.3.3 Convert ASCII to String This command is used to convert between ASCII and String format. AT+CONVFORM ( Max length: 80 bytes) Example: 1) AT+CONVFORM=0, string Convert String from String to ASCII...
  • Page 22 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. ...
  • Page 23 • LL :   The length of AT+COMMAND or AT+DATACUT command • XX XX XX XX : AT+COMMAND or AT+DATACUT command • 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.  ...
  • Page 24 The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them. • AT Command: AT+CMDEAR=mm,nn  mm: start position of erase ,nn: stop position of erase Etc. AT+CMDEAR=1,10 means erase AT+COMMAND1/AT+DATACUT1 to AT+COMMAND10/AT+DATACUT10 •  Downlink Payload: 0x09 aa bb  same as AT+CMDEAR=aa,bb command combination Below shows a screen shot how the results combines together to a uplink payload.
  • Page 25 If AT+ALLDATAMOD=1, 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. Compose Uplink AT+DATAUP=0 Compose the uplink payload with value returns in sequence and send with A SIGNLE UPLINK.
  • Page 26 DR value. 2.4 Uplink Payload 2.4.1 Device Payload, FPORT=5 Include device configure status. Once SDI-12-LB Joined the network, it will uplink this message to the server. Users can also use the downlink command(0x26 01) to ask SDI-12-LB to resend this uplink.
  • Page 27 Example parse in TTNv3 Sensor Model: For SDI-12-LB, this value is 0x17 Firmware Version: 0x0100, Means: v1.0.0 version Frequency Band: *0x01: EU868 *0x02: US915 *0x03: IN865 *0x04: AU915 *0x05: KZ865 *0x06: RU864 *0x07: AS923 *0x08: AS923-1 *0x09: AS923-2 *0x0a: AS923-3...
  • Page 28 LoRaWAN server. 2.4.3 Battery Info Check the battery voltage for SDI-12-LB. Ex1: 0x0B45 = 2885mV Ex2: 0x0B49 = 2889mV 2.4.4 Interrupt Pin This data field shows if this packet is generated by Interrupt Pin or not. Click here for the hardware and...
  • Page 29 User need to write the decoder themselves for their case. SDI-12-LB TTN Payload Decoder: https://github.com/dragino/dragino-end-node-decoder (https://github.com/dragino/dragino-end-node-decoder) 2.5 Uplink Interval 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: http://wiki.dragino.com/xwiki/bin/view /Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command...
  • Page 30 2.6 Examples To Set SDI commands. 2.6.1 Examples 1 COM port and SDI-12 sensor communication converted to SDI-12-LB and SDI-12 sensor communication. 1) The AT+COMMANDx command is applied to the red arrow part, and sends the SDI12 command to the SDI12 sensor: a.
  • Page 31 Partial cut, the cut sensor address and the first two parameters：AT+DATACUTx=25,2,1~12, cut out the character field ” 4+30.8+22.84”. 2.7 Frequency Plans 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. http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/...
  • Page 32 These commands are to configure: • General system settings like: uplink interval. • LoRaWAN protocol & radio related command. They are same for all Dragino Device which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki: http://wiki.dragino.com/xwiki/bin/view /Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/ (http://wiki.dragino.com/xwiki/bin/view...
  • Page 33 AT+TDC=? Show current 30000 transmit Interval the interval is 30000ms = 30s AT+TDC=60000 Set Transmit Interval Set transmit interval to 60000ms = 60 seconds Downlink Command: 0x01 Format: Command Code (0x01) followed by 3 bytes time value. If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
  • Page 34 • Example 2: Downlink Payload: 06000003       //  Set the interrupt mode to rising edge trigger 3.3 Set the output time Feature, Control the output 3V3 , 5V or 12V. AT Command: AT+3V3T Command Example Function Response AT+3V3T=? Show 3V3 open time. AT+3V3T=0 Normally open 3V3 power supply.
  • Page 35 AT+12VT=0 Normally closed 12V power supply. AT+12VT=500 Close after a delay of 500 milliseconds. Downlink Command: 0x07 Format: Command Code (0x07) followed by 3 bytes. The first byte is which power, the second and third bytes are the time to turn on. •...
  • Page 36 Command Example Function Response AT+DATAUP =? Show current splicing payload for uplink mode AT+DATAUP =0 Set splicing payload for uplink mode is AT+DATAUP =1 Set splicing payload for uplink mode is 1 , and the each splice uplink is sent sequentially.
  • Page 37 4. Battery & how to replace 4.1 Battery Type 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.
  • Page 38 4.3 Power Consumption Analyze 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.
  • Page 39 4.3.2 Replace the battery 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...
  • Page 40 You can follow the instructions for how to upgrade image (/xwiki/bin/view /Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/). When downloading the images, choose the required image file for download. 8. Order Info Part Number: SDI-12-LB-XXX XXX: The default frequency band  AS923: LoRaWAN AS923 band AU915: LoRaWAN AU915 band...
  • Page 41 However, your questions will be answered as soon as possible in the before-mentioned schedule. • 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 (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)

Table of Contents