Home Assistant Integration

The Pod Management app is a fork of Home Assistant Companion apps: https://github.com/home-assistant/android and https://github.com/home-assistant/iOS

Introduction to how we use Home assistant

The Home Assistant Companion apps are part of a software ecosystem that the Home Assistant team is maintaining. Our pods will be running an instance of Home Assistant on a Raspberry Pi (actually using https://github.com/home-assistant/operating-system, that includes Home Assistant core and some extras). That HA instance is configured for accepting remote connections.

All the hardware is connected to the Raspberry Pi using different physical connections and different protocols. A breakdown of what connections/protocols are used and documentation on the hardware side of things can be found in the Home Automation documentation.

Everything related to how the app looks like, behaves like and all the possible hardware that can be controlled from the app is configured in the Raspberry Pi HA instance by using the HA UI that stores the configuration in YAML files. Alternatively those YAML files can be modified directly. All those files can bee seen in this repo https://github.com/oceanbuilders/hass-integrations

Yaml Configuration files

automations.yaml

https://www.home-assistant.io/docs/automation/yaml/ 

Here a series of automations can be defined. They are created or modified using HA UI and stored in YAML.

Automations are a set of predefined actions that will happen automatically when a "trigger" happens and if a series of conditions are met.

configuration.yaml

This the main configuration file for Home Assistant. Contains information needed for all the hardware integrations. Many integrations will work out of the box and many can be added easily by applying integrations that the community have created https://www.home-assistant.io/integrations/

Some have to be created specifically for Ocean Builders hardware.

groups.yaml

lovelaceui.yaml

scenes.yaml

scripts.yaml

secrets.yaml

https://www.home-assistant.io/docs/configuration/secrets/

Here we store the passwords needed for several integrations. The passwords could be stored directly in configuration.yaml, but is cleaner and safer to store them in this separated file.

themes.yaml