HMBridge – Phase 1

HMBridge wird eine lokale, modulare Bridge für MQTT-Geräte und RaspberryMatic.

Phase 1 enthält:

• Python-Projekt im src-Layout
• YAML-Konfiguration mit Umgebungsvariablen
• Konsolen- und Datei-Logging
• asynchronen MQTT-Client mit Wiederverbindung
• Topic-Handler
• Plugin-Grundgerüst
• Konfigurationsprüfung und Tests

Die Homematic-XML-RPC-Schnittstelle und der Shelly-Dimmer-Treiber folgen in Phase 2/3.

Installation

cd hmbridge-phase1
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e ".[dev]"
cp config.example.yaml config.yaml

Brokeradresse in config.yaml anpassen. Optional:

export HMBRIDGE_MQTT_PASSWORD='geheim'

Prüfen und starten

hmbridge --config config.yaml --check-config
hmbridge --config config.yaml

Testnachricht:

mosquitto_pub -h 192.168.1.10 -t hmbridge/test/hello -m '{"value":42}'

Tests:

pytest
ruff check .

Nächster Meilenstein

Ein minimaler Homematic-XML-RPC-Server mit einem virtuellen Dimmer:

Shelly brightness 0...100  <->  Homematic LEVEL 0.0...1.0

Development and contributions

Project architecture, roadmap and contribution rules are documented in:

• docs/architecture.md
• docs/roadmap.md
• docs/plugin-api.md
• CONTRIBUTING.md

Install local checks once with:

pre-commit install

Pull requests are automatically checked on Python 3.11, 3.12 and 3.13.