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

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

From 230.12 to 230.11 From 233.1 to 232.1

From version 232.1

edited by Dilisi S
on 2024/12/16 00:55

Change comment: Dec 15 edits - convert remaining AT commands to table format

To version 230.12

edited by Xiaoling
on 2024/12/09 10:15

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (2 modified, 0 added, 0 removed)

Details

Page properties

Author

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

Content

@@ -98,6 +98,8 @@
  * Automatic RF Sense and CAD with ultra-fast AFC.
  * Packet engine up to 256 bytes with CRC.
++
++
  == 1.3 Features ==
@@ -109,6 +109,8 @@
  * Firmware upgradable via program port
  * Counting
++
++
  == 1.4 Applications ==
@@ -119,6 +119,8 @@
  * Smart cities
  * Smart factory
++
++
  == 1.5 Hardware Variants ==
@@ -126,7 +126,7 @@
  |(% style="background-color:#4f81bd; color:white; width:94px" %)**Model**|(% style="background-color:#4f81bd; color:white; width:172px" %)**Photo**|(% style="background-color:#4f81bd; color:white; width:244px" %)**Description**
  |(% style="width:94px" %)**LT-22222-L**|(% style="width:172px" %)(((
  (% style="text-align:center" %)
--[[image:lt33222-l.jpg||height="110" width="95"]]
++[[image:lt33222-l.jpg||height="116" width="100"]]
  )))|(% style="width:256px" %)(((
  * 2 x Digital Input (Bi-direction)
  * 2 x Digital Output
@@ -140,7 +140,6 @@
  == 2.1 Connecting the antenna ==
--
  Connect the LoRa antenna to the antenna connector, **ANT**,** **located on the top right side of the device, next to the upper screw terminal block. Secure the antenna by tightening it clockwise.
  {{warning}}
@@ -147,41 +147,38 @@
  **Warning! Do not power on the device without connecting the antenna.**
  {{/warning}}
--
  == 2.2 Terminals ==
--
  The  LT-22222-L has two screw terminal blocks. The upper screw treminal block has 6 screw terminals and the lower screw terminal block has 10 screw terminals.
  **Upper screw terminal block (from left to right):**
--(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:381px" %)
--|=(% style="width: 139px;background-color:#4f81bd;color:white" %)Screw Terminal|=(% style="width: 242px;background-color:#4f81bd;color:white" %)Function
--|(% style="width:139px" %)GND|(% style="width:242px" %)Ground
--|(% style="width:139px" %)VIN|(% style="width:242px" %)Input Voltage
--|(% style="width:139px" %)AVI2|(% style="width:242px" %)Analog Voltage Input Terminal 2
--|(% style="width:139px" %)AVI1|(% style="width:242px" %)Analog Voltage Input Terminal 1
--|(% style="width:139px" %)ACI2|(% style="width:242px" %)Analog Current Input Terminal 2
--|(% style="width:139px" %)ACI1|(% style="width:242px" %)Analog Current Input Terminal 1
++(% style="width:634px" %)
++|=(% style="width: 295px;" %)Screw Terminal|=(% style="width: 338px;" %)Function
++|(% style="width:295px" %)GND|(% style="width:338px" %)Ground
++|(% style="width:295px" %)VIN|(% style="width:338px" %)Input Voltage
++|(% style="width:295px" %)AVI2|(% style="width:338px" %)Analog Voltage Input Terminal 2
++|(% style="width:295px" %)AVI1|(% style="width:338px" %)Analog Voltage Input Terminal 1
++|(% style="width:295px" %)ACI2|(% style="width:338px" %)Analog Current Input Terminal 2
++|(% style="width:295px" %)ACI1|(% style="width:338px" %)Analog Current Input Terminal 1
  **Lower screw terminal block (from left to right):**
--(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:253px" %)
--|=(% style="width: 125px;background-color:#4f81bd;color:white" %)Screw Terminal|=(% style="width: 128px;background-color:#4f81bd;color:white" %)Function
--|(% style="width:125px" %)RO1-2|(% style="width:128px" %)Relay Output 1
--|(% style="width:125px" %)RO1-1|(% style="width:128px" %)Relay Output 1
--|(% style="width:125px" %)RO2-2|(% style="width:128px" %)Relay Output 2
--|(% style="width:125px" %)RO2-1|(% style="width:128px" %)Relay Output 2
--|(% style="width:125px" %)DI2+|(% style="width:128px" %)Digital Input 2
--|(% style="width:125px" %)DI2-|(% style="width:128px" %)Digital Input 2
--|(% style="width:125px" %)DI1+|(% style="width:128px" %)Digital Input 1
--|(% style="width:125px" %)DI1-|(% style="width:128px" %)Digital Input 1
--|(% style="width:125px" %)DO2|(% style="width:128px" %)Digital Output 2
--|(% style="width:125px" %)DO1|(% style="width:128px" %)Digital Output 1
++(% style="width:633px" %)
++|=(% style="width: 296px;" %)Screw Terminal|=(% style="width: 334px;" %)Function
++|(% style="width:296px" %)RO1-2|(% style="width:334px" %)Relay Output 1
++|(% style="width:296px" %)RO1-1|(% style="width:334px" %)Relay Output 1
++|(% style="width:296px" %)RO2-2|(% style="width:334px" %)Relay Output 2
++|(% style="width:296px" %)RO2-1|(% style="width:334px" %)Relay Output 2
++|(% style="width:296px" %)DI2+|(% style="width:334px" %)Digital Input 2
++|(% style="width:296px" %)DI2-|(% style="width:334px" %)Digital Input 2
++|(% style="width:296px" %)DI1+|(% style="width:334px" %)Digital Input 1
++|(% style="width:296px" %)DI1-|(% style="width:334px" %)Digital Input 1
++|(% style="width:296px" %)DO2|(% style="width:334px" %)Digital Output 2
++|(% style="width:296px" %)DO1|(% style="width:334px" %)Digital Output 1
  == 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.
  {{warning}}
@@ -194,27 +194,23 @@
  = 3. Registering LT-22222-L 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.1 Prerequisites ==
++=== 3.2.1 Prerequisites ===
--
  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}}
--If you are unable to set the provided root key and other identifiers in the network server, you must generate new keys and identifiers with the network server and configure the device with them using AT commands.
++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 ===
--== 3.2 The Things Stack ==
--
--
  This section guides you through how to register your LT-22222-L with The Things Stack Sandbox.
  {{info}}
@@ -225,7 +225,7 @@
  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-lorawan-nw-lt-22222-n.jpg||height="374" width="1400"]]
++[[image:dragino-lorawan-nw-lt-22222-n.jpg]]
  {{info}}
   You can use a LoRaWAN gateway, such as the [[Dragino LPS8N>>https://www.dragino.com/products/lora-lorawan-gateway/item/200-lps8n.html]], to expand or create LoRaWAN coverage in your area.
@@ -232,9 +232,8 @@
  {{/info}}
--=== 3.2.1 Setting up ===
++==== 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).
@@ -241,10 +241,8 @@
  * 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.1.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.
@@ -268,9 +268,8 @@
  [[image:lt-22222-l-dev-repo-reg-p2.png]]
--==== 3.2.1.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**.
  ** Select the **Frequency plan** that matches your device from the **Frequency plan** dropdown list.
@@ -300,9 +300,8 @@
  [[image:lt-22222-device-overview.png]]
--=== 3.2.2 Joining ===
++==== 3.2.2.4 Joining ====
--
  On the Device's page, click on **Live data** tab. The Live data panel for your device will display.
  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.
@@ -311,9 +311,10 @@
  [[image:lt-22222-l-joining.png]]
--=== 3.2.3 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.
  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.
@@ -336,9 +336,8 @@
  [[image:lt-22222-l-js-custom-payload-formatter.png]]
--=== 3.2.4 Downlinks ===
++==== 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**.
@@ -361,10 +361,8 @@
  The uplink messages are sent over LoRaWAN FPort=2. By default, an uplink message is sent every 10 minutes.
--
  === 3.3.1 AT+MOD~=1, 2ACI+2AVI ===
--
  (((
  This is the default mode.
@@ -437,7 +437,6 @@
  MOD = 1
--
  === 3.3.2 AT+MOD~=2, (Double DI Counting) ===
@@ -516,7 +516,6 @@
  === 3.3.3 AT+MOD~=3, Single DI Counting + 2 x ACI ===
--
  (% style="color:red" %)**Note: The maximum count depends on the bytes it is.
  The maximum count for four bytes is FFFFFFFF (hex) = 4294967295 (dec).
  It starts counting again when it reaches the maximum value.**
@@ -570,7 +570,6 @@
  === 3.3.4 AT+MOD~=4, Single DI Counting + 1 x Voltage Counting ===
--
  (% style="color:red" %)**Note:The maximum count depends on the bytes it is.
  The maximum count for four bytes is FFFFFFFF (hex) = 4294967295 (dec).
  It starts counting again when it reaches the maximum value.**
@@ -640,7 +640,6 @@
  === 3.3.5 AT+MOD~=5, Single DI Counting + 2 x AVI + 1 x ACI ===
--
  (% style="color:red" %)**Note:The maximum count depends on the bytes it is.
  The maximum count for four bytes is FFFFFFFF (hex) = 4294967295 (dec).
  It starts counting again when it reaches the maximum value.**
@@ -905,6 +905,7 @@
  * (% style="color:blue" %)**Sensor-related commands**(%%):
++
  === 3.4.1 Common commands ===
@@ -1025,6 +1025,7 @@
  Sets the device to working mode 2 (Double DI Counting + DO + RO)
  )))
++
  ==== 3.4.2.3 Request an uplink from the device ====
@@ -1045,6 +1045,7 @@
  Requests an uplink from LT-22222-L.
  )))
++
  ==== 3.4.2.4 Enable/Disable Trigger Mode ====
@@ -1083,6 +1083,7 @@
  Enable trigger mode for the current working mode
  )))
++
  ==== 3.4.2.5 Request trigger settings ====
@@ -1103,6 +1103,7 @@
  Uplinks the trigger settings.
  )))
++
  ==== 3.4.2.6 Enable/Disable DI1/DI2/DI3 as a trigger ====
@@ -1158,6 +1158,7 @@
  Enable DI1 trigger, disable DI2 trigger
  )))
++
  ==== 3.4.2.7 Trigger1 – Set DI or DI3 as a trigger ====
@@ -1197,6 +1197,7 @@
  Set the DI1 port to trigger on a rising edge; the valid signal duration is 100 ms.
  )))
++
  ==== 3.4.2.8 Trigger2 – Set DI2 as a trigger ====
@@ -1231,6 +1231,7 @@
  )))
  |(% style="width:96px" %)**Example**|(% style="width:402px" %)09 02 **00 00 64**
++
  ==== 3.4.2.9 Trigger – Set AC (current) as a trigger ====
@@ -1281,6 +1281,7 @@
  )))
  |(% style="width:104px" %)Note|(% style="width:394px" %)See also, [[trigger mode>>||anchor="H3.3.6AT2BADDMOD3D6.28TriggerMode2COptional29"]]
++
  ==== 3.4.2.10 Trigger – Set AV (voltage) as trigger ====
@@ -1329,6 +1329,7 @@
  )))
  |(% style="width:104px" %)**Note**|(% style="width:394px" %)See also, [[trigger mode>>||anchor="H3.3.6AT2BADDMOD3D6.28TriggerMode2COptional29"]]
++
  ==== 3.4.2.11 Trigger – Set minimum interval ====
@@ -1365,6 +1365,7 @@
  )))
  |(% 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 ====
@@ -1416,84 +1416,82 @@
  )))
  )))
++
  ==== 3.4.2.13 DO ~-~- Control Digital Output DO1/DO2/DO3 with time control ====
--(% style="color:#037691" %)**AT command**
++* (% style="color:#037691" %)**AT Command**
  There is no AT command to control the digital output.
--(% style="color:#037691" %)**Downlink payload**
++* (% style="color:#037691" %)**Downlink Payload (prefix 0xA9)**
++(% style="color:blue" %)**0xA9 aa bb cc     **(%%) ~/~/ Sets DO1/DO2/DO3 outputs with time control
--(% border="2" style="width:500px" %)
--|(% style="width:116px" %)**Prefix**|(% style="width:382px" %)0xA9
--|(% style="width:116px" %)**Parameters**|(% style="width:382px" %)(((
--**inverter_mode**: 1 byte in hex.
++This is to control the digital output time of DO pin. Include four bytes:
++(% style="color:#4f81bd" %)**First byte**(%%)**:** Type code (0xA9)
++
++(% style="color:#4f81bd" %)**Second byte**(%%): Inverter Mode
++
  **01:** DO pins revert to their original state after the timeout.
  **00:** DO pins switch to an inverted state after the timeout.
--**DO1_control_method_and_port_status **- 1 byte in hex
++(% style="color:#4f81bd" %)**Third Byte**(%%): Control Method and Port status:
--0x01 :  DO1 set to low
++(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:300px" %)
++|(% style="background-color:#4f81bd; color:white" %)**Second Byte**|(% style="background-color:#4f81bd; color:white" %)**Status**
++|0x01|DO1 set to low
++|0x00|DO1 set to high
++|0x11|DO1 NO Action
--0x00 :  DO1 set to high
++(% style="color:#4f81bd" %)**Fourth byte**(%%): Control Method and Port status:
--0x11 :  DO1 NO action
++(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:300px" %)
++|(% style="background-color:#4f81bd; color:white" %)**Second Byte**|(% style="background-color:#4f81bd; color:white" %)**Status**
++|0x01|DO2 set to low
++|0x00|DO2 set to high
++|0x11|DO2 NO Action
++(% style="color:#4f81bd" %)**Fifth byte**(%%): Control Method and Port status:
--**DO2_control_method_and_port_status** - 1 byte in hex
++(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:300px" %)
++|(% style="background-color:#4f81bd; color:white" %)**Second Byte**|(% style="background-color:#4f81bd; color:white" %)**Status**
++|0x01|DO3 set to low
++|0x00|DO3 set to high
++|0x11|DO3 NO Action
--0x01 :  DO2 set to low
++(% style="color:#4f81bd" %)**Sixth, Seventh, Eighth, and Ninth bytes**:(%%) Latching time (Unit: ms)
--0x00 :  DO2 set to high
--0x11 :  DO2 NO action
--
--
--**DO3_control_method_and_port_status **- 1 byte in hex
--
--0x01 :  DO3 set to low
--
--0x00 :  DO3 set to high
--
--0x11 :  DO3 NO action
--
--
--**latching_time** : 4 bytes in hex
--
  (% style="color:red" %)**Note: **
--   Since firmware v1.6.0, the latch time support 4 bytes or 2 bytes
++   Since firmware v1.6.0, the latch time support 4 bytes and 2 bytes
     Before firmware v1.6.0, the latch time only supported 2 bytes.
  (% style="color:red" %)**The device will uplink a packet if the downlink code executes successfully.**
--)))
--|(% style="width:116px" %)**Payload format**|(% style="width:382px" %)<prefix><inverter_mode><DO1_control_method_and_port_status><DO2_control_method_and_port_status><DO2_control_method_and_port_status><latching_time>
--|(% style="width:116px" %)**Example**|(% style="width:382px" %)(((
--**A9 01 01 01 01 07 D0**
--DO1 pin, DO2 pin, and DO3 pin will be set to low, last for 2 seconds, and then revert to their original state.
++**Example payload:**
--**A9 01 00 01 11 07 D0**
++**~1. A9 01 01 01 01 07 D0**
--DO1 pin is set to high, DO2 pin is set to low, and DO3 pin takes no action. This lasts for 2 seconds and then reverts to the original state.
++DO1 pin, DO2 pin, and DO3 pin will be set to low, last for 2 seconds, and then revert to their original state.
++**2. A9 01 00 01 11 07 D0**
--**A9 00 00 00 00 07 D0**
++DO1 pin is set to high, DO2 pin is set to low, and DO3 pin takes no action. This lasts for 2 seconds and then reverts to the original state.
++**3. A9 00 00 00 00 07 D0**
++
  DO1 pin, DO2 pin, and DO3 pin will be set to high, last for 2 seconds, and then all change to low.
++**4. A9 00 11 01 00 07 D0**
--**A9 00 11 01 00 07 D0**
--
  DO1 pin takes no action, DO2 pin is set to low, and DO3 pin is set to high. This lasts for 2 seconds, after which DO1 pin takes no action, DO2 pin is set to high, and DO3 pin is set to low.
--)))
  ==== 3.4.2.14 Relay ~-~- Control Relay Output RO1/RO2 ====
@@ -1731,6 +1731,7 @@
  )))
  |(% style="width:141px" %)**Example**|(% style="width:357px" %)A6 **01**
++
  ==== 3.4.2.19 Counting ~-~- Set Saving Interval for 'Counting Result' ====
@@ -1763,6 +1763,7 @@
  Sets the device to save its counting results to the memory every 60 seconds.
  )))
++
  ==== 3.4.2.20 Reset saved RO and DO states ====
@@ -1813,6 +1813,7 @@
  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 ====
@@ -1952,6 +1952,7 @@
  Set DISMACANS=1
  )))
++
  ==== 3.4.2.25 Copy downlink to uplink ====
@@ -2377,6 +2377,7 @@
  |**RO1**|For LT-22222-L: ON when RO1 is closed, OFF when RO1 is open
  |**RO2**|For LT-22222-L: ON when RO2 is closed, OFF when RO2 is open
++
  = 4. Using AT Commands =
@@ -2786,6 +2786,7 @@
  * In modes 2 to 5, the DO/RO status and pulse count are saved to flash memory.
  * After a restart, the status before the power failure will be read from flash.
++
  == 6.8 Can I setup LT-22222-L as a NC (Normally Closed) relay? ==
@@ -2876,6 +2876,8 @@
  * (% style="color:red" %)**IN865**(%%): LT with frequency bands IN865
  * (% style="color:red" %)**CN779**(%%): LT with frequency bands CN779
++
++
  = 9. Package information =
@@ -2893,6 +2893,8 @@
  * Package Size / pcs : 14.5 x 8 x 5 cm
  * Weight / pcs : 170 g
++
++
  = 10. Support =