--- title: "HYXI" description: "HYXI is a Marketplace integration for Home Assistant. It has 53 installs sharing analytics, needs the vendor's cloud and was last updated October 27, 2026." canonical: "https://vulpo.app/integrations/marketplace/veldkornet-ha-hyxi-cloud" url: "https://vulpo.app/integrations/marketplace/veldkornet-ha-hyxi-cloud.md" last-updated: "2026-10-25" version: "1.4" --- # HYXI > HYXI is a Marketplace integration for Home Assistant. It has 53 installs sharing analytics, needs the vendor's cloud and was last updated October 27, 2026. 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](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=Veldkornet&repository=ha-hyxi-cloud&category=integration) On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=Veldkornet&repository=ha-hyxi-cloud&category=integration) ## 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. ## 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 Push**: When 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 & Protection**: Enable 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](https://github.com/Veldkornet/ha-hyxi-cloud). ## Entities - **Binary sensors**: Connection Status, Active Problems, Night Mode, High Load Detected, Work Mode - **Buttons**: Restart 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 - **Numbers**: Target 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 - **Sensors**: Battery 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 - **Switches**: Frequency Control, Power, Anti-Starvation Protection, Battery Dispatch Control, Grid Charge Allowed, Energy Manager, High Load Battery Assist, Night Mode, Export Limiting ## Actions - **Cancel Subscription**: Manually cancel an active or orphaned push/alarm subscription on the HYXI Cloud server. Fields: Subscription Code, Entry - **Set battery mode**: Send 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 - **Diagnostics**: Downloads a diagnostics file to attach to a bug report. - **Repair notices**: Notices 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](https://github.com/Veldkornet/ha-hyxi-cloud#readme), [MIT License](https://spdx.org/licenses/MIT.html). Shortened. ## At a glance - Kind: Marketplace integration - Number: 53 installs sharing analytics; 15 GitHub stars - Connection: Needs the vendor's cloud - Upkeep: Updated in the last 6 months - Needs: Needs the Marketplace (HACS on 2026.10 and older) - Latest version: v1.7.0, last updated October 27, 2026 - Domain: `hyxi_cloud` - Source: - Issues: - Screenshot: https://vulpo.app/integrations-img/ac7055ca859d71d9.webp (from Veldkornet/ha-hyxi-cloud's README) In Vulpo: Quick Toggle card, Button card, Chart card, Apple Watch, Control Center Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about) Last updated 2026-10-25. Source: https://vulpo.app/integrations/marketplace/veldkornet-ha-hyxi-cloud --- - HTML version of this page: https://vulpo.app/integrations/marketplace/veldkornet-ha-hyxi-cloud - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml