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

From version 166.1
edited by Dilisi S
on 2024/11/07 05:43
Change comment: more edits
To version 177.1
edited by Dilisi S
on 2024/11/08 06:48
Change comment: NOV 7 edits - part 2

Summary

Details

Page properties
Content
... ... @@ -245,17 +245,33 @@
245 245  * Enter **AppKey** in the **AppKey** field.
246 246  * In the **End device ID** field, enter a unique name within this application for your LT-22222-N.
247 247  * Under **After registration**, select the **View registered end device** option.
248 +* Click the **Register end device** button.
248 248  
249 249  [[image:lt-22222-l-manually-p2.png||height="625" width="1000"]]
250 250  
251 251  
253 +You will be navigated to the **Device overview** page.
254 +
255 +[[image:lt-22222-device-overview.png||height="625" width="1000"]]
256 +
257 +
252 252  ==== Joining ====
253 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.
260 +Click on **Live data** in the left navigation. Then, power on LT-22222-L. It will join The Things Stack LoRaWAN network server. You can see the **join request**, **join accept**, followed by **uplink data messages** form the device showing in the **Live data** panel.
255 255  
256 -[[image:1653298044601-602.png||height="405" width="709"]]
262 +[[image:lt-22222-join-network.png||height="625" width="1000"]]
257 257  
258 258  
265 +Click on a message with the messge type, **Forward uplink data message**. You can see the  decoded uplink payload as shown below.
266 +
267 +[[image:lt-22222-ul-payload-decoded.png]]
268 +
269 +
270 +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.
271 +
272 +[[image:lt-22222-ul-payload-fmt.png||height="686" width="1000"]]
273 +
274 +
259 259  == 3.3 Work Modes and their Uplink Payload formats ==
260 260  
261 261  
... ... @@ -783,9 +783,8 @@
783 783  
784 784  === 3.4.1 Common Commands ===
785 785  
786 -
787 787  (((
788 -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]]
803 +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]].
789 789  )))
790 790  
791 791  
... ... @@ -793,7 +793,6 @@
793 793  
794 794  ==== 3.4.2.1 Set Transmit Interval ====
795 795  
796 -
797 797  Sets the uplink interval of the device. The default uplink transmission interval is 10 minutes.
798 798  
799 799  * (% style="color:#037691" %)**AT command:**
... ... @@ -1355,69 +1355,122 @@
1355 1355  
1356 1356  == 3.5 Integrating with ThingsEye.io ==
1357 1357  
1358 -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.
1372 +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.
1359 1359  
1360 -=== 3.5.1 Configuring The Things Stack Sandbox ===
1374 +=== 3.5.1 Configuring MQTT Connection Information with The Things Stack Sandbox ===
1361 1361  
1362 -* Go to your Application and select MQTT under Integrations.
1363 -* In the Connection credentials section, under Username, The Thins Stack displays an auto-generated username. You can use it or provide a new one.
1364 -* For the Password, click the Generate new API key button to generate a password. You can see it by clicking on the eye button.
1376 +We use The Things Stack Sandbox for demonstating the configuration but  other
1365 1365  
1378 +* In **The Things Stack Sandbox**, select your application under **Applications**.
1379 +* Select **MQTT** under **Integrations**.
1380 +* In the **Connection information **section, for **Username**, The Things Stack displays an auto-generated username. You can use it or provide a new one.
1381 +* 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.
1382 +
1383 +NOTE. The username and  password (API key) you created here are required in the next section.
1384 +
1366 1366  [[image:tts-mqtt-integration.png||height="625" width="1000"]]
1367 1367  
1368 1368  === 3.5.2 Configuring ThingsEye.io ===
1369 1369  
1370 -* Login to your thingsEye.io account.
1371 -* Under the Integrations center, click Integrations.
1372 -* Click the Add integration button (the button with the + symbol).
1389 +This section guides you on how to create an integration in ThingsEye to connect with The Things Stack MQTT server.
1373 1373  
1391 +* Login to your [[ThingsEye.io >>https://thingseye.io]]account.
1392 +* Under the **Integrations center**, click **Integrations**.
1393 +* Click the **Add integration** button (the button with the **+** symbol).
1394 +
1374 1374  [[image:thingseye-io-step-1.png||height="625" width="1000"]]
1375 1375  
1376 1376  
1377 -On the Add integration page configure the following:
1398 +On the **Add integration** window, configure the following:
1378 1378  
1379 -Basic settings:
1400 +**Basic settings:**
1380 1380  
1381 -* Select The Things Stack Community from the Integration type list.
1382 -* Enter a suitable name for your integration in the Name box or keep the default name.
1383 -* Click the Next button.
1402 +* Select **The Things Stack Community** from the **Integration type** list.
1403 +* Enter a suitable name for your integration in the **Name **text** **box or keep the default name.
1404 +* Ensure the following options are turned on.
1405 +** Enable integration
1406 +** Debug mode
1407 +** Allow create devices or assets
1408 +* Click the **Next** button. you will be navigated to the **Uplink data converter** tab.
1384 1384  
1385 1385  [[image:thingseye-io-step-2.png||height="625" width="1000"]]
1386 1386  
1387 -Uplink Data converter:
1388 1388  
1389 -* Click the Create New button if it is not selected by default.
1390 -* Click the JavaScript button.
1391 -* Paste the uplink decoder function into the text area (first, delete the default code). The demo decoder function can be found here.
1392 -* Click the Next button.
1413 +**Uplink data converter:**
1393 1393  
1415 +* Click the **Create new** button if it is not selected by default.
1416 +* Enter a suitable name for the uplink data converter in the **Name **text** **box or keep the default name.
1417 +* Click the **JavaScript** button.
1418 +* 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]].
1419 +* Click the **Next** button. You will be navigated to the **Downlink data converter **tab.
1420 +
1394 1394  [[image:thingseye-io-step-3.png||height="625" width="1000"]]
1395 1395  
1396 -Downlink Data converter (this is an optional step):
1397 1397  
1398 -* Click the Create new button if it is not selected by default.
1399 -* Click the JavaScript button.
1400 -* Paste the downlink decoder function into the text area (first, delete the default code). The demo decoder function can be found here.
1401 -* Click the Next button.
1424 +**Downlink data converter (this is an optional step):**
1402 1402  
1426 +* Click the **Create new** button if it is not selected by default.
1427 +* Enter a suitable name for the downlink data converter in the **Name **text** **box or keep the default name
1428 +* Click the **JavaScript** button.
1429 +* Paste the downlink decoder function into the text area (first, delete the default code). The demo downlink decoder function can be found here.
1430 +* Click the **Next** button. You will be navigated to the **Connection** tab.
1431 +
1403 1403  [[image:thingseye-io-step-4.png||height="625" width="1000"]]
1404 1404  
1405 -Connection:
1406 1406  
1407 -* Choose Region from the Host type.
1408 -* Enter the cluster of your The Things Stack in the Region textbox.
1409 -* 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.
1410 -* Click Check connection to test the connection. If the connection is successful, you can see the message saying Connected.
1411 -* Click the Add button.
1435 +**Connection:**
1412 1412  
1437 +* Choose **Region** from the **Host type**.
1438 +* 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/...).
1439 +* 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).
1440 +* Click the **Check connection** button to test the connection. If the connection is successful, you will see the message saying **Connected**.
1441 +
1442 +[[image:message-1.png]]
1443 +
1444 +
1445 +* Click the **Add** button.
1446 +
1413 1413  [[image:thingseye-io-step-5.png||height="625" width="1000"]]
1414 1414  
1415 1415  
1416 -Your integration is added to the integrations list and it will display on the Integrations page.
1450 +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.
1417 1417  
1418 -[[image:thingseye-io-step-6.png||height="625" width="1000"]]
1419 1419  
1453 +[[image:thingseye.io_integrationsCenter_integrations.png||height="686" width="1000"]]
1420 1420  
1455 +
1456 +**Viewing integration details**:
1457 +
1458 +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.
1459 +
1460 +[[image:integration-details.png||height="686" width="1000"]]
1461 +
1462 +
1463 +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.
1464 +
1465 +Note: See also ThingsEye documentation.
1466 +
1467 +
1468 +**Viewing events:**
1469 +
1470 +This tab  displays all the uplink messages from the LT-22222-L.
1471 +
1472 +* Click on the **Events **tab.
1473 +* Select **Debug **from the **Event type** dropdown.
1474 +* Select the** time frame** from the **time window**.
1475 +
1476 +[insert image]
1477 +
1478 +- To view the JSON payload of a message, click on the three dots (...) in the Message column of the desired message.
1479 +
1480 +[insert image]
1481 +
1482 +
1483 +**Deleting the integration**:
1484 +
1485 +If you want to delete this integration, click the **Delete integratio**n button.
1486 +
1487 +
1421 1421  == 3.6 Interface Details ==
1422 1422  
1423 1423  === 3.6.1 Digital Input Port: DI1/DI2 /DI3 ( For LT-33222-L, low active ) ===
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