Integrations

Home Assistant

Enable MQTT in the admin page and point it at your broker. With HA Discovery turned on, the controller announces itself to Home Assistant whenever it connects and whenever Home Assistant restarts. Entities then appear with no YAML to write.

Home Assistant device Entity type Fields
OurBrewbot (controller) sensor firmware version, IP address, mDNS name, WiFi SSID, RSSI, free heap, uptime, chip ID, reboot reason and code
button reboot, all off
OurBrewbot F0–F3 (fermenters) sensor beer and ambient temperature, gravity and its source, attenuation, status, profile step
binary_sensor alarm
switch power, temperature control, profile running
number ceiling and floor temperature, hysteresis, compressor delay, OG, TG
text / select name, beer name, yeast / profile number
OurBrewbot Probe sensor, binary_sensor temperature, name, function, fermenter / active
OurBrewbot Tilt sensor, binary_sensor temperature, gravity, fermenter, function / active, is Pro
OurBrewbot iSpindel sensor temperature, gravity, corrected gravity, battery, RSSI, angle, run time

Controlling from Home Assistant#

By default, Home Assistant can only read values. To let it change settings, turn on Allow HA Control in the MQTT settings. The controller then accepts commands on <baseTopic>/+/+/set for switches, numbers, text, selects and buttons. It ignores out-of-range values, and the entity goes back to the real value within about a minute.

Dashboard#

A ready-made dashboard is in HomeAssistant/dashboard.yaml. It uses the Plotly graph, Mushroom and card-mod cards from HACS.