luisomoreau / sigfox-platform

Open Source platform to display and parse Sigfox messages in real time
GNU Affero General Public License v3.0
13 stars 6 forks source link

Sigfox Platform

This project is no longer maintain, please see the offical fork: https://github.com/IoT-Makers/sigfox-platform

About this project

This project is a cloud platform to manage and visualize Sigfox devices and messages.

Get started

Demo

Try it now with Heroku

Deploy an instance on your Heroku account to play around with it!

Warning: When using the free plan, the application goes to sleep after 30 min of inactivity (checkout the pricing).

Deploy

An alternative way to get it running at Heroku is to install the Heroku Toolbelt and follow these steps:

git clone https://github.com/IoT-Makers/sigfox-platform.git my-project
cd my-project
heroku apps:create my-project
git push heroku master

If you are not familiar with Heroku, just create an account an follow the procedure:

  1. Create a new app:

create app

  1. Build & deploy app:

build app

  1. (Optional) Link the application with a MongoDB MLab database (Free):

Note that if you don't link a database to your application, all the data will be erased every time the application restarts.

mlab-select-service

mlab-select-plan

mlab-select-region

mlab-create-db

mlab-validate

mlab-create-user

mlab-view-user

heroku-show-env-variables

heroku-add-MONGODB_URI

You may also add the variable SECRET with a password of your choice. This SECRET will be used to cypher all the connector passwords you add in the application.

heroku-restart-dynos

User guide

login

register

Note that, the first user to register will be granted an admin role. The other users to register will be granted user roles.

Development

This project uses Loopback 3, Angular 4, Fireloop and MongoDB.

Requirements

API (To Be Updated, below is an old version)

Below is the functional/sequential diagram representing the message journey.

message_journey

Webapp

Color code

GPS Sigfox WiFi BLE
#9B7A48 #9B7A48 #792FAA #792FAA #2F2A30 #2F2A30 #3C58CE #3C58CE

Developers

Linking a Sigfox device to the platform

Once the application is deployed, head over to the 'connectors'. You will need to create a developer access token in order to secure the API calls. You can then copy & paste the callback information you need in the device type new callback onto the Sigfox Backend.

Adding a custom parser

A short wiki can be found here.

Roadmap

Authors

Contributors

Feel free to submit a Pull Request and don't forget to add you name and your useful links ;)

Made with  :heart:  by Antoine de Chassey & Louis Moreau