nixes/iothublib

a library for the esp8266 arduino platform that allows easy writing of sensor node programs for the iotHub platform

iotHub Arduino Library

This is a library for the esp8266 arduino platform that allows easy writing of sensor / actor node programs for the iotHub platform.

Should support up to 20 sensors per device.

Stable releases are found under releases.

Dependencies

• aWOT
• ArduinoJson

Example

The /examples folder contains some simple heavily commented examples of usage including both sensors and actors

iothublib's Issues

move sensor state to the sensor struct

http responses are being sent one byte at a time

GET request for a favicon.ico causes crash

restructure to arduino library standards

latest code is very crashy

Seems to only happen when something is routed.

Reset codes provide no help.
Maybe I'm not yielding enough?

implement actor support

Based on api described here: Nixes/iotHub#24

switch to using built in httpclient library rather than raw tcp

enable firmware update on local network

This would be important for any real world deployment, where bugs will be found in this library and people will want to update their devices.

get actor side restful api functional

Currently trying to use aWOT for a nice api router interface but bumping into problems using class state from within callbacks.

Solutions I can think of include, overloads for non-static class methods. Or the addition of an option to pass pointers to internal objects through the route interface. The final option I can think of is the use of global variables to store sensor and actor objects, and the reading of state from within the router callbacks.

add timed sleep / wake up functionality

Allow user to handle own sensor data gathering / processing

Currently thinking that callbacks aka function pointers might be the best way to go about this.

Good stuff here: http://arduino.stackexchange.com/questions/23063/user-callback-functions

overread of sensor ids

Read from eeprom into sensor_ids: 57b6ee6696069f5c1384272957b6ee6696069f5c1384272a
Read from eeprom into sensor_ids: 57b6ee6696069f5c1384272a

could probably fix by just reading as one big block into multidimensional array

add function pointer support for actors

implement firewall to protect against crappy NAT configs

Not a bad start: https://github.com/joemcmanus/ESP8266-Firewall

Practical function would be to prevent internet access from ip's that are not on the local subnet.

Save current sensor config to file system

Use this:
https://github.com/esp8266/Arduino/blob/master/doc/filesystem.md

How to allow multiple actors with different state types?

Some ideas so far:

• Have a separate array for each type of actor struct and have an actor struct for each type,
• Have the state actually be a json object and the callback function decides what to do with it.
• Do some crazy templating so we can determine type at compile time (but this would allow only actors of the same type)

allow going into deep sleep for longer sleep intervals

If a sleep interval is over 30 seconds, use deep sleep instead.

check sensor ids are valid for selected server

if they are not valid, then attempt to obtain new ids

better look after eeprom, reduce unnecessary writes / clearings

Specific circumstances:

• If server 404's and only one nodes registration fails continuously. Then the working nodes id will constantly get overridden.
• Clearing of first boot bit when node is not recognised by server and registration succeeded anyway.

Arduino class constructor with arguments

So I'm having trouble defining the class constructor in the way that I would in normal c++ when it requires parameters.

Some clues: http://forum.arduino.cc/index.php?topic=45931.0

actors never invalidated if they registered successfully

Fix this by checking if an actor is still valid before committing to a complete boot.
Just do a get to /api/actors/invalid_id if anything but a 200 response unset first boot bit.