TapHome Home Assistant integration

TapHome integration into Home Assistant.

Supported devices

• Climates - thermostats
• Covers - blinds, shades, garage doors
• Fan - AO for air recuperation, HVAC dampers
• Humidifiers - DO, AO
• Lights - switch, brightness, RGB
• Sensors - Humidity, Temperature, Variable, Motion, Generic reed contact, Electric counter (consumption, demand), Brightness, Co2, Wind speed, Pulse counter (total impulse, current hour impulse, frequency)
• Switches - power outlet, digital out
• MultiValueSwitches
• Valves - DO, AO
• Time - variable with time conversion

Quick start

Install with HACS (recomended)

Do you you have HACS installed? Just search for TapHome and install it direct from HACS. HACS will keep track of updates and you can easly upgrade TapHome to latest version.

Install manually

1. Install this platform by creating a custom_components folder in the same folder as your configuration.yaml, if it doesn't already exist.
2. Create another folder taphome in the custom_components folder. Copy all files from this repository into the taphome folder.

Configuration

The configuration is described in more detail in the wiki

1. Use config-generator to generate your config
2. Copy config to your configuration.yaml

If you used first preview of this component (2020.1.1-pre). Your TapHome entities'll duplicate after update. Please follow next steps

1. Disable taphome (comment taphome section in your configuration.yaml)
2. Restart Home Assistant Core
3. Remove all TapHome entities
4. Uncomment taphome section in your configuration.yaml
5. Restart Home Assistant Core again

Home Assistant will recreate entities with same entity_id (If you're not change the name of taphome device in cloudapi setting). So you don't have to change your dashbords or scripts

License

This repository is under the GPL v3 with Commons Clause.

Contributing

1. Set up Home Assistant development environment
2. Clone this repository
3. Mount repository into dev container

  "mounts": [
    "source=/Users/martin/Repos/taphome-homeassistant,target=${containerWorkspaceFolder}/config/custom_components/taphome/,type=bind,consistency=cached"
  ],

1. The Home Assistant's devcontainer needs to get rebuilt via the Dev Containers: Rebuild Container with: Shift+Command+P(Mac) / Ctrl+Shift+P (Windows/Linux).
2. Find a good first issue for you.
3. Solve it and send me pull request :-)