Menu

TagoIO Visualisation - FlexSense

In this article:

    TagoIO

    TagoIO is an IoT cloud platform that transforms the way businesses create value from connected products and user interactions. It provides tools for your business to manage devices, store data, run analytics, and integrate services, with a high level of customization and specific functions based on your application.

    To find out more about the features of the platform and determine whether it is the right solution for you, check out the TagoIO website.

    Register your account

    TagoIO offers a free plan that enables you to set up and test your Myriota integration at no cost.

    Complete your registration before returning here to continue with the tutorial.

    Configuring TagoIO Visualisation

    If you aren't already, log in to your TagoIO account and familiarise yourself with the landing page.

    To begin setting up TagoIO, you must first register a device with TagoIO. You can do this from the main dashboard.

    1_connector_screen.png

    From the list of devices, choose Myriota, then Custom Myriota. 

    2_custom_myriota.png

    Give your device a name and enter its module ID.

    3_connector_setup.png

    From here you will need to generate an authorization token, this is a secure string that lets you add data to your device on TagoIO. Give your token a name, and proceed with the rest of the prompts. Copy the Myriota Authorization code (TOKEN) from the table that is associated with your device.

    4_auth_screen.png

    Now open Device Manager, and create a new HTTP destination. Specify the URL as https://myriota.middleware.tago.io/uplink?authorization=TOKEN, where TOKEN represents the token you generated earlier

    e.g.

    https://myriota.middleware.tago.io/uplink?authorization=at9a53c1b6276d4c71a5f5f5164c94ec24

    Now click Create.

    If required, you can find your token back in TagoIO on the General Information page for your device.

    5_destination.png

    Within the Device Manager, navigate to your device and assign the destination you have just created to complete the connection.

    Switch back to the device view in TagoIO, where you can now set up a parser. 

    6_device_config.png

    Enable the "Run your own parser" option.

    7_parser.png

    The nature of the parsing required will vary from app to app, but we have provided an example below to use with the default firmware on the Myriota FlexSense:

    const payload_raw = payload.find(x => 
    x.variable === 'payload_raw' || 
    x.variable === 'payload' || 
    x.variable === 'data'
    );

    if (payload_raw) {
    try {
    // Convert the data from Hex to Javascript Buffer.
    const buffer = Buffer.from(payload_raw.value, 'hex');

    // Define Message Types
    const MESSAGE_TYPE_LOCATION = 0;
    const MESSAGE_TYPE_SENSOR = 1;

    // Decode Header
    const message_type = buffer.readUInt8(0);
    const sequence_number = buffer.readUInt16LE(1);
    const time = buffer.readUInt32LE(3);
    const unixTimestampInSeconds = Math.floor(Date.now() / 1000);
    const latency = (unixTimestampInSeconds - time) / 3600;

    // Write header data
    let data = [];
    data.push({ variable: 'message_type', value: message_type });
    data.push({ variable: 'sequence_number', value: sequence_number });
    data.push({ variable: 'time', value: time });
    data.push({ variable: 'latency', value: latency });

    if (message_type === MESSAGE_TYPE_LOCATION) {
    // Decode location data
    const latitude = buffer.readInt32LE(7) / 1e7;
    const longitude = buffer.readInt32LE(11) / 1e7;

    // Write location data
    data.push({ variable: 'latitude', value: latitude });
    data.push({ variable: 'longitude', value: longitude });
    // NOTE: The field below adds support for using the map widget in the dashboard
    data.push({
    variable: 'location',
    value: 'sensor location',
    location: {
    lat: latitude,
    lng: longitude
    }
    });
    } else if (message_type === MESSAGE_TYPE_SENSOR) {
    // Decode sensor data
    const temperature = buffer.readUInt32LE(7) / 100;
    const value = buffer.readUInt32LE(11);

    // Write sensor data
    data.push({ variable: 'temperature', value: temperature });
    data.push({ variable: 'value', value: value });
    } else {
    throw new Error("Invalid Message Type!");
    }

    const date = new Date(0);
    date.setUTCSeconds(time);

    // Concatenate the content sent by your device with the content generated in this payload parser.
    payload = payload.concat(data.map(x => ({
    ...x, 
    group: payload_raw.group, 
    time: date 
    })));
    } catch (e) {
    // Print the error to the Live Inspector.
    console.error(e);

    // Return the variable parse_error for debugging.
    payload = [{ variable: 'parse_error', value: e.message }];
    }
    }

    With your parser in, click Save, in the bottom right corner.

    From here you can now begin creating dashboards for your device, click the + icon next to Dashboards to begin.

    For more information go to: https://community.tago.io/t/how-to-integrate-tagoio-with-myriota-satellite-connectivity/926

    Related articles