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

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

From version < 200.1 >

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

To version < 205.1 >

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

Change comment: Nov 19 edits - part 1

Raw
Rendered

Summary

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

Details

Page properties

Content

@@ -40,7 +40,7 @@
  (((
  You can connect the LT-22222-L I/O Controller to a LoRaWAN network service provider in several ways:
--* If there is public LoRaWAN network coverage in the area where you plan to install the device (e.g., The Things Network), you can select a network and register the LT-22222-L I/O controller with it.
++* If there is public LoRaWAN network coverage in the area where you plan to install the device (e.g., The Things Stack Community Network), you can select a network and register the LT-22222-L I/O controller with it.
  * If there is no public LoRaWAN coverage in your area, you can set up a LoRaWAN gateway, or multiple gateways, and connect them to a LoRaWAN network server to create adequate coverage. Then, register the LT-22222-L I/O controller with this network.
  * Setup your own private LoRaWAN network.
@@ -50,11 +50,14 @@
  )))
  (((
--[[image:1653295757274-912.png]]
--
++
++The network diagram below shows how the LT-22222-L is connected to a typical LoRaWAN network.
  )))
++(% class="wikigeneratedid" %)
++[[image:lorawan-nw.jpg||height="354" width="900"]]
++
  == 1.2 Specifications ==
  (% style="color:#037691" %)**Hardware System:**
@@ -115,6 +115,22 @@
  * Smart cities
  * Smart factory
++== 1.5 Hardware Variants ==
++
++(% style="width:524px" %)
++|(% style="width:94px" %)**Model**|(% style="width:98px" %)**Photo**|(% style="width:329px" %)**Description**
++|(% style="width:94px" %)**LT33222-L**|(% style="width:98px" %)(((
++
++)))|(% style="width:329px" %)(((
++* 2 x Digital Input (Bi-direction)
++* 2 x Digital Output
++* 2 x Relay Output (5A@250VAC / 30VDC)
++* 2 x 0~~20mA Analog Input (res:0.01mA)
++* 2 x 0~~30V Analog Input (res:0.01v)
++* 1 x Counting Port
++)))
++
++
  == 2. Assembling the device ==
  == 2.1 Connecting the antenna ==
@@ -155,11 +155,11 @@
  |(% style="width:296px" %)DO2|(% style="width:334px" %)Digital Output 2
  |(% style="width:296px" %)DO1|(% style="width:334px" %)Digital Output 1
--== 2.3 Powering the device ==
++== 2.3 Connecting LT-22222-L to a Power Source ==
--The LT-22222-L I/O Controller can be powered by a **7–24V DC** power source. Connect your power supply’s positive wire to the VIN and the negative wire to the GND screw terminals. The power indicator **(PWR) LED** will turn on when the device is properly powered.
++The LT-22222-L I/O Controller can be powered by a **7–24V DC** power source. Connect your power supply’s **positive wire** to the **VIN** and the **negative wire** to the **GND** screw terminals. The power indicator **(PWR) LED** will turn on when the device is properly powered.
--Once powered, the **TX LED** will **fast-blink 5 times** which means the LT-22222-L will enter the **work mode** and start to **join** The Things Stack. The **TX LED** will be on for **5 seconds** after joining the network. When there is a **downlink** message from the server, the **RX LED** will be on for **1 second**. When the device is sending an uplink message to the server, the **TX LED** will be on for **1 second**. See also LED status.
++Once powered, the **TX LED** will **fast-blink 5 times** which means the LT-22222-L will enter the **work mode** and start to **join** with the Network Server.
  {{warning}}
  We recommend that you power on the LT-22222-L after configuring its registration information with a LoRaWAN network server. Otherwise, the device will continuously send join-request messages to attempt to join a LoRaWAN network but will fail.
@@ -169,35 +169,45 @@
  [[image:1653297104069-180.png]]
--= 3. Registering with a LoRaWAN Network Server =
++= 3. Registering LT-22222-L with a LoRaWAN Network Server =
--By default, the LT-22222-L is configured to operate in LoRaWAN Class C mode. It supports OTAA (Over-the-Air Activation), the most secure method for activating a device with a LoRaWAN network server. The LT-22222-L comes with device registration information that allows you to register it with a LoRaWAN network, enabling the device to perform OTAA activation with the network server upon initial power-up and after any subsequent reboots.
++By default, the LT-22222-L is configured to operate in LoRaWAN Class C mode. It supports both OTAA (Over-the-Air Activation) and ABP (Activation By Personalization) methods to activate with a LoRaWAN Network Server. However, OTAA is the most secure method for activating a device with a LoRaWAN Network Server.
--After powering on, the **TX LED** will **fast-blink 5 times** which means the LT-22222-L will enter the **work mode** and start to **join** the LoRaWAN network. The **TX LED** will be on for **5 seconds** after joining the network. When there is a **downlink** message from the server, the **RX LED** will be on for **1 second**. When the device is sending an uplink message to the server, the **TX LED** will be on for **1 second**. See also LED status.
--In case you can't set the root key and other identifiers in the network server and must use them from the server, you can use [[AT Commands>>||anchor="H4.UseATCommand"]] to configure them on the device.
--The network diagram below shows how the LT-22222-L is connected to a typical LoRaWAN network.
--
--[[image:image-20220523172350-1.png||height="266" width="864"]]
--
  === 3.2.1 Prerequisites ===
--Make sure you have the device registration information such as DevEUI, AppEUI, and AppKey with you. The registration information can be found on a sticker that can be found inside the package. Please keep the **registration information** sticker in a safe place for future reference.
++The LT-22222-L comes with device registration information 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.
++Make sure you have the device registration information such as DevEUI, AppEUI, and AppKey with you. These registration information can be found on a sticker that can be found inside the package. Please keep the **registration information** sticker in a safe place for future reference.
++
  [[image:image-20230425173427-2.png||height="246" width="530"]]
++{{info}}
++In case you can't set the root key and other identifiers in the network server and must use them from the server, you can use [[AT Commands>>||anchor="H4.UseATCommand"]] to configure them on the device.
++{{/info}}
++
  The following subsections explain how to register the LT-22222-L with different LoRaWAN network server providers.
--=== 3.2.2 The Things Stack Sandbox (TTSS) ===
++=== 3.2.2 Registering with The Things Stack ===
++{{info}}
  The Things Stack Sandbox was formally called The Things Stack Community Edition.
++{{/info}}
--* Log in to your [[The Things Stack Sandbox>>https://eu1.cloud.thethings.network]] account.
++
++The network diagram below shows how the LT-22222-L is connected to The Things Stack and integrates its data with the ThingsEye IoT platform.
++
++[[image:dragino-ttn-te.jpg]]
++
++
++* Create a free account with [[The Things Stack Sandbox>>https://eu1.cloud.thethings.network]] if you do not have a one yet.
++* Log in to your The Things Stack Sandbox account.
  * Create an application with The Things Stack if you do not have one yet.
  * Go to your application page and click on the **End devices** in the left menu.
  * On the End devices page, click on **+ Register end device**. Two registration options are available:
++
  ==== 3.2.2.1 Using the LoRaWAN Device Repository ====
  * On the **Register end device** page:
@@ -210,6 +210,7 @@
  *** **Profile (Region)**: Select the region that matches your device.
  ** Select the **Frequency plan** that matches your device from the **Frequency plan** dropdown list.
++
  [[image:lt-22222-l-dev-repo-reg-p1.png||height="625" width="1000"]]
@@ -259,14 +259,17 @@
  On the Device overview page, click on **Live data** tab. The Live data panel for your device will display.
--Now power on your LT-22222-L. It will begin joining The Things Stack. In the **Live data** panel, you can see the **join-request** and **join-accept** messages exchanged between the device and the network server. Once successfully joined, the device will send its first **uplink data message** to the application it belongs to (in this example, **dragino-docs**).
++Now power on your LT-22222-L. The **TX LED** will **fast-blink 5 times** which means the LT-22222-L will enter the **work mode** and start to **join** The Things Stack network server. The **TX LED** will be on for **5 seconds** after joining the network. In the **Live data** panel, you can see the **join-request** and **join-accept** messages exchanged between the device and the network server.
  [[image:lt-22222-join-network.png||height="625" width="1000"]]
--By default, you will receive an uplink data message from the device every 10 minutes.
++==== 3.2.2.4 Uplinks ====
++
++After successfully joining, the device will send its first **uplink data message** to the application it belongs to (in this example, **dragino-docs**). When the LT-22222-L sends an uplink message to the server, the **TX LED** turns on for **1 second**. By default, you will receive an uplink data message from the device every 10 minutes.
++
  Click on one of a **Forward uplink data messages **to see its payload content. The payload content is encapsulated within the decode_payload {} JSON object.
  [[image:lt-22222-ul-payload-decoded.png]]
@@ -281,6 +281,11 @@
  [[image:lt-22222-ul-payload-fmt.png||height="686" width="1000"]]
++==== 3.2.2.4 Uplinks ====
++
++When the LT-22222-L receives a downlink message from the server, the **RX LED** turns on for **1 second**.
++
++
  == 3.3 Working Modes and Uplink Payload formats ==
@@ -556,13 +556,13 @@
  )))
  (((
--Other AT Commands for counting are similar to the [[MOD2 Counting Command>>||anchor="H3.3.2AT2BMOD3D22C28DoubleDICounting29"]]s.
++AT Commands for counting are similar to the [[MOD2 Counting Command>>||anchor="H3.3.2AT2BMOD3D22C28DoubleDICounting29"]]s.
  )))
  (((
  **In addition to that,  below are the commands for AVI1 Counting:**
--(% style="color:blue" %)**AT+SETCNT=3,60 **(%%)**(Sets AVI Count to 60)**
++(% style="color:blue" %)**AT+SETCNT=3,60 **(%%)**(Sets AVI1 Count to 60)**
  (% style="color:blue" %)**AT+VOLMAX=20000 **(%%)**(If AVI1 voltage higher than VOLMAX (20000mV =20v), counter increase 1)**
@@ -1133,7 +1133,6 @@
  )))
  |(% style="width:96px" %)**Example**|(% style="width:402px" %)09 02 **00 00 64**
--(% class="wikigeneratedid" %)
  ====   ====
  ==== 3.4.2.9 Trigger – Set AC (current) as a trigger ====
@@ -1210,7 +1210,6 @@
  )))
  |(% style="width:104px" %)**Note**|(% style="width:387px" %)See also, [[trigger mode>>||anchor="H3.3.6AT2BADDMOD3D6.28TriggerMode2COptional29"]]
--
  (% style="color:#037691" %)**Downlink Payload**
  (% border="2" style="width:500px" %)
@@ -1233,7 +1233,6 @@
  )))
  |(% style="width:104px" %)**Note**|(% style="width:394px" %)See also, [[trigger mode>>||anchor="H3.3.6AT2BADDMOD3D6.28TriggerMode2COptional29"]]
--
  ==== 3.4.2.11 Trigger – Set minimum interval ====
  Sets the AV and AC trigger minimum interval. The device won't respond to a second trigger within this set time after the first trigger.
@@ -1269,7 +1269,6 @@
  )))
  |(% style="width:112px" %)Note|(% style="width:386px" %)(% style="color:red" %)**The time must be greater than 5 minutes.**
--
  ==== 3.4.2.12 DO ~-~- Control Digital Output DO1/DO2/DO3 ====
  Controls the digital outputs DO1, DO2, and DO3
@@ -1320,7 +1320,6 @@
  )))
  )))
--(% class="wikigeneratedid" %)
  ====   ====
  ==== 3.4.2.13 DO ~-~- Control Digital Output DO1/DO2/DO3 with time control ====
@@ -1512,10 +1512,70 @@
  (% style="color:blue" %)**0xA5 aa bb cc   ** (%%)~/~/ Same as AT+VOLMAX=(aa bb),cc
++(% style="color:#037691" %)**AT Command**
++(% border="2" style="width:500px" %)
++|(% style="width:137px" %)**Command**|(% style="width:361px" %)AT+VOLMAX=<voltage><logic>
++|(% style="width:137px" %)**Response**|(% style="width:361px" %)
++|(% style="width:137px" %)**Parameters**|(% style="width:361px" %)(((
++**voltage** : voltage threshold in mV
++
++**logic**:
++
++0 : lower than
++
++1: higher than
++
++if you leave logic parameter blank, it is considered 0
++)))
++|(% style="width:137px" %)**Examples**|(% style="width:361px" %)(((
++AT+VOLMAX=20000
++
++If AVI1 voltage higher than VOLMAX (20000mV =20v), counter increase 1
++
++AT+VOLMAX=20000,0
++
++If AVI1 voltage lower than VOLMAX (20000mV =20v), counter increase 1
++
++AT+VOLMAX=20000,1
++
++If AVI1 voltage higher than VOLMAX (20000mV =20v), counter increase 1
++)))
++
++(% style="color:#037691" %)**Downlink Payload**
++
++(% border="2" style="width:500px" %)
++|(% style="width:140px" %)**Payload**|(% style="width:358px" %)<prefix><voltage><logic>
++|(% style="width:140px" %)**Parameters**|(% style="width:358px" %)(((
++**prefix** : A5 (hex)
++
++**voltage** : voltage threshold in mV (2 bytes in hex)
++
++**logic**: (1 byte in hexadecimal)
++
++0 : lower than
++
++1: higher than
++
++if you leave logic parameter blank, it is considered 1 (higher than)
++)))
++|(% style="width:140px" %)**Example**|(% style="width:358px" %)(((
++A5 **4E 20**
++
++If AVI1 voltage higher than VOLMAX (20000mV =20v), counter increase 1
++
++A5 **4E 20 00**
++
++If AVI1 voltage lower than VOLMAX (20000mV =20v), counter increase 1
++
++A5 **4E 20 01**
++
++If AVI1 voltage higher than VOLMAX (20000mV =20v), counter increase 1
++)))
++
  ==== 3.4.2.17 Counting ~-~- Pre-configure the Count Number ====
--This feature allows users to pre-configure specific count numbers for various counting parameters such as count1, count2, or AV1 count. Use the AT command to set the desired count number for each configuration.
++This feature allows users to pre-configure specific count numbers for various counting parameters such as Count1, Count2, or AVI1 Count. Use the AT command to set the desired count number for each configuration.
  * (% style="color:#037691" %)**AT Command:**(%%) (% style="color:blue" %)**AT+SETCNT=aa,(bb cc dd ee) **
@@ -1529,7 +1529,51 @@
  (% style="color:blue" %)**0x A8 aa bb cc dd ee     ** (%%)~/~/ same as AT+SETCNT=aa,(bb cc dd ee)
++(% style="color:#037691" %)**AT Command**
++(% border="2" style="width:500px" %)
++|(% style="width:134px" %)**Command**|(% style="width:364px" %)AT+SETCNT=<counting_parameter><number>
++|(% style="width:134px" %)**Response**|(% style="width:364px" %)
++|(% style="width:134px" %)**Parameters**|(% style="width:364px" %)(((
++**counting_parameter** :
++
++1: COUNT1
++
++2: COUNT2
++
++3: AVI1 Count
++
++**number** : Start number
++)))
++|(% style="width:134px" %)**Example**|(% style="width:364px" %)(((
++AT+SETCNT=1,10
++
++Sets the COUNT1 to 10.
++)))
++
++(% style="color:#037691" %)**Downlink Payload**
++
++(% border="2" style="width:500px" %)
++|(% style="width:135px" %)**Payload**|(% style="width:363px" %)<prefix><counting_parameter><number>
++|(% style="width:135px" %)**Parameters**|(% style="width:363px" %)(((
++prefix : A8 (hex)
++
++**counting_parameter** :  (1 byte in hexadecimal)
++
++1: COUNT1
++
++2: COUNT2
++
++3: AVI1 Count
++
++**number** : Start number, 4 bytes in hexadecimal
++)))
++|(% style="width:135px" %)**Example**|(% style="width:363px" %)(((
++A8 **01 00 00 00 0A**
++
++Sets the COUNT1 to 10.
++)))
++
  ==== 3.4.2.18 Counting ~-~- Clear Counting ====
  This feature clears the counting in counting mode.
@@ -1540,8 +1540,23 @@
  (% style="color:blue" %)**0x A6 01    ** (%%)~/~/ clear all counting
++(% style="color:#037691" %)**AT Command**
++(% border="2" style="width:500px" %)
++|(% style="width:142px" %)**Command**|(% style="width:356px" %)AT+CLRCOUNT
++|(% style="width:142px" %)**Response**|(% style="width:356px" %)-
++(% style="color:#037691" %)**Downlink Payload**
++
++(% border="2" style="width:500px" %)
++|(% style="width:141px" %)**Payload**|(% style="width:357px" %)<prefix><clear?>
++|(% style="width:141px" %)**Parameters**|(% style="width:357px" %)(((
++prefix : A6 (hex)
++
++clear? : 01 (hex)
++)))
++|(% style="width:141px" %)**Example**|(% style="width:357px" %)A6 **01**
++
  ==== 3.4.2.19 Counting ~-~- Change counting mode to save time ====
  This feature allows you to configure the device to save its counting result to internal flash memory at specified intervals. By setting a save time, the device will periodically store the counting data to prevent loss in case of power failure. The save interval can be adjusted to suit your requirements, with a minimum value of 30 seconds.

dragino-ttn-te.jpg

Author

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

Size

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

Content

lorawan-nw.jpg

Author

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

Size

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

Content

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

Summary

Details

Applications

Navigation