view README.md @ 1692:2883da14847c

debugging and cleanup, as i looked for a bug
author drewp@bigasterisk.com
date Sat, 25 Sep 2021 22:20:00 -0700
parents def4a53cbb6c
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?