<
From version < 140.1 >
edited by Dilisi S
on 2024/10/31 03:45
To version < 162.1 >
edited by Dilisi S
on 2024/11/05 03:38
>
Change comment: edits from section 3.6.3

Summary

Details

Page properties
Content
... ... @@ -158,21 +158,20 @@
158 158  
159 159  (% style="width:633px" %)
160 160  |=(% style="width: 296px;" %)Terminal|=(% style="width: 334px;" %)Function
161 -|(% style="width:296px" %)RO1-2|(% style="width:334px" %)
162 -|(% style="width:296px" %)RO1-1|(% style="width:334px" %)
163 -|(% style="width:296px" %)RO2-2|(% style="width:334px" %)
164 -|(% style="width:296px" %)RO2-1|(% style="width:334px" %)
165 -|(% style="width:296px" %)DI2+|(% style="width:334px" %)
166 -|(% style="width:296px" %)DI2-|(% style="width:334px" %)
167 -|(% style="width:296px" %)DI1+|(% style="width:334px" %)
168 -|(% style="width:296px" %)DI1-|(% style="width:334px" %)
169 -|(% style="width:296px" %)DO2|(% style="width:334px" %)
170 -|(% style="width:296px" %)DO1|(% style="width:334px" %)
161 +|(% style="width:296px" %)RO1-2|(% style="width:334px" %)Relay Output 1
162 +|(% style="width:296px" %)RO1-1|(% style="width:334px" %)Relay Output 1
163 +|(% style="width:296px" %)RO2-2|(% style="width:334px" %)Relay Output 2
164 +|(% style="width:296px" %)RO2-1|(% style="width:334px" %)Relay Output 2
165 +|(% style="width:296px" %)DI2+|(% style="width:334px" %)Digital Input 2
166 +|(% style="width:296px" %)DI2-|(% style="width:334px" %)Digital Input 2
167 +|(% style="width:296px" %)DI1+|(% style="width:334px" %)Digital Input 1
168 +|(% style="width:296px" %)DI1-|(% style="width:334px" %)Digital Input 1
169 +|(% style="width:296px" %)DO2|(% style="width:334px" %)Digital Output 2
170 +|(% style="width:296px" %)DO1|(% style="width:334px" %)Digital Output 1
171 171  
172 172  == 2.3 Powering ==
173 173  
174 -(% style="line-height:1.38" %)
175 -(% 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" %)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. (% 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" %)The power indicator (PWR) LED will turn on when the device is properly powered.
174 +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.
176 176  
177 177  
178 178  [[image:1653297104069-180.png]]
... ... @@ -182,72 +182,87 @@
182 182  
183 183  == 3.1 How does it work? ==
184 184  
185 -(((
186 186  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.
187 187  
188 188  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. 
189 -)))
190 190  
191 -(((
192 192  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.
193 -)))
194 194  
190 +== 3.2 Registering with a LoRaWAN network server ==
195 195  
196 -== 3.2 Joining the LoRaWAN network server ==
197 -
198 -(((
199 199  The diagram below shows how the LT-22222-L connects to a typical LoRaWAN network.
200 200  
201 -
202 -)))
203 -
204 204  [[image:image-20220523172350-1.png||height="266" width="864"]]
205 205  
196 +=== 3.2.1 Prerequisites ===
206 206  
207 -(((
208 -The LG308 is already set to connect to [[TTN network >>url:https://www.thethingsnetwork.org/]]. So what we need to do now is only configure register this device to TTN:
198 +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.
209 209  
210 -
211 -)))
200 +[[image:image-20230425173427-2.png||height="246" width="530"]]
212 212  
213 -(((
214 -(% style="color:blue" %)**Step 1**(%%): Create a device in TTN with the OTAA keys from LT IO controller.
215 -)))
202 +The following subsections explain how to register the LT-22222-L with different LoRaWAN network server providers.
216 216  
217 -(((
218 -Each LT is shipped with a sticker with the default device EUI as below:
219 -)))
204 +=== 3.2.2 The Things Stack Sandbox (TTSS) ===
220 220  
221 -[[image:image-20230425173427-2.png||height="246" width="530"]]
206 +* Log in to your [[The Things Stack Sandbox>>https://eu1.cloud.thethings.network]] account.
207 +* Create an application if you do not have one yet.
208 +* Register LT-22222-L with that application. Two registration options available:
222 222  
210 +==== Using the LoRaWAN Device Repository: ====
223 223  
224 -Input these keys in the LoRaWAN Server portal. Below is TTN screen shot:
212 +* Go to your application and click on the **Register end device** button.
213 +* On the **Register end device** page:
214 +** Select the option **Select the end device in the LoRaWAN Device Repository**.
215 +** Choose the **End device brand**, **Model**, **Hardware version**, **Firmware version**, and **Profile (Region)**.
216 +** Select the **Frequency plan** that matches with your device.
225 225  
226 -**Add APP EUI in the application.**
218 +[[image:lt-22222-l-dev-repo-reg-p1.png||height="625" width="1000"]]
227 227  
228 -[[image:1653297955910-247.png||height="321" width="716"]]
220 +*
221 +** Enter the **AppEUI** in the **JoinEUI** field and click **Confirm** button.
222 +** Enter the **DevEUI** in the **DevEUI** field.
223 +** Enter the **AppKey** in the **AppKey** field.
224 +** In the **End device ID** field, enter a unique name within this application for your LT-22222-N.
225 +** Under **After registration**, select the **View registered end device** option.
229 229  
227 +[[image:lt-22222-l-dev-repo-reg-p2.png||height="625" width="1000"]]
230 230  
231 -**Add APP KEY and DEV EUI**
229 +==== Entering device information manually: ====
232 232  
233 -[[image:1653298023685-319.png]]
231 +* On the **Register end device** page:
232 +** Select the **Enter end device specifies manually** option as the input method.
233 +** Select the **Frequency plan** that matches with your device.
234 +** Select the **LoRaWAN version**.
235 +** Select the **Regional Parameters version**.
236 +** Click **Show advanced activation, LoRaWAN class and cluster settings** link to expand the section.
237 +** Select **Over the air activation (OTAA)** option under **Activation mode**
238 +** Select **Class C (Continuous)** from the **Additional LoRaWAN class capabilities**.
234 234  
240 +[[image:lt-22222-l-manually-p1.png||height="625" width="1000"]]
235 235  
236 -(((
237 -(% style="color:blue" %)**Step 2**(%%): Power on LT and it will auto join to the TTN network. After join success, it will start to upload message to TTN and user can see in the panel.
238 238  
239 -
240 -)))
243 +* Enter **AppEUI** in the **JoinEUI** field and click **Confirm** button.
244 +* Enter **DevEUI** in the **DevEUI** field.
245 +* Enter **AppKey** in the **AppKey** field.
246 +* In the **End device ID** field, enter a unique name within this application for your LT-22222-N.
247 +* Under **After registration**, select the **View registered end device** option.
241 241  
249 +[[image:lt-22222-l-manually-p2.png||height="625" width="1000"]]
250 +
251 +
252 +==== Joining ====
253 +
254 +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.
255 +
242 242  [[image:1653298044601-602.png||height="405" width="709"]]
243 243  
244 244  
245 -== 3.3 Uplink Payload ==
259 +== 3.3 Uplink Payload formats ==
246 246  
247 247  
248 -There are five working modes + one interrupt mode on LT for different type application:
262 +The LT-22222-L has 5 working modes. It also has an interrupt/trigger mode for different type applications that can be used together with all the working modes as an additional feature. The default mode is MOD1 and you can switch between these modes using AT commands.
249 249  
250 -* (% style="color:blue" %)**MOD1**(%%): (default setting): 2 x ACI + 2AVI + DI + DO + RO
264 +* (% style="color:blue" %)**MOD1**(%%): (default mode/factory set): 2 x ACI + 2AVI + DI + DO + RO
251 251  
252 252  * (% style="color:blue" %)**MOD2**(%%): Double DI Counting + DO + RO
253 253  
... ... @@ -263,7 +263,7 @@
263 263  
264 264  
265 265  (((
266 -The uplink payload includes totally 9 bytes. Uplink packets use FPORT=2 and every 10 minutes send one uplink by default. (% style="display:none" %)
280 +The uplink payload is 11 bytes long. Uplink packets are sent over LoRaWAN FPort=2. By default, one uplink is sent every 10 minutes. (% style="display:none" %)
267 267  
268 268  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
269 269  |(% 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**
... ... @@ -281,23 +281,23 @@
281 281  )))
282 282  
283 283  (((
284 -(% style="color:#4f81bd" %)**DIDORO**(%%) is a combination for RO1, RO2, DI3, DI2, DI1, DO3, DO2 and DO1. Totally 1bytes as below
298 +(% style="color:#4f81bd" %)*** DIDORO**(%%) is a combination for RO1, RO2, DI3, DI2, DI1, DO3, DO2 and DO1, for a total of 1 byte, as shown below.
285 285  
286 286  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
287 -|**bit7**|**bit6**|**bit5**|**bit4**|**bit3**|**bit2**|**bit1**|**bit0**
288 -|RO1|RO2|DI3|DI2|DI1|DO3|DO2|DO1
301 +|**bit 7**|**bit 6**|**bit 5**|**bit 4**|**bit 3**|**bit 2**|**bit 1**|**bit 0**
302 +|RO1|RO2|--DI3--|DI2|DI1|--DO3--|DO2|DO1
289 289  )))
290 290  
291 -* RO is for relay. ROx=1 : close, ROx=0 always open.
292 -* DI is for digital input. DIx=1: high or float, DIx=0: low.
293 -* DO is for reverse digital output. DOx=1: output low, DOx=0: high or float.
305 +* RO is for relay. ROx=1 : closed, ROx=0 always open.
306 +* DI is for digital input. DIx=1: high or floating, DIx=0: low.
307 +* DO is for reverse digital output. DOx=1: output low, DOx=0: high or floating.
294 294  
295 -(% style="color:red" %)**Note: DI3 and DO3 bit are not valid for LT-22222-L**
309 +(% style="color:red" %)**Note: DI3 and DO3 bits are not valid for LT-22222-L**
296 296  
297 -For example if payload is: [[image:image-20220523175847-2.png]]
311 +For example, if the payload is: [[image:image-20220523175847-2.png]]
298 298  
299 299  
300 -**The value for the interface is:  **
314 +**The interface values can be calculated as follows:  **
301 301  
302 302  AVI1 channel voltage is 0x04AB/1000=1195(DEC)/1000=1.195V
303 303  
... ... @@ -307,35 +307,35 @@
307 307  
308 308  ACI2 channel current is 0x1300/1000=4.864mA
309 309  
310 -The last byte 0xAA= 10101010(B) means
324 +The last byte 0xAA= 10101010(b) means,
311 311  
312 -* [1] RO1 relay channel is close and the RO1 LED is ON.
313 -* [0] RO2 relay channel is open and RO2 LED is OFF;
314 -
315 -**LT22222-L:**
316 -
317 -* [1] DI2 channel is high input and DI2 LED is ON;
318 -* [0] DI1 channel is low input;
319 -
320 -* [0] DO3 channel output state
321 -** DO3 is float in case no load between DO3 and V+.;
326 +* [1] RO1 relay channel is closed, and the RO1 LED is ON.
327 +* [0] RO2 relay channel is open, and RO2 LED is OFF.
328 +* [1] DI3 - not used for LT-22222-L.
329 +* [0] DI2 channel input is low, and the DI2 LED is OFF.
330 +* [1] DI1 channel input state:
331 +** DI1 is floating when there is no load between DI1 and V+.
332 +** DI1 is high when there is load between DI1 and V+.
333 +** DI1 LED is ON in both cases.
334 +* [0] DO3 channel output state:
335 +** DO3 is float in case no load between DO3 and V+.
322 322  ** DO3 is high in case there is load between DO3 and V+.
323 -** DO3 LED is off in both case
324 -* [1] DO2 channel output is low and DO2 LED is ON.
325 -* [0] DO1 channel output state
326 -** DO1 is float in case no load between DO1 and V+.;
327 -** DO1 is high in case there is load between DO1 and V+.
328 -** DO1 LED is off in both case
337 +** DO3 LED is OFF in both case
338 +* [1] DO2 channel output is low, and the DO2 LED is ON.
339 +* [0] DO1 channel output state:
340 +** DO1 is floating when there is no load between DO1 and V+.
341 +** DO1 is high when there is load between DO1 and V+.
342 +** DO1 LED is OFF in both case.
329 329  
330 330  === 3.3.2 AT+MOD~=2, (Double DI Counting) ===
331 331  
332 332  
333 333  (((
334 -**For LT-22222-L**: this mode the **DI1 and DI2** are used as counting pins.
348 +**For LT-22222-L**: In this mode, the **DI1 and DI2** are used as counting pins.
335 335  )))
336 336  
337 337  (((
338 -Total : 11 bytes payload
352 +The uplink payload is 11 bytes long.
339 339  
340 340  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
341 341  |(% 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**
... ... @@ -345,26 +345,26 @@
345 345  )))
346 346  
347 347  (((
348 -(% style="color:#4f81bd" %)**DIDORO**(%%) is a combination for RO1, RO2, DO3, DO2 and DO1. Totally 1bytes as below
362 +(% style="color:#4f81bd" %)***DIDORO**(%%) is a combination for RO1, RO2, DO3, DO2 and DO1, for a total of 1 byte, as shown below.
349 349  
350 350  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
351 -|**bit7**|**bit6**|**bit5**|**bit4**|**bit3**|**bit2**|**bit1**|**bit0**
352 -|RO1|RO2|FIRST|Reserve|Reserve|DO3|DO2|DO1
365 +|**bit 7**|**bit 6**|**bit 5**|**bit 4**|**bit 3**|**bit 2**|**bit 1**|**bit 0**
366 +|RO1|RO2|FIRST|Reserve|Reserve|--DO3--|DO2|DO1
353 353  
354 -RO is for relay. ROx=1 : close , ROx=0 always open.
368 +* RO is for relay. ROx=1 : closed, ROx=0 always open.
355 355  )))
356 356  
357 -* FIRST: Indicate this is the first packet after join network.
358 -* DO is for reverse digital output. DOx=1: output low, DOx=0: high or float.
371 +* FIRST: Indicates that this is the first packet after joining the network.
372 +* DO is for reverse digital output. DOx=1: output low, DOx=0: high or floating.
359 359  
360 360  (((
361 -(% style="color:red" %)**Note: DO3 bit is not valid for LT-22222-L.**
375 +(% style="color:red" %)**Note: DO3 bit is not valid for LT-22222-L**
362 362  
363 363  
364 364  )))
365 365  
366 366  (((
367 -**To use counting mode, please run:**
381 +**To activate this mode, please run the following AT command:**
368 368  )))
369 369  
370 370  (((
... ... @@ -385,17 +385,17 @@
385 385  (((
386 386  **For LT22222-L:**
387 387  
388 -(% style="color:blue" %)**AT+TRIG1=0,100**(%%)**  (set DI1 port to trigger on low level, valid signal is 100ms) **
402 +(% style="color:blue" %)**AT+TRIG1=0,100**(%%)**  (set the DI1 port to trigger on a low level, the valid signal duration is 100ms) **
389 389  
390 -(% style="color:blue" %)**AT+TRIG1=1,100**(%%)**  (set DI1 port to trigger on high level, valid signal is 100ms ) **
404 +(% style="color:blue" %)**AT+TRIG1=1,100**(%%)**  (set the DI1 port to trigger on a high level, the valid signal duration is 100ms) **
391 391  
392 -(% style="color:blue" %)**AT+TRIG2=0,100**(%%)**  (set DI2 port to trigger on low level, valid signal is 100ms) **
406 +(% style="color:blue" %)**AT+TRIG2=0,100**(%%)**  (set the DI2 port to trigger on a low level, the valid signal duration is 100ms) **
393 393  
394 -(% style="color:blue" %)**AT+TRIG2=1,100**(%%)**  (set DI2 port to trigger on high level, valid signal is 100ms ) **
408 +(% style="color:blue" %)**AT+TRIG2=1,100**(%%)**  (set the DI2 port to trigger on a high level, the valid signal duration is 100ms) **
395 395  
396 -(% style="color:blue" %)**AT+SETCNT=1,60**(%%)**   (Set COUNT1 value to 60)**
410 +(% style="color:blue" %)**AT+SETCNT=1,60**(%%)**   (Set the COUNT1 value to 60)**
397 397  
398 -(% style="color:blue" %)**AT+SETCNT=2,60**(%%)**   (Set COUNT2 value to 60)**
412 +(% style="color:blue" %)**AT+SETCNT=2,60**(%%)**   (Set the COUNT2 value to 60)**
399 399  )))
400 400  
401 401  
... ... @@ -402,7 +402,7 @@
402 402  === 3.3.3 AT+MOD~=3, Single DI Counting + 2 x ACI ===
403 403  
404 404  
405 -**LT22222-L**: This mode the DI1 is used as a counting pin.
419 +**LT22222-L**: In this mode, the DI1 is used as a counting pin.
406 406  
407 407  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
408 408  |(% 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**
... ... @@ -413,16 +413,16 @@
413 413  )))|DIDORO*|Reserve|MOD
414 414  
415 415  (((
416 -(% style="color:#4f81bd" %)**DIDORO**(%%) is a combination for RO1, RO2, DI3, DI2, DI1, DO3, DO2 and DO1. Totally 1bytes as below
430 +(% style="color:#4f81bd" %)***DIDORO**(%%) is a combination for RO1, RO2, DI3, DI2, DI1, DO3, DO2 and DO1, for a total of 1 byte, as shown below.
417 417  
418 418  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
419 -|**bit7**|**bit6**|**bit5**|**bit4**|**bit3**|**bit2**|**bit1**|**bit0**
420 -|RO1|RO2|FIRST|Reserve|Reserve|DO3|DO2|DO1
433 +|**bit 7**|**bit 6**|**bit 5**|**bit 4**|**bit 3**|**bit 2**|**bit 1**|**bit 0**
434 +|RO1|RO2|FIRST|Reserve|Reserve|--DO3--|DO2|DO1
421 421  )))
422 422  
423 -* RO is for relay. ROx=1 : close, ROx=0 always open.
424 -* FIRST: Indicate this is the first packet after join network.
425 -* DO is for reverse digital output. DOx=1: output low, DOx=0: high or float.
437 +* RO is for relay. ROx=1 : closed, ROx=0 always open.
438 +* FIRST: Indicates that this is the first packet after joining the network.
439 +* DO is for reverse digital output. DOx=1: output low, DOx=0: high or floating.
426 426  
427 427  (((
428 428  (% style="color:red" %)**Note: DO3 is not valid for LT-22222-L.**
... ... @@ -430,7 +430,7 @@
430 430  
431 431  
432 432  (((
433 -**To use counting mode, please run:**
447 +**To activate this mode, please run the following AT command:**
434 434  )))
435 435  
436 436  (((
... ... @@ -443,7 +443,9 @@
443 443  )))
444 444  
445 445  (((
446 -Other AT Commands for counting are similar to [[MOD2 Counting Command>>||anchor="H3.3.2AT2BMOD3D22C28DoubleDICounting29"]].
460 +AT Commands for counting:
461 +
462 +The AT Commands for counting are similar to [[MOD2 Counting Command>>||anchor="H3.3.2AT2BMOD3D22C28DoubleDICounting29"]]. Use only the commands that match 'DI'.
447 447  )))
448 448  
449 449  
... ... @@ -451,11 +451,11 @@
451 451  
452 452  
453 453  (((
454 -**LT22222-L**: This mode the DI1 is used as a counting pin.
470 +**LT22222-L**: In this mode, the DI1 is used as a counting pin.
455 455  )))
456 456  
457 457  (((
458 -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.
474 +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.
459 459  
460 460  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
461 461  |(% 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**
... ... @@ -465,16 +465,16 @@
465 465  )))
466 466  
467 467  (((
468 -(% style="color:#4f81bd" %)**DIDORO **(%%)is a combination for RO1, RO2, DI3, DI2, DI1, DO3, DO2 and DO1. Totally 1bytes as below
484 +(% style="color:#4f81bd" %)**DIDORO **(%%)is a combination for RO1, RO2, DI3, DI2, DI1, DO3, DO2 and DO1, for a total of 1 byte, as shown below.
469 469  
470 470  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
471 -|**bit7**|**bit6**|**bit5**|**bit4**|**bit3**|**bit2**|**bit1**|**bit0**
472 -|RO1|RO2|FIRST|Reserve|Reserve|DO3|DO2|DO1
487 +|**bit 7**|**bit 6**|**bit 5**|**bit 4**|**bit 3**|**bit 2**|**bit 1**|**bit 0**
488 +|RO1|RO2|FIRST|Reserve|Reserve|--DO3--|DO2|DO1
473 473  )))
474 474  
475 -* RO is for relay. ROx=1 : close, ROx=0 always open.
476 -* FIRST: Indicate this is the first packet after join network.
477 -* DO is for reverse digital output. DOx=1: output low, DOx=0: high or float.
491 +* RO is for relay. ROx=1 : closed, ROx=0 always open.
492 +* FIRST: Indicates that this is the first packet after joining the network.
493 +* DO is for reverse digital output. DOx=1: output low, DOx=0: high or floating.
478 478  
479 479  (((
480 480  (% style="color:red" %)**Note: DO3 is not valid for LT-22222-L.**
... ... @@ -483,7 +483,7 @@
483 483  )))
484 484  
485 485  (((
486 -**To use this mode, please run:**
502 +**To activate this mode, please run the following AT command:**
487 487  )))
488 488  
489 489  (((
... ... @@ -500,9 +500,9 @@
500 500  )))
501 501  
502 502  (((
503 -**Plus below command for AVI1 Counting:**
519 +**In addition to that, below are the commands for AVI1 Counting:**
504 504  
505 -(% style="color:blue" %)**AT+SETCNT=3,60**(%%)**  (set AVI Count to 60)**
521 +(% style="color:blue" %)**AT+SETCNT=3,60**(%%)**  (set AVI Count to 60)**
506 506  
507 507  (% style="color:blue" %)**AT+VOLMAX=20000**(%%)**  (If AVI1 voltage higher than VOLMAX (20000mV =20v), counter increase 1)**
508 508  
... ... @@ -1339,56 +1339,73 @@
1339 1339  [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50%20%26%20LSN50-V2%20-%20LoRaWAN%20Sensor%20Node%20User%20Manual/WebHome/image-20220823173929-8.png?width=1205&height=76&rev=1.1||alt="image-20220823173929-8.png"]]
1340 1340  
1341 1341  
1342 -== 3.5 Integrate with Mydevice ==
1358 +== 3.5 Integrating with ThingsEye.io ==
1343 1343  
1360 +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.
1344 1344  
1345 -Mydevices provides a human friendly interface to show the sensor data, once we have data in TTN, we can use Mydevices to connect to TTN and see the data in Mydevices. Below are the steps:
1362 +=== 3.5.1 Configuring The Things Stack Sandbox ===
1346 1346  
1347 -(((
1348 -(% style="color:blue" %)**Step 1**(%%): Be sure that your device is programmed and properly connected to the network at this time.
1349 -)))
1364 +* Go to your Application and select MQTT under Integrations.
1365 +* In the Connection credentials section, under Username, The Thins Stack displays an auto-generated username. You can use it or provide a new one.
1366 +* For the Password, click the Generate new API key button to generate a password. You can see it by clicking on the eye button.
1350 1350  
1351 -(((
1352 -(% style="color:blue" %)**Step 2**(%%): To configure the Application to forward data to Mydevices you will need to add integration. To add the Mydevices integration, perform the following steps:
1368 +[[image:tts-mqtt-integration.png||height="625" width="1000"]]
1353 1353  
1354 -
1355 -)))
1370 +=== 3.5.2 Configuring ThingsEye.io ===
1356 1356  
1357 -[[image:image-20220719105525-1.png||height="377" width="677"]]
1372 +* Login to your thingsEye.io account.
1373 +* Under the Integrations center, click Integrations.
1374 +* Click the Add integration button (the button with the + symbol).
1358 1358  
1376 +[[image:thingseye-io-step-1.png||height="625" width="1000"]]
1359 1359  
1360 1360  
1361 -[[image:image-20220719110247-2.png||height="388" width="683"]]
1379 +On the Add integration page configure the following:
1362 1362  
1381 +Basic settings:
1363 1363  
1364 -(% style="color:blue" %)**Step 3**(%%): Create an account or log in Mydevices.
1383 +* Select The Things Stack Community from the Integration type list.
1384 +* Enter a suitable name for your integration in the Name box or keep the default name.
1385 +* Click the Next button.
1365 1365  
1366 -(% style="color:blue" %)**Step 4**(%%): Search LT-22222-L(for both LT-22222-L) and add DevEUI.(% style="display:none" %)
1387 +[[image:thingseye-io-step-2.png||height="625" width="1000"]]
1367 1367  
1368 -Search under The things network
1389 +Uplink Data converter:
1369 1369  
1370 -[[image:1653356838789-523.png||height="337" width="740"]]
1391 +* Click the Create New button if it is not selected by default.
1392 +* Click the JavaScript button.
1393 +* Paste the uplink decoder function into the text area (first, delete the default code). The demo decoder function can be found here.
1394 +* Click the Next button.
1371 1371  
1396 +[[image:thingseye-io-step-3.png||height="625" width="1000"]]
1372 1372  
1373 -After added, the sensor data arrive TTN, it will also arrive and show in Mydevices.
1398 +Downlink Data converter (this is an optional step):
1374 1374  
1375 -[[image:image-20220524094909-1.png||height="335" width="729"]]
1400 +* Click the Create new button if it is not selected by default.
1401 +* Click the JavaScript button.
1402 +* Paste the downlink decoder function into the text area (first, delete the default code). The demo decoder function can be found here.
1403 +* Click the Next button.
1376 1376  
1405 +[[image:thingseye-io-step-4.png||height="625" width="1000"]]
1377 1377  
1378 -[[image:image-20220524094909-2.png||height="337" width="729"]]
1407 +Connection:
1379 1379  
1409 +* Choose Region from the Host type.
1410 +* Enter the cluster of your The Things Stack in the Region textbox.
1411 +* 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.
1412 +* Click Check connection to test the connection. If the connection is successful, you can see the message saying Connected.
1413 +* Click the Add button.
1380 1380  
1381 -[[image:image-20220524094909-3.png||height="338" width="727"]]
1415 +[[image:thingseye-io-step-5.png||height="625" width="1000"]]
1382 1382  
1383 1383  
1384 -[[image:image-20220524094909-4.png||height="339" width="728"]](% style="display:none" %)
1418 +Your integration is added to the integrations list and it will display on the Integrations page.
1385 1385  
1420 +[[image:thingseye-io-step-6.png||height="625" width="1000"]]
1386 1386  
1387 -[[image:image-20220524094909-5.png||height="341" width="734"]]
1388 1388  
1423 +== 3.6 Interface Details ==
1389 1389  
1390 -== 3.6 Interface Detail ==
1391 -
1392 1392  === 3.6.1 Digital Input Port: DI1/DI2 /DI3 ( For LT-33222-L, low active ) ===
1393 1393  
1394 1394  
... ... @@ -1397,16 +1397,16 @@
1397 1397  [[image:1653356991268-289.png]]
1398 1398  
1399 1399  
1400 -=== 3.6.2 Digital Input Port: DI1/DI2 ( For LT-22222-L) ===
1433 +=== 3.6.2 Digital Input Ports: DI1/DI2 ( For LT-22222-L) ===
1401 1401  
1402 1402  
1403 1403  (((
1404 -The DI port of LT-22222-L can support **NPN** or **PNP** or **Dry Contact** output sensor.
1437 +The DI ports of the LT-22222-L can support **NPN**, **PNP**, or **dry contact** output sensors.
1405 1405  )))
1406 1406  
1407 1407  (((
1408 1408  (((
1409 -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.
1442 +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.
1410 1410  
1411 1411  
1412 1412  )))
... ... @@ -1416,7 +1416,7 @@
1416 1416  
1417 1417  (((
1418 1418  (((
1419 -When use need to connect a device to the DI port, both DI1+ and DI1- must be connected.
1452 +(% 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.
1420 1420  )))
1421 1421  )))
1422 1422  
... ... @@ -1425,22 +1425,22 @@
1425 1425  )))
1426 1426  
1427 1427  (((
1428 -(% style="color:blue" %)**Example1**(%%): Connect to a Low active sensor.
1461 +(% style="color:blue" %)**Example1**(%%): Connecting to a low-active sensor.
1429 1429  )))
1430 1430  
1431 1431  (((
1432 -This type of sensor will output a low signal GND when active.
1465 +This type of sensors outputs a low (GND) signal when active.
1433 1433  )))
1434 1434  
1435 1435  * (((
1436 -Connect sensor's output to DI1-
1469 +Connect the sensor's output to DI1-
1437 1437  )))
1438 1438  * (((
1439 -Connect sensor's VCC to DI1+.
1472 +Connect the sensor's VCC to DI1+.
1440 1440  )))
1441 1441  
1442 1442  (((
1443 -So when sensor active, the current between NEC2501 pin1 and pin2 is
1476 +When the sensor is active, the current between NEC2501 pin 1 and pin 2 will be
1444 1444  )))
1445 1445  
1446 1446  (((
... ... @@ -1448,7 +1448,7 @@
1448 1448  )))
1449 1449  
1450 1450  (((
1451 -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.
1484 +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.
1452 1452  )))
1453 1453  
1454 1454  (((
... ... @@ -1456,22 +1456,22 @@
1456 1456  )))
1457 1457  
1458 1458  (((
1459 -(% style="color:blue" %)**Example2**(%%): Connect to a High active sensor.
1492 +(% style="color:blue" %)**Example2**(%%): Connecting to a high-active sensor.
1460 1460  )))
1461 1461  
1462 1462  (((
1463 -This type of sensor will output a high signal (example 24v) when active.
1496 +This type of sensors outputs a high signal (e.g., 24V) when active.
1464 1464  )))
1465 1465  
1466 1466  * (((
1467 -Connect sensor's output to DI1+
1500 +Connect the sensor's output to DI1+
1468 1468  )))
1469 1469  * (((
1470 -Connect sensor's GND DI1-.
1503 +Connect the sensor's GND DI1-.
1471 1471  )))
1472 1472  
1473 1473  (((
1474 -So when sensor active, the current between NEC2501 pin1 and pin2 is:
1507 +When the sensor is active, the current between NEC2501 pin1 and pin2 will be:
1475 1475  )))
1476 1476  
1477 1477  (((
... ... @@ -1479,7 +1479,7 @@
1479 1479  )))
1480 1480  
1481 1481  (((
1482 -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.
1515 +If **DI1+ = 24V**, the resulting current[[image:1653968155772-850.png||height="23" width="19"]] 24mA , Therefore, the LT-22222-L will detect this high-active signal.
1483 1483  )))
1484 1484  
1485 1485  (((
... ... @@ -1487,22 +1487,22 @@
1487 1487  )))
1488 1488  
1489 1489  (((
1490 -(% style="color:blue" %)**Example3**(%%): Connect to a 220v high active sensor.
1523 +(% style="color:blue" %)**Example3**(%%): Connecting to a 220V high-active sensor.
1491 1491  )))
1492 1492  
1493 1493  (((
1494 -Assume user want to monitor an active signal higher than 220v, to make sure not burn the photocoupler  
1527 +Assume that you want to monitor an active signal higher than 220V without damaging the photocoupler  
1495 1495  )))
1496 1496  
1497 1497  * (((
1498 -Connect sensor's output to DI1+ with a serial 50K resistor
1531 +Connect the sensor's output to DI1+ with a 50K resistor in series.
1499 1499  )))
1500 1500  * (((
1501 -Connect sensor's GND DI1-.
1534 +Connect the sensor's GND DI1-.
1502 1502  )))
1503 1503  
1504 1504  (((
1505 -So when sensor active, the current between NEC2501 pin1 and pin2 is:
1538 +When the sensor is active, the current between NEC2501 pin1 and pin2 will be:
1506 1506  )))
1507 1507  
1508 1508  (((
... ... @@ -1510,37 +1510,37 @@
1510 1510  )))
1511 1511  
1512 1512  (((
1513 -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.
1546 +If the 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. Therefore, the LT-22222-L will be able to safely detect this high-active signal.
1514 1514  )))
1515 1515  
1516 1516  
1517 -(% style="color:blue" %)**Example4**(%%): Connect to Dry Contact sensor
1550 +(% style="color:blue" %)**Example4**(%%): Connecting to Dry Contact sensor
1518 1518  
1519 -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.
1552 +From 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.
1520 1520  
1521 -To detect a Dry Contact, we can provide a power source to one pin of the Dry Contact. Below is a reference connection.
1554 +To detect a Dry Contact, you can supply a power source to one pin of the Dry Contact. Below is a reference circuit diagram.
1522 1522  
1523 1523  [[image:image-20230616235145-1.png]]
1524 1524  
1525 -(% style="color:blue" %)**Example5**(%%): Connect to Open Colleactor
1558 +(% style="color:blue" %)**Example5**(%%): Connecting to an Open Collector
1526 1526  
1527 1527  [[image:image-20240219115718-1.png]]
1528 1528  
1529 1529  
1530 -=== 3.6.3 Digital Output Port: DO1/DO2 /DO3 ===
1563 +=== 3.6.3 Digital Output Ports: DO1/DO2 /DO3 ===
1531 1531  
1532 1532  
1533 -(% style="color:blue" %)**NPN output**(%%): GND or Float. Max voltage can apply to output pin is 36v.
1566 +(% style="color:blue" %)**NPN output**(%%): GND or Float. The maximum voltage that can be applied to the output pin is 36V.
1534 1534  
1535 -(% style="color:red" %)**Note: DO pins go to float when device is power off.**
1568 +(% style="color:red" %)**Note: The DO pins will float when device is powered off.**
1536 1536  
1537 1537  [[image:1653357531600-905.png]]
1538 1538  
1539 1539  
1540 -=== 3.6.4 Analog Input Interface ===
1573 +=== 3.6.4 Analog Input Interfaces ===
1541 1541  
1542 1542  
1543 -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:
1576 +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:
1544 1544  
1545 1545  
1546 1546  (% style="color:blue" %)**AC2 = (IN2 voltage )/12**
... ... @@ -1547,14 +1547,14 @@
1547 1547  
1548 1548  [[image:1653357592296-182.png]]
1549 1549  
1550 -Example to connect a 4~~20mA sensor
1583 +Example: Connecting a 4~~20mA sensor
1551 1551  
1552 -We take the wind speed sensor as an example for reference only.
1585 +We will use the wind speed sensor as an example for reference only.
1553 1553  
1554 1554  
1555 1555  (% style="color:blue" %)**Specifications of the wind speed sensor:**
1556 1556  
1557 -(% style="color:red" %)**Red:  12~~24v**
1590 +(% style="color:red" %)**Red:  12~~24V**
1558 1558  
1559 1559  (% style="color:#ffc000" %)**Yellow:  4~~20mA**
1560 1560  
... ... @@ -1567,7 +1567,7 @@
1567 1567  [[image:1653357648330-671.png||height="155" width="733"]]
1568 1568  
1569 1569  
1570 -Example connected to a regulated power supply to measure voltage
1603 +Example: Connecting to a regulated power supply to measure voltage
1571 1571  
1572 1572  [[image:image-20230608101532-1.png||height="606" width="447"]]
1573 1573  
... ... @@ -1576,7 +1576,7 @@
1576 1576  [[image:image-20230608101722-3.png||height="102" width="1139"]]
1577 1577  
1578 1578  
1579 -(% style="color:blue; font-weight:bold" %)**Specifications of the regulated power**(%%) (% style="color:blue" %)**:**
1612 +(% style="color:blue; font-weight:bold" %)**Specifications of the regulated power supply**(% style="color:blue" %)**:**
1580 1580  
1581 1581  (% style="color:red" %)**Red:  12~~24v**
1582 1582  
... ... @@ -1587,9 +1587,9 @@
1587 1587  
1588 1588  
1589 1589  (((
1590 -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:
1623 +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:
1591 1591  
1592 -**Note**: RO pins go to Open(NO) when device is power off.
1625 +**Note**: The ROx pins will be in the Open (NO) state when the LT-22222-L is powered off.
1593 1593  )))
1594 1594  
1595 1595  [[image:image-20220524100215-9.png]]
... ... @@ -1629,13 +1629,13 @@
1629 1629  |**RO1**|For LT-22222-L: ON when RO1 is closed, LOW when RO1 is open
1630 1630  |**RO2**|For LT-22222-L: ON when RO2 is closed, LOW when RO2 is open
1631 1631  
1632 -= 4. Use AT Command =
1665 += 4. Using AT Command =
1633 1633  
1634 -== 4.1 Access AT Command ==
1667 +== 4.1 Connecting the LT-22222-L to a computer ==
1635 1635  
1636 1636  
1637 1637  (((
1638 -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.
1671 +The LT-22222-L supports programming using AT Commands. You can use a USB-to-TTL adapter along with a 3.5mm Program Cable to connect the LT-22222-L to a computer, as shown below.
1639 1639  )))
1640 1640  
1641 1641  [[image:1653358238933-385.png]]
... ... @@ -1642,7 +1642,7 @@
1642 1642  
1643 1643  
1644 1644  (((
1645 -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:
1678 +On the PC, the user needs to set the (% style="color:#4f81bd" %)**serial tool**(%%)(such as [[putty>>url:https://www.chiark.greenend.org.uk/~~sgtatham/putty/latest.html]], SecureCRT) to a baud rate o(% style="color:green" %)**9600**(%%) to access to access serial console of LT-22222-L. The AT commands are disabled by default, and a password (default:(% style="color:green" %)**123456**)(%%) must be entered to active them, as shown below:
1646 1646  )))
1647 1647  
1648 1648  [[image:1653358355238-883.png]]
... ... @@ -1649,10 +1649,12 @@
1649 1649  
1650 1650  
1651 1651  (((
1652 -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/]]
1685 +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/]]
1653 1653  )))
1654 1654  
1655 1655  (((
1689 +The following table lists all the AT commands related to the LT-22222-L, except for those used for switching between modes.
1690 +
1656 1656  AT+<CMD>?        : Help on <CMD>
1657 1657  )))
1658 1658  
lt-22222-l-dev-repo-reg-p1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.pradeeka
Size
... ... @@ -1,0 +1,1 @@
1 +391.7 KB
Content
lt-22222-l-dev-repo-reg-p2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.pradeeka
Size
... ... @@ -1,0 +1,1 @@
1 +319.1 KB
Content
lt-22222-l-manually-p1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.pradeeka
Size
... ... @@ -1,0 +1,1 @@
1 +306.6 KB
Content
lt-22222-l-manually-p2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.pradeeka
Size
... ... @@ -1,0 +1,1 @@
1 +279.1 KB
Content
thingseye-io-step-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.pradeeka
Size
... ... @@ -1,0 +1,1 @@
1 +191.8 KB
Content
thingseye-io-step-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.pradeeka
Size
... ... @@ -1,0 +1,1 @@
1 +260.3 KB
Content
thingseye-io-step-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.pradeeka
Size
... ... @@ -1,0 +1,1 @@
1 +336.6 KB
Content
thingseye-io-step-4.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.pradeeka
Size
... ... @@ -1,0 +1,1 @@
1 +361.1 KB
Content
thingseye-io-step-5.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.pradeeka
Size
... ... @@ -1,0 +1,1 @@
1 +292.1 KB
Content
thingseye-io-step-6.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.pradeeka
Size
... ... @@ -1,0 +1,1 @@
1 +203.8 KB
Content
tts-mqtt-integration.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.pradeeka
Size
... ... @@ -1,0 +1,1 @@
1 +306.4 KB
Content
Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0