Document hass

docs/space/srv-acraze/homeassistant.md

@@ -0,0 +1,56 @@
+# Home Assistant
+
+The [Home Assistant OS](https://www.home-assistant.io/installation/linux#install-home-assistant-operating-system)
+install running on `zombiehyperdrive.asozial.it-syndikat.org` (web interface
+available on <https://homeassistant.asozial.it-syndikat.org/>) allows
+controlling several space functions using cyber.
+
+## Power metering
+
+- A [go-e Controller](https://go-e.com/en/products/go-e-controller) in the
+  [fusebox](../electrical/README.md#fusebox) measures the incoming supply and
+  the lighting circuits, 3 phases each. It is connected via MQTT (over
+  Ethernet).
+- Several [Shelly PM Mini Gen3](https://us.shelly.com/products/shelly-pm-mini-gen3)
+  are hidden in the cable ducts to measure entire circuits. They are connected
+  via WiFi.
+- Several [Eightree ET21](https://eightreesmart.com/products/eu-wlan-smart-steckdose-misst-stromverbrauchsmesser-et21)
+  running [Tasmota] are plugged in series with appliances (fridges, dishwasher,
+  washing machine, etc). They are connected via WiFi.
+
+## Environmental sensors
+
+- A single IKEA sensor attached to the wall between Siebdruckwerkstatt and
+  Lötwerkstatt measures the "core temperature/humidiy" (as exposed via
+  [SpaceAPI](#spaceapi)).
+- An [ESP32-POE-ISO] running [ESPHome] in Coucharea measuring temperature,
+  humidity, pressure, CO2 and PM2.5+PM10
+- An [ESP32-POE-ISO] running [ESPHome] in TAK measuring temperature, humidity,
+  and CO2
+
+## Blinkenlights
+
+There are several [ESP32-POE-ISO] running [WLED] scattered all over the place,
+making WS2812 blink.
+
+## isitopen
+
+There is a small box at the top of the staircase (containing an [ESP32-POE-ISO]
+running [ESPHome]) with two buttons. The first person to enter the space
+presses the green button, the last person to leave presses the red button.
+
+An automation exists to do stuff (lights, phone do-not-disturb, etc) when the
+space opens/closes.
+
+The [matrix bot](matrix.md#bot-schizohal) can also make the box beep.
+
+## SpaceAPI
+
+Home Assistant serves our [SpaceAPI](https://spaceapi.io/) endpoint under
+<https://spaceapi.it-syndikat.org/api/>. It reports the state of
+[isitopen](#isitopen) and a couple sensor values.
+
+[Tasmota]: https://tasmota.github.io/
+[ESPHome]: https://esphome.io/
+[WLED]: https://kno.wled.ge/
+[ESP32-POE-ISO]: https://www.olimex.com/Products/IoT/ESP32/ESP32-POE-ISO/open-source-hardware

mkdocs.yml

@@ -12,6 +12,7 @@ nav:
       - 'Discourse': space/srv-acraze/discourse.md
       - 'DNS': space/srv-acraze/dns.md
       - 'Forgejo': space/srv-acraze/gitea.md
+      - 'Home Assistant': space/srv-acraze/homeassistant.md
       - 'LDAP': space/srv-acraze/ldap.md
       - 'Logging': space/srv-acraze/logging.md
       - 'E-Mail': space/srv-acraze/mail.md