SmarIoT

Barebones REST App for IoT. Hooks up with TheThingsNetwork

What it is

• A very simple REST application written using Python and the Flask framework.
• Can be depolyed to Heroku's free-tier
• Can be connected to TheThingsNetwork via HTTP Integration to receive, store and visualize sensor data.

What it does

• Receives incoming JSON data as POST on the /data endpoint. POSTed data is parsed and the relevant info is persisted to PostgreSQL DB. POSTs are secured via an API_KEY. Unauthorized POSTs will be rejected with a 401

• Retrevies stored records as JSON via GET on the /db endpoint. A (optional) count of records to retrieve maybe specified. Eg: GET on /db/15 will return 15 latest records (if available) whereas a simple GET on /db will return the latest record

• Data in DB can be visualized as a line graph via the /viz endpoint.

Live Preview

A live instance is hosted and hooked up to receive a stream of LoRaWAN messages from TTN (one message exepected every 5 mins). Messages themselves are sent from out from a LoPy board.

Run Your Own Instance

• Create a new heroku via

• Once the instance is up, navigate to Heroku's Dashboard -> Your Application Name -> Settings and take note of the generated environment variable named API_KEY

• Follow TTN documentation and add a new HTTP Integration. Use your heroku's URL followed by /data for the URL field

• Ensure that the Custom Header Name is set to x-api-key and Custom Header Value is set to match the generated API_KEY

• Wait for some data to arrive. If everything is setup correctly, it'll show up on the homepage

Customizing SmarIoT

Details in customizing.md

ToDo

• Hook-up to TTN for testing
• Auto-refresh homepage
• Timestamps for requests
• Implement GET on the endpoint
• Save data to DB
• Add /db Endpoint for fetching data from DB
• Visualization of data (charts and stuff)
• Simple API Key auth for POSTing data to /data
• Upgrade to new data format
• Upgrade to chart.js ver 2.x
• Plot multi-line chart
• Get rid of cache + prep socketio (local machine)
• Pretty printing of requests on homepage using socketio
• Separate chart for each endnode's data
• Add fectching via parameters (by max count, by timestamp, by Hardware ID)
• DB housekeeping (rotate out old data so that it stays under 10k rows limit)
• Add a "live" chart (chart data as it is POSTed) using socketio