Skip to content
jmb42 edited this page May 27, 2017 · 18 revisions

Sigfox plugin

This plugin received callbacks from the Sigfox portal.

Features

It historizes messages received from callbacks create into the Sigfox backend portal. you will have all information about your Sigfox sensors centralised into Yadoms.

Configuration

YADOMS

Create a new plugin Sigfox. No data is required for this plugin. The only needed information, is the plugin number, that would be found into the Yadoms console, logs. Example :

12:59:04 : : [Information] : Start plugin instance Sigfox
12:59:05 : plugin.IpcAdapter#2 : [Information] : Message queue ID : yPlugin.d640c9e9-7da8-42d7-894a-7fd5622ce365
12:59:05 : Plugin.**2** : [Information] : #### START ####
12:59:05 : Plugin.**2** : [Information] : Opening message queues id yPlugin.d640c9e9-7da8-42d7-894a-7fd5622ce365
12:59:05 : Plugin.**2** : [Information] : Sigfox starting
12:59:05 : Plugin.**2** : [Information] : Sigfox configure logger : logs\plugins\2\plugin.log

Sigfox Portal

Into the callback page, create a new callback, by clicking "new".

The first thing from your Sigfox account is to create callbacks:

Please choose the following parameters:
Type : DATA or SERVICE, UPLINK.
Channel : URL.
Enter the url pattern to your Yadoms server : http://[name_server]/rest/plugin/xx/extraQuery/sigfox

  • name_server is the server name into Internet.
  • xx : is the plugin number, when created into Yadoms. This number could be retrieved from logs file, or the Yadoms console.

HTTP Method : POST
Content type : application/json
The body will contain the json message to be sent to Yadoms.

The plugin Sigfox treat two type of messages. Following structures must be configured into the body for the good operating.

message DATA

The default message structure is the following one :
{
"time" : "{time}",
"type" : "data",
"device" : "{device}",
"data" : "{data}",
"rssi" : "{rssi}",
"snr" : "{snr}"
}

Each embraced information are evaluated, and replaced by the final value by the Sigfox website.

message SERVICE

The message service, could provide for Yadoms the battery information. The default message structure is the following one :

{
"type" : "service",
"device" : "{device}",
"battery" : "{batt}",
"rssi" : "{rssi}",
"snr" : "{snr}"
}

Clone this wiki locally