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

Last modified by Mengting Qiu on 2025/06/04 18:42

From 204.1 to 205.1 From 208.1 to 209.1

From version 205.1

edited by Dilisi S
on 2024/11/19 21:19

Change comment: Nov 19 edits - part 1

To version 208.1

edited by Dilisi S
on 2024/11/22 05:35

Change comment: Nov 21 edits

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)
Attachments (0 modified, 1 added, 0 removed)
- dragino-lorawan-nw-lt-22222-n.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.
  )))
@@ -45,7 +45,7 @@
  * Setup your own private LoRaWAN network.
  {{info}}
-- You can use a LoRaWAN gateway, such as the [[Dragino LG308>>https://www.dragino.com/products/lora-lorawan-gateway/item/140-lg308.html]], to expand or create LoRaWAN coverage in your area.
++ You can use a LoRaWAN gateway, such as the Dragino LPS8N, to expand or create LoRaWAN coverage in your area.
  {{/info}}
  )))
@@ -133,7 +133,6 @@
  * 1 x Counting Port
  )))
--
  == 2. Assembling the device ==
  == 2.1 Connecting the antenna ==
@@ -178,10 +178,8 @@
  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** with the Network Server.
--
  {{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}}
@@ -190,16 +190,13 @@
  = 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 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.
++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.
--
  === 3.2.1 Prerequisites ===
--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 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.
--Make sure you have the device registration information such as DevEUI, AppEUI, and AppKey with you. 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}}
@@ -208,27 +208,33 @@
  The following subsections explain how to register the LT-22222-L with different LoRaWAN network server providers.
--=== 3.2.2 Registering with The Things Stack ===
++=== 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}}
--The network diagram below shows how the LT-22222-L is connected to The Things Stack and integrates its data with the ThingsEye IoT platform.
++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]]
++[[image:dragino-lorawan-nw-lt-22222-n.jpg]]
--* Create a free account with [[The Things Stack Sandbox>>https://eu1.cloud.thethings.network]] if you do not have a one yet.
++
++
++
++==== 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.
--* Go to your application page and click on the **End devices** in the left menu.
++* 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.2 Using the LoRaWAN Device Repository ====
--==== 3.2.2.1 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.
@@ -239,7 +239,6 @@
  *** **Profile (Region)**: Select the region that matches your device.
  ** Select the **Frequency plan** that matches your device from the **Frequency plan** dropdown list.
--
  [[image:lt-22222-l-dev-repo-reg-p1.png||height="625" width="1000"]]
@@ -254,7 +254,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**.
@@ -269,7 +269,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.
@@ -285,7 +285,7 @@
  [[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.
@@ -295,7 +295,7 @@
  [[image:lt-22222-join-network.png||height="625" width="1000"]]
--==== 3.2.2.4 Uplinks ====
++==== 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.
@@ -314,7 +314,7 @@
  [[image:lt-22222-ul-payload-fmt.png||height="686" width="1000"]]
--==== 3.2.2.4 Uplinks ====
++==== 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**.
@@ -1608,7 +1608,7 @@
  ==== 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 AVI1 Count. Use the AT command to set the desired count number for each configuration.
++This command 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) **
@@ -1669,7 +1669,7 @@
  ==== 3.4.2.18 Counting ~-~- Clear Counting ====
--This feature clears the counting in counting mode.
++This command clears the counting in counting mode.
  * (% style="color:#037691" %)**AT Command:**(%%) (% style="color:blue" %)**AT+CLRCOUNT         **(%%) ~/~/ clear all counting
@@ -1696,7 +1696,7 @@
  ==== 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.
++This command 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.
  * (% style="color:#037691" %)**AT Command:**
@@ -1712,10 +1712,36 @@
  )))
++(% 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.
++This command 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.
  * (% style="color:#037691" %)**AT Command:**
@@ -1729,10 +1729,50 @@
  (% 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.
++This command 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.
  * (% style="color:#037691" %)**AT Command:**
@@ -1741,9 +1741,32 @@
  (% style="color:blue" %)**AT+DECRYPT=0    **(%%)~/~/  Encrypt when uploading payload (default)
++(% border="2" style="width:500px" %)
++|(% style="width:127px" %)**Command**|(% style="width:371px" %)AT+DECRYPT=<state>
++|(% style="width:127px" %)**Response**|(% style="width:371px" %)
++|(% style="width:127px" %)**Parameters**|(% style="width:371px" %)(((
++state :
++1 : The payload is uploaded without encryption
++
++0 : The payload is encrypted when uploaded (default)
++)))
++|(% style="width:127px" %)**Example**|(% style="width:371px" %)(((
++AT+DECRYPT=1
++
++The payload is uploaded without encryption
++
++AT+DECRYPT=0
++
++The payload is encrypted when uploaded (default)
++)))
++
++There is no downlink payload for this configuration.
++
++
  ==== 3.4.2.22 Get sensor value ====
++This command allows you to retrieve and optionally uplink sensor readings through the serial port.
  * (% style="color:#037691" %)**AT Command:**
@@ -1752,10 +1752,33 @@
  (% style="color:blue" %)**AT+GETSENSORVALUE=1    **(%%)~/~/ The serial port retrieves the current sensor reading and uploads it.
++(% border="2" style="width:500px" %)
++|(% style="width:127px" %)**Command**|(% style="width:371px" %)AT+GETSENSORVALUE=<state>
++|(% style="width:127px" %)**Response**|(% style="width:371px" %)
++|(% style="width:127px" %)**Parameters**|(% style="width:371px" %)(((
++**state** :
--==== 3.4.2.23 Resets the downlink packet count ====
++**0 **: Retrieves the current sensor reading via the serial port.
++**1 **: Retrieves and uploads the current sensor reading via the serial port.
++)))
++|(% style="width:127px" %)**Example**|(% style="width:371px" %)(((
++AT+GETSENSORVALUE=0
++Retrieves the current sensor reading via the serial port.
++
++AT+GETSENSORVALUE=1
++
++Retrieves and uplinks the current sensor reading via the serial port.
++)))
++
++There is no downlink payload for this configuration.
++
++
++==== 3.4.2.23 Resetting the downlink packet count ====
++
++This command manages how the node handles mismatched downlink packet counts. It offers two modes: one disables the reception of further downlink packets if discrepancies occur, while the other resets the downlink packet count to align with the server, ensuring continued communication.
++
  * (% style="color:#037691" %)**AT Command:**
  (% style="color:blue" %)**AT+DISFCNTCHECK=0   **(%%)~/~/ When the downlink packet count sent by the server is less than the node downlink packet count or exceeds 16384, the node will no longer receive downlink packets (default)
@@ -1763,10 +1763,37 @@
  (% style="color:blue" %)**AT+DISFCNTCHECK=1   **(%%)~/~/ When the downlink packet count sent by the server is less than the node downlink packet count or exceeds 16384, the node resets the downlink packet count and keeps it consistent with the server downlink packet count.
++(% border="2" style="width:500px" %)
++|(% style="width:130px" %)**Command**|(% style="width:368px" %)AT+DISFCNTCHECK=<state>
++|(% style="width:130px" %)**Response**|(% style="width:368px" %)(((
++
++)))
++|(% style="width:130px" %)**Parameters**|(% style="width:368px" %)(((
++**state **:
++**0** : When the downlink packet count sent by the server is less than the node's downlink packet count or exceeds 16,384, the node stops receiving further downlink packets (default).
++
++
++**1** : When the downlink packet count sent by the server is less than the node's downlink packet count or exceeds 16,384, the node resets its downlink packet count to match the server's, ensuring consistency.
++)))
++|(% style="width:130px" %)**Example**|(% style="width:368px" %)(((
++AT+DISFCNTCHECK=0
++
++When the downlink packet count sent by the server is less than the node's downlink packet count or exceeds 16,384, the node stops receiving further downlink packets (default).
++
++AT+DISFCNTCHECK=1
++
++When the downlink packet count sent by the server is less than the node's downlink packet count or exceeds 16,384, the node resets its downlink packet count to match the server's, ensuring consistency.
++)))
++
++There is no downlink payload for this configuration.
++
++
  ==== 3.4.2.24 When the limit bytes are exceeded, upload in batches ====
++This command controls the behavior of the node when the combined size of the MAC commands (MACANS) from the server and the payload exceeds the allowed byte limit for the current data rate (DR). The command provides two modes: one enables splitting the data into batches to ensure compliance with the byte limit, while the other prioritizes the payload and ignores the MACANS in cases of overflow.
++
  * (% style="color:#037691" %)**AT Command:**
  (% style="color:blue" %)**AT+DISMACANS=0**   (%%)  ~/~/ When the MACANS of the reply server plus the payload exceeds the maximum number of bytes of 11 bytes (DR0 of US915, DR2 of AS923, DR2 of AU195), the node will send a packet with a payload of 00 and a port of 4. (default)
@@ -1778,10 +1778,51 @@
  (% style="color:blue" %)**0x21 00 01 **   (%%)      ~/~/ Set  the DISMACANS=1
++(% style="color:#037691" %)**AT Command**
++(% border="2" style="width:500px" %)
++|(% style="width:127px" %)**Command**|(% style="width:371px" %)AT+DISMACANS=<state>
++|(% style="width:127px" %)**Response**|(% style="width:371px" %)
++|(% style="width:127px" %)**Parameters**|(% style="width:371px" %)(((
++**state** :
++**0** : When the combined size of the MACANS from the server and the payload exceeds the byte limit (11 bytes for DR0 of US915, DR2 of AS923, DR2 of AU915), the node sends a packet with a payload of 00 and a port of 4. (default)
++
++**1** : When the combined size of the MACANS from the server and the payload exceeds the byte limit for the current DR, the node ignores the MACANS and only uploads the payload.
++)))
++|(% style="width:127px" %)**Example**|(% style="width:371px" %)(((
++AT+DISMACANS=0
++
++When the combined size of the MACANS from the server and the payload exceeds the byte limit (11 bytes for DR0 of US915, DR2 of AS923, DR2 of AU915), the node sends a packet with a payload of 00 and a port of 4. (default)
++
++AT+DISMACANS=1
++
++When the combined size of the MACANS from the server and the payload exceeds the byte limit for the current DR, the node ignores the MACANS and only uploads the payload.
++)))
++
++(% style="color:#037691" %)**Downlink Payload**
++
++(% border="2" style="width:500px" %)
++|(% style="width:126px" %)**Payload**|(% style="width:372px" %)<prefix><state>
++|(% style="width:126px" %)**Parameters**|(% style="width:372px" %)(((
++**prefix** : 21
++
++**state** : (2 bytes in hexadecimal)
++
++**0** : When the combined size of the MACANS from the server and the payload exceeds the byte limit (11 bytes for DR0 of US915, DR2 of AS923, DR2 of AU915), the node sends a packet with a payload of 00 and a port of 4. (default)
++
++**1 **: When the combined size of the MACANS from the server and the payload exceeds the byte limit for the current DR, the node ignores the MACANS and only uploads the payload.
++)))
++|(% style="width:126px" %)**Example**|(% style="width:372px" %)(((
++21 **00 01**
++
++Set DISMACANS=1
++)))
++
++
  ==== 3.4.2.25 Copy downlink to uplink ====
++This command enables the device to immediately uplink the content of a received downlink packet back to the server. The command allows for quick data replication from downlink to uplink, with a fixed port number of 100.
  * (% style="color:#037691" %)**AT Command**(%%)**:**
@@ -1794,8 +1794,32 @@
  For example, sending 11 22 33 44 55 66 77 will return invalid configuration 00 11 22 33 44 55 66 77.
++(% border="2" style="width:500px" %)
++|(% style="width:122px" %)Command|(% style="width:376px" %)(((
++AT+RPL=5
++After receiving a downlink packet from the server, the node immediately uplinks the content of the packet back to the server using port number 100.
++)))
++|(% style="width:122px" %)Uplink payload|(% style="width:376px" %)(((
++aa xx xx xx xx
++aa : indicates whether the configuration has changed.
++
++00 : YES
++
++01 : NO
++)))
++|(% style="width:122px" %)Example|(% style="width:376px" %)(((
++Downlink:
++
++11 22 33 44 55 66 77
++
++Uplink:
++
++00 11 22 33 44 55 66 77
++)))
++
++
  [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50%20%26%20LSN50-V2%20-%20LoRaWAN%20Sensor%20Node%20User%20Manual/WebHome/image-20220823173833-7.png?width=1124&height=149&rev=1.1||alt="image-20220823173833-7.png"]]
  For example, if 01 00 02 58 is issued, a valid configuration of 01 01 00 02 58 will be returned.

dragino-lorawan-nw-lt-22222-n.jpg

Author

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

Size

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

Content

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

Summary

Details

Applications

Navigation