Changes for page LT-22222-L -- LoRa I/O Controller User Manual

Last modified by Saxer Lin on 2025/04/15 17:24

From version < 200.1 >

edited by Dilisi S
on 2024/11/18 04:06

To version < 206.1 >

edited by Dilisi S
on 2024/11/20 05:04

Change comment: Nov 19 Edits - part 2

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)
Attachments (0 modified, 2 added, 0 removed)
- dragino-ttn-te.jpg
- lorawan-nw.jpg

Details

Page properties

Content

@@ -27,7 +27,7 @@
  **This manual is also applicable to the LT-33222-L.**
  {{/info}}
--The Dragino (% style="color:blue" %)**LT-22222-L I/O Controller**(%%) is an advanced LoRaWAN device designed to provide seamless wireless long-range connectivity with various I/O options, including analog current and voltage inputs, digital inputs and outputs, and relay outputs.
++The Dragino (% style="color:blue" %)**LT-22222-L I/O Controller**(%%) is an advanced LoRaWAN end device designed to provide seamless wireless long-range connectivity with various I/O options, including analog current and voltage inputs, digital inputs and outputs, and relay outputs.
  The LT-22222-L I/O Controller simplifies and enhances I/O monitoring and controlling. It is ideal for professional applications in wireless sensor networks, including irrigation systems, smart metering, smart cities, building automation, and more. These controllers are designed for easy, cost-effective deployment using LoRa wireless technology.
  )))
@@ -40,7 +40,7 @@
  (((
  You can connect the LT-22222-L I/O Controller to a LoRaWAN network service provider in several ways:
--* If there is public LoRaWAN network coverage in the area where you plan to install the device (e.g., The Things Network), you can select a network and register the LT-22222-L I/O controller with it.
++* If there is public LoRaWAN network coverage in the area where you plan to install the device (e.g., The Things Stack Community Network), you can select a network and register the LT-22222-L I/O controller with it.
  * If there is no public LoRaWAN coverage in your area, you can set up a LoRaWAN gateway, or multiple gateways, and connect them to a LoRaWAN network server to create adequate coverage. Then, register the LT-22222-L I/O controller with this network.
  * Setup your own private LoRaWAN network.
@@ -50,11 +50,14 @@
  )))
  (((
--[[image:1653295757274-912.png]]
--
++
++The network diagram below shows how the LT-22222-L is connected to a typical LoRaWAN network.
  )))
++(% class="wikigeneratedid" %)
++[[image:lorawan-nw.jpg||height="354" width="900"]]
++
  == 1.2 Specifications ==
  (% style="color:#037691" %)**Hardware System:**
@@ -115,6 +115,21 @@
  * Smart cities
  * Smart factory
++== 1.5 Hardware Variants ==
++
++(% style="width:524px" %)
++|(% style="width:94px" %)**Model**|(% style="width:98px" %)**Photo**|(% style="width:329px" %)**Description**
++|(% style="width:94px" %)**LT33222-L**|(% style="width:98px" %)(((
++
++)))|(% style="width:329px" %)(((
++* 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
++)))
++
  == 2. Assembling the device ==
  == 2.1 Connecting the antenna ==
@@ -155,14 +155,12 @@
  |(% style="width:296px" %)DO2|(% style="width:334px" %)Digital Output 2
  |(% style="width:296px" %)DO1|(% style="width:334px" %)Digital Output 1
--== 2.3 Powering the device ==
++== 2.3 Connecting LT-22222-L to a Power Source ==
--The LT-22222-L I/O Controller can be powered by a **7–24V DC** power source. Connect your power supply’s positive wire to the VIN and the negative wire to the GND screw terminals. The power indicator **(PWR) LED** will turn on when the device is properly powered.
++The LT-22222-L I/O Controller can be powered by a **7–24V DC** power source. Connect your power supply’s **positive wire** to the **VIN** and the **negative wire** to the **GND** screw terminals. The power indicator **(PWR) LED** will turn on when the device is properly powered.
--Once powered, the **TX LED** will **fast-blink 5 times** which means the LT-22222-L will enter the **work mode** and start to **join** The Things Stack. The **TX LED** will be on for **5 seconds** after joining the network. When there is a **downlink** message from the server, the **RX LED** will be on for **1 second**. When the device is sending an uplink message to the server, the **TX LED** will be on for **1 second**. See also LED status.
--
  {{warning}}
--We recommend that you power on the LT-22222-L after configuring its registration information with a LoRaWAN network server. Otherwise, the device will continuously send join-request messages to attempt to join a LoRaWAN network but will fail.
++**We recommend that you power on the LT-22222-L after configuring its registration information with a LoRaWAN network server. Otherwise, the device will continuously send join-request messages to attempt to join a LoRaWAN network but will fail.**
  {{/warning}}
@@ -169,37 +169,49 @@
  [[image:1653297104069-180.png]]
--= 3. Registering with a LoRaWAN Network Server =
++= 3. Registering LT-22222-L with a LoRaWAN Network Server =
--By default, the LT-22222-L is configured to operate in LoRaWAN Class C mode. It supports OTAA (Over-the-Air Activation), the most secure method for activating a device with a LoRaWAN network server. The LT-22222-L comes with device registration information that allows you to register it with a LoRaWAN network, enabling the device to perform OTAA activation with the network server upon initial power-up and after any subsequent reboots.
++The LT-22222-L supports both OTAA (Over-the-Air Activation) and ABP (Activation By Personalization) methods to activate with a LoRaWAN Network Server. However, OTAA is the most secure method for activating a device with a LoRaWAN Network Server. OTAA regenerates session keys upon initial registration and regenerates new session keys after any subsequent reboots. By default, the LT-22222-L is configured to operate in LoRaWAN Class C mode.
--After powering on, the **TX LED** will **fast-blink 5 times** which means the LT-22222-L will enter the **work mode** and start to **join** the LoRaWAN network. The **TX LED** will be on for **5 seconds** after joining the network. When there is a **downlink** message from the server, the **RX LED** will be on for **1 second**. When the device is sending an uplink message to the server, the **TX LED** will be on for **1 second**. See also LED status.
--In case you can't set the root key and other identifiers in the network server and must use them from the server, you can use [[AT Commands>>||anchor="H4.UseATCommand"]] to configure them on the device.
--
--The network diagram below shows how the LT-22222-L is connected to a typical LoRaWAN network.
--
--[[image:image-20220523172350-1.png||height="266" width="864"]]
--
  === 3.2.1 Prerequisites ===
--Make sure you have the device registration information such as DevEUI, AppEUI, and AppKey with you. The registration information can be found on a sticker that can be found inside the package. Please keep the **registration information** sticker in a safe place for future reference.
++The LT-22222-L comes with device registration information such as DevEUI, AppEUI, and AppKey that allows you to register it with a LoRaWAN network. These registration information can be found on a sticker that can be found inside the package. Please keep the **registration information** sticker in a safe place for future reference.
  [[image:image-20230425173427-2.png||height="246" width="530"]]
++{{info}}
++In case you can't set the root key and other identifiers in the network server and must use them from the server, you can use [[AT Commands>>||anchor="H4.UseATCommand"]] to configure them on the device.
++{{/info}}
++
  The following subsections explain how to register the LT-22222-L with different LoRaWAN network server providers.
--=== 3.2.2 The Things Stack Sandbox (TTSS) ===
++=== 3.2.2 The Things Stack ===
++This section guides you through how to register your LT-22222-L with The Things Stack Sandbox.
++
++{{info}}
  The Things Stack Sandbox was formally called The Things Stack Community Edition.
++{{/info}}
--* Log in to your [[The Things Stack Sandbox>>https://eu1.cloud.thethings.network]] account.
--* Create an application with The Things Stack if you do not have one yet.
--* Go to your application page and click on the **End devices** in the left menu.
++
++The network diagram below illustrates the connection between the LT-22222-L and The Things Stack, as well as how the data can be integrated with the ThingsEye IoT platform.
++
++[[image:dragino-ttn-te.jpg]]
++
++
++
++==== 3.2.2.1 Setting up ====
++
++* Sign up for a free account with [[The Things Stack Sandbox>>https://eu1.cloud.thethings.network]] if you do not have one yet.
++* Log in to your The Things Stack Sandbox account.
++* Create an **application** with The Things Stack if you do not have one yet (E.g., dragino-docs).
++* Go to your application's page and click on the **End devices** in the left menu.
  * On the End devices page, click on **+ Register end device**. Two registration options are available:
--==== 3.2.2.1 Using the LoRaWAN Device Repository ====
++==== 3.2.2.2 Using the LoRaWAN Device Repository ====
++
  * On the **Register end device** page:
  ** Select the option **Select the end device in the LoRaWAN Device Repository **under **Input method**.
  ** Select the **End device brand**, **Model**, **Hardware version**, **Firmware version**, and **Profile (Region)** from the respective dropdown lists.
@@ -224,7 +224,7 @@
  ====   ====
--==== 3.2.2.2 Adding device manually ====
++==== 3.2.2.3 Adding device manually ====
  * On the **Register end device** page:
  ** Select the option **Enter end device specifies manually** under **Input method**.
@@ -239,7 +239,7 @@
  * Register end device page continued...
--** Enter the **AppEUI** in the **JoinEUI** field and click the **Confirm** button. If The Things Stack accepts the JoinEUI you provided, it will display the message 'This end device can be registered on the network'
++** Enter the **AppEUI** in the **JoinEUI** field and click the **Confirm** button. If The Things Stack accepts the JoinEUI you provided, it will display the message '//**This end device can be registered on the network**//'
  ** In the **DevEUI** field, enter the **DevEUI**.
  ** In the **AppKey** field, enter the **AppKey**.
  ** In the **End device ID** field, enter a unique name for your LT-22222-N within this application.
@@ -255,18 +255,21 @@
  [[image:lt-22222-device-overview.png||height="625" width="1000"]]
--==== 3.2.2.3 Joining ====
++==== 3.2.2.4 Joining ====
  On the Device overview page, click on **Live data** tab. The Live data panel for your device will display.
--Now power on your LT-22222-L. It will begin joining The Things Stack. In the **Live data** panel, you can see the **join-request** and **join-accept** messages exchanged between the device and the network server. Once successfully joined, the device will send its first **uplink data message** to the application it belongs to (in this example, **dragino-docs**).
++Now power on your LT-22222-L. The **TX LED** will **fast-blink 5 times** which means the LT-22222-L will enter the **work mode** and start to **join** The Things Stack network server. The **TX LED** will be on for **5 seconds** after joining the network. In the **Live data** panel, you can see the **join-request** and **join-accept** messages exchanged between the device and the network server.
  [[image:lt-22222-join-network.png||height="625" width="1000"]]
--By default, you will receive an uplink data message from the device every 10 minutes.
++==== 3.2.2.5 Uplinks ====
++
++After successfully joining, the device will send its first **uplink data message** to the application it belongs to (in this example, **dragino-docs**). When the LT-22222-L sends an uplink message to the server, the **TX LED** turns on for **1 second**. By default, you will receive an uplink data message from the device every 10 minutes.
++
  Click on one of a **Forward uplink data messages **to see its payload content. The payload content is encapsulated within the decode_payload {} JSON object.
  [[image:lt-22222-ul-payload-decoded.png]]
@@ -281,6 +281,11 @@
  [[image:lt-22222-ul-payload-fmt.png||height="686" width="1000"]]
++==== 3.2.2.6 Downlinks ====
++
++When the LT-22222-L receives a downlink message from the server, the **RX LED** turns on for **1 second**.
++
++
  == 3.3 Working Modes and Uplink Payload formats ==
@@ -556,13 +556,13 @@
  )))
  (((
--Other AT Commands for counting are similar to the [[MOD2 Counting Command>>||anchor="H3.3.2AT2BMOD3D22C28DoubleDICounting29"]]s.
++AT Commands for counting are similar to the [[MOD2 Counting Command>>||anchor="H3.3.2AT2BMOD3D22C28DoubleDICounting29"]]s.
  )))
  (((
  **In addition to that,  below are the commands for AVI1 Counting:**
--(% style="color:blue" %)**AT+SETCNT=3,60 **(%%)**(Sets AVI Count to 60)**
++(% style="color:blue" %)**AT+SETCNT=3,60 **(%%)**(Sets AVI1 Count to 60)**
  (% style="color:blue" %)**AT+VOLMAX=20000 **(%%)**(If AVI1 voltage higher than VOLMAX (20000mV =20v), counter increase 1)**
@@ -1133,7 +1133,6 @@
  )))
  |(% style="width:96px" %)**Example**|(% style="width:402px" %)09 02 **00 00 64**
--(% class="wikigeneratedid" %)
  ====   ====
  ==== 3.4.2.9 Trigger – Set AC (current) as a trigger ====
@@ -1210,7 +1210,6 @@
  )))
  |(% style="width:104px" %)**Note**|(% style="width:387px" %)See also, [[trigger mode>>||anchor="H3.3.6AT2BADDMOD3D6.28TriggerMode2COptional29"]]
--
  (% style="color:#037691" %)**Downlink Payload**
  (% border="2" style="width:500px" %)
@@ -1233,7 +1233,6 @@
  )))
  |(% style="width:104px" %)**Note**|(% style="width:394px" %)See also, [[trigger mode>>||anchor="H3.3.6AT2BADDMOD3D6.28TriggerMode2COptional29"]]
--
  ==== 3.4.2.11 Trigger – Set minimum interval ====
  Sets the AV and AC trigger minimum interval. The device won't respond to a second trigger within this set time after the first trigger.
@@ -1269,7 +1269,6 @@
  )))
  |(% style="width:112px" %)Note|(% style="width:386px" %)(% style="color:red" %)**The time must be greater than 5 minutes.**
--
  ==== 3.4.2.12 DO ~-~- Control Digital Output DO1/DO2/DO3 ====
  Controls the digital outputs DO1, DO2, and DO3
@@ -1320,7 +1320,6 @@
  )))
  )))
--(% class="wikigeneratedid" %)
  ====   ====
  ==== 3.4.2.13 DO ~-~- Control Digital Output DO1/DO2/DO3 with time control ====
@@ -1512,10 +1512,70 @@
  (% style="color:blue" %)**0xA5 aa bb cc   ** (%%)~/~/ Same as AT+VOLMAX=(aa bb),cc
++(% style="color:#037691" %)**AT Command**
++(% border="2" style="width:500px" %)
++|(% style="width:137px" %)**Command**|(% style="width:361px" %)AT+VOLMAX=<voltage><logic>
++|(% style="width:137px" %)**Response**|(% style="width:361px" %)
++|(% style="width:137px" %)**Parameters**|(% style="width:361px" %)(((
++**voltage** : voltage threshold in mV
++
++**logic**:
++
++0 : lower than
++
++1: higher than
++
++if you leave logic parameter blank, it is considered 0
++)))
++|(% style="width:137px" %)**Examples**|(% style="width:361px" %)(((
++AT+VOLMAX=20000
++
++If AVI1 voltage higher than VOLMAX (20000mV =20v), counter increase 1
++
++AT+VOLMAX=20000,0
++
++If AVI1 voltage lower than VOLMAX (20000mV =20v), counter increase 1
++
++AT+VOLMAX=20000,1
++
++If AVI1 voltage higher than VOLMAX (20000mV =20v), counter increase 1
++)))
++
++(% style="color:#037691" %)**Downlink Payload**
++
++(% border="2" style="width:500px" %)
++|(% style="width:140px" %)**Payload**|(% style="width:358px" %)<prefix><voltage><logic>
++|(% style="width:140px" %)**Parameters**|(% style="width:358px" %)(((
++**prefix** : A5 (hex)
++
++**voltage** : voltage threshold in mV (2 bytes in hex)
++
++**logic**: (1 byte in hexadecimal)
++
++0 : lower than
++
++1: higher than
++
++if you leave logic parameter blank, it is considered 1 (higher than)
++)))
++|(% style="width:140px" %)**Example**|(% style="width:358px" %)(((
++A5 **4E 20**
++
++If AVI1 voltage higher than VOLMAX (20000mV =20v), counter increase 1
++
++A5 **4E 20 00**
++
++If AVI1 voltage lower than VOLMAX (20000mV =20v), counter increase 1
++
++A5 **4E 20 01**
++
++If AVI1 voltage higher than VOLMAX (20000mV =20v), counter increase 1
++)))
++
  ==== 3.4.2.17 Counting ~-~- Pre-configure the Count Number ====
--This feature allows users to pre-configure specific count numbers for various counting parameters such as count1, count2, or AV1 count. Use the AT command to set the desired count number for each configuration.
++This feature allows users to pre-configure specific count numbers for various counting parameters such as Count1, Count2, or AVI1 Count. Use the AT command to set the desired count number for each configuration.
  * (% style="color:#037691" %)**AT Command:**(%%) (% style="color:blue" %)**AT+SETCNT=aa,(bb cc dd ee) **
@@ -1529,7 +1529,51 @@
  (% style="color:blue" %)**0x A8 aa bb cc dd ee     ** (%%)~/~/ same as AT+SETCNT=aa,(bb cc dd ee)
++(% style="color:#037691" %)**AT Command**
++(% border="2" style="width:500px" %)
++|(% style="width:134px" %)**Command**|(% style="width:364px" %)AT+SETCNT=<counting_parameter><number>
++|(% style="width:134px" %)**Response**|(% style="width:364px" %)
++|(% style="width:134px" %)**Parameters**|(% style="width:364px" %)(((
++**counting_parameter** :
++
++1: COUNT1
++
++2: COUNT2
++
++3: AVI1 Count
++
++**number** : Start number
++)))
++|(% style="width:134px" %)**Example**|(% style="width:364px" %)(((
++AT+SETCNT=1,10
++
++Sets the COUNT1 to 10.
++)))
++
++(% style="color:#037691" %)**Downlink Payload**
++
++(% border="2" style="width:500px" %)
++|(% style="width:135px" %)**Payload**|(% style="width:363px" %)<prefix><counting_parameter><number>
++|(% style="width:135px" %)**Parameters**|(% style="width:363px" %)(((
++prefix : A8 (hex)
++
++**counting_parameter** :  (1 byte in hexadecimal)
++
++1: COUNT1
++
++2: COUNT2
++
++3: AVI1 Count
++
++**number** : Start number, 4 bytes in hexadecimal
++)))
++|(% style="width:135px" %)**Example**|(% style="width:363px" %)(((
++A8 **01 00 00 00 0A**
++
++Sets the COUNT1 to 10.
++)))
++
  ==== 3.4.2.18 Counting ~-~- Clear Counting ====
  This feature clears the counting in counting mode.
@@ -1540,8 +1540,23 @@
  (% style="color:blue" %)**0x A6 01    ** (%%)~/~/ clear all counting
++(% style="color:#037691" %)**AT Command**
++(% border="2" style="width:500px" %)
++|(% style="width:142px" %)**Command**|(% style="width:356px" %)AT+CLRCOUNT
++|(% style="width:142px" %)**Response**|(% style="width:356px" %)-
++(% style="color:#037691" %)**Downlink Payload**
++
++(% border="2" style="width:500px" %)
++|(% style="width:141px" %)**Payload**|(% style="width:357px" %)<prefix><clear?>
++|(% style="width:141px" %)**Parameters**|(% style="width:357px" %)(((
++prefix : A6 (hex)
++
++clear? : 01 (hex)
++)))
++|(% style="width:141px" %)**Example**|(% style="width:357px" %)A6 **01**
++
  ==== 3.4.2.19 Counting ~-~- Change counting mode to save time ====
  This feature allows you to configure the device to save its counting result to internal flash memory at specified intervals. By setting a save time, the device will periodically store the counting data to prevent loss in case of power failure. The save interval can be adjusted to suit your requirements, with a minimum value of 30 seconds.
@@ -1560,7 +1560,34 @@
  )))
++(% style="color:#037691" %)**AT Command**
++(% border="2" style="width:500px" %)
++|(% style="width:124px" %)**Command**|(% style="width:374px" %)AT+COUTIME=<time>
++|(% style="width:124px" %)**Response**|(% style="width:374px" %)
++|(% style="width:124px" %)**Parameters**|(% style="width:374px" %)time : seconds (0 to 16777215)
++|(% style="width:124px" %)**Example**|(% style="width:374px" %)(((
++AT+COUTIME=60
++
++Sets the device to save its counting results to the memory every 60 seconds.
++)))
++
++(% style="color:#037691" %)**Downlink Payload**
++
++(% border="2" style="width:500px" %)
++|(% style="width:123px" %)**Payload**|(% style="width:375px" %)<prefix><time>
++|(% style="width:123px" %)**Parameters**|(% style="width:375px" %)(((
++prefix : A7
++
++time : seconds, 3 bytes in hexadecimal
++)))
++|(% style="width:123px" %)**Example**|(% style="width:375px" %)(((
++A7 **00 00 3C**
++
++Sets the device to save its counting results to the memory every 60 seconds.
++)))
++
++
  ==== 3.4.2.20 Reset save RO DO state ====
  This feature allows you to reset the saved relay output (RO) and digital output (DO) states when the device joins the network. By configuring this setting, you can control whether the device should retain or reset the relay states after a reset and rejoin to the network.
@@ -1577,7 +1577,49 @@
  (% style="color:blue" %)**0x AD aa      ** (%%)~/~/ same as AT+RODORET =aa
++(% border="2" style="width:500px" %)
++|(% style="width:127px" %)**Command**|(% style="width:371px" %)AT+RODORESET=<state>
++|(% style="width:127px" %)**Response**|(% style="width:371px" %)
++|(% style="width:127px" %)**Parameters**|(% style="width:371px" %)(((
++state :
++0 : RODO will close when the device joins the network. (default)
++
++1: After the device is reset, the previously saved RODO state (limited to MOD2 to MOD5) is read, and it will not change when the device reconnects to the network.
++)))
++|(% style="width:127px" %)**Example**|(% style="width:371px" %)(((
++(% style="color:blue" %)**AT+RODORESET=1 **
++
++RODO will close when the device joins the network. (default)
++
++(% style="color:blue" %)**AT+RODORESET=0 **
++
++After the device is reset, the previously saved RODO state (limited to MOD2 to MOD5) is read, and it will not change when the device reconnects to the network.
++)))
++
++
++(% border="2" style="width:500px" %)
++|(% style="width:127px" %)**Payload**|(% style="width:371px" %)<prefix><state>
++|(% style="width:127px" %)**Parameters**|(% style="width:371px" %)(((
++prefix : AD
++
++state :
++
++0 : RODO will close when the device joins the network. (default), represents as 1 byte in hexadecimal.
++
++1: After the device is reset, the previously saved RODO state (limited to MOD2 to MOD5) is read, and it will not change when the device reconnects to the network. - represents as 1 byte in hexadecimal
++)))
++|(% style="width:127px" %)**Example**|(% style="width:371px" %)(((
++AD **01**
++
++RODO will close when the device joins the network. (default)
++
++AD **00**
++
++After the device is reset, the previously saved RODO state (limited to MOD2 to MOD5) is read, and it will not change when the device reconnects to the network.
++)))
++
++
  ==== 3.4.2.21 Encrypted payload ====
  This feature allows you to configure whether the device should upload data in an encrypted format or in plaintext. By default, the device encrypts the payload before uploading. You can toggle this setting to either upload encrypted data or transmit it without encryption.

dragino-ttn-te.jpg

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.pradeeka

Size

...	...	@@ -1,0 +1,1 @@
	1	+273.8 KB

Content

lorawan-nw.jpg

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.pradeeka

Size

...	...	@@ -1,0 +1,1 @@
	1	+250.6 KB

Content

Changes for page LT-22222-L -- LoRa I/O Controller User Manual

Summary

Details

Applications

Navigation