How To Guide: SIGFOX Gateway Plugin


August 03, 2016  |  By Dale Rankine

SIGFOX is the world’s leading provider of dedicated cellular connectivity for Internet of Things and M2M communications. Thinxtra, the Sigfox Operator for Australia and New Zealand, are one of Reekoh’s newest partners.

SIGFOX’ network complements existing high-bandwidth systems by providing economical, energy-efficient two-way transmission of small quantities of data over long distances, thus lowering barriers to wide implementation of IoT and M2M solutions, and greatly extending the battery and service life of connected devices.
Reekoh has developed a new plugin for SIGFOX which is now available in the Plugin Store. The SIGFOX Gateway Plugin enables Reekoh to ingest data from SIGFOX-powered devices via HTTP Callback API. We’ll show you how the plugin works through the guide below.
First off, you need to log in to your Reekoh account, and then navigate to Devices > Register New Device. Complete the form that comes next. You can also use any existing device in your instance, if you have one.
Next is to search and install the plugins you will be using by navigating to Plugins > Plugin Store. For this demo, we’ll be using SIGFOX Gateway and HTTP Webhooks Connector (this will integrate your Reekoh instance to any HTTP endpoint to POST and synchronize device data).
After you’ve installed your plugins, you can now create your topology by navigating to Topologies > Build New Topology. Complete the form that comes next.
Once your topology is set, configure your plugins by locating their respective categories in your topology. For example, the SIGFOX plugin should be configured under the Gateway category. Click Configure New, and then complete the form that comes next.
After you’ve configured both plugins, you should be able to see them in your topology.
Next, you need to configure your device in SIGFOX. Login to SIGFOX Control Panel, and then navigate to Device Type. Select the device type you’d like to configure a callback.
Once you’re directed to your selected Device Type’s Information page, navigate to Callbacks and then click New. On the Callback Configuration form, set the following fields:

    • Type – select Data as your type.
    • Channel – select URL as your channel.
    • URL Pattern – this should be set as http://(Your Instance ID).reekoh.com:(Port you’ve opened for the SIGFOX Gateway)/data. For example, http://mydemoinstance.reekoh.com:8058/data.
    • Use HTTP Method – select POST as your HTTP method.
    • Content Type – key-in application/json as your content type.
    • Body – this should be any body that conforms to SIGFOX’ JSON templating engine. See example below:

"device": "{device}",
"time": "{time}",
"snr": "{snr}",
"station": "{station}",
"data": "{data}",
"avgSignal": "{avgSnr}",
"lat": "{lat}",
"lng": "{lng}",
"rssi": "{rssi}",
"seqNumber": "{seqNumber}"

Click OK and SIGFOX will start sending data to your Reekoh gateway immediately.
For more info on how to customize your Reekoh topology, you can check out our Starter Guides in the Reekoh Help Center.