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 < 157.1 >

edited by Dilisi S
on 2024/11/01 04:54

To version < 180.1 >

edited by Dilisi S
on 2024/11/09 06:08

Change comment: Nov 8 edits - part 2

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)
Attachments (0 modified, 8 added, 0 removed)

Details

Page properties

Content

@@ -17,7 +17,7 @@
--= 1.Introduction =
++= 1. Introduction =
  == 1.1 What is the LT-22222-L I/O Controller? ==
@@ -33,8 +33,6 @@
  With the LT-22222-L I/O Controller, users can transmit data over ultra-long distances with low power consumption using LoRa, a spread-spectrum modulation technique derived from chirp spread spectrum (CSS) technology that operates on license-free ISM bands.
  )))
--> The LT Series I/O Controllers are designed for easy, low-cost installation on LoRaWAN networks.
--
  (((
  You can connect the LT-22222-L I/O Controller to a LoRaWAN network service provider in several ways:
@@ -42,7 +42,7 @@
  * 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.
--> You can use the Dragino LG308 gateway to expand or create LoRaWAN coverage in your area.
++> You can use a LoRaWAN gateway, such as the Dragino LG308, to expand or create LoRaWAN coverage in your area.
  )))
  (((
@@ -59,16 +59,16 @@
  * SX1276/78 Wireless Chip
  * Power Consumption:
  ** Idle: 4mA@12v
--** 20dB Transmit: 34mA@12v
--* Operating Temperature: -40 ~~ 85 Degree, No Dew
++** 20dB Transmit: 34mA@12V
++* Operating Temperature: -40 ~~ 85 Degrees, No Dew
  (% style="color:#037691" %)**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 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)
++* 2 x 0~~30V Analog Input (res:0.01V)
  * Power Input 7~~ 24V DC.
  (% style="color:#037691" %)**LoRa Spec:**
@@ -78,7 +78,7 @@
  ** Band 2 (LF): 410 ~~ 528 Mhz
  * 168 dB maximum link budget.
  * +20 dBm - 100 mW constant RF output vs.
--* +14 dBm high efficiency PA.
++* +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.
@@ -98,7 +98,7 @@
  * Optional Customized LoRa Protocol
  * Frequency Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/RU864/IN865/MA869
  * AT Commands to change parameters
--* Remote configure parameters via LoRa Downlink
++* Remotely configure parameters via LoRaWAN Downlink
  * Firmware upgradable via program port
  * Counting
@@ -136,10 +136,10 @@
  * 1 x LT-22222-L I/O Controller
  * 1 x LoRaWAN antenna matched to the frequency of the LT-22222-L
--* 1 x bracket for wall mounting
++* 1 x bracket for DIN rail mounting
  * 1 x programming cable
--Attach the LoRaWAN antenna to the connector labeled **ANT** (located on the top right side of the device, next to the upper terminal block). Secure the antenna by tightening it clockwise.
++Attach the LoRaWAN antenna to the antenna connector, **ANT**,** **located on the top right side of the device, next to the upper terminal block. Secure the antenna by tightening it clockwise.
  == 2.2 Terminals ==
@@ -169,9 +169,9 @@
  |(% style="width:296px" %)DO2|(% style="width:334px" %)Digital Output 2
  |(% style="width:296px" %)DO1|(% style="width:334px" %)Digital Output 1
--== 2.3 Powering ==
++== 2.3 Powering the LT-22222-L ==
--The LT-22222-L I/O Controller can be powered by a 7–24V DC power source. Connect the power supply’s positive wire to the VIN screw terminal and the negative wire to the GND screw terminal. 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 the 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.
  [[image:1653297104069-180.png]]
@@ -181,15 +181,15 @@
  == 3.1 How does it work? ==
--The LT-22222-L is configured to operate in LoRaWAN Class C mode by default. It supports OTAA (Over-the-Air Activation), which is 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.
++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.
--For LT-22222-L, the LED will show the Join status: After power on (% style="color:green" %)**TX LED**(%%) will fast blink 5 times, LT-22222-L will enter working mode and start to JOIN LoRaWAN network. (% style="color:green" %)**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.
++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 LE**D 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.
  == 3.2 Registering with a LoRaWAN network server ==
--The diagram below shows how the LT-22222-L connects to a typical LoRaWAN network.
++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"]]
@@ -205,20 +205,23 @@
  * Log in to your [[The Things Stack Sandbox>>https://eu1.cloud.thethings.network]] account.
  * Create an application if you do not have one yet.
--* Register LT-22222-L with that application. Two registration options available:
++* Register LT-22222-L with that application. Two registration options are available:
--==== Using the LoRaWAN Device Repository: ====
++====   ====
++==== 3.2.2.1 Using the LoRaWAN Device Repository ====
++
  * Go to your application and click on the **Register end device** button.
  * On the **Register end device** page:
  ** Select the option **Select the end device in the LoRaWAN Device Repository**.
  ** Choose the **End device brand**, **Model**, **Hardware version**, **Firmware version**, and **Profile (Region)**.
--** Select the **Frequency plan** that matches with your device.
++** Select the **Frequency plan** that matches your device.
  [[image:lt-22222-l-dev-repo-reg-p1.png||height="625" width="1000"]]
--*
--** Enter the **AppEUI** in the **JoinEUI** field and click **Confirm** button.
++
++* Page continued...
++** Enter the **AppEUI** in the **JoinEUI** field and click the **Confirm** button.
  ** Enter the **DevEUI** in the **DevEUI** field.
  ** Enter the **AppKey** in the **AppKey** field.
  ** In the **End device ID** field, enter a unique name within this application for your LT-22222-N.
@@ -226,36 +226,68 @@
  [[image:lt-22222-l-dev-repo-reg-p2.png||height="625" width="1000"]]
--==== Entering device information manually: ====
++====   ====
++==== 3.2.2.2 Entering device information manually ====
++
  * On the **Register end device** page:
--** Select the **Enter end device specified manually** option.
--** Select the **Frequency plan** that matches with your device.
++** Select the **Enter end device specifies manually** option as the input method.
++** Select the **Frequency plan** that matches your device.
  ** Select the **LoRaWAN version**.
  ** Select the **Regional Parameters version**.
--** Click **Show advanced activation, LoRaWAN class and cluster settings** option.
--** Select **Over the air activation (OTAA)** option under **Activation mode**
++** Click **Show advanced activation, LoRaWAN class and cluster settings** link to expand the section.
++** Select **Over the air activation (OTAA)** option under the **Activation mode**
  ** Select **Class C (Continuous)** from the **Additional LoRaWAN class capabilities**.
--** Enter **AppEUI** in the **JoinEUI** field and click **Confirm** button.
++
++[[image:lt-22222-l-manually-p1.png||height="625" width="1000"]]
++
++
++* Page continued...
++** Enter **AppEUI** in the **JoinEUI** field and click the **Confirm** button.
  ** Enter **DevEUI** in the **DevEUI** field.
  ** Enter **AppKey** in the **AppKey** field.
  ** In the **End device ID** field, enter a unique name within this application for your LT-22222-N.
  ** Under **After registration**, select the **View registered end device** option.
++** Click the **Register end device** button.
--==== Joining ====
++[[image:lt-22222-l-manually-p2.png||height="625" width="1000"]]
--Click on **Live Data** in the left navigation. Then, power on the device, and it will join The Things Stack Sandbox. You can see the join request, join accept, followed by uplink messages form the device showing in the Live Data panel.
--[[image:1653298044601-602.png||height="405" width="709"]]
++You will be navigated to the **Device overview** page.
--== 3.3 Uplink Payload ==
++[[image:lt-22222-device-overview.png||height="625" width="1000"]]
--There are five working modes + one interrupt mode on LT for different type application:
++==== 3.2.2.3 Joining ====
--* (% style="color:blue" %)**MOD1**(%%): (default setting): 2 x ACI + 2AVI + DI + DO + RO
++Click on **Live data** in the left navigation. The Live data panel for your application will display.
++Power on your LT-22222-L. It will begin joining The Things Stack LoRaWAN network server. 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**).
++
++
++[[image:lt-22222-join-network.png||height="625" width="1000"]]
++
++
++By default, you will receive an uplink data message 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]]
++
++
++If you can't see the decoded payload, it is because you haven't added the uplink formatter code. To add the uplink formatter code, select **End devices** > **LT-22222-L** > **Payload formatters** > **Uplink**. Then  select **Use Device repository formatters** for the **Formatter type** dropdown. Click the **Save changes** button to apply the changes.
++
++[[image:lt-22222-ul-payload-fmt.png||height="686" width="1000"]]
++
++
++== 3.3 Work Modes and their Uplink Payload formats ==
++
++
++The LT-22222-L has 5 **work modes**. It also has an interrupt/trigger mode for different types of applications that can be used together with any work mode as an additional feature. The default mode is MOD1 and you can switch between these modes using AT commands.
++
++* (% style="color:blue" %)**MOD1**(%%): (default mode/factory set): 2ACI + 2AVI + DI + DO + RO
++
  * (% style="color:blue" %)**MOD2**(%%): Double DI Counting + DO + RO
  * (% style="color:blue" %)**MOD3**(%%): Single DI Counting + 2 x ACI + DO + RO
@@ -266,12 +266,15 @@
  * (% style="color:blue" %)**ADDMOD6**(%%): Trigger Mode, Optional, used together with MOD1 ~~ MOD5
++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 ===
--
  (((
--The uplink payload includes totally 9 bytes. Uplink packets use FPORT=2 and every 10 minutes send one uplink by default. (% style="display:none" %)
++This is the default mode.
++The uplink payload is 11 bytes long. (% style="display:none" wfd-invisible="true" %)
++
  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
  |(% style="background-color:#4f81bd; color:white" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:white" %)**2**|(% style="background-color:#4f81bd; color:white" %)**2**|(% style="background-color:#4f81bd; color:white" %)**2**|(% style="background-color:#4f81bd; color:white" %)**2**|(% style="background-color:#4f81bd; color:white" %)**1**|(% style="background-color:#4f81bd; color:white" %)**1**|(% style="background-color:#4f81bd; color:white" %)**1**
  |Value|(((
@@ -282,29 +282,29 @@
  ACI1 Current
  )))|(((
  ACI2 Current
--)))|DIDORO*|(((
++)))|**DIDORO***|(((
  Reserve
  )))|MOD
  )))
  (((
--(% style="color:#4f81bd" %)**DIDORO**(%%) is a combination for RO1, RO2, DI3, DI2, DI1, DO3, DO2 and DO1. Totally 1bytes as below
++(% style="color:#4f81bd" %)*** DIDORO**(%%) is a combination of RO1, RO2, DI3, DI2, DI1, DO3, DO2 and DO1, and its size is1 byte long as shown below.
  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
--|**bit7**|**bit6**|**bit5**|**bit4**|**bit3**|**bit2**|**bit1**|**bit0**
--|RO1|RO2|DI3|DI2|DI1|DO3|DO2|DO1
++|**bit 7**|**bit 6**|**bit 5**|**bit 4**|**bit 3**|**bit 2**|**bit 1**|**bit 0**
++|RO1|RO2|--DI3--|DI2|DI1|--DO3--|DO2|DO1
  )))
--* RO is for relay. ROx=1 : close, ROx=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.
++* RO is for the relay. ROx=1: CLOSED, ROx=0 always OPEN.
++* DI is for digital input. DIx=1: HIGH or FLOATING, DIx=0: LOW.
++* DO is for reverse digital output. DOx=1: LOW, DOx=0: HIGH or FLOATING.
--(% style="color:red" %)**Note: DI3 and DO3 bit are not valid for LT-22222-L**
++(% style="color:red" %)**Note: DI3 and DO3 bits are not valid for LT-22222-L**
--For example if payload is: [[image:image-20220523175847-2.png]]
++For example, if the payload is: [[image:image-20220523175847-2.png]]
--**The value for the interface is:  **
++**The interface values can be calculated as follows:  **
  AVI1 channel voltage is 0x04AB/1000=1195(DEC)/1000=1.195V
@@ -314,35 +314,32 @@
  ACI2 channel current is 0x1300/1000=4.864mA
--The last byte 0xAA= 10101010(B) means
++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;
++* [1] The RO1 relay channel is CLOSED, and the RO1 LED is ON.
++* [0] The RO2 relay channel is OPEN, and the RO2 LED is OFF.
++* **[1] DI3 - not used for LT-22222-L.**
++* [0] DI2 channel input is LOW, and the DI2 LED is OFF.
++* [1] DI1 channel input state:
++** DI1 is FLOATING when no sensor is connected between DI1+ and DI1-.
++** DI1 is HIGH when a sensor is connected between DI1- and DI1+ and the sensor is ACTIVE.
++** DI1 LED is ON in both cases.
++* **[0] DO3 - not used for LT-22222-L.**
++* [1] DO2 channel output is LOW, and the DO2 LED is ON.
++* [0] DO1 channel output state:
++** DO1 is FLOATING when there is no load between DO1 and V+.
++** DO1 is HIGH when there is a load between DO1 and V+.
++** DO1 LED is OFF in both cases.
--**LT22222-L:**
--
--* [1] DI2 channel is high input and DI2 LED is ON;
--* [0] DI1 channel is low input;
--
--* [0] DO3 channel output state
--** DO3 is float in case no load between DO3 and V+.;
--** DO3 is high in case there is load between DO3 and V+.
--** DO3 LED is off in both case
--* [1] DO2 channel output is low and DO2 LED is ON.
--* [0] DO1 channel output state
--** DO1 is float in case no load between DO1 and V+.;
--** DO1 is high in case there is load between DO1 and V+.
--** DO1 LED is off in both case
--
  === 3.3.2 AT+MOD~=2, (Double DI Counting) ===
  (((
--**For LT-22222-L**: this mode the **DI1 and DI2** are used as counting pins.
++**For LT-22222-L**: In this mode, **DI1 and DI2** are used as counting pins.
  )))
  (((
--Total : 11 bytes payload
++The uplink payload is 11 bytes long.
  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
  |(% style="background-color:#4f81bd; color:white" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:white" %)**4**|(% style="background-color:#4f81bd; color:white" %)**4**|(% style="background-color:#4f81bd; color:white" %)**1**|(% style="background-color:#4f81bd; color:white" %)**1**|(% style="background-color:#4f81bd; color:white" %)**1**
@@ -352,26 +352,26 @@
  )))
  (((
--(% style="color:#4f81bd" %)**DIDORO**(%%) is a combination for RO1, RO2, DO3, DO2 and DO1. Totally 1bytes as below
++(% style="color:#4f81bd" %)***DIDORO**(%%) is a combination of RO1, RO2, FIRST, Reserve, Reserve, DO3, DO2 and DO1, and its size is 1 byte long as shown below.
  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
--|**bit7**|**bit6**|**bit5**|**bit4**|**bit3**|**bit2**|**bit1**|**bit0**
--|RO1|RO2|FIRST|Reserve|Reserve|DO3|DO2|DO1
++|**bit 7**|**bit 6**|**bit 5**|**bit 4**|**bit 3**|**bit 2**|**bit 1**|**bit 0**
++|RO1|RO2|FIRST|Reserve|Reserve|--DO3--|DO2|DO1
--RO is for relay. ROx=1 : close , ROx=0 always open.
++* RO is for the relay. ROx=1: CLOSED,  ROx=0 always OPEN.
  )))
--* FIRST: Indicate this is the first packet after join network.
--* DO is for reverse digital output. DOx=1: output low, DOx=0: high or float.
++* FIRST: Indicates that this is the first packet after joining the network.
++* DO is for reverse digital output. DOx=1: LOW, DOx=0: HIGH or FLOATING.
  (((
--(% style="color:red" %)**Note: DO3 bit is not valid for LT-22222-L.**
++(% style="color:red" %)**Note: DO3 bit is not valid for LT-22222-L**
  )))
  (((
--**To use counting mode, please run:**
++**To activate this mode, run the following AT commands:**
  )))
  (((
@@ -392,17 +392,17 @@
  (((
  **For LT22222-L:**
--(% style="color:blue" %)**AT+TRIG1=0,100**(%%)**    (set DI1 port to trigger on low level, valid signal is 100ms) **
++(% style="color:blue" %)**AT+TRIG1=0,100**(%%)** (sets the DI1 port to trigger on a LOW level. The valid signal duration is 100ms) **
--(% style="color:blue" %)**AT+TRIG1=1,100**(%%)**    (set DI1 port to trigger on high level, valid signal is 100ms ) **
++(% style="color:blue" %)**AT+TRIG1=1,100**(%%)** (sets the DI1 port to trigger on a HIGH level. The valid signal duration is 100ms) **
--(% style="color:blue" %)**AT+TRIG2=0,100**(%%)**    (set DI2 port to trigger on low level, valid signal is 100ms) **
++(% style="color:blue" %)**AT+TRIG2=0,100**(%%)** (sets the DI2 port to trigger on a LOW level. The valid signal duration is 100ms) **
--(% style="color:blue" %)**AT+TRIG2=1,100**(%%)**    (set DI2 port to trigger on high level, valid signal is 100ms ) **
++(% style="color:blue" %)**AT+TRIG2=1,100**(%%)** (sets the DI2 port to trigger on a HIGH level. The valid signal duration is 100ms) **
--(% style="color:blue" %)**AT+SETCNT=1,60**(%%)**   (Set COUNT1 value to 60)**
++(% style="color:blue" %)**AT+SETCNT=1,60**(%%)** (sets the COUNT1 value to 60)**
--(% style="color:blue" %)**AT+SETCNT=2,60**(%%)**   (Set COUNT2 value to 60)**
++(% style="color:blue" %)**AT+SETCNT=2,60 **(%%)**(sets the COUNT2 value to 60)**
  )))
@@ -409,7 +409,7 @@
  === 3.3.3 AT+MOD~=3, Single DI Counting + 2 x ACI ===
--**LT22222-L**: This mode the DI1 is used as a counting pin.
++**LT22222-L**: In this mode, the DI1 is used as a counting pin.
  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
  |(% style="background-color:#4f81bd; color:white" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:white" %)**4**|(% style="background-color:#4f81bd; color:white" %)**2**|(% style="background-color:#4f81bd; color:white" %)**2**|(% style="background-color:#4f81bd; color:white" %)**1**|(% style="background-color:#4f81bd; color:white" %)**1**|(% style="background-color:#4f81bd; color:white" %)**1**
@@ -420,24 +420,24 @@
  )))|DIDORO*|Reserve|MOD
  (((
--(% style="color:#4f81bd" %)**DIDORO**(%%) is a combination for RO1, RO2, DI3, DI2, DI1, DO3, DO2 and DO1. Totally 1bytes as below
++(% style="color:#4f81bd" %)***DIDORO**(%%) is a combination of RO1, RO2, DI3, DI2, DI1, DO3, DO2 and DO1, for a total of 1 byte, as shown below.
  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
--|**bit7**|**bit6**|**bit5**|**bit4**|**bit3**|**bit2**|**bit1**|**bit0**
--|RO1|RO2|FIRST|Reserve|Reserve|DO3|DO2|DO1
++|**bit 7**|**bit 6**|**bit 5**|**bit 4**|**bit 3**|**bit 2**|**bit 1**|**bit 0**
++|RO1|RO2|FIRST|Reserve|Reserve|--DO3--|DO2|DO1
  )))
--* RO is for relay. ROx=1 : close, ROx=0 always open.
--* FIRST: Indicate this is the first packet after join network.
--* DO is for reverse digital output. DOx=1: output low, DOx=0: high or float.
++* RO is for the relay. ROx=1: closed, ROx=0 always open.
++* FIRST: Indicates that this is the first packet after joining the network.
++* DO is for reverse digital output. DOx=1: output low, DOx=0: high or floating.
  (((
--(% style="color:red" %)**Note: DO3 is not valid for LT-22222-L.**
++(% style="color:red" %)**Note: DO3 bit is not valid for LT-22222-L.**
  )))
  (((
--**To use counting mode, please run:**
++**To activate this mode, run the following AT commands:**
  )))
  (((
@@ -450,7 +450,9 @@
  )))
  (((
--Other AT Commands for counting are similar to [[MOD2 Counting Command>>||anchor="H3.3.2AT2BMOD3D22C28DoubleDICounting29"]].
++AT Commands for counting:
++
++The AT Commands for counting are similar to the [[MOD2 Counting Command>>||anchor="H3.3.2AT2BMOD3D22C28DoubleDICounting29"]]s.
  )))
@@ -458,11 +458,11 @@
  (((
--**LT22222-L**: This mode the DI1 is used as a counting pin.
++**LT22222-L**: In this mode, the DI1 is used as a counting pin.
  )))
  (((
--The AVI1 is also used for counting. AVI1 is used to monitor the voltage. It will check the voltage **every 60s**, if voltage is higher or lower than VOLMAX mV, the AVI1 Counting increase 1, so AVI1 counting can be used to measure a machine working hour.
++The AVI1 is also used for counting. It monitors the voltage and checks it every **60 seconds**. If the voltage is higher or lower than VOLMAX mV, the AVI1 count increases by 1, allowing AVI1 counting to be used to measure a machine's working hours.
  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
  |(% style="background-color:#4f81bd; color:white" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:white" %)**4**|(% style="background-color:#4f81bd; color:white" %)**4**|(% style="background-color:#4f81bd; color:white" %)**1**|(% style="background-color:#4f81bd; color:white" %)**1**|(% style="background-color:#4f81bd; color:white" %)**1**
@@ -472,25 +472,25 @@
  )))
  (((
--(% style="color:#4f81bd" %)**DIDORO **(%%)is a combination for RO1, RO2, DI3, DI2, DI1, DO3, DO2 and DO1. Totally 1bytes as below
++(% style="color:#4f81bd" %)**DIDORO **(%%)is a combination of RO1, RO2, DI3, DI2, DI1, DO3, DO2 and DO1, for a total of 1 byte, as shown below.
  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
--|**bit7**|**bit6**|**bit5**|**bit4**|**bit3**|**bit2**|**bit1**|**bit0**
--|RO1|RO2|FIRST|Reserve|Reserve|DO3|DO2|DO1
++|**bit 7**|**bit 6**|**bit 5**|**bit 4**|**bit 3**|**bit 2**|**bit 1**|**bit 0**
++|RO1|RO2|FIRST|Reserve|Reserve|--DO3--|DO2|DO1
  )))
--* RO is for relay. ROx=1 : close, ROx=0 always open.
--* FIRST: Indicate this is the first packet after join network.
--* DO is for reverse digital output. DOx=1: output low, DOx=0: high or float.
++* RO is for the relay. ROx=1: closed, ROx=0 always open.
++* FIRST: Indicates that this is the first packet after joining the network.
++* DO is for reverse digital output. DOx=1: output low, DOx=0: high or floating.
  (((
--(% style="color:red" %)**Note: DO3 is not valid for LT-22222-L.**
++(% style="color:red" %)**Note: DO3 bit is not valid for LT-22222-L.**
  )))
  (((
--**To use this mode, please run:**
++**To activate this mode, run the following AT commands:**
  )))
  (((
@@ -503,19 +503,19 @@
  )))
  (((
--Other AT Commands for counting are similar to [[MOD2 Counting Command>>||anchor="H3.3.2AT2BMOD3D22C28DoubleDICounting29"]].
++Other AT Commands for counting are similar to the [[MOD2 Counting Command>>||anchor="H3.3.2AT2BMOD3D22C28DoubleDICounting29"]]s.
  )))
  (((
--**Plus below command for AVI1 Counting:**
++**In addition to that,  below are the commands for AVI1 Counting:**
--(% style="color:blue" %)**AT+SETCNT=3,60**(%%)**            (set AVI Count to 60)**
++(% style="color:blue" %)**AT+SETCNT=3,60**(%%)**           (Sets AVI Count to 60)**
  (% style="color:blue" %)**AT+VOLMAX=20000**(%%)**       (If AVI1 voltage higher than VOLMAX (20000mV =20v), counter increase 1)**
  (% style="color:blue" %)**AT+VOLMAX=20000,0**(%%)**    (If AVI1 voltage lower than VOLMAX (20000mV =20v), counter increase 1)**
--(% style="color:blue" %)**AT+VOLMAX=20000,1**(%%)**    (If AVI1 voltage higer than VOLMAX (20000mV =20v), counter increase 1)**
++(% style="color:blue" %)**AT+VOLMAX=20000,1**(%%)**    (If AVI1 voltage higher than VOLMAX (20000mV =20v), counter increase 1)**
  )))
@@ -522,7 +522,7 @@
  === 3.3.5 AT+MOD~=5, Single DI Counting + 2 x AVI + 1 x ACI ===
--**LT22222-L**: This mode the DI1 is used as a counting pin.
++**LT22222-L**: In this mode, the DI1 is used as a counting pin.
  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
  |(% style="background-color:#4f81bd; color:white" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:white" %)**2**|(% style="background-color:#4f81bd; color:white" %)**2**|(% style="background-color:#4f81bd; color:white" %)**2**|(% style="background-color:#4f81bd; color:white" %)**2**|(% style="background-color:#4f81bd; color:white" %)**1**|(% style="background-color:#4f81bd; color:white" %)**1**|(% style="background-color:#4f81bd; color:white" %)**1**
@@ -537,25 +537,25 @@
  )))|MOD
  (((
--(% style="color:#4f81bd" %)**DIDORO**(%%) is a combination for RO1, RO2, DI3, DI2, DI1, DO3, DO2 and DO1. Totally 1bytes as below
++(% style="color:#4f81bd" %)**DIDORO**(%%) is a combination of RO1, RO2, DI3, DI2, DI1, DO3, DO2 and DO1, for a total of 1 byte, as shown below.
  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
--|**bit7**|**bit6**|**bit5**|**bit4**|**bit3**|**bit2**|**bit1**|**bit0**
++|**bit 7**|**bit 6**|**bit 5**|**bit 4**|**bit 3**|**bit 2**|**bit 1**|**bit 0**
  |RO1|RO2|FIRST|Reserve|Reserve|DO3|DO2|DO1
  )))
--* RO is for relay. ROx=1 : close, ROx=0 always open.
--* FIRST: Indicate this is the first packet after join network.
++* RO is for the relay. ROx=1: closed, ROx=0 always open.
++* FIRST: Indicates that this is the first packet after joining the network.
  * (((
--DO is for reverse digital output. DOx=1: output low, DOx=0: high or float.
++DO is for reverse digital output. DOx=1: output low, DOx=0: high or floating.
  )))
  (((
--(% style="color:red" %)**Note: DO3 is not valid for LT-22222-L.**
++(% style="color:red" %)**Note: DO3 bit is not valid for LT-22222-L.**
  )))
  (((
--**To use this mode, please run:**
++**To activate this mode, run the following AT commands:**
  )))
  (((
@@ -568,7 +568,7 @@
  )))
  (((
--Other AT Commands for counting are similar to [[MOD2 Counting Command>>||anchor="H3.3.2AT2BMOD3D22C28DoubleDICounting29"]].
++Other AT Commands for counting are similar to the [[MOD2 Counting Command>>||anchor="H3.3.2AT2BMOD3D22C28DoubleDICounting29"]]s.
  )))
@@ -575,49 +575,46 @@
  === 3.3.6 AT+ADDMOD~=6. (Trigger Mode, Optional) ===
--(% style="color:#4f81bd" %)**This mode is an optional mode for trigger purpose. It can run together with other mode.**
++(% style="color:#4f81bd" %)**This mode is optional and intended for trigger purposes. It can operate together with other modes.**
--For example, if user has configured below commands:
++For example, if you configured the following commands:
  * **AT+MOD=1 **            **~-~->**   The normal working mode
--* **AT+ADDMOD6=1**   **~-~->**   Enable trigger
++* **AT+ADDMOD6=1**   **~-~->**   Enable trigger mode
--LT will keep monitoring AV1/AV2/AC1/AC2 every 5 seconds; LT will send uplink packets in two cases:
++The LT-22222-L will continuously monitor AV1, AV2, AC1, and AC2 every 5 seconds. LT will send uplink packets in two cases:
--1. Periodically uplink (Base on TDC time). Payload is same as the normal MOD (MOD 1 for above command). This uplink uses LoRaWAN (% style="color:#4f81bd" %)**unconfirmed**(%%) data type
--1. Trigger uplink when meet the trigger condition. LT will sent two packets in this case, the first uplink use payload specify in this mod (mod=6), the second packets use the normal mod payload(MOD=1 for above settings). Both Uplinks use LoRaWAN (% style="color:#4f81bd" %)**CONFIRMED data type.**
++1. Periodically uplink (Based on TDC time). The payload is the same as in normal mode (MOD=1 for the commands above). These are (% style="color:#4f81bd" %)**unconfirmed**(%%) uplinks.
++1. Trigger uplink when the trigger condition is met. LT will send two packets in this case. The first uplink uses the payload specified in trigger mode (MOD=6). The second packet uses the normal mode payload (MOD=1 as set above). Both are (% style="color:#4f81bd" %)**CONFIRMED uplinks.**
  (% style="color:#037691" %)**AT Command to set Trigger Condition**:
++(% style="color:#4f81bd" %)**Trigger based on voltage**:
--(% style="color:#4f81bd" %)**Trigger base on voltage**:
--
  Format: AT+AVLIM=<AV1_LIMIT_LOW>,< AV1_LIMIT_HIGH>,<AV2_LIMIT_LOW>,< AV2_LIMIT_HIGH>
  **Example:**
--AT+AVLIM=3000,6000,0,2000   (If AVI1 voltage lower than 3v or higher than 6v.  or AV2 voltage is higher than 2v, LT will trigger Uplink)
++AT+AVLIM=3000,6000,0,2000   (triggers an uplink if AVI1 voltage is lower than 3V or higher than 6V, or if AV2 voltage is higher than 2V)
--AT+AVLIM=5000,0,0,0   (If AVI1 voltage lower than 5V , trigger uplink, 0 means ignore)
++AT+AVLIM=5000,0,0,0   (triggers an uplink if AVI1 voltage lower than 5V. Use 0 for parameters that are not in use)
++(% style="color:#4f81bd" %)**Trigger based on current**:
--(% style="color:#4f81bd" %)**Trigger base on current**:
--
  Format: AT+ACLIM=<AC1_LIMIT_LOW>,< AC1_LIMIT_HIGH>,<AC2_LIMIT_LOW>,< AC2_LIMIT_HIGH>
  **Example:**
--AT+ACLIM=10000,15000,0,0   (If ACI1 voltage lower than 10mA or higher than 15mA, trigger an uplink)
++AT+ACLIM=10000,15000,0,0   (triggers an uplink if ACI1 voltage is lower than 10mA or higher than 15mA)
++(% style="color:#4f81bd" %)**Trigger based on DI status**:
--(% style="color:#4f81bd" %)**Trigger base on DI status**:
++DI status triggers Flag.
--DI status trigger Flag.
--
  Format: AT+DTRI=<DI1_TIRGGER_FlAG>,< DI2_TIRGGER_FlAG >
@@ -626,39 +626,38 @@
  AT+ DTRI =1,0   (Enable DI1 trigger / disable DI2 trigger)
--(% style="color:#037691" %)**Downlink Command to set Trigger Condition:**
++(% style="color:#037691" %)**LoRaWAN Downlink Commands for Setting the Trigger Conditions:**
  Type Code: 0xAA. Downlink command same as AT Command **AT+AVLIM, AT+ACLIM**
  Format: AA xx yy1 yy1 yy2 yy2 yy3 yy3 yy4 yy4
--  AA: Code for this downlink Command:
++  AA: Type Code for this downlink Command:
--  xx: 0: Limit for AV1 and AV2;  1: limit for AC1 and AC2 ; 2 DI1, DI2 trigger enable/disable
++  xx: **0**: Limit for AV1 and AV2; **1**: limit for AC1 and AC2; **2**: DI1and DI2 trigger enable/disable.
--  yy1 yy1: AC1 or AV1 low limit or DI1/DI2 trigger status.
++  yy1 yy1: AC1 or AV1 LOW limit or DI1/DI2 trigger status.
--  yy2 yy2: AC1 or AV1 high limit.
++  yy2 yy2: AC1 or AV1 HIGH limit.
--  yy3 yy3: AC2 or AV2 low limit.
++  yy3 yy3: AC2 or AV2 LOW limit.
--  Yy4 yy4: AC2 or AV2 high limit.
++  Yy4 yy4: AC2 or AV2 HIGH limit.
--**Example1**: AA 00 13 88 00 00 00 00 00 00
++**Example 1**: AA 00 13 88 00 00 00 00 00 00
--Same as AT+AVLIM=5000,0,0,0   (If AVI1 voltage lower than 5V , trigger uplink, 0 means ignore)
++Same as AT+AVLIM=5000,0,0,0 (triggers an uplink if AVI1 voltage is lower than 5V. Use 0s for parameters that are not in use)
--**Example2**: AA 02 01 00
++**Example 2**: AA 02 01 00
--Same as AT+ DTRI =1,0  (Enable DI1 trigger / disable DI2 trigger)
++Same as AT+ DTRI =1,0 (Enable DI1 trigger / disable DI2 trigger)
--
  (% style="color:#4f81bd" %)**Trigger Settings Payload Explanation:**
--MOD6 Payload : total 11 bytes payload
++MOD6 Payload: total of 11 bytes
  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
  |(% style="background-color:#4f81bd; color:white; width:60px" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:white; width:69px" %)**1**|(% style="background-color:#4f81bd; color:white; width:69px" %)**1**|(% style="background-color:#4f81bd; color:white; width:109px" %)**1**|(% style="background-color:#4f81bd; color:white; width:49px" %)**6**|(% style="background-color:#4f81bd; color:white; width:109px" %)**1**|(% style="background-color:#4f81bd; color:white; width:50px" %)**1**
@@ -672,10 +672,10 @@
  MOD(6)
  )))
--(% style="color:#4f81bd" %)**TRI FLAG1**(%%) is a combination to show if trigger is set for this part. Totally 1byte as below
++(% style="color:#4f81bd" %)**TRI FLAG1**(%%) is a combination to show if the trigger is set for this part. Totally 1 byte as below
  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
--|**bit7**|**bit6**|**bit5**|**bit4**|**bit3**|**bit2**|**bit1**|**bit0**
++|**bit 7**|**bit 6**|**bit 5**|**bit 4**|**bit 3**|**bit 2**|**bit 1**|**bit 0**
  |(((
  AV1_LOW
  )))|(((
@@ -694,17 +694,17 @@
  AC2_HIGH
  )))
--* Each bits shows if the corresponding trigger has been configured.
++* Each bit shows if the corresponding trigger has been configured.
  **Example:**
--10100000: Means the system has configure to use the trigger: AC1_LOW and AV2_LOW
++10100000: Means the system has configure to use the trigger: AV1_LOW and AV2_LOW
--(% style="color:#4f81bd" %)**TRI Status1**(%%) is a combination to show which condition is trigger. Totally 1byte as below
++(% style="color:#4f81bd" %)**TRI Status1**(%%) is a combination to show which condition is trigger. Totally 1 byte as below
  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
--|**bit7**|**bit6**|**bit5**|**bit4**|**bit3**|**bit2**|**bit1**|**bit0**
++|**bit 7**|**bit 6**|**bit 5**|**bit 4**|**bit 3**|**bit 2**|**bit 1**|**bit 0**
  |(((
  AV1_LOW
  )))|(((
@@ -723,11 +723,11 @@
  AC2_HIGH
  )))
--* Each bits shows which status has been trigger on this uplink.
++* Each bit shows which status has been triggered on this uplink.
  **Example:**
--10000000: Means this packet is trigger by AC1_LOW. Means voltage too low.
++10000000: Means this uplink is triggered by AV1_LOW. That means the voltage is too low.
  (% style="color:#4f81bd" %)**TRI_DI FLAG+STA **(%%)is a combination to show which condition is trigger. Totally 1byte as below
@@ -736,7 +736,7 @@
  |**bit7**|**bit6**|**bit5**|**bit4**|**bit3**|**bit2**|**bit1**|**bit0**
  |N/A|N/A|N/A|N/A|DI2_STATUS|DI2_FLAG|DI1_STATUS|DI1_FLAG
--* Each bits shows which status has been trigger on this uplink.
++* Each bits shows which status has been triggered on this uplink.
  **Example:**
@@ -763,11 +763,11 @@
  )))
--== 3.4 Configure LT via AT or Downlink ==
++== 3.4 Configure LT via AT Commands or Downlinks ==
  (((
--User can configure LT I/O Controller via AT Commands or LoRaWAN Downlink Commands
++User can configure LT I/O Controller via AT Commands or LoRaWAN Downlinks.
  )))
  (((
@@ -782,9 +782,8 @@
  === 3.4.1 Common Commands ===
--
  (((
--They should be available for each of Dragino Sensors, such as: change uplink interval, reset device. For firmware v1.5.4, user can find what common commands it supports: [[End Device AT Commands and Downlink Command>>doc:Main.End Device AT Commands and Downlink Command.WebHome]]
++These commands should be available for all Dragino sensors, such as changing the uplink interval or resetting the device. For firmware v1.5.4, you can find the supported common commands under [[End Device AT Commands and Downlink Command>>doc:Main.End Device AT Commands and Downlink Command.WebHome]].
  )))
@@ -792,34 +792,37 @@
  ==== 3.4.2.1 Set Transmit Interval ====
++Sets the uplink interval of the device. The default uplink transmission interval is 10 minutes.
--Set device uplink interval.
++* (% style="color:#037691" %)**AT command:**
--* (% style="color:#037691" %)**AT Command:**
++(% style="color:blue" %)**AT+TDC=N**
--(% style="color:blue" %)**AT+TDC=N **
++where N is the time in milliseconds.
++**Example: **AT+TDC=30000. This will set the uplink interval to 30 seconds
--**Example: **AT+TDC=30000. Means set interval to 30 seconds
++* (% style="color:#037691" %)**Downlink payload (prefix 0x01):**
--* (% style="color:#037691" %)**Downlink Payload (prefix 0x01):**
--
  (% style="color:blue" %)**0x01 aa bb cc  **(%%)**   ~/~/ Same as AT+TDC=0x(aa bb cc)**
--==== 3.4.2.2 Set Work Mode (AT+MOD) ====
++==== 3.4.2.2 Set the Work Mode (AT+MOD) ====
--Set work mode.
++Sets the work mode.
--* (% style="color:#037691" %)**AT Command:**(%%) (% style="color:blue" %)**AT+MOD=N  **
++* (% style="color:#037691" %)**AT command:**(%%) (% style="color:blue" %)**AT+MOD=N  **
--**Example**: AT+MOD=2. Set work mode to Double DI counting mode
++Where N is the work mode.
--* (% style="color:#037691" %)**Downlink Payload (prefix 0x0A):**
++**Example**: AT+MOD=2. This will set the work mode to Double DI counting mode.
++
++* (% style="color:#037691" %)**Downlink payload (prefix 0x0A):**
++
  (% style="color:blue" %)**0x0A aa  **(%%)**  ** ~/~/ Same as AT+MOD=aa
@@ -827,10 +827,12 @@
  ==== 3.4.2.3 Poll an uplink ====
--* (% style="color:#037691" %)**AT Command:**(%%) There is no AT Command to poll uplink
++Asks the device to send an uplink.
--* (% style="color:#037691" %)**Downlink Payload (prefix 0x08):**
++* (% style="color:#037691" %)**AT command:**(%%) There is no AT Command to poll uplink
++* (% style="color:#037691" %)**Downlink payload (prefix 0x08):**
++
  (% style="color:blue" %)**0x08 FF  **(%%)**   **~/~/ Poll an uplink
  **Example**: 0x08FF, ask device to send an Uplink
@@ -837,16 +837,16 @@
--==== 3.4.2.4 Enable Trigger Mode ====
++==== 3.4.2.4 Enable/Disable Trigger Mode ====
--Use of trigger mode, please check [[ADDMOD6>>||anchor="H3.3.6AT2BADDMOD3D6.28TriggerMode2COptional29"]]
++Enable or disable the trigger mode (see also [[ADDMOD6>>||anchor="H3.3.6AT2BADDMOD3D6.28TriggerMode2COptional29"]]).
  * (% style="color:#037691" %)**AT Command:**(%%) (% style="color:blue" %)**AT+ADDMOD6=1 or 0**
--(% style="color:red" %)**1:** (%%)Enable Trigger Mode
++(% style="color:red" %)**1:** (%%)Enable the trigger mode
--(% style="color:red" %)**0: **(%%)Disable Trigger Mode
++(% style="color:red" %)**0: **(%%)Disable the trigger mode
  * (% style="color:#037691" %)**Downlink Payload (prefix 0x0A 06):**
@@ -858,7 +858,7 @@
  ==== 3.4.2.5 Poll trigger settings ====
--Poll trigger settings
++Polls the trigger settings
  * (% style="color:#037691" %)**AT Command:**
@@ -866,7 +866,7 @@
  * (% style="color:#037691" %)**Downlink Payload (prefix 0x AB 06):**
--(% style="color:blue" %)**0xAB 06  **  (%%)   ~/~/ Poll trigger settings, device will uplink trigger settings once receive this command
++(% style="color:blue" %)**0xAB 06  **  (%%)   ~/~/ Poll the trigger settings. Device will uplink trigger settings once receive this command
@@ -873,11 +873,11 @@
  ==== 3.4.2.6 Enable / Disable DI1/DI2/DI3 as trigger ====
--Enable Disable DI1/DI2/DI2 as trigger,
++Enable or Disable DI1/DI2/DI2 as trigger,
  * (% style="color:#037691" %)**AT Command:**(%%) (% style="color:blue" %)**Format: AT+DTRI=<DI1_TIRGGER_FlAG>,< DI2_TIRGGER_FlAG >**
--**Example:** AT+ DTRI =1,0   (Enable DI1 trigger / disable DI2 trigger)
++**Example:** AT+ DTRI =1,0 (Enable DI1 trigger / disable DI2 trigger)
  * (% style="color:#037691" %)**Downlink Payload (prefix 0xAA 02):**
@@ -909,15 +909,15 @@
  ==== 3.4.2.8 Trigger2 – Set DI2 as trigger ====
--Set DI2 trigger.
++Sets DI2 trigger.
  * (% style="color:#037691" %)**AT Command:**(%%) (% style="color:blue" %)**AT+TRIG2=a,b**
--(% style="color:red" %)**a :** (%%)Interrupt mode. 0: falling edge; 1: rising edge, 2: falling and raising edge(for MOD=1).
++(% style="color:red" %)**a :** (%%)Interrupt mode. 0: falling edge; 1: rising edge, 2: falling and raising edge (for MOD=1).
  (% style="color:red" %)**b :** (%%)delay timing.
--**Example:** AT+TRIG2=0,100(set DI1 port to trigger on low level, valid signal is 100ms )
++**Example:** AT+TRIG2=0,100 (set DI1 port to trigger on low level, valid signal is 100ms )
  * (% style="color:#037691" %)**Downlink Payload (prefix 0x09 02 ):**
@@ -955,7 +955,7 @@
  ==== 3.4.2.11 Trigger – Set minimum interval ====
--Set AV and AC trigger minimum interval, system won't response to the second trigger within this set time after the first trigger.
++Sets AV and AC trigger minimum interval.  Device won't response to the second trigger within this set time after the first trigger.
  * (% style="color:#037691" %)**AT Command**(%%): (% style="color:blue" %)**AT+ATDC=5        ** ~/~/ (%%)Device won't response the second trigger within 5 minute after the first trigger.
@@ -1103,7 +1103,7 @@
  )))
  (((
--00: Close ,  01: Open , 11: No action
++00: Closed ,  01: Open , 11: No action
  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:320px" %)
  |(% style="background-color:#4f81bd; color:white" %)**Downlink Code**|(% style="background-color:#4f81bd; color:white" %)**RO1**|(% style="background-color:#4f81bd; color:white" %)**RO2**
@@ -1225,7 +1225,7 @@
--==== 3.4.2.19 Counting ~-~- Change counting mode save time ====
++==== 3.4.2.19 Counting ~-~- Change counting mode to save time ====
  * (% style="color:#037691" %)**AT Command:**
@@ -1348,89 +1348,142 @@
  == 3.5 Integrating with ThingsEye.io ==
--If you are using one of The Things Stack plans, you can integrate ThingsEye.io with your application. Once integrated, ThingsEye.io works as an MQTT client for The Things Stack MQTT broker, allowing it to subscribe to upstream traffic and publish downlink traffic.
++The Things Stack applications can be integrated with ThingsEye.io. Once integrated, ThingsEye.io works as an MQTT client for The Things Stack MQTT broker, allowing it to subscribe to upstream traffic and publish downlink traffic.
--=== 3.5.1 Configuring The Things Stack Sandbox ===
++=== 3.5.1 Configuring MQTT Connection Information with The Things Stack Sandbox ===
--* Go to your Application and select MQTT under Integrations.
--* In the Connection credentials section, under Username, The Thins Stack displays an auto-generated username. You can use it or provide a new one.
--* For the Password, click the Generate new API key button to generate a password. You can see it by clicking on the eye button.
++We use The Things Stack Sandbox for demonstating the configuration but  other
++* In **The Things Stack Sandbox**, select your application under **Applications**.
++* Select **MQTT** under **Integrations**.
++* In the **Connection information **section, for **Username**, The Things Stack displays an auto-generated username. You can use it or provide a new one.
++* For the **Password**, click the **Generate new API key** button to generate a password. You can see it by clicking on the **eye** button. The API key works as the password.
++
++NOTE. The username and  password (API key) you created here are required in the next section.
++
  [[image:tts-mqtt-integration.png||height="625" width="1000"]]
  === 3.5.2 Configuring ThingsEye.io ===
--* Login to your thingsEye.io account.
--* Under the Integrations center, click Integrations.
--* Click the Add integration button (the button with the + symbol).
++This section guides you on how to create an integration in ThingsEye to connect with The Things Stack MQTT server.
++* Login to your [[ThingsEye.io >>https://thingseye.io]]account.
++* Under the **Integrations center**, click **Integrations**.
++* Click the **Add integration** button (the button with the **+** symbol).
++
  [[image:thingseye-io-step-1.png||height="625" width="1000"]]
--On the Add integration page configure the following:
++On the **Add integration** window, configure the following:
--Basic settings:
++**Basic settings:**
--* Select The Things Stack Community from the Integration type list.
--* Enter a suitable name for your integration in the Name box or keep the default name.
--* Click the Next button.
++* Select **The Things Stack Community** from the **Integration type** list.
++* Enter a suitable name for your integration in the **Name **text** **box or keep the default name.
++* Ensure the following options are turned on.
++** Enable integration
++** Debug mode
++** Allow create devices or assets
++* Click the **Next** button. you will be navigated to the **Uplink data converter** tab.
  [[image:thingseye-io-step-2.png||height="625" width="1000"]]
--Uplink Data converter:
--* Click the Create New button if it is not selected by default.
--* Click the JavaScript button.
--* Paste the uplink decoder function into the text area (first, delete the default code). The demo decoder function can be found here.
--* Click the Next button.
++**Uplink data converter:**
++* Click the **Create new** button if it is not selected by default.
++* Enter a suitable name for the uplink data converter in the **Name **text** **box or keep the default name.
++* Click the **JavaScript** button.
++* Paste the uplink decoder function into the text area (first, delete the default code). The demo uplink decoder function can be found [[here>>https://raw.githubusercontent.com/ThingsEye-io/te-platform/refs/heads/main/Data%20Converters/The_Things_Network_MQTT_Uplink_Converter.js]].
++* Click the **Next** button. You will be navigated to the **Downlink data converter **tab.
++
  [[image:thingseye-io-step-3.png||height="625" width="1000"]]
--Downlink Data converter (this is an optional step):
--* Click the Create new button if it is not selected by default.
--* Click the JavaScript button.
--* Paste the downlink decoder function into the text area (first, delete the default code). The demo decoder function can be found here.
--* Click the Next button.
++**Downlink data converter (this is an optional step):**
++* Click the **Create new** button if it is not selected by default.
++* Enter a suitable name for the downlink data converter in the **Name **text** **box or keep the default name
++* Click the **JavaScript** button.
++* Paste the downlink decoder function into the text area (first, delete the default code). The demo downlink decoder function can be found here.
++* Click the **Next** button. You will be navigated to the **Connection** tab.
++
  [[image:thingseye-io-step-4.png||height="625" width="1000"]]
--Connection:
--* Choose Region from the Host type.
--* Enter the cluster of your The Things Stack in the Region textbox.
--* Enter the Username and Password in the Credentials section. Use the same username and password you created with the MQTT page of The Things Stack.
--* Click Check connection to test the connection. If the connection is successful, you can see the message saying Connected.
--* Click the Add button.
++**Connection:**
++* Choose **Region** from the **Host type**.
++* Enter the **cluster** of your **The Things Stack** in the **Region** textbox. You can find the cluster in the url (e.g., https:~/~/**eu1**.cloud.thethings.network/...).
++* Enter the **Username** and **Password** of the MQTT integration in the **Credentials** section. The username and password can be found on the MQTT integration page of your The Things Stack account (see Configuring MQTT Connection information with The Things Stack Sandbox).
++* Click the **Check connection** button to test the connection. If the connection is successful, you will see the message saying **Connected**.
++
++[[image:message-1.png]]
++
++
++* Click the **Add** button.
++
  [[image:thingseye-io-step-5.png||height="625" width="1000"]]
--Your integration is added to the integrations list and it will display on the Integrations page.
++Your integration has been added to the** Integrations** list and will be displayed on the **Integrations** page. Check whether the status is shown as **Active**. If not, review your configuration settings.
--[[image:thingseye-io-step-6.png||height="625" width="1000"]]
++[[image:thingseye.io_integrationsCenter_integrations.png||height="686" width="1000"]]
--== 3.6 Interface Detail ==
++**Viewing integration details**:
++
++Click on your integration from the list. The Integration details window will appear with the Details tab selected. The Details tab shows all the settings you have provided for this integration.
++
++[[image:integration-details.png||height="686" width="1000"]]
++
++
++If you want to edit the settings you have provided, click on the **Toggle edit mode** button. Once you have done click on the **Apply changes **button.
++
++Note: See also ThingsEye documentation.
++
++
++**Viewing events:**
++
++This tab  displays all the uplink messages from the LT-22222-L.
++
++* Click on the **Events **tab.
++* Select **Debug **from the **Event type** dropdown.
++* Select the** time frame** from the **time window**.
++
++[insert image]
++
++- To view the JSON payload of a message, click on the three dots (...) in the Message column of the desired message.
++
++[insert image]
++
++
++**Deleting the integration**:
++
++If you want to delete this integration, click the **Delete integratio**n button.
++
++
++== 3.6 Interface Details ==
++
  === 3.6.1 Digital Input Port: DI1/DI2 /DI3 ( For LT-33222-L, low active ) ===
--Support NPN Type sensor
++Support NPN-type sensor
  [[image:1653356991268-289.png]]
--=== 3.6.2 Digital Input Port: DI1/DI2 ( For LT-22222-L) ===
++=== 3.6.2 Digital Input Ports: DI1/DI2 ( For LT-22222-L) ===
  (((
--The DI port of LT-22222-L can support **NPN** or **PNP** or **Dry Contact** output sensor.
++The DI ports of the LT-22222-L can support **NPN**, **PNP**, or **dry contact** output sensors.
  )))
  (((
  (((
--Internal circuit as below, the NEC2501 is a photocoupler, the Active current (from NEC2501 pin 1 to pin 2 is 1ma and the max current is 50mA). (% class="mark" %)When there is active current pass NEC2501 pin1 to pin2. The DI will be active high and DI LED status will change.
++The part of the internal circuit of the LT-22222-L shown below includes the NEC2501 photocoupler. The active current from NEC2501 pin 1 to pin 2 is 1 mA, with a maximum allowable current of 50 mA. When active current flows from NEC2501 pin 1 to pin 2, the DI becomes active HIGH and the DI LED status changes.
  )))
@@ -1440,7 +1440,7 @@
  (((
  (((
--When use need to connect a device to the DI port, both DI1+ and DI1- must be connected.
++(% style="color:#000000; font-family:Arial,sans-serif; font-size:11pt; font-style:normal; font-variant-alternates:normal; font-variant-east-asian:normal; font-variant-ligatures:normal; font-variant-numeric:normal; font-variant-position:normal; font-weight:400; text-decoration:none; white-space:pre-wrap" %)When connecting a device to the DI port, both DI1+ and DI1- must be connected.
  )))
  )))
@@ -1449,22 +1449,22 @@
  )))
  (((
--(% style="color:blue" %)**Example1**(%%): Connect to a Low active sensor.
++(% style="color:#0000ff" %)**Example 1**(%%): Connecting to a low-active sensor.
  )))
  (((
--This type of sensor will output a low signal GND when active.
++This type of sensor outputs a low (GND) signal when active.
  )))
  * (((
--Connect sensor's output to DI1-
++Connect the sensor's output to DI1-
  )))
  * (((
--Connect sensor's VCC to DI1+.
++Connect the sensor's VCC to DI1+.
  )))
  (((
--So when sensor active, the current between NEC2501 pin1 and pin2 is：
++When the sensor is active, the current between NEC2501 pin 1 and pin 2 will be：
  )))
  (((
@@ -1472,7 +1472,7 @@
  )))
  (((
--If** DI1+ **= **12v**, the [[image:1653968155772-850.png||height="23" width="19"]]= 12mA , So the LT-22222-L will be able to detect this active signal.
++For example, if** DI1+ **= **12V**, the resulting current is [[image:1653968155772-850.png||height="23" width="19"]]= 12mA. Therefore, the LT-22222-L will be able to detect this active signal.
  )))
  (((
@@ -1480,22 +1480,22 @@
  )))
  (((
--(% style="color:blue" %)**Example2**(%%): Connect to a High active sensor.
++(% style="color:#0000ff" %)**Example 2**(%%): Connecting to a high-active sensor.
  )))
  (((
--This type of sensor will output a high signal (example 24v) when active.
++This type of sensor outputs a high signal (e.g., 24V) when active.
  )))
  * (((
--Connect sensor's output to DI1+
++Connect the sensor's output to DI1+
  )))
  * (((
--Connect sensor's GND DI1-.
++Connect the sensor's GND DI1-.
  )))
  (((
--So when sensor active, the current between NEC2501 pin1 and pin2 is:
++When the sensor is active, the current between NEC2501 pin1 and pin2 will be:
  )))
  (((
@@ -1503,7 +1503,7 @@
  )))
  (((
--If **DI1+ = 24v**, the[[image:1653968155772-850.png||height="23" width="19"]] 24mA , So the LT-22222-L will be able to detect this high active signal.
++If **DI1+ = 24V**, the resulting current[[image:1653968155772-850.png||height="23" width="19"]] is 24mA, Therefore, the LT-22222-L will detect this high-active signal.
  )))
  (((
@@ -1511,22 +1511,22 @@
  )))
  (((
--(% style="color:blue" %)**Example3**(%%): Connect to a 220v high active sensor.
++(% style="color:#0000ff" %)**Example 3**(%%): Connecting to a 220V high-active sensor.
  )))
  (((
--Assume user want to monitor an active signal higher than 220v, to make sure not burn the photocoupler
++Assume that you want to monitor an active signal higher than 220V without damaging the photocoupler
  )))
  * (((
--Connect sensor's output to DI1+ with a serial 50K resistor
++Connect the sensor's output to DI1+ with a 50K resistor in series.
  )))
  * (((
--Connect sensor's GND DI1-.
++Connect the sensor's GND DI1-.
  )))
  (((
--So when sensor active, the current between NEC2501 pin1 and pin2 is:
++When the sensor is active, the current between NEC2501 pin1 and pin2 will be:
  )))
  (((
@@ -1534,37 +1534,37 @@
  )))
  (((
--If sensor output is 220v, the [[image:1653968155772-850.png||height="23" width="19"]](% id="cke_bm_243359S" style="display:none" %)[[image:image-20220524095628-8.png]](%%) = DI1+ / 51K.  = 4.3mA , So the LT-22222-L will be able to detect this high active signal safely.
++If the sensor output is 220V, then [[image:1653968155772-850.png||height="23" width="19"]](% id="cke_bm_243359S" style="display:none" wfd-invisible="true" %)[[image:image-20220524095628-8.png]](%%) = DI1+ / 51K  = 4.3mA. Therefore, the LT-22222-L will be able to safely detect this high-active signal.
  )))
--(% style="color:blue" %)**Example4**(%%): Connect to Dry Contact sensor
++(% style="color:blue" %)**Example4**(%%): Connecting to Dry Contact sensor
--From above DI ports circuit, we can see that active the photocoupler will need to have a voltage difference between DI+ and DI- port. While the Dry Contact sensor is a passive component which can't provide this voltage difference.
++From the DI port circuit above, you can see that activating the photocoupler requires a voltage difference between the DI+ and DI- ports. However, the Dry Contact sensor is a passive component and cannot provide this voltage difference.
--To detect a Dry Contact, we can provide a power source to one pin of the Dry Contact. Below is a reference connection.
++To detect a Dry Contact, you can supply a power source to one pin of the Dry Contact. Below is a reference circuit diagram.
  [[image:image-20230616235145-1.png]]
--(% style="color:blue" %)**Example5**(%%): Connect to Open Colleactor
++(% style="color:blue" %)**Example5**(%%): Connecting to an Open Collector
  [[image:image-20240219115718-1.png]]
--=== 3.6.3 Digital Output Port: DO1/DO2 /DO3 ===
++=== 3.6.3 Digital Output Ports: DO1/DO2 /DO3 ===
--(% style="color:blue" %)**NPN output**(%%): GND or Float. Max voltage can apply to output pin is 36v.
++(% style="color:blue" %)**NPN output**(%%): GND or Float. The maximum voltage that can be applied to the output pin is 36V.
--(% style="color:red" %)**Note: DO pins go to float when device is power off.**
++(% style="color:red" %)**Note: The DO pins will float when the device is powered off.**
  [[image:1653357531600-905.png]]
--=== 3.6.4 Analog Input Interface ===
++=== 3.6.4 Analog Input Interfaces ===
--The analog input interface is as below. The LT will measure the IN2 voltage so to calculate the current pass the Load. The formula is:
++The analog input interface is shown below. The LT-22222-L will measure the IN2 voltage to calculate the current passing through the load. The formula is:
  (% style="color:blue" %)**AC2 = (IN2 voltage )/12**
@@ -1571,14 +1571,14 @@
  [[image:1653357592296-182.png]]
--Example to connect a 4~~20mA sensor
++Example:  Connecting a 4~~20mA sensor
--We take the wind speed sensor as an example for reference only.
++We will use the wind speed sensor as an example for reference only.
  (% style="color:blue" %)**Specifications of the wind speed sensor:**
--(% style="color:red" %)**Red:      12~~24v**
++(% style="color:red" %)**Red:      12~~24V**
  (% style="color:#ffc000" %)**Yellow:  4~~20mA**
@@ -1591,7 +1591,7 @@
  [[image:1653357648330-671.png||height="155" width="733"]]
--Example connected to a regulated power supply to measure voltage
++Example: Connecting to a regulated power supply to measure voltage
  [[image:image-20230608101532-1.png||height="606" width="447"]]
@@ -1600,7 +1600,7 @@
  [[image:image-20230608101722-3.png||height="102" width="1139"]]
--(% style="color:blue; font-weight:bold" %)**Specifications of the regulated power**(%%) (% style="color:blue" %)**:**
++(% style="color:blue; font-weight:bold" %)**Specifications of the regulated power supply**(% style="color:blue" %)**:**
  (% style="color:red" %)**Red:      12~~24v**
@@ -1611,9 +1611,9 @@
  (((
--The LT serial controller has two relay interfaces; each interface uses two pins of the screw terminal. User can connect other device's Power Line to in serial of RO1_1 and RO_2. Such as below:
++The LT-22222-L has two relay interfaces, RO1 and RO2, each using two pins of the screw terminal (ROx-1 and ROx-2 where x is the port number, 1 or 2). You can connect a device's power line in series with one of the relay interfaces (e.g., RO1-1 and RO1-2 screw terminals). See the example below:
--**Note**: RO pins go to Open(NO) when device is power off.
++**Note**: The ROx pins will be in the Open (NO) state when the LT-22222-L is powered off.
  )))
  [[image:image-20220524100215-9.png]]
@@ -1641,25 +1641,26 @@
  Transmit a LoRa packet: TX blinks once
  )))
  )))
--|**RX**|RX blinks once when receive a packet.
--|**DO1**|For LT-22222-L: ON when DO1 is low, LOW when DO1 is high
--|**DO2**|For LT-22222-L: ON when DO2 is low, LOW when DO2 is high
++|**RX**|RX blinks once when receiving a packet.
++|**DO1**|For LT-22222-L: ON when DO1 is low, OFF when DO1 is high
++|**DO2**|For LT-22222-L: ON when DO2 is low, OFF when DO2 is high
  |**DI1**|(((
--For LT-22222-L: ON when DI1 is high, LOW when DI1 is low
++For LT-22222-L: ON when DI1 is high, OFF when DI1 is low
  )))
  |**DI2**|(((
--For LT-22222-L: ON when DI2 is high, LOW when DI2 is low
++For LT-22222-L: ON when DI2 is high, OFF when DI2 is low
  )))
--|**RO1**|For LT-22222-L: ON when RO1 is closed, LOW when RO1 is open
--|**RO2**|For LT-22222-L: ON when RO2 is closed, LOW when RO2 is open
++|**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. Use AT Command =
++= 4. Using AT Commands =
--== 4.1 Access AT Command ==
++The LT-22222-L supports programming using AT Commands.
++== 4.1 Connecting the LT-22222-L to a PC ==
  (((
--LT supports AT Command set. User can use a USB to TTL adapter plus the 3.5mm Program Cable to connect to LT for using AT command, as below.
++You can use a USB-to-TTL adapter along with a 3.5mm Program Cable to connect the LT-22222-L to a PC, as shown below.
  )))
  [[image:1653358238933-385.png]]
@@ -1666,7 +1666,7 @@
  (((
--In PC, User needs to set (% style="color:#4f81bd" %)**serial tool**(%%)(such as [[putty>>url:https://www.chiark.greenend.org.uk/~~sgtatham/putty/latest.html]], SecureCRT) baud rate to (% style="color:green" %)**9600**(%%) to access to access serial console for LT. The AT commands are disable by default and need to enter password (default:(% style="color:green" %)**123456**)(%%) to active it. As shown below:
++On the PC, you need to set the (% style="color:#4f81bd" %)**serial tool **(%%)(such as [[PuTTY>>url:https://www.chiark.greenend.org.uk/~~sgtatham/putty/latest.html]] or [[SecureCRT>>https://www.vandyke.com/cgi-bin/releases.php?product=securecrt]]) to a baud rate of (% style="color:green" %)**9600**(%%) to access the serial console of LT-22222-L. Access to AT commands is disabled by default, and a password (default: (% style="color:green" %)**123456**)(%%) must be entered to enable AT command access, as shown below:
  )))
  [[image:1653358355238-883.png]]
@@ -1673,194 +1673,63 @@
  (((
--More detail AT Command manual can be found at [[AT Command Manual>>url:http://www.dragino.com/downloads/index.php?dir=LT_LoRa_IO_Controller/LT33222-L/]]
--)))
++You can find more details in the [[AT Command Manual>>url:http://www.dragino.com/downloads/index.php?dir=LT_LoRa_IO_Controller/LT33222-L/]]
--(((
--AT+<CMD>?        : Help on <CMD>
++== 4.2 LT-22222-L related AT commands ==
  )))
  (((
--AT+<CMD>         : Run <CMD>
--)))
++The following is the list of all the AT commands related to the LT-22222-L, except for those used for switching between work modes.
--(((
--AT+<CMD>=<value> : Set the value
++* AT+<CMD>? : Help on <CMD>
++* AT+<CMD> : Run <CMD>
++* AT+<CMD>=<value> : Set the value
++* AT+<CMD>=? : Get the value
++* ATZ: Trigger a reset of the MCU
++* ##**AT+FDR**##: Reset Parameters to factory default, reserve keys
++* **##AT+DEUI##**: Get or set the Device EUI (DevEUI)
++* **##AT+DADDR##**: Get or set the Device Address (DevAddr)
++* **##AT+APPKEY##**: Get or set the Application Key (AppKey)
++* AT+NWKSKEY: Get or set the Network Session Key (NwkSKey)
++* AT+APPSKEY: Get or set the Application Session Key (AppSKey)
++* AT+APPEUI: Get or set the Application EUI (AppEUI)
++* AT+ADR: Get or set the Adaptive Data Rate setting. (0: OFF, 1: ON)
++* AT+TXP: Get or set the Transmit Power (0-5, MAX:0, MIN:5, according to LoRaWAN Specification)
++* AT+DR:  Get or set the Data Rate. (0-7 corresponding to DR_X)
++* AT+DCS: Get or set the ETSI Duty Cycle setting - 0=disable, 1=enable - Only for testing
++* AT+PNM: Get or set the public network mode. (0: off, 1: on)
++* AT+RX2FQ: Get or set the Rx2 window frequency
++* AT+RX2DR: Get or set the Rx2 window data rate (0-7 corresponding to DR_X)
++* AT+RX1DL: Get or set the delay between the end of the Tx and the Rx Window 1 in ms
++* AT+RX2DL: Get or set the delay between the end of the Tx and the Rx Window 2 in ms
++* AT+JN1DL: Get or set the Join Accept Delay between the end of the Tx and the Join Rx Window 1 in ms
++* AT+JN2DL: Get or set the Join Accept Delay between the end of the Tx and the Join Rx Window 2 in ms
++* AT+NJM: Get or set the Network Join Mode. (0: ABP, 1: OTAA)
++* AT+NWKID: Get or set the Network ID
++* AT+FCU: Get or set the Frame Counter Uplink (FCntUp)
++* AT+FCD: Get or set the Frame Counter Downlink (FCntDown)
++* AT+CLASS: Get or set the Device Class
++* AT+JOIN: Join network
++* AT+NJS: Get OTAA Join Status
++* AT+SENDB: Send hexadecimal data along with the application port
++* AT+SEND: Send text data along with the application port
++* AT+RECVB: Print last received data in binary format (with hexadecimal values)
++* AT+RECV: Print last received data in raw format
++* AT+VER: Get current image version and Frequency Band
++* AT+CFM: Get or Set the confirmation mode (0-1)
++* AT+CFS: Get confirmation status of the last AT+SEND (0-1)
++* AT+SNR: Get the SNR of the last received packet
++* AT+RSSI: Get the RSSI of the last received packet
++* AT+TDC: Get or set the application data transmission interval in ms
++* AT+PORT: Get or set the application port
++* AT+DISAT: Disable AT commands
++* AT+PWORD: Set password, max 9 digits
++* AT+CHS: Get or set the Frequency (Unit: Hz) for Single Channel Mode
++* AT+CHE: Get or set eight channels mode, Only for US915, AU915, CN470
++* AT+CFG: Print all settings
  )))
--(((
--AT+<CMD>=?       :  Get the value
--)))
--(((
--ATZ: Trig a reset of the MCU
--)))
--
--(((
--AT+FDR: Reset Parameters to Factory Default, Keys Reserve
--)))
--
--(((
--AT+DEUI: Get or Set the Device EUI
--)))
--
--(((
--AT+DADDR: Get or Set the Device Address
--)))
--
--(((
--AT+APPKEY: Get or Set the Application Key
--)))
--
--(((
--AT+NWKSKEY: Get or Set the Network Session Key
--)))
--
--(((
--AT+APPSKEY:  Get or Set the Application Session Key
--)))
--
--(((
--AT+APPEUI:    Get or Set the Application EUI
--)))
--
--(((
--AT+ADR: Get or Set the Adaptive Data Rate setting. (0: off, 1: on)
--)))
--
--(((
--AT+TXP: Get or Set the Transmit Power (0-5, MAX:0, MIN:5, according to LoRaWAN Spec)
--)))
--
--(((
--AT+DR:  Get or Set the Data Rate. (0-7 corresponding to DR_X)
--)))
--
--(((
--AT+DCS: Get or Set the ETSI Duty Cycle setting - 0=disable, 1=enable - Only for testing
--)))
--
--(((
--AT+PNM: Get or Set the public network mode. (0: off, 1: on)
--)))
--
--(((
--AT+RX2FQ: Get or Set the Rx2 window frequency
--)))
--
--(((
--AT+RX2DR: Get or Set the Rx2 window data rate (0-7 corresponding to DR_X)
--)))
--
--(((
--AT+RX1DL: Get or Set the delay between the end of the Tx and the Rx Window 1 in ms
--)))
--
--(((
--AT+RX2DL: Get or Set the delay between the end of the Tx and the Rx Window 2 in ms
--)))
--
--(((
--AT+JN1DL: Get or Set the Join Accept Delay between the end of the Tx and the Join Rx Window 1 in ms
--)))
--
--(((
--AT+JN2DL: Get or Set the Join Accept Delay between the end of the Tx and the Join Rx Window 2 in ms
--)))
--
--(((
--AT+NJM:    Get or Set the Network Join Mode. (0: ABP, 1: OTAA)
--)))
--
--(((
--AT+NWKID: Get or Set the Network ID
--)))
--
--(((
--AT+FCU: Get or Set the Frame Counter Uplink
--)))
--
--(((
--AT+FCD: Get or Set the Frame Counter Downlink
--)))
--
--(((
--AT+CLASS: Get or Set the Device Class
--)))
--
--(((
--AT+JOIN: Join network
--)))
--
--(((
--AT+NJS: Get OTAA Join Status
--)))
--
--(((
--AT+SENDB: Send hexadecimal data along with the application port
--)))
--
--(((
--AT+SEND: Send text data along with the application port
--)))
--
--(((
--AT+RECVB: Print last received data in binary format (with hexadecimal values)
--)))
--
--(((
--AT+RECV: Print last received data in raw format
--)))
--
--(((
--AT+VER:  Get current image version and Frequency Band
--)))
--
--(((
--AT+CFM: Get or Set the confirmation mode (0-1)
--)))
--
--(((
--AT+CFS:  Get confirmation status of the last AT+SEND (0-1)
--)))
--
--(((
--AT+SNR: Get the SNR of the last received packet
--)))
--
--(((
--AT+RSSI: Get the RSSI of the last received packet
--)))
--
--(((
--AT+TDC: Get or set the application data transmission interval in ms
--)))
--
--(((
--AT+PORT: Get or set the application port
--)))
--
--(((
--AT+DISAT: Disable AT commands
--)))
--
--(((
--AT+PWORD: Set password, max 9 digits
--)))
--
--(((
--AT+CHS: Get or Set Frequency (Unit: Hz) for Single Channel Mode
--)))
--
--(((
--AT+CHE: Get or Set eight channels mode, Only for US915, AU915, CN470
--)))
--
--(((
--AT+CFG: Print all settings
--)))
--
--
  == 4.2 Common AT Command Sequence ==
  === 4.2.1 Multi-channel ABP mode (Use with SX1301/LG308) ===
@@ -1869,41 +1869,41 @@
  (((
--(% style="color:blue" %)**If device has not joined network yet:**
++(% style="color:blue" %)**If the device has not joined the network yet:**
  )))
  )))
  (((
--(% style="background-color:#dcdcdc" %)**123456**
++(% style="background-color:#dcdcdc" %)##**123456 ~/~/enable AT commands access**##
  )))
  (((
--(% style="background-color:#dcdcdc" %)**AT+FDR**
++(% style="background-color:#dcdcdc" %)##**AT+FDR ~/~/reset parameters to factory default, reserve keys**##
  )))
  (((
--(% style="background-color:#dcdcdc" %)**123456**
++(% style="background-color:#dcdcdc" %)##**123456 ~/~/enable AT commands access**##
  )))
  (((
--(% style="background-color:#dcdcdc" %)**AT+NJM=0**
++(% style="background-color:#dcdcdc" %)##**AT+NJM=0 ~/~/set to ABP mode**##
  )))
  (((
--(% style="background-color:#dcdcdc" %)**ATZ**
++(% style="background-color:#dcdcdc" %)##**ATZ ~/~/reset MCU**##
  )))
  (((
--(% style="color:blue" %)**If device already joined network:**
++(% style="color:blue" %)**If the device has already joined the network:**
  )))
  (((
--(% style="background-color:#dcdcdc" %)**AT+NJM=0**
++(% style="background-color:#dcdcdc" %)##**AT+NJM=0**##
  )))
  (((
--(% style="background-color:#dcdcdc" %)**ATZ**
++(% style="background-color:#dcdcdc" %)##**ATZ**##
  )))
@@ -2001,37 +2001,50 @@
  = 5. Case Study =
--== 5.1 Counting how many objects pass in Flow Line ==
++== 5.1 Counting how many objects pass through the flow Line ==
--Reference Link: [[How to set up to count objects pass in flow line>>How to set up to count objects pass in flow line]]?
++Reference Link: [[How to set up to setup counting for objects passing through the flow line>>How to set up to count objects pass in flow line]]?
  = 6. FAQ =
--== 6.1 How to upgrade the image? ==
++This section contains some frequently asked questions, which can help you resolve common issues and find solutions quickly.
++== 6.1 How to update the firmware? ==
--The LT LoRaWAN Controller is shipped with a 3.5mm cable, the cable is used to upload image to LT to:
++Dragino frequently releases firmware updates for the LT-22222-L.
++Updating your LT-22222-L with the latest firmware version helps to:
++
  * Support new features
--* For bug fix
--* Change LoRaWAN bands.
++* Fix bugs
++* Change LoRaWAN frequency bands
--Below shows the hardware connection for how to upload an image to the LT:
++You will need the following things before proceeding:
++* 3.5mm programming cable (included with the LT-22222-L as an additional accessory)
++* USB to TTL adapter
++* Download and install the [[STM32 Flash loader>>url:https://www.st.com/content/st_com/en/products/development-tools/software-development-tools/stm32-software-development-tools/stm32-programmers/flasher-stm32.html]]. (replaced by STM32CubeProgrammer)
++* Download the latest firmware image from [[LT-22222-L firmware image files>>https://www.dropbox.com/sh/g99v0fxcltn9r1y/AACrbrDN0AqLHbBat0ViWx5Da/LT-22222-L/Firmware?dl=0&subfolder_nav_tracking=1]]. Check the file name of the firmware to find the correct region.
++
++{{info}}
++As of this writing, the latest firmware version available for the LT-22222-L is v1.6.1.
++{{/info}}
++
++Below is the hardware setup for uploading a firmware image to the LT-22222-L:
++
++
  [[image:1653359603330-121.png]]
--(((
--(% style="color:blue" %)**Step1**(%%)**:** Download [[flash loader>>url:https://www.st.com/content/st_com/en/products/development-tools/software-development-tools/stm32-software-development-tools/stm32-programmers/flasher-stm32.html]].
--(% style="color:blue" %)**Step2**(%%)**:** Download the [[LT Image files>>https://www.dropbox.com/sh/g99v0fxcltn9r1y/AACrbrDN0AqLHbBat0ViWx5Da/LT-22222-L/Firmware?dl=0&subfolder_nav_tracking=1]].
--(% style="color:blue" %)**Step3**(%%)**:** Open flashloader; choose the correct COM port to update.
--
++Start the STM32 Flash Loader and choose the correct COM port to update.
  (((
++(((
  (% style="color:blue" %)**For LT-22222-L**(%%):
--Hold down the PRO button and then momentarily press the RST reset button and the (% style="color:red" %)**DO1 led**(%%) will change from OFF to ON. When (% style="color:red" %)**DO1 LED**(%%) is on, it means the device is in download mode.
++
++Hold down the **PRO** button, then briefly press the **RST** button. The **DO1** LED will change from OFF to ON. When the **DO1** LED is ON, it indicates that the device is in firmware download mode.
  )))
@@ -2046,7 +2046,7 @@
  [[image:image-20220524104033-15.png]]
--(% style="color:red" %)**Notice**(%%): In case user has lost the program cable. User can hand made one from a 3.5mm cable. The pin mapping is:
++(% style="color:red" %)**Note**(%%): If you have lost the programming cable, you can make one from a 3.5mm cable. The pin mapping is as follows:
  [[image:1653360054704-518.png||height="186" width="745"]]
@@ -2053,7 +2053,7 @@
  (((
  (((
--== 6.2 How to change the LoRa Frequency Bands/Region? ==
++== 6.2 How to change the LoRaWAN frequency band/region? ==
  )))
@@ -2060,13 +2060,13 @@
  )))
  (((
--User can follow the introduction for [[how to upgrade image>>||anchor="H5.1Howtoupgradetheimage3F"]]. When download the images, choose the required image file for download.
++You can follow the introductions on [[how to upgrade image>>||anchor="H5.1Howtoupgradetheimage3F"]]. When downloading, select the required image file.
  )))
  (((
--== 6.3 How to set up LT to work with Single Channel Gateway such as LG01/LG02? ==
++== 6.3 How to setup LT to work with a Single Channel Gateway, such as LG01/LG02? ==
  )))
@@ -2073,13 +2073,13 @@
  (((
  (((
--In this case, users need to set LT-33222-L to work in ABP mode & transmit in only one frequency.
++In this case, you need to set the LT-33222-L to work in ABP mode and transmit on only one frequency.
  )))
  )))
  (((
  (((
--Assume we have a LG02 working in the frequency 868400000 now , below is the step.
++Assume you have an LG02 working on the frequency 868400000. Below are the steps.
  )))
@@ -2086,7 +2086,7 @@
  )))
  (((
--(% style="color:blue" %)**Step1**(%%):  Log in TTN, Create an ABP device in the application and input the network session key (NETSKEY), app session key (APPSKEY) from the device.
++(% style="color:#0000ff" %)**Step 1**(%%):  Log in to The Things Stack SANDBOX, create an ABP device in the application, and input the Network Session key (NwkSKey), App session key (AppSKey) of the device.
  )))
@@ -2143,61 +2143,55 @@
  Please see this link: [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/How%20to%20set%20the%20transmit%20time%20interval/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20set%20the%20transmit%20time%20interval/]]
--== 6.5 Can I see counting event in Serial? ==
++== 6.5 Can I see the counting event in the serial output? ==
  (((
--User can run AT+DEBUG command to see the counting event in serial. If firmware too old and doesn't support AT+DEBUG. User can update to latest firmware first.
++You can run the AT command AT+DEBUG to view the counting event in the serial output. If the firmware is too old and doesn’t support AT+DEBUG, update to the latest firmware first.
--== 6.6 Can i use point to point communication for LT-22222-L? ==
++== 6.6 Can I use point-to-point communication with LT-22222-L? ==
--Yes, please refer [[Point to Point Communication>>doc:Main. Point to Point Communication of LT-22222-L.WebHome]]  ，this is [[firmware>>https://github.com/dragino/LT-22222-L/releases]].
--
--
++Yes, you can. Please refer to the [[Point-to-Point Communication of LT-22222-L>>https://wiki.dragino.com/xwiki/bin/view/Main/%20Point%20to%20Point%20Communication%20of%20LT-22222-L/]] page. The firmware that supports point-to-point communication can be found [[here>>https://github.com/dragino/LT-22222-L/releases]].
  )))
  (((
--== 6.7 Why does the relay output become the default and open relay after the lt22222 is powered off? ==
++== 6.7 Why does the relay output default to an open relay after the LT-22222-L is powered off? ==
--If the device is not shut down, but directly powered off.
++* If the device is not properly shut down and is directly powered off.
++* It will default to a power-off state.
++* 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.
--It will default that this is a power-off state.
++== 6.8 Can I setup LT-22222-L as a NC (Normally Closed) relay? ==
--In modes 2 to 5, DO RO status and pulse count are saved in flash.
--After restart, the status before power failure will be read from flash.
++The LT-22222-L's built-in relay is Normally Open (NO). You can use an external relay to achieve a Normally Closed (NC) configuration. The circuit diagram is shown below:
--== 6.8 Can i set up LT-22222-L as a NC(Normal Close) Relay? ==
--
--
--LT-22222-L built-in relay is NO (Normal Open). User can use an external relay to achieve Normal Close purpose. Diagram as below:
--
--
  [[image:image-20221006170630-1.png||height="610" width="945"]]
--== 6.9 Can LT22222-L save RO state? ==
++== 6.9 Can the LT-22222-L save the RO state? ==
--Firmware version needs to be no less than 1.6.0.
++The firmware version must be at least 1.6.0.
--== 6.10 Why does the LT22222 always report 15.585V when measuring AVI? ==
++== 6.10 Why does the LT-22222-L always report 15.585V when measuring the AVI? ==
--It is likely that the GND is not connected during the measurement, or the wire connected to the GND is loose.
++It is likely that the GND is not connected during the measurement, or that the wire connected to the GND is loose.
--= 7. Trouble Shooting =
++= 7. Troubleshooting =
  )))
  (((
  (((
--== 7.1 Downlink doesn't work, how to solve it? ==
++== 7.1 Downlink isn't working. How can I solve this? ==
  )))
@@ -2204,42 +2204,42 @@
  )))
  (((
--Please see this link for how to debug: [[LoRaWAN Communication Debug>>doc:Main.LoRaWAN Communication Debug.WebHome||anchor="H5.1Howitwork"]]
++Please refer to this link for debugging instructions: [[LoRaWAN Communication Debug>>doc:Main.LoRaWAN Communication Debug.WebHome||anchor="H5.1Howitwork"]]
  )))
  (((
--== 7.2 Have trouble to upload image. ==
++== 7.2 Having trouble uploading an image? ==
  )))
  (((
--See this link for trouble shooting: [[Firmware Upgrade Instruction>>doc:Main.Firmware Upgrade Instruction for STM32 base products.WebHome]]
++Please refer to this link for troubleshooting: [[Firmware Upgrade Instruction>>doc:Main.Firmware Upgrade Instruction for STM32 base products.WebHome]]
  )))
  (((
--== 7.3 Why I can't join TTN in US915 /AU915 bands? ==
++== 7.3 Why can't I join TTN in the US915 /AU915 bands? ==
  )))
  (((
--It might be about the channels mapping. [[Please see this link for detail>>doc:Main.LoRaWAN Communication Debug.WebHome||anchor="H2.NoticeofUS9152FCN4702FAU915Frequencyband"]]
++It might be related to the channel mapping. [[Please refer to this link for details.>>https://github.com/dragino/LT-22222-L/releases]]
  )))
--== 7.4 Why can LT22222 perform Uplink normally, but cannot receive Downlink? ==
++== 7.4 Why can the LT-22222-L perform Uplink normally, but cannot receive Downlink? ==
--The FCD count of the gateway is inconsistent with the FCD count of the node, causing the downlink to remain in the queue state.
--Use this command to bring their counts back together: [[Resets the downlink packet count>>||anchor="H3.4.2.23Resetsthedownlinkpacketcount"]]
++The FCD count of the gateway is inconsistent with the FCD count of the node, causing the downlink to remain in the queue.
++Use this command to synchronize their counts: [[Resets the downlink packet count>>||anchor="H3.4.2.23Resetsthedownlinkpacketcount"]]
--= 8. Order Info =
++= 8. Ordering information =
  (% style="color:#4f81bd" %)**LT-22222-L-XXX:**
@@ -2246,43 +2246,42 @@
  (% style="color:#4f81bd" %)**XXX:**
--* (% style="color:red" %)**EU433**(%%):   LT with frequency bands EU433
--* (% style="color:red" %)**EU868**(%%):   LT with frequency bands EU868
--* (% style="color:red" %)**KR920**(%%):   LT with frequency bands KR920
--* (% style="color:red" %)**CN470**(%%):  LT with frequency bands CN470
--* (% style="color:red" %)**AS923**(%%):   LT with frequency bands AS923
--* (% style="color:red" %)**AU915**(%%):  LT with frequency bands AU915
--* (% style="color:red" %)**US915**(%%):  LT with frequency bands US915
--* (% style="color:red" %)**IN865**(%%):   LT with frequency bands IN865
--* (% style="color:red" %)**CN779**(%%):  LT with frequency bands CN779
++* (% style="color:red" %)**EU433**(%%): LT with frequency bands EU433
++* (% style="color:red" %)**EU868**(%%): LT with frequency bands EU868
++* (% style="color:red" %)**KR920**(%%): LT with frequency bands KR920
++* (% style="color:red" %)**CN470**(%%): LT with frequency bands CN470
++* (% style="color:red" %)**AS923**(%%): LT with frequency bands AS923
++* (% style="color:red" %)**AU915**(%%): LT with frequency bands AU915
++* (% style="color:red" %)**US915**(%%): LT with frequency bands US915
++* (% style="color:red" %)**IN865**(%%): LT with frequency bands IN865
++* (% style="color:red" %)**CN779**(%%): LT with frequency bands CN779
--= 9. Packing Info =
++= 9. Packing information =
--**Package Includes**:
++**Package includes**:
  * LT-22222-L I/O Controller x 1
  * Stick Antenna for LoRa RF part x 1
  * Bracket for controller x1
--* Program cable x 1
++* 3.5mm Programming cable x 1
  **Dimension and weight**:
  * Device Size: 13.5 x 7 x 3 cm
--* Device Weight: 105g
++* Device Weight: 105 g
  * Package Size / pcs : 14.5 x 8 x 5 cm
--* Weight / pcs : 170g
++* Weight / pcs : 170 g
  = 10. Support =
  * (((
--Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule.
++Support is available Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different time zones, we cannot offer live support. However, your questions will be answered as soon as possible within the aforementioned 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.cc>>mailto:Support@dragino.cc]]
++Please provide as much information as possible regarding your inquiry (e.g., product models, a detailed description of the problem, steps to replicate it, etc.) and send an email to [[support@dragino.cc>>mailto:support@dragino.cc]]
--
  )))

integration-details.png

Author

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

Size

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

Content

lt-22222-device-overview.png

Author

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

Size

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

Content

lt-22222-join-network.png

Author

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

Size

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

Content

lt-22222-ul-payload-decoded.png

Author

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

Size

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

Content

lt-22222-ul-payload-fmt.png

Author

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

Size

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

Content

message-1.png

Author

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

Size

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

Content

thingseye.io_integrationsCenter_integrations-2.png

Author

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

Size

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

Content

thingseye.io_integrationsCenter_integrations.png

Author

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

Size

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

Content

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

Summary

Details

Applications

Navigation