Guide Contents

• Sigfox registration
• Sigfox login
• Using Wia
• Wia Sigfox Setup
• Wia Sigfox message integration
• Creating Wia flows
• Re-programming your Siguino
  • What you will need
  • Install the IDE
  • Powering up your Siguino
  • Downloading Siguino code

Sigfox Registration

• Device is pre-registered. Activate at following site:
  • http://buy.sigfox.com/activate
• 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

• Siguino board (Available here).
• FTDI breakout board-5V/3.3V version.
  • NOTE:The Siguino runs a 3.3V Atmel CPU so MUST be powered at 3.3V
  • Dual 5V/3.3V FTDI devices are widely available for ~€15 or less.
  • For multiple devices these have been found to work fine at £12 for 3:
    • https://www.amazon.co.uk/gp/product/B0753GY7FR/ref=oh_aui_detailpage_o04_s00?ie=UTF8&psc=1
• A 6 way female to female ribbon cable to connect FTDI to Siguino. For example this kit includes a 40 way you can split:
  • https://www.amazon.co.uk/Elegoo-120pcs-Multicolored-Breadboard-arduino-colorful/dp/B01EV70C78/
  • Only needed if your FTDI device does not come with one!
• A USB to mini USB cable to connect FTDI header to conputer USB port. Eg:
  • https://www.amazon.co.uk/AmazonBasics-USB-Male-Mini-B-Cable/dp/B00NH13S44
• Linux, Apple or Windows machine.

Install the IDE

• Install Arduino IDE on your development machine.
  • Download from here:https://www.arduino.cc/en/Main/Software
  • Helpful tutorial: https://learn.sparkfun.com/tutorials/installing-arduino-ide/all
• Open the IDE.
• Open menu Tools->Port:
• Make a note of port list – you will need to select the correct port when your FTDI connects.

Powering Up Your Siguino

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:
  • https://github.com/adafruit/Adafruit_Sensor
  • https://github.com/adafruit/Adafruit_BME280_Library
  • https://github.com/PaulStoffregen/AltSoftSerial
  • https://github.com/rocketscream/Low-Power
  • https://github.com/sparkfun/SparkFun_LIS3DH_Arduino_Library
• 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