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
- 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:
- 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:
- 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
- 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
