Home Assistant Knowledgebase

A collection of guides, scripts, and documentation for Home Assistant configuration, debugging, and deployment.

📚 Guides

WH52 YAML Bridge

Decode Ecowitt WH52 soil sensors in Home Assistant using pure YAML (no Python required)

A temporary bridge for integrating Ecowitt / Fine Offset WH52 3-in-1 soil sensors (moisture, temperature, EC) into Home Assistant using MQTT and HA automations.

• Setup with RTL-HAOS add-on
• Flex decoder configuration
• Complete YAML package template with calibration guide
• Troubleshooting
• Upgrade path to native rtl_433 support (protocol 353)

Poolstation Modbus Migration

HTTP to Modbus TCP migration for Idegis pool controller

Complete guide for migrating from HTTP-based pool control to native Modbus TCP integration. Includes entity renaming, YAML updates, and rollback procedures.

• 53 Modbus entities mapped
• Automated and manual migration steps
• Entity renaming from idegis_domotic_* to poolcontroller_*
• Comprehensive troubleshooting
• Rollback instructions if needed

---

🛠️ Scripts

ha_control.ps1

Deploy Home Assistant YAML configuration from a Git repository over SSH

• Diff, pull and deploy between the repository and /config. A single-file upload is checked by sha256.
• Server-side backup before every deploy. It is restored automatically when the deploy fails or -Verify reports an invalid configuration.
• Pull refuses to overwrite uncommitted local changes.
• Reload one domain (automations, scripts, template entities, …) or restart, and wait until Home Assistant answers again.
• Dry run with -WhatIf. Exit code 1 on any failure.

ha_yaml.py

Canonical YAML formatting and diff by meaning

Keeps comments, key order and !secret tags. Reads YAML 1.1 like Home Assistant, and never writes a file whose meaning would change. ha_control.ps1 calls it automatically.

.deployignore

Sample deployment exclusions. Keeps .env, .git and other repository-only files out of /config.

Scripts Manual

Setup, commands, rollback, formatting and troubleshooting for both scripts.

---

🏠 Related Home Assistant Projects

Pool Management

• homeassistant-poolstation — Pool management custom component
• PyPoolstation — Python library for Poolstation

Smart Home Automation

• HA EV Charge Control — Home Assistant integration for EV smart charging: solar, EMS, price and the capacity tariff

Tools & Libraries

• IdegisModbus — Modbus utilities for Idegis devices
• alfen_modbus — Modbus integration for Alfen EV chargers
• HA_AI_Analyzer — AI-powered Home Assistant log analysis

---

📋 Quick Start

Put the three files from scripts/ into a Tools folder in your configuration repository, and create .env in the repository root. See the Scripts Manual.

.\Tools\ha_control.ps1 -Diff                                        # preview, changes nothing
.\Tools\ha_control.ps1 -Pull                                        # get UI-made changes first
.\Tools\ha_control.ps1 -Deploy -File automations.yaml -Verify -Reload -Target Automations
.\Tools\ha_control.ps1 -Deploy -Verify                              # full deploy, always with -Verify

---

📄 License

MIT License — see LICENSE