Report: EEBus Integration with Home Assistant 1. Executive Summary EEBus (Energy Efficiency Bus) is a communication standard designed to enable interoperability between smart home devices, energy management systems, and the power grid. When integrated with Home Assistant (an open-source home automation platform), EEBus facilitates automated, grid-aware energy optimization. This report outlines EEBus fundamentals, its technical implementation in Home Assistant, use cases, limitations, and future potential. 2. What is EEBus? EEBus is a vendor-independent, standardized communication protocol (based on SPINE – Smart Premises Interoperable Neutral-message Exchange) for the energy sector. It allows devices from different manufacturers to exchange energy-related information without proprietary gateways. Key features:
Use cases defined: e.g., EV charging, heat pump control, PV & battery optimization, load balancing. Transport agnostic: Works over Wi-Fi, Ethernet, Thread, etc. (IPv6-based). Semantic interoperability: Devices understand the meaning of data (e.g., “tariff change at 14:00” vs. raw values). Grid-aware operation: Supports demand response, self-consumption maximization, and grid congestion management.
3. EEBus Architecture in Home Assistant 3.1 Native Integration (Official) Home Assistant introduced native EEBus support via the EEBus Local API integration (introduced in HA Core 2024.x). It acts as an EEBus SPINE node on your local network. How it works:
HA discovers EEBus-compatible devices (e.g., wallbox, heat pump, smart meter) via mDNS/DNS-SD. HA establishes a secure SPINE connection (certificate-based). HA subscribes to device functions (e.g., ElectricalConnection , HeatingSystem , EVSE ). Entities are automatically created in Home Assistant (sensors, numbers, switches). eebus home assistant
Supported device types (in official integration):
EV charging stations (EVSE) Heat pumps (for heating/cooling) Battery storage systems Photovoltaic inverters Smart meters (grid-side) Controllable loads (e.g., water heaters)
3.2 Configuration Steps # Example configuration.yaml (basic) eebus: devices: - device_id: "wallbox_abc123" certificate: "/config/eebus/certs/wallbox.pem" Report: EEBus Integration with Home Assistant 1
Alternatively, configure via Settings → Devices & Services → Add Integration → EEBus . Manual steps:
Obtain device EEBus certificate (often generated via manufacturer app). Place certificate in Home Assistant /config/eebus/certs/ . Restart HA. Approve pairing in device UI (if required).
3.3 Exposed Entities After pairing, HA creates entities like: Challenges 6.1 Current Limitations in HA
sensor.ev_charging_power number.ev_max_charging_current sensor.heat_pump_operating_mode switch.battery_discharge_allowed sensor.grid_import_limit
4. Use Cases in Home Assistant | Use Case | EEBus Role | HA Automation Benefit | |----------|------------|------------------------| | PV self-consumption optimization | EV charger reports current PV surplus; HA adjusts charging current. | Use solar forecast + battery SOC to delay/accelerate charging. | | Time-of-use tariff shifting | Smart meter sends current tariff (e.g., high price 17:00–20:00). | HA pre-heats water or pre-cools house before peak period. | | Grid congestion management | Grid operator sends temporary import limit (e.g., 3.6 kW). | HA reduces heat pump power and pauses EV charging. | | Emergency islanding | Battery inverter signals grid loss. | HA disables non-critical loads automatically. | | Load balancing | HA reads main meter current; limits EVSE to prevent breaker trip. | Dynamically allocates available capacity to multiple large loads. | 5. Comparison: EEBus vs. Other Energy Integrations in HA | Feature | EEBus | Modbus | REST API (vendor) | MQTT | |---------|-------|--------|-------------------|------| | Standardization | High (cross-vendor) | Low (register map varies) | None | None | | Security | TLS + certificates | Often none | Token | Optional TLS | | Energy-specific semantics | Yes (SPINE) | No | Depends | Custom | | Discovery | Automatic | Manual | Manual | Manual | | Real-time grid signals | Yes (e.g., external grid limit) | No | Rarely | Custom | | Maturity in HA | Growing (since 2024) | Mature | Mature | Mature | 6. Limitations & Challenges 6.1 Current Limitations in HA