Plug and play home automation solution. If a node fails just plug in another one and the system should continue with little to no disruption.
This is achieved through a combination of lansrv and nats-server. When a node starts up, nats-server uses lansrv to find all of the other active nodes on the LAN and join the cluster (or start their own if there are no available nodes). Events are published to the local nats-server, reducers written in Javascript calculate the new state and publish the resulting delta, and finally devices with plugins to control devices subscribe to the resulting state updates.
Home automation turns your home into one big user interface. The flux architecture is the best I've seen for managing stateful systems like this and Igor seeks to apply the concepts of flux to home automation. Specifically, it seeks to use the flux architecture as implemented by NGRX which adds the concept of effects which are functions that receive actions and produce 0:n actions as a result.
- Igor starts from a base state where no default values initialize the system.
- Actions/events are generated
- user actions involve changing settings (max/min temperature settings, triggering garage door, etc.)
- sensor actions report on how the environment has changed
- Effects (updating settings in a file/db, toggle GPIO pin, etc.) run based on the new proposed state and emit new actions
- Reducers are run to compute the desired state.
- The new state is published to the system.
- Controllers read the new state and run the necessary commands to their attached devices and report any errors as events returning to step #2.
Note: since the system communicates via NATS so update broadcasts can be sent specifically so {a: 1, b: {c: 2, d: 3}} where only c is updated can be broadcast on state.b.c with a message of 4 (or whatever the value was updated to).
Reducers are written in Javascript and run via Otto
- [] security
- choose serialization format -- JSON
Please do! PRs are certainly welcome. Note, this project is intended to be the base for a home automation system and will not house device drivers, user interfaces, etc. Those can exist in their own repositories.
Igor is a home automation system based on the [flux architecture](https://facebook.github.io/flux/). User commands, sensor readings,
and system notifications are all marked with a `type` attribute and the event is processed by scripted reducers that take a piece of the current
state of the system and compute a new state based on the event data.
Communication is handled by [NATS](https://www.nats.io/). NATS has a number of nice qualities that make it ideal for Igor. There are queue groups
that send messages to one member of the group at a time so only one node will ever process an event and publish any resulting state updates.
State is persisted on the file system ($IGOR_HOME/state), reducers are javascript scripts run by otto and are read from $IGOR_HOME/reducers (reducers
dictate what gets put into the state). Components are go plugins. All designed to be run on Raspberry Pis.
Reducers:
Currently only Javascript with otto. Would like to support Gentee and possibly arbitrary binaries or maybe even wasm