Search…
⌃K
Links

HTTPS Integration

Overview

HTTPS Integration allows converting existing protocols and payload formats to Tesenso IoT Cloud message format and is useful in several deployment scenarios:
  • stream device and/or asset data from external system, IoT platform or connectivity provider back-end.
  • stream device and/or asset data from your custom application running in the cloud.
  • connect the existing device with custom HTTPS based protocol to Tesenso IoT Cloud.
Before creating the integration, you need to create an Uplink converter in Data converters. Uplink is necessary in order to convert the incoming data from the device into the required format for displaying them in Tesenso IoT Cloud. Click on the “plus” and on “Create new converter”. To view the events, enable Debug. In the function decoder field, specify a script to parse and transform data.
Example for the Uplink converter:
// Decode an uplink message from a buffer
// payload - array of bytes
// metadata - key/value object
/** Decoder **/
// decode payload to string
var payloadStr = decodeToString(payload);
var payloadJson = decodeToJson(payload);
// decode payload to JSON
var data = decodeToJson(payload);
var deviceName = 'Testdevice';
var deviceType = 'Testprofile';
//var customerName = 'Test Customer';
//var groupName = 'thermostat devices';
// use assetName and assetType instead of deviceName and deviceType
// to automatically create assets instead of devices.
// var assetName = 'Asset A';
// var assetType = 'building';
// Result object with device/asset attributes/telemetry data
var result = {
// Use deviceName and deviceType or assetName and assetType, but not both.
deviceName: deviceName,
deviceType: deviceType,
// assetName: assetName,
// assetType: assetType,
// customerName: customerName,
// groupName: groupName,
attributes: {
integrationName: metadata['integrationName']
},
telemetry: {
temperature: payloadJson.temperature,
humidity: payloadJson.humidity,
co2: payloadJson.co2
}
};
/** Helper functions **/
function decodeToString(payload) {
return String.fromCharCode.apply(String, payload);
}
function decodeToJson(payload) {
// covert payload to string.
var str = decodeToString(payload);
// parse string to JSON
var data = JSON.parse(str);
return data;
}
return result;
You can change the decoder function while creating the converter or after creating it. If the converter has already been created, then click on the “pencil” icon to edit it. Copy the configuration example for the converter (or your own configuration) and insert it into the decoder function. Save changes by clicking on the “checkmark” icon
NOTE While Debug mode is very useful for development and troubleshooting, leaving it enabled in production mode can significantly increase the disk space used by the database since all the debug data is stored there. It is highly recommended turning the Debug mode off after debugging is complete.

Create integration

Now that the Uplink converter has been created, it is possible to create an integration
Enable security option
If necessary, you can specify additional parameters, without which the data will not be included in the integration. To do this, check the Enable security checkbox and click on the Headers filter. Specify an arbitrary value and save the changes
Once the Headers filter has been configured, it will also need to be specified in the uplink message as follows.
-H "test-header:secret
To send an uplink message, you need a HTTPS endpoint URL from the integration. Let`s go to the Integrations tab in Tesenso IoT Cloud. Find your HTTPS integration and click on it. There you can find the HTTP endpoint URL. Click on the icon to copy the url
Use this command to send the message. Replace $DEVICEname, $DEVICEtype and $YOUR_HTTPS_ENDPOINT_URL with corresponding values.
curl -v -X POST -d "{\"deviceName\":\"$DEVICEname\",\"deviceType\":\"$DEVICEtype\",\"temperature\":33,\"model\":\"test\"}" $YOUR_HTTP_ENDPOINT_URL -H "Content-Type:application/json"
Use this command to send the message. Replace $DEVICEname, $DEVICEtype, $YOUR_HTTPS_ENDPOINT_URL and $VALUE with corresponding values.
curl -v -X POST -d "{\"deviceName\":\"$DEVICEname\",\"deviceType\":\"$DEVICEtype\",\"temperature\":33,\"model\":\"test\"}" $YOUR_HTTPS_ENDPOINT_URL -H "Content-Type:application/json" -H "$VALUE"
The created device with data can be seen in the section Device groups -> All
Received data can be viewed in the Uplink converter. In the “In” and “Out” blocks of the Events tab
Use the Dashboards to work with data. Dashboards are a modern format for collecting and visualizing data sets. Visibility of data presentation is achieved through a variety of widgets.
How to work with dashboards read here.
Create Downlink in Data converters. To see events enable Debug
Add a converter to the integration. You can customize a downlink according to your configuration. Let’s consider an example where we send an attribute update message. So we should change code in the downlink encoder function under line //downlink data input:
data: JSON.stringify(msg)
where msg is the message that we receive and send back to the device
An example of downlink converter:
// 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
var result = {
// downlink data content type: JSON, TEXT or BINARY (base64 format)
contentType: "JSON",
// downlink data
data: JSON.stringify(msg),
// Optional metadata object presented in key/value format
metadata: {
}
};
return result;