From 10aeab31f5707f4067518cb1f2567413292b54cf Mon Sep 17 00:00:00 2001
From: Xiretza <xiretza@xiretza.xyz>
Date: Wed, 19 Mar 2025 22:04:33 +0000
Subject: [PATCH] Document hass
---
docs/space/srv-acraze/homeassistant.md | 56 ++++++++++++++++++++++++++
mkdocs.yml | 1 +
2 files changed, 57 insertions(+)
create mode 100644 docs/space/srv-acraze/homeassistant.md
diff --git a/docs/space/srv-acraze/homeassistant.md b/docs/space/srv-acraze/homeassistant.md
new file mode 100644
index 0000000..f4350e8
--- /dev/null
+++ b/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
diff --git a/mkdocs.yml b/mkdocs.yml
index a2ce49b..aba4588 100644
--- a/mkdocs.yml
+++ b/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