Dragino LoRa User Manual

www.dragino.com
Description
Date
Release
2018-Sep-26
Add 8 channels mode for US915, AU915, CN470
2018-Oct-24
Add current measure photo
2018-Nov-2
Add Cayenne connection guide
2018-Nov-24
Add downlink trouble shooting, Add Hardware Source code link.
Add change log for v1.1. (related to Downlink, Payload part)
Add TTN payload format
2019-Jan-24
Add more info for 8 channel mode descript and troubleshooting while use
US915 and AU915
2019-Feb-21
Modify trouble shooting for upload via FlashLoader,
2019-Apr-26
LT Series LoRa IO Controller User Manual
Document Version: 1.4.2
Image Version: v1.4
LT Series LoRa IO controller User Manual 1 / 42
www.dragino.com
Correct the TTN payload decoder
Add Counting Mode
Improve description of single channel gateway compatible
Adjust Downlink instruction while using with LG01-N and LG02
2019-5-7
Add new feature on downlink, able to control the relay base on timing
2019-Aug-9
Add Power ON info
2019-Aug-20
Add LT-22222-L description and support.
Add Decode in LoRaserver
2020-Mar-7
Modify Downlink trouble shooting, Add MyDevice Photo
2020-Mar-28
Add Upgrade info for v1.4.2 firmware version
2020-Mar-30
LT Series LoRa IO controller User Manual 2 / 42
www.dragino.com
1. Introduction .............................................................................................................................. 5
1.1 What is LT Series I/O Controller .................................................................................................. 5
1.2 Specifications .............................................................................................................................. 6
1.3 Features ...................................................................................................................................... 7
1.4 Applications ................................................................................................................................ 7
1.5 Hardware Variants ..................................................................................................................... 8
1.6 Firmware Change log ................................................................................................................. 8
2. Power ON Device .................................................................................................................... 10
3. Operation Mode ..................................................................................................................... 11
3.1 How it works? ........................................................................................................................... 11
3.2 Example to join LoRaWAN network .......................................................................................... 11
3.3 Uplink Payload .......................................................................................................................... 13
There are five working modes on LT for different type application: ............................................. 13
3.3.1 AT+MOD=1, 2ACI+2AVI ................................................................................................ 13
3.3.2 AT+MOD=2, (Double DI Counting) .................................................................................. 14
3.3.3 AT+MOD=3, Single DI Counting + 2 x ACI ........................................................................ 15
3.3.4 AT+MOD=4, Single DI Counting + 1 x Voltage Counting .................................................. 16
3.3.5 AT+MOD=5, Single DI Counting + 2 x AVI + 1 x ACI ......................................................... 16
3.3.6 Payload Decoder ............................................................................................................. 17
3.4 Downlink Payload ..................................................................................................................... 18
3.5 Integrate with Mydevice........................................................................................................... 22
3.6 Interface Detail ......................................................................................................................... 25
3.6.1 Digital Input Port: DI1/DI2 /DI3 ( For LT-33222-L, low active ) ....................................... 25
3.6.2 Digital Input Port: DI1/DI2 ( For LT-22222-L) .................................................................. 26
3.6.3 Digital Output Port: DO1/DO2 /DO3 .............................................................................. 27
3.6.4 Analog Input Interface .................................................................................................... 27
3.6.5 Relay Output ................................................................................................................... 27
3.7 LEDs Indicators ......................................................................................................................... 29
4. Use AT Command .................................................................................................................... 30
4.1 Access AT Command ................................................................................................................. 30
4.2 Common AT Command Sequence ............................................................................................. 32
4.2.1 Multi-channel ABP mode (Use with SX1301/LG308) ...................................................... 32
4.2.2 Single-channel ABP mode (Use with LG01/LG02) ........................................................... 32
LT Series LoRa IO controller User Manual 3 / 42
www.dragino.com
4.2.3 Change to Class A ............................................................................................................ 33
5. FAQ ......................................................................................................................................... 34
5.1 How to upgrade the image? ..................................................................................................... 34
5.2 How to change the LoRa Frequency Bands/Region? ................................................................ 36
5.3 How to set up LT to work in 8 channel mode in US915, AU915, CN470 bands? ....................... 36
5.4 How to set up LT to work with Single Channel Gateway such as LG01/LG02? ......................... 38
6. Trouble Shooting ..................................................................................................................... 40
6.1 Downlink doesn’t work, how to solve it? .................................................................................. 40
6.2 Have trouble to upload image. ................................................................................................. 40
6.3 Why I can’t join TTN in US915 /AU915 bands? ......................................................................... 40
7. Order Info ............................................................................................................................... 40
8. Packing Info ............................................................................................................................ 40
9. Support ................................................................................................................................... 41
10. Reference ................................................................................................................................ 42
LT Series LoRa IO controller User Manual 4 / 42
www.dragino.com
1. Introduction
1.1 What is LT Series I/O Controller
The Dragino LT series I/O Modules are Long Range LoRaWAN I/O Controller. It contains different
I/O Interfaces such as: analog current Input, analog voltage input, relay output, digital input and
digital output etc. The LT I/O Modules are designed to simplify the installation of I/O monitoring.
The LT I/O Controllers allows the user to send data and reach extremely long ranges. It provides
ultra-long range spread spectrum communication and high interference immunity whilst
minimizing current consumption. It targets professional wireless sensor network applications
such as irrigation systems, smart metering, smart cities, smartphone detection, building
automation, and so on.
The LT I/O Controllers is aiming to provide a simple plug and play, low cost installation by using
LoRaWAN wireless technology.
The use environment includes:
1) If user’s area has LoRaWAN service coverage, they can just install the I/O controller and
configure it to connect the LoRaWAN provider via wireless.
2) User can set up a LoRaWAN gateway locally and configure the controller to connect to the
gateway via wireless.
LT Series LoRa IO controller User Manual 5 / 42
www.dragino.com
1.2 Specifications
Hardware System:
STM32L072CZT6 MCU
SX1276/78 Wireless Chip
Power Consumption:
Idle: 4mA@12v
20dB Transmit: 34mA@12v
Interface for Model: LT33222-L:
3 x Digital Input ( Detect Low signal , Max, 6V)
3 x Digital Output (NPN output. Max pull up voltage 36V,450mA)
2 x Relay Output (5A@250VAC / 30VDC)
2 x 0~20mA Analog Input (res:0.01mA)
2 x 0~30V Analog Input (res:0.01v)
Power Input 7~ 24V DC.
Interface for Model: LT22222-L:
2 x Digital dual direction Input (Detect High/Low signal, Max: 50v, or 220v with
optional external resistor)
2 x Digital Output (NPN output. Max pull up voltage 36V,450mA)
2 x Relay Output (5A@250VAC / 30VDC)
2 x 0~20mA Analog Input (res:0.01mA)
2 x 0~30V Analog Input (res:0.01v)
Power Input 7~ 24V DC.
LoRa Spec:
Frequency Range:
Band 1 (HF): 862 ~ 1020 Mhz
Band 2 (LF): 410 ~ 528 Mhz
168 dB maximum link budget.
+20 dBm - 100 mW constant RF output vs.
+14 dBm high efficiency PA.
Programmable bit rate up to 300 kbps.
High sensitivity: down to -148 dBm.
Bullet-proof front end: IIP3 = -12.5 dBm.
Excellent blocking immunity.
Low RX current of 10.3 mA, 200 nA register retention.
Fully integrated synthesizer with a resolution of 61 Hz.
FSK, GFSK, MSK, GMSK, LoRaTM and OOK modulation.
Built-in bit synchronizer for clock recovery.
Preamble detection.
LT Series LoRa IO controller User Manual 6 / 42
www.dragino.com
127 dB Dynamic Range RSSI.
Automatic RF Sense and CAD with ultra-fast AFC.
Packet engine up to 256 bytes with CRC.
1.3 Features
LoRaWAN Class A & Class C protocol
Optional Customized LoRa Protocol
Frequency Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/RU864/IN865
AT Commands to change parameters
Remote configure parameters via LoRa Downlink
Firmware upgradable via program port
Counting
1.4 Applications
Smart Buildings & Home Automation
Logistics and Supply Chain Management
Smart Metering
Smart Agriculture
Smart Cities
Smart Factory
LT Series LoRa IO controller User Manual 7 / 42
www.dragino.com
Model
Photo
Description
LT33222-L
3 x Digital Input
3 x Digital Output
2 x Relay Output (5A@250VAC / 30VDC)
2 x 0~20mA Analog Input (res:0.01mA)
2 x 0~30V Analog Input (res:0.01v)
1 x Counting Port
Model
Photo
Description
LT22222-L
2 x Digital Input (Bi-direction)
2 x Digital Output
2 x Relay Output (5A@250VAC / 30VDC)
2 x 0~20mA Analog Input (res:0.01mA)
2 x 0~30V Analog Input (res:0.01v)
1 x Counting Port
1.5 Hardware Variants
1.6 Firmware Change log
LT Image files
Image v1.4.2
Update LoRaWAN stack to DR-LWS-003
(http://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/DR-LWS/&file=chang
elog )
Fix DO / Relay state lose after reboot. Now After reboot, the DO/Relay will keep the same
state as before.
Image v1.4.1
Fix watchdog bug. This bug cause some device will un-stop reboot with the v1.4 firmware.
Image v1.4
Add hardware support for LT-22222-L
Update LoRaWAN stack to DR-LWS-002
Change to Class C by default
Add Software Watchdog
Re-construct Payload format, use the new decoder for v1.4.
Add Downlink command to pre-set count number
First bug for endless loop when TDC is too small
LT Series LoRa IO controller User Manual 8 / 42
www.dragino.com
Image v1.3
Add clear counting feature via Downlink
Improve Downlink type code 0x03 to support control RO1 or RO2 separately.
Add Downlink type code 0x05
Add Downlink type code 0x07
Image v1.2
Add counting feature
Image v1.1
Voltage and Current reserve three decimal, previous is two
Can use any Fport for downlink
Add AT+CFG to print all settings
Fix current and voltage glith bug
LT Series LoRa IO controller User Manual 9 / 42
www.dragino.com
2. Power ON Device
The LT controller can be powered by 7 ~ 24V DC power source. Connect VIN to Power Input V+
and GND to power input V- to power the LT controller.
PWR will on when device is properly powered.
LT Series LoRa IO controller User Manual 10 / 42
www.dragino.com
3. Operation Mode
3.1 How it works?
The LT is configured as LoRaWAN OTAA Class C mode by default. It has OTAA keys to join network.
To connect a local LoRaWAN network, user just need to input the OTAA keys in the network
server and power on the LT. It will auto join the network via OTAA. For LT-22222-L, the LED will
show the Join status: After power on TX LED will fast blink 5 times, LT-22222-L will enter working
mode and start to JOIN LoRaWAN network. TX LED will be on for 5 seconds after joined in
network. When there is message from server, the RX LED will be on for 1 second.
In case user can’t set the OTAA keys in the network server and has to use the existing keys from
server. User can use AT Command to set the keys in the devices.
3.2 Example to join LoRaWAN network
This chapter shows an example for how to join the TTN LoRaWAN Network. Below is the network
structure, we use our LG308 as LoRaWAN gateway here.
The LG308 is already set to connect to TTN network . So what we need to do now is only
configure register this device to TTN:
Step 1: Create a device in TTN with the OTAA keys from LT IO controller.
Each LT is shipped with a sticker with the default device EUI as below:
LT Series LoRa IO controller User Manual 11 / 42
www.dragino.com
Input these keys in the LoRaWAN Server portal. Below is TTN screen shot:
Add APP EUI in the application.
Add APP KEY and DEV EUI
Step 2: Power on LT and it will auto join to the TTN network. After join success, it will start to
upload message to TTN and user can see in the panel.
LT Series LoRa IO controller User Manual 12 / 42
www.dragino.com
Size(bytes)
2 2 2 2 1 1 1
Value
AVI1
voltage
AVI2
voltage
ACI1
Current
ACI2
Current
DIDORO*
Reserve
MOD
bit7
bit6
bit5
bit4
bit3
bit2
bit1
bit0
RO1
RO2
DI3
DI2
DI1
DO3
DO2
DO1
3.3 Uplink Payload
There are five working modes on LT for different type application:
MOD1: (default setting): 2 x ACI + 2AVI + DI + DO + RO
MOD2: Double DI Counting + DO + RO
MOD3: Single DI Counting + 2 x ACI + DO + RO
MOD4: Single DI Counting + 1 x Voltage Counting + DO + RO
MOD5: Single DI Counting + 2 x AVI + 1 x ACI + DO + RO
3.3.1 AT+MOD=1, 2ACI+2AVI
The uplink payload includes totally 9 bytes. Uplink packets use FPORT=2 and every 10 minutes
send one uplink by default.
DIDORO is a combination for RO1, RO2, DI3, DI2, DI1, DO3, DO2 and DO1. Totally 1bytes as below
RO is for relay. ROx=1 : closeROx=0 always open. DI is for digital input. DIx=1: high or float, DIx=0: low.
DO is for reverse digital output. DOx=1: output low, DOx=0: high or float.
Note: DI3 and DO3 bit are not valid for LT-22222-L
For example if payload is: 04 AB 04 AC 13 10 13 00 AA FF 01 The value for the interface is: AVI1 channel voltage is 0x04AB/1000=1195DEC/1000=1.195V AVI2 channel voltage is 0x04AC/1000=1.196V ACI1 channel current is 0x1310/1000=4.880mA ACI2 channel current is 0x1300/1000=4.864mA The last byte 0xAA= 10101010(B) means 
[1] RO1 relay channel is close and the RO1 LED is ON.
[0] RO2 relay channel is open and RO2 LED is OFF;
LT33222-L:
[1] DI3 channel is high input and DI3 LED is OFF;
[0] DI2 channel is low input;
[1] DI1 channel is high input and DI1 LED is OFF;
LT22222-L:
[1] DI2 channel is high input and DI2 LED is ON;
[0] DI1 channel is low input;
LT Series LoRa IO controller User Manual 13 / 42
Loading...
+ 29 hidden pages