HYXI for Home Assistant (Marketplace integration)

Installs: 53 sharing analytics
GitHub stars: 15
Connection: Uses the vendor's cloud
Upkeep: Updated in the last 6 months
Version: v1.7.0, October 27, 2026
Kind: Marketplace integration
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: hyxi_cloud
Source: github.com/Veldkornet/ha-hyxi-cloud
Issues: Report an issue

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

Screenshots From the README of Veldkornet/ha-hyxi-cloud.

About

HYXI is a Home Assistant integration for HYXiPower solar inverters, batteries and meters. Data comes either through the HYXI Cloud with an account, or over a direct RS485 Modbus link to a single inverter, via a TCP gateway or a serial port. It adds sensors for battery charge, solar power, home load and grid flow, plus binary sensors, buttons, numbers and switches, and it supports the Energy Dashboard. Control entities for battery modes, power targets and protection thresholds stay hidden until Device Control & Protection is enabled in the options. Optional features include webhook push for live data and alarms, adjustable polling, and a beta Energy Manager that handles battery charging and discharging from a P1 meter and solar forecast. A set battery mode action is available for automations, and setup is done in the UI.

Automatic summary of the README and code of Veldkornet/ha-hyxi-cloud. Something wrong, or are you the maintainer and want your own text here? Get in touch

Supports

Uses the vendor's cloud Needs an internet connection and an account with the vendor.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.

Provides

Switches
Sensors

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

How should Home Assistant reach your HYXI system?

Connection method

Connect to HYXI Cloud

Access Key (AK)
Secret Key (SK)
Server Region
Enable Real-Time Webhook PushWhen on, HYXI sends live data and alarms to Home Assistant as they happen. This needs a public HTTPS URL that HYXI's cloud can reach; the next page asks which one. Off by default; the push rate can be set later in the options.

Push callback URL

Custom Callback URL (optional, dynamic default — base URL, path appended automatically)Optional. A public HTTPS address for HYXI's cloud to send push data to, if it isn't Home Assistant Cloud or Home Assistant's external URL. Enter the base URL only; the webhook path is added automatically.

How is the RS485 bus connected?

Connection type

Also asked when changing the connection.

Modbus TCP gateway

Gateway host or IP address
Port
Slave address

Serial port

Serial device
Baud rate
Slave address

Re-authenticate HYXI Cloud

Access Key (AK)
Secret Key (SK)
Server Region

After setup

Polling Interval (1-60 Minutes, Default: 5)
Polling Interval (1-60 Seconds, Default: 15)
Enable discovery via alarms (Advanced)
Enable Device Control & ProtectionEnable with caution if your inverter is already managed by your energy provider or enrolled in a Virtual Power Plant (VPP) programme. Sending commands while your provider has control may conflict with their dispatch schedule.
Enable Energy Manager Standalone (Beta)
Enable Real-Time Webhook Push
Push Update Frequency (seconds)
Custom Callback URL (optional, dynamic default — base URL, path appended automatically)
P1 Smart Meter (power sensor)
Solar Forecast Remaining Today (optional)
Solar Forecast Current Power (optional)
Inverter to Control
Override Battery Capacity
Battery Capacity (Wh)
Decision Loop Interval (seconds)
Dry-Run Mode (no API calls)

Texts from the code of Veldkornet/ha-hyxi-cloud.

Entities

Binary sensorsConnection Status, Active Problems, Night Mode, High Load Detected, Work Mode
ButtonsRestart Device, Mode: Idle, Mode: Charge, Mode: Discharge, Mode: Self-Consumption, Work Mode: Self-Use, Work Mode: Grid Backup, Work Mode: Time of Use, Peak Shaving: Turn Off, Peak Shaving: Force Charge, Peak Shaving: Force Discharge, Peak Shaving: Stop, and 7 more
NumbersTarget Charge Power, Target Discharge Power, Power Limit, Feed-in Power Limit, VPP Minimum SOC, Forced Charge Start SOC, Forced Charge Stop SOC, Off-grid Minimum SOC, Self-Use Reserve SOC, Discharge Minimum SOC, Backup Reserve SOC, Forced Charge SOC, and 23 more
SensorsBattery State of Charge, Battery Power, Solar Power, Home Load, Grid Import, Grid Export, Battery Charging, Battery Discharging, Total Energy Yield, Total Energy Yield B, Total Energy Yield C, Total Battery Charge, and 137 more
SwitchesFrequency Control, Power, Anti-Starvation Protection, Battery Dispatch Control, Grid Charge Allowed, Energy Manager, High Load Battery Assist, Night Mode, Export Limiting

Actions

Cancel SubscriptionManually cancel an active or orphaned push/alarm subscription on the HYXI Cloud server.Fields: Subscription Code, Entry
Set battery modeSend a battery operating-mode command to a HYXI inverter. Requires "Device Control & Protection" to be enabled for that entry, and is refused while the Energy Manager is managing the target inverter unless Force is set.Fields: Mode, Power, Force

Troubleshooting

DiagnosticsDownloads a diagnostics file to attach to a bug report.
Repair noticesNotices it can show in Settings, Repairs:Battery control isn't available over the HYXI Cloud, Energy Manager paused: no fresh data

From the README

Monitor your HYXIPower solar production, battery, and grid flow in real-time.
Bring your HYXIPower inverter, battery, and meter data into Home Assistant — over the HYXI Cloud (your account, any supported device) or a direct Local Modbus (RS485) connection to one inverter (no account, no internet dependency).
☁️ Cloud or 📟 local — pull data through the HYXI Cloud API, or talk straight to one inverter over RS485 Modbus for faster polling and no internet dependency (Local Modbus).
⚡ Energy Dashboard ready — native support for Home Assistant's Energy Dashboard (setup).
🔄 Real-time push — optional webhook subscriptions for instant telemetry and alarm updates, bypassing the poll interval (details).
🔧 Device control — opt-in inverter mode buttons, charge/discharge power, peak shaving, battery protection, and microinverter controls (reference).
🔋 Energy Manager (Beta) — an automated battery engine that manages charge/discharge from your P1 meter, solar, SOC, and forecast (guide).
📊 Diagnostics — dedicated sensors for cloud connectivity, data freshness, and sync latency.
🛡️ Resilient — 100% test coverage, and glitch-filtering that rejects impossible energy spikes and dips from cloud reporting delays.
🕥 Adjustable polling — 1 to 60 minutes.
🌍 20+ languages — English, German, French, Dutch, Afrikaans, Portuguese, Spanish, Italian, and more.

From the README of Veldkornet/ha-hyxi-cloud, MIT License. Shortened.