annotate README.md @ 1544:33076ad439d1

fixes to TS and page build. remove some unused attempts at binding to <streamed-graph> Ignore-this: dc4cd74d21fef101b32da824bbf60a00 darcs-hash:46f8164157442fb22e93a3e2062ffbcd20b43350
author drewp <drewp@bigasterisk.com>
date Thu, 13 Feb 2020 10:17:54 -0800
parents a3dc6a31590f
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1530
f4e1493e9526 there's a plan
drewp <drewp@bigasterisk.com>
parents:
diff changeset
1 # Goals
f4e1493e9526 there's a plan
drewp <drewp@bigasterisk.com>
parents:
diff changeset
2
f4e1493e9526 there's a plan
drewp <drewp@bigasterisk.com>
parents:
diff changeset
3 Make rules easy to add and experiment with.
f4e1493e9526 there's a plan
drewp <drewp@bigasterisk.com>
parents:
diff changeset
4 Be transparent and debuggable.
f4e1493e9526 there's a plan
drewp <drewp@bigasterisk.com>
parents:
diff changeset
5 Don't pack things into names that need to be parsed out.
f4e1493e9526 there's a plan
drewp <drewp@bigasterisk.com>
parents:
diff changeset
6 Prefer RDF and URIs over ad-hoc structures and ids.
f4e1493e9526 there's a plan
drewp <drewp@bigasterisk.com>
parents:
diff changeset
7 Integrate with lots of outside data sources.
f4e1493e9526 there's a plan
drewp <drewp@bigasterisk.com>
parents:
diff changeset
8
f4e1493e9526 there's a plan
drewp <drewp@bigasterisk.com>
parents:
diff changeset
9 ## Input
f4e1493e9526 there's a plan
drewp <drewp@bigasterisk.com>
parents:
diff changeset
10
f4e1493e9526 there's a plan
drewp <drewp@bigasterisk.com>
parents:
diff changeset
11 Services create RDF graphs (legacy) and send MQTT messages (esp32 nodes, and eventually everything)
f4e1493e9526 there's a plan
drewp <drewp@bigasterisk.com>
parents:
diff changeset
12
f4e1493e9526 there's a plan
drewp <drewp@bigasterisk.com>
parents:
diff changeset
13 `mqtt_to_rdf` gathers those inputs; writes some of them to influxdb; turns them into an RDF graph
f4e1493e9526 there's a plan
drewp <drewp@bigasterisk.com>
parents:
diff changeset
14
f4e1493e9526 there's a plan
drewp <drewp@bigasterisk.com>
parents:
diff changeset
15 `collector` takes multiple RDF graphs and merges them into new combinations
f4e1493e9526 there's a plan
drewp <drewp@bigasterisk.com>
parents:
diff changeset
16
f4e1493e9526 there's a plan
drewp <drewp@bigasterisk.com>
parents:
diff changeset
17 ## Reasoning
f4e1493e9526 there's a plan
drewp <drewp@bigasterisk.com>
parents:
diff changeset
18 `reasoning` takes an RDF graph and N3 rules; emits an RDF graph (and makes HTTP PUT and POST requests)
f4e1493e9526 there's a plan
drewp <drewp@bigasterisk.com>
parents:
diff changeset
19
f4e1493e9526 there's a plan
drewp <drewp@bigasterisk.com>
parents:
diff changeset
20 ## Output
f4e1493e9526 there's a plan
drewp <drewp@bigasterisk.com>
parents:
diff changeset
21
f4e1493e9526 there's a plan
drewp <drewp@bigasterisk.com>
parents:
diff changeset
22 `rdf_to_mqtt` takes RDF graph and emits MQTT messages
f4e1493e9526 there's a plan
drewp <drewp@bigasterisk.com>
parents:
diff changeset
23
f4e1493e9526 there's a plan
drewp <drewp@bigasterisk.com>
parents:
diff changeset
24 (`reasoning` does some of its own output actions)
f4e1493e9526 there's a plan
drewp <drewp@bigasterisk.com>
parents:
diff changeset
25
f4e1493e9526 there's a plan
drewp <drewp@bigasterisk.com>
parents:
diff changeset
26 Services (sometimes, the same ones that gathered input) perform home automation outputs.
1531
a3dc6a31590f protocol notes
drewp <drewp@bigasterisk.com>
parents: 1530
diff changeset
27
a3dc6a31590f protocol notes
drewp <drewp@bigasterisk.com>
parents: 1530
diff changeset
28 ## Protocols
a3dc6a31590f protocol notes
drewp <drewp@bigasterisk.com>
parents: 1530
diff changeset
29
a3dc6a31590f protocol notes
drewp <drewp@bigasterisk.com>
parents: 1530
diff changeset
30 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.
a3dc6a31590f protocol notes
drewp <drewp@bigasterisk.com>
parents: 1530
diff changeset
31
a3dc6a31590f protocol notes
drewp <drewp@bigasterisk.com>
parents: 1530
diff changeset
32 MQTT: Matching a lot of what esphome.io has, which maybe is compatible with homeassistant?