view README.md @ 1560:c3d699b5759c

more py3 fixes Ignore-this: f212b4a5edf8e599e9efd70bc65e7651 darcs-hash:d944ca9d7d7b36c2c02529dcf9225a99c0aa1831
author drewp <drewp@bigasterisk.com>
date Fri, 14 Feb 2020 00:33:31 -0800
parents a3dc6a31590f
children
line wrap: on
line source

# Goals

Make rules easy to add and experiment with. 
Be transparent and debuggable. 
Don't pack things into names that need to be parsed out. 
Prefer RDF and URIs over ad-hoc structures and ids. 
Integrate with lots of outside data sources. 

## Input

Services create RDF graphs (legacy) and send MQTT messages (esp32 nodes, and eventually everything)

`mqtt_to_rdf` gathers those inputs; writes some of them to influxdb; turns them into an RDF graph

`collector` takes multiple RDF graphs and merges them into new combinations

## Reasoning
`reasoning` takes an RDF graph and N3 rules; emits an RDF graph (and makes HTTP PUT and POST requests)

## Output

`rdf_to_mqtt` takes RDF graph and emits MQTT messages

(`reasoning` does some of its own output actions)

Services (sometimes, the same ones that gathered input) perform home automation outputs.

## Protocols

A SyncedGraph can be updated on a server such that the updates (as Patch objects) are sent as JSON-LD over a long-running SSE connection. There's a Patches-over-websocket connector in the `rdfdb` repo.

MQTT: Matching a lot of what esphome.io has, which maybe is compatible with homeassistant?