Changes for page Connect Devices to ThingsEye

Last modified by Hera Guo on 2025/02/18 09:29

From 8.1 to 9.1 From 15.1 to 16.1

From version 9.1

edited by Chxy
on 2024/10/10 21:20

Change comment: There is no comment for this version

To version 15.1

edited by Hera Guo
on 2024/11/27 09:02

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (2 modified, 0 added, 0 removed)
Attachments (0 modified, 1 added, 0 removed)
- 1729562069134-315.png

Details

Page properties

Author

@@ -1,1 +1,1 @@
--XWiki.EdwinChen
++XWiki.hera

Content

@@ -44,7 +44,7 @@
  Device here is **[[S31-NB>>https://www.dragino.com/products/temperature-humidity-sensor/item/288-s31-nb-s31b-nb.html]]** : and have been configure below
--* Set to use ThingsEye UDP server: **AT+SERVADDR=server1.thingseye.io,11560**
++* Set to use ThingsEye UDP server: **AT+SERVADDR=server1.thingseye.io,11562**
  * Use UDP Uplink & Json protocol:** AT+PRO=2,5**
  * Equip with a NB-IoT SIM Card to access to NB-IoT Network.
@@ -71,12 +71,12 @@
--= 2.  Connect to The Things Stack =
++= 3.  Connect to The Things Stack =
--== 2.1 Network Structure ==
++== 3.1 Network Structure ==
--== 2.2 Creat Integration for The Things Stack. ==
++== 3.2 Creat Integration for The Things Stack. ==
  (% class="lead" %)
  Add Integration
@@ -95,107 +95,17 @@
  [[image:1728535941851-388.png||height="466" width="398"]]
--Demo Code as below:
++Demo JavaScript Code: [[https:~~/~~/raw.githubusercontent.com/ThingsEye-io/te-platform/refs/heads/main/Data%20Converters/The_Things_Network_MQTT_Uplink_Converter.js >>https://raw.githubusercontent.com/ThingsEye-io/te-platform/refs/heads/main/Data%20Converters/The_Things_Network_MQTT_Uplink_Converter.js]]
-->var data = decodeToJson(payload);
-->var deviceName = data.end_device_ids.device_id;
-->var deviceType = data.end_device_ids.application_ids.application_id;
-->var model = {};
-->var data2 = data.uplink_message.decoded_payload;
-->var flg = data.uplink_message.f_port
-->for (var key in data2) {
-->    model[key] = data2[key];
-->}
-->var obj =  {"devid":deviceName}
-->var result = {
-->    deviceName: deviceName,
-->    deviceType: deviceType,
-->    telemetry: model,
-->    groupName: "Case Study",
-->    attributes:{"devid":deviceName,
-->        "timevalue":"test",
-->        "inactivityTimeout":1260000
-->    }
-->};
-->function decodeToString(payload) {
-->    return String.fromCharCode.apply(String, payload);
-->}function decodeToJson(payload) {
-->    var str = decodeToString(payload);
-->    var data = JSON.parse(str);
-->    return data;
-->}
-->if (flg===2){
-->return result;
-->}
--
  (% class="lead" %)
  Input Downlink Converter
  [[image:1728536142721-488.png||height="470" width="407"]]
--Example Code as below:
++Example Javascript Code as below: [[https:~~/~~/raw.githubusercontent.com/ThingsEye-io/te-platform/refs/heads/main/Data%20Converters/The_Things_Network_MQTT_Downlink_Converter.js>>https://raw.githubusercontent.com/ThingsEye-io/te-platform/refs/heads/main/Data%20Converters/The_Things_Network_MQTT_Downlink_Converter.js]]
-->function hexToBase64(hexString) {
-->    var bytes = hexString.match(/.{2}/g);
-->    var binaryString = bytes.map(function(byte) {
-->        return String.fromCharCode(parseInt(byte, 16));
-->    }).join('');
-->
-->    return btoa(binaryString);
-->}
-->var flg = "shared_value" in metadata
-->var value2 = parseInt(metadata.ss_timevalue).toString(16)if (value2.length==1){
-->    value2 = "00000"+parseInt(metadata.ss_timevalue).toString(16)
-->}
-->else if (value2.length==2){
-->    value2 = "0000"+parseInt(metadata.ss_timevalue).toString(16)
-->}
-->else if (value2.length==3){
-->    value2 = "000"+parseInt(metadata.ss_timevalue).toString(16)
-->}
-->else if (value2.length==4){
-->    value2 = "00"+parseInt(metadata.ss_timevalue).toString(16)
-->}
-->else if (value2.length==5){
-->    value2 = "0"+parseInt(metadata.ss_timevalue).toString(16)
-->}
-->else {
-->    value2 = value2
-->}
-->var data = "01"+value2
-->if (flg === true){
-->data = {
-->        downlinks: [{
-->            f_port: 1,
-->            confirmed: false,
-->            frm_payload: hexToBase64(metadata.shared_value),
-->            priority: "NORMAL"
-->        }]
-->    };
-->}
-->else{
-->  data = {
-->        downlinks: [{
-->            f_port: 1,
-->            confirmed: false,
-->            frm_payload: hexToBase64(data),
-->            priority: "NORMAL"
-->        }]
-->    };
-->}
-->var result = {
-->    contentType: "JSON",
-->    data: JSON.stringify(data),
-->    metadata: {
-->        devId: metadata.ss_devid
-->    }
-->};
-->if (metadata.shared_timevalue!=="test" || metadata.ss_timevalue!=="test"){
-->return result;
-->}
--
  (% class="lead" %)
  Set up Connection to The Things Network application
@@ -213,7 +213,7 @@
  [[image:1728536420275-153.png||height="208" width="1404"]]
--== 2.3 Test Uplink ==
++== 3.3 Test Uplink ==
  We can use Simulate Uplink to simulate an uplink in the things stack. Then we should be able to see the message in ThingsEye
@@ -221,3 +221,200 @@
  [[image:1728536541040-814.png]]
++
++= 4.Connect chirpstack to Thingseye by way of MQTT =
++
++* **How to connect chirpstack to Thingseye by way of MQTT? The following tutorial will show you**
++
++== 4.1 Thingseye adds MQTT integration ==
++
++Go to the Integrations page in the Integrations center section. Click the plus button to start adding a new integration. Select the type "MQTT" integration and click "Next";
++
++[[image:图片1.png||height="655" width="1320"]]
++
++== 4.2 Add an uplink and downlink data converter ==
++
++In the function decoder field, specify the script to parse and transform the data.
++
++[[image:图片2.png||height="653" width="1315"]]
++
++* **Uplink——JavaScript：**
++
++var data = decodeToJson(payload);
++
++var deviceName = data.deviceInfo.deviceName;
++
++var deviceType = data.applicationName;
++
++var devEui = data.deviceInfo.devEui
++
++var label = data.deviceInfo.devEui
++
++var model = {};
++
++var data2 = data.object;
++
++var flg = data.fPort
++
++for (var key in data2) {
++
++    ~/~/ 将属性名存入新对象中
++
++    model[key] = data2[key];
++
++}
++
++~/~/var obj =  {"devid":deviceName}
++
++var result = {
++
++    deviceName: deviceName,
++
++    deviceType: deviceType,
++
++    telemetry: model,
++
++    groupName: "Case Study",
++
++    ~/~/label:label,
++
++    attributes:{"devEui":devEui,
++
++        ~/~/"timevalue":"test",
++
++        "inactivityTimeout":1260000
++
++        ~/~/ "High_humidity_alarm":"not set",
++
++        ~/~/ "High_temperature_alarm":"not set",
++
++        ~/~/ "Low_humidity_alarm":"not set",
++
++        ~/~/ "Low_temperature_alarm":"not set",
++
++        ~/~/ "Low_voltage_alarm":"not set"
++
++        ~/~/"customerName": "Civionic Engineering & Consulting (2014) Inc."
++
++    }
++
++};
++
++function decodeToString(payload) {
++
++    return String.fromCharCode.apply(String, payload);
++
++}
++
++function decodeToJson(payload) {
++
++    var str = decodeToString(payload);
++
++    var data = JSON.parse(str);
++
++    return data;
++
++}
++
++return result;
++
++[[image:图片3.png||height="657" width="1324"]]
++
++* **Dowblink——JavaScript：**
++
++~/~/ Encode downlink data from incoming Rule Engine message
++
++~/~/ msg - JSON message payload downlink message json
++
++~/~/ msgType - type of message, for ex. 'ATTRIBUTES_UPDATED', 'POST_TELEMETRY_REQUEST', etc.
++
++~/~/ metadata - list of key-value pairs with additional data about the message
++
++~/~/ integrationMetadata - list of key-value pairs with additional data defined in Integration executing this converter
++
++~/~/ /~*~* Encoder ~*~*/
++
++~/~/var data = {"value":99};
++
++~/~/ ~/~/ Process data from incoming message and metadata
++
++~/~/ data.tempFreq = msg.temperatureUploadFrequency;
++
++~/~/ data.humFreq = msg.humidityUploadFrequency;
++
++~/~/ data.devSerialNumber = metadata['ss_serialNumber'];
++
++~/~/ ~/~/ Result object with encoded downlink payload
++
++var result = {
++
++    ~/~/ downlink data content type: JSON, TEXT or BINARY (base64 format)
++
++    contentType: "TEXT",
++
++    ~/~/ downlink data
++
++    data: msg.shared_value ,~/~/JSON.stringify(data),
++
++    ~/~/ Optional metadata object presented in key/value format
++
++    metadata: {
++
++            topic: '/test/down/'+metadata.deviceName
++
++    }
++
++};
++
++return result;
++
++== 4.3 Configure the connection ==
++
++Generate MQTT certificate integrated on chirpstack
++
++Chirpstack generates CA certificate, TLS certificate, and TLS key respectively
++
++They correspond to the CA certificate file, Certificate file, and Private key file on thingseye
++
++[[image:图片4.png||height="669" width="1348"]]
++
++[[image:图片5.png||height="669" width="1348"]]
++
++* Copy the contents of the certificates and paste them into the linked file below, a total of three certificates are required
++
++**Integrated Certificate File demo Download Address：**
++
++[[https:~~/~~/github.com/ThingsEye-io/te-platform/tree/main/chirpstack>>https://github.com/ThingsEye-io/te-platform/tree/main/chirpstack]]
++
++Enter the server address Host: lns1.thingseye.io on the Connection configuration
++
++Port: 8883
++
++Credentials type: PEM
++
++Upload the certificate and key file
++
++[[image:图片6.png||height="672" width="1353"]]
++
++[[image:图片7.png||height="671" width="1352"]]
++
++The default for Topic is:
++
++application/**chirpstack application id**/device/+/event/up
++
++[[image:图片8.png||height="673" width="1356"]]
++
++[[image:1732500689044-955.png]]
++
++== 4.4 Check the connection ==
++
++[[image:图片9.png||height="718" width="1446"]]
++
++[[image:图片10.png||height="711" width="1432"]]
++
++
++= 5. Check Data Uplink Log =
++
++User can check the devices log in Intergration.
++
++[[image:1729562069134-315.png||height="587" width="723"]]

1729562069134-315.png

Author

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

Size

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

Content

Changes for page Connect Devices to ThingsEye

Summary

Details

Applications

Navigation