Home Assistant custom integration for Geyserwala
At present this integration is a custom integration, a few steps are required to install it into your Home Assistant:
- Download this repository as a ZIP file by clicking this link.
- Uncompress the ZIP file, and browse into it.
- Move/copy the
thingwala_geyserwala
folder to.../homeassistant/core/config/custom_components/thingwala_geyserwala
. - On the side bar menu select "Developer Tools".
- At the bottom left of the "Check and Restart" panel, click "CHECK CONFIGURATION".
- If you see "Configuration will not prevent Home Assistant from starting!", then click "RESTART" at the bottom right of the panel.
The integration is written to allow Home Assistant to discover your Geyserwala on your network using Zeroconf. However if you do not get a notification:
- On the side bar menu select "Settings".
- Then select "Devices & Services"
- Then click "+ ADD INTEGRATION" at the bottom right of your browser.
- Type "Geysewala" into the search box.
- "Geyserwala" should show up in the list, click it.
- Enter the device details.
- You can use your Geyserwala
IP
address as theHost
, which you can find by looking on the device menus. Press SET 4 times, "Info" page 1.
- You can use your Geyserwala
- Click "SUBMIT", and then "FINISH".
- Your Geyserwala should now be available to your Home Assistant dashboard.
Note the integration includes advanced entities which are hidden by default. To change this: go to "Setings" -> "Devices & Services" -> Click the Geyserwala "entities" -> Adjust filters to show hidden entities -> Select the desired entites -> Click "ENABLE SELECTED" -> Edit the entities "Advanced settings". (If you find the Entity Status selection is disabled, first hide the entity.)
It is possible to configure additional entities to access more advanced Geyserwala values by adding an entry to configuration.yaml
, e.g.:
thingwala_geyserwala:
custom_entities:
sensor:
- name: Element Runtime
key: element-seconds
device_class: duration
icon: mdi:heating-coil
visible: True
unit: s
- name: Element Cycles
key: element-cycles
icon: mdi:heating-coil
visible: True
- name: Pump Runtime
key: pump-seconds
device_class: duration
icon: mdi:pump
visible: True
unit: s
- name: Pump Cycles
key: pump-cycles
icon: mdi:pump
visible: True
Entity types binary_sensor
, number
, sensor
, switch
and text
are supported. The schema for each type is defined in the Python file of the same name in the source.
Yes please! We want our Geyserwala integration with Home Assistant to be the best it can be for everyone. If you have Home Assistant development experience or have just noticed a niggly bug, feel free to fork this repo and submit a pull request.
See Set up Development Environment for more details. Checkout your fork to a convienient location (inside the container scope) and symlink the thingwala_geyserwala
folder to .../core/config/custom_components/thingwala_geyserwala
.
In the spirit of the Hackers of the Tech Model Railroad Club from the Massachusetts Institute of Technology, who gave us all so very much to play with. The license is MIT.