Echolo

The Echolo Developer Hub

Welcome to the Echolo developer hub. You'll find comprehensive guides and documentation to help you start working with Echolo's IoT Platform as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

The Echolo IoT Platform supports a special type of message that can be used for device telemetry data or location. The following will explain how to format this packet and send it to the Echolo IoT Platform.

Scan packet format

As stated above, the scan packet is specially formatted and is validated once sent, if the format does not match it will be rejected without response (due to the nature of the connections). Below is a correctly formatted scan packet.

{
    hubId: "MyHub1",
    data: {
        location: false,
        deviceType: "echolo"
    },
    scan: [
        {
            adData: "0000001010101",
            rssi: -28,
            node: "AB:CD:EF:12:34:56",
            time: "Tue Aug 29 04:44:36 2017",
            name: "MY Device Name"
        },
      	{
            adData: "8765467893232244000000033234ac3b21cb34e33f3d33a2ab3ca30",
            rssi: -51,
            node: "BB:CD:EF:12:34:00",
            time: "Tue Aug 29 04:44:36 2017",
            name: "Echolo Beacon"
        }
    ]
}

Send the Scan packet to the Echolo IoT Platform

Now that you have a valid scan packet, you can send this data into a shared topic outlined in Topics. The example below will assume you are sending in Bluetooth scan data using the bt share write-only topic share/hub/bt/scans.

let data = {
    hubId: "MyHub1",
    data: {
        location: false,
        deviceType: "echolo"
    },
    scan: [
        {
            adData: "0000001010101",
            rssi: -28,
            node: "AB:CD:EF:12:34:56",
            time: "Tue Aug 29 04:44:36 2017",
            name: "MY Device Name"
        },
      	{
            adData: "8765467893232244000000033234ac3b21cb34e33f3d33a2ab3ca30",
            rssi: -51,
            node: "BB:CD:EF:12:34:00",
            time: "Tue Aug 29 04:44:36 2017",
            name: "Echolo Beacon"
        }
    ]
}

iot.publish('share/hub/bt/scans', JSON.stringify(data))