Home Assistant Integration

Overview

The Domoriks Home Assistant integration connects your HA instance to the RS-485 bus as the Modbus RTU master. It communicates with Domoriks modules over a USB-to-RS485 adapter (or a direct RS-485 interface), and exposes each module’s inputs and outputs as native HA entities.

💡 Installation

Install via HACS or copy the custom_components/domoriks folder into your HA config directory. See the full setup guide in the docs.

Features

UI-based setup

Configure everything through the Home Assistant UI. No configuration.yaml editing required. The setup flow walks you through port selection, module discovery, and entity naming.

Serial Modbus RTU communication

Communicates with modules over:

USB — plug a USB-to-RS485 adapter into your HA host
RS-485 — direct serial port on a Home Assistant Yellow, RPi, or similar

Configurable baud rate, parity, stop bits, and polling interval.

Switch entities

Each relay output channel appears as a switch entity in Home Assistant. Name them, assign icons, and use them in dashboards and automations exactly like any other switch.

Gateway diagnostics device

A dedicated gateway device is created per config entry with the following diagnostic entities:

Entity	Type	Description
`sensor.domoriks_last_rx`	Sensor	Timestamp of last received Modbus frame
`sensor.domoriks_last_tx`	Sensor	Timestamp of last transmitted frame
`sensor.domoriks_bus_status`	Sensor	`ok` / `timeout` / `error`
`text.domoriks_raw_command`	Text	Stage a raw hex Modbus command
`button.domoriks_send_command`	Button	Send the staged raw command

Per-module output naming

During setup, name each relay output individually. Names and icons are stored in HA’s entity registry and appear in all dashboards.

Duplicate prevention

The integration prevents registering the same serial port twice, avoiding bus conflicts between multiple config entries.

Raw command service

An domoriks.send_raw_command service is available for automations that need to send arbitrary Modbus frames:

service: domoriks.send_raw_command
data:
  entry_id: "abc123"
  command: "01 05 00 01 FF 00"

Diagnostics download

Every config entry has a Download Diagnostics button in HA’s integration settings. The downloaded JSON includes bus stats, entity states, and connection parameters (sensitive values redacted).

Installation

HACS (recommended)

Open HACS → Integrations → Custom repositories
Add https://github.com/domoriks/ha-integration
Install Domoriks
Restart Home Assistant

Manual

# In your HA config directory:
mkdir -p custom_components/domoriks
cp -r ha-integration/custom_components/domoriks/* custom_components/domoriks/

Setup flow

Settings → Integrations → Add Integration → search Domoriks
Select your serial port from the dropdown
Configure baud rate (default: 9600)
The integration scans the bus and lists found modules
Name each output, assign icons
Done — entities appear immediately

Compatibility

Home Assistant Core 2024.1+
Python 3.11+
Any USB-to-RS485 adapter (CH340, FTDI, CP2102 based)
RS-485 on native UART (RPi GPIO, HA Yellow, etc.)