homeassistant-kohler

KO | EN

gitlite — search

#python #ai #typescript #machine-learning #deep-learning #docker #nodejs #awesome #vue #pytorch #security #ios #openai #open-source

homeassistant-kohler

(★ 20)

Kohler Integration for Home Assistant

homeassistant-kohler Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Kohler for Home Assistant

Local Home Assistant integration for Kohler DTV+ shower systems.

This project talks directly to the Kohler controller over your local network and exposes shower controls, outlet controls, diagnostics, and maintenance actions inside Home Assistant.

## Status

- Supported hardware: Kohler DTV+
- Transport: local polling over HTTP
- Home Assistant setup: config flow
- HACS compatible: yes

This is an independent community project. It is not affiliated with or supported by Kohler or the Home Assistant project.

## Features

- Primary shower control exposed through Home Assistant
- Per-outlet valve entities with friendly names and mapped icons
- Dynamic polling for faster updates while the shower is running
- Active user preset selection
- Light control for installed shower lights
- Steam control when a steam module is installed
- Maintenance buttons for time sync, massage toggle, update checks, and fault resets
- Translated valve settings surfaced as entity attributes
- Diagnostic entities for firmware, connection state, and calibration codes
- Downloadable Home Assistant diagnostics that include controller and Konnect error logs

## Entities

Depending on installed hardware and configuration, the integration can create:

- `climate` and `water_heater` shower control entities
- `valve` entities for each mapped shower outlet
- `light` entities for installed light modules
- `switch` entities for steam
- `select` entities for active user presets
- `button` entities for maintenance actions
- `sensor` and `binary_sensor` entities for diagnostics and device state

## Installation

### HACS

1. Open HACS.
2. Add this repository as a custom repository.
3. Choose the `Integration` category.
4. Install `Kohler`.
5. Restart Home Assistant.

### Manual installation

1. Copy `custom_components/kohler` into your Home Assistant `custom_components` directory.
2. Restart Home Assistant.

## Configuration

1. In Home Assistant, go to `Settings > Devices & services`.
2. Click `Add Integration`.
3. Search for `Kohler`.
4. Enter the IP address or hostname of your Kohler DTV+ controller.
5. Accept the liability terms to finish setup.

## What Gets Exposed

### Primary shower control

The integration exposes the shower as both a `climate` entity and a `water_heater` entity for broader dashboard and voice-assistant compatibility.

### Outlet controls

Each installed outlet is exposed as a Home Assistant `valve` entity. The integration uses the Kohler outlet mapping information to assign friendlier names and icons when possible, for example:

- `Shower Head 1`
- `Shower Head 2`
- `Hand Shower`
- `Body Sprayer`

Valve and outlet numbers are still available as attributes for automations and debugging.

### Device settings and diagnostics

The integration surfaces translated valve settings and diagnostics such as:

- Default temperature
- Max temperature
- Cold water timeout
- Auto purge duration
- Max run time
- Connection diagnostics for interfaces, controller, valves, and optional modules
- Six-port calibration codes
- Firmware versions

Home Assistant diagnostics downloads also include:

- Current values payload
- Current system info payload
- Outlet mapping state
- Controller error log
- Konnect error log

## Safety

This integration can control live water hardware. Before enabling it:

- Make sure you understand which outlets and valves are connected.
- Be careful with automations, voice assistants, and remote access.
- Test changes while you are present.
- Treat this integration as capable of turning on water.

## Waiver of Liability

This integration can read device state and send live commands to plumbing hardware, including commands that may start water flow. By installing, configuring, or using this project, you accept responsibility for the risks involved.

The software is provided as-is, without warranty of any kind. The maintainers and contributors are not liable for injury, water damage, property damage, equipment damage, data loss, downtime, or any other loss that may result from using this integration.

By accepting the liability terms during setup, you acknowledge that:

- you understand this integration can control real water hardware
- you are responsible for testing and operating it safely
- you accept the risk of damage or injury that may result from its use
- you will not hold the maintainers or contributors liable for resulting harm or loss

## Development

Create a virtual environment and install the test dependencies:

```console
uv venv
source .venv/bin/activate
uv pip install -r requirements.test.txt
```

Run the local checks:

```console
ruff check custom_components tests
ruff format --check custom_components tests
pytest
```

## Troubleshooting

- Confirm the controller is reachable from the Home Assistant host.
- Verify the Kohler web interface responds at the configured IP address.
- Use the integration diagnostics download in Home Assistant for a support bundle.
- Check the exported controller and Konnect error logs when diagnosing device-side faults.

## Contributing

Issues and pull requests are welcome.

If you are adding support for more Kohler hardware, improving diagnostics, or tightening entity behavior, please include:

- a short summary of the hardware or behavior being added
- local test results
- any screenshots or Home Assistant entity examples that help explain the change

homeassistant-kohler

homeassistant-kohler Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

homeassistant-kohler

homeassistant-kohler Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README