Siguino - Getting Started Guide

Use this guide for getting started by registering your device with Sigfox and optionally re-programming your device or integrating with Wia.

Sigfox Registration

  • Device is pre-registered. Activate at following site:
  • Scroll down list and select your country eg. Ireland.
  • Click NEXT at bottom right.
  • Enter Credential: Device ID & PAC Code
    • These are included with your Siguino board.
  • Click NEXT at bottom right.
  • Complete your registration with your name, email & company etc.
    • Check Terms & Conditions box.
    • Click “Activate your kit”
  • Should get “Congratulations”page!
  • Complete “Purpose of project” and Description boxes.
  • NOTE: More info here: https://siguino.com/getting-started-with-siguino-and-wia-io/

Sigfox Login

  • Follow link to http://backend.sigfox.com

  • Sign in using the credentials created activating your device.
  • Click Device Type in top menu.

  • In the right hand column of the table “name” your device name is a link – click it.

  • Now click “Associated Devices” on the left hand menu.

  • The entry in the ID column (6 hex chars) of this table is also link – click it then “Messages” in the left menu.

  • This gives a list of details of messages sent so far.

  • You have a working Siguino sending data!

  • NOTE: On power-up  the Siguino will send one Sigfox message containing it’s test sensor data.
  • This will repeat every 15 minutes – a frequency that will keep it below the 140 message per day limit.
  • Now need to make sense of the data in the next section.

Using Wia

  • Create a free account with Wia:  https://www.wia.io/signup 
  • Enter name, email and password with 8 chars or more. Tick age checkbox.
  • Create Your First Space. Enter name eg MySpace1 & click Create Space button.
  • Add a device… Name: Siguino, Type: Custom, Model: Custom & click Add Device.
  • Click settings icon (gear) from the left menu and then the “integrations” tab at top.
  • Of the box options find Sigfox and click the power-on icon at bottom of that box.

 

Wia Sigfox Setup

  • A frame will appear for API Login and API Password details from Sigfox.
  • You will need to go back to your Sigfox web page to produce these.
  • Return to your Sigfox page and click “Group” from top menu.
  • Only one will be listed in the body of the page – click this one.
  • Details of this will be shown – click API Access from left menu.
  • Click “New” in top right-hand corner.
  • Enter “Wia” as “name”.
  • Leave timezone Europe/Dublin (or change if needed).
  • Select “Devices Messages” from Profile list.
  • Click “Ok” button.
  • A page of data will appear including Login and Password details as hex strings.
  • Copy Login and password to Wia “Setup Sigfox Integration” box input boxes.
  • Then click “Create Integration” button.
  • Should get success message and back to Integrations page.

 

Wia Sigfox Message Integration

  • Back on the Wia “Integrations” page the power button should now show “On” on Sigfox box.
  • Now we need to create a “Call back”.
  • You will need a key from your Wia integrations page.
  • Click the Settings ican (gear) to the right of the power-on icon in the Sigfox box on your integrations page.
  • Your “inbound key” will be at the bottom of that frame. The rest of the page details used as below.
  • On Sigfox dashboard select “Device Type” and click on name of device in list.
  • Click CALLBACKS in left menu.
  • Click “New” in top right-hand corner.
  • Select “Custom Callback” from list in main page.
  • Leave default Type “DATA” / “UPLINK” & Channel “URL”.
  • Change “Use HTTP Method” to “POST”.
  • In “URL Pattern” box paste https://api.wia.io/v1/events
  • Set Header = “Authorization” Value = Bearer [YOUR INBOUND KEY]
  • Replace “[YOUR INBOUND KEY]” with the Inbound Key produced above.
  • Click “Ok” button and bottom of page.

Creating Wia Flows

  • On your Wia MySpace page click the “Flows” icon in the left menu to open flows page.
  • “Click here” to create your first flow.
  • Enter Flow name eg. “Temperature” & click “Create Flow”.
  • Select “Trigger” from top left horizontal menu.
  • Drag event box to work area.
  • Name it “sigfoxDataUplink”, Select your device from the box & click “Update” button.
  • Select “Logic” tab from top left Trigger/Service/Logic/Action menu.
  • Drag “Run Function” to work area.
  • Copy “Javascript Code for Data extraction” from Siguino “Getting Started” page:
  • https://siguino.com/getting-started-with-siguino-and-wia-io/
  • Paste sample Javascript code into Code Block on Configure Logic box.
  • You should get “Your code is looking good” message. Click “Update” button.
  • Add output event. Select “Action” menu on left and drag “Email” box to work area.
  • Fill in your email address, a subject eg “My Siguino data”.
  • In Body use text with embedded variable available from list on right eg: temp = ${input.body.data}
  • When complete click “Update”.

Re-programming Your Siguino

  • Your Siguino is capable of sending useful data and above you set it up with Wia to report temperature to you.
  • And there are many more things you can do by adding more Wia constructs.
  • Or by integrating with IFTTT and similar services.
  • However, the REAL power to do almost anything you need comes from re-programming your Siguino!

What you will need

Install the IDE

Powering Up Your Siguino

  • Connect FTDI interface to Siguino board with the 6 way ribbon cable.
  • Take care to connect the header pins in the correct order – they go in sequence.
  • DTR at one end and Ground at the other.
  • If dual voltage supported on your FTDI ensure the 5V / 3.3V jumper is set to 3.3V.
  • Plug the USB cable into the FTDI header and into USB port on dev machine.
  • When powered up check the IDE menu Tools->Port again for a new entry.
    • Select this new entry if not already selected eg. /dev/ttyUSB0 (or COM1 etc).
  • Click IDE top right icon‭ “‬Serial Monitor‭”‬.
  • On serial monitor window set‭ ‬9600‭ ‬baud on bottom right drop-down select box.
  • Dev ID and PAC Code‭ ‬response from Sigfox module ‭ ‬will ‬appear after a few seconds.‭
  • These will be the same values used during registration.
  • Power cycle by unplugging and re-plugging the USB cable if you missed it!

Download Siguino Code

  • All code is available on github: https://github.com/statts/siguino
  • Clone this code to your code dev folder:
  • From a terninal in your dev folder type “git clone https://github.com/statts/siguino.git”
  • This will save all code to “siguino” subdir.
  • Open the Arduino IDE and Load Siguino code into Arduino dev env (tested on 1.8.4).
  • From top menu File -> Open and navigate to  ../siguino/arduino/sigfox_sensors/sigfox_sensors.ino file and click “Open”.
  • Before you attempt to compile you will need to download required zip libraries or you will see a lot of errors.
  • These can all be added by downloading zip library files:
  • Once you have downloaded these library zip files add them to your IDE Sketch:
    • Sketch -> Include Library -> Add .ZIP Library & navigate to the file in your local download folder.
    • Select zip file and click “Ok”.
  • When all libraries have been included compile with “Verify” button.
  • There should be no errors now.
  • Ensure your Siguino is connected (see “Powering Up” above).
  • Click right-arrow button “Upload” – this will recompile the code and if successful download it to your Siguino board.
  • This will apply the latest version of the code that comes pre-installed in your Siguino device.
  • You should get an email with the temperature recorded at your Siguino. Every 15 minutes!
  • For more useful ways to use this data, for example graph it over time see: https://developers.wia.io/docs/add-a-widget

 

Contact Us!