HYXI Cloud for Homey
Connect your HYXI Halo home battery to Homey through HYXI Cloud.
Monitor battery level, power, charging and discharging status, energy totals, temperatures, grid information and diagnostic data, and use the available status and measurements in Homey Flows.
This unofficial integration connects to the HYXI Cloud API using your personal developer credentials.
Download HYXI Cloud in the Homey App Store!
Getting Started – HYXI Developer Platform
Before you can connect your HYXI Halo battery to Homey, you need to create an application on the HYXIPOWER Developer Platform and generate your personal API credentials.
The process is straightforward and only needs to be completed once.
Step 1 – Register or sign in
- Open the HYXIPOWER Developer Platform.
- Click Sign In in the top-right corner.
- If you don’t have an account, select Register Now.
- Register using the same email address associated with your HYXI app and home battery.
- Complete the registration process and sign in.
Important: Use the same email address that your devices are registered to in the HYXI app. Otherwise, your battery or installation might not be accessible through the API.
Step 2 – Open Authentication
Once signed in to the Developer Platform:
- Click your account/profile menu in the upper-right corner.
- Select Authentication.
- The Authentication page allows you to manage applications and their API credentials.
Step 3 – Create an application
-
On the Authentication page, click Create Application.
-
Enter an application name, for example Homey HYXI Cloud.
-
Click Confirm to create the application.
-
The platform will generate your API credentials:
- Access Key (AK) – Identifies your application.
- Secret Key (SK) – Authenticates requests from your application.
Important: Copy and securely store both keys immediately. The Secret Key may only be displayed once during application creation.
Step 4 – Activate your API connection
After creating your application:
- Confirm that your application appears in the Authentication section.
- Make sure you have copied both the Access Key and Secret Key.
- Check that your HYXI Halo battery is online and visible in your regular HYXI app.
- Use your credentials in Homey to establish the API connection.
Creating the application generates the credentials needed to authenticate with HYXI Cloud. No separate activation link is normally required for this step.
HYXI Developer – Quick Start Documentation
Note: If your credentials are accepted but your devices are missing, verify that your developer account has access to the correct HYXI installation. Additional owner authorization or assistance from your installer/HYXI support may be required.
Connect HYXI Cloud to Homey
Once your developer credentials are ready:
- Install HYXI Cloud for Homey.
- Open the HYXI Cloud app settings in Homey.
- Enter your Access Key.
- Enter your Access Secret / Secret Key.
- Save your settings.
- Add your HYXI device to Homey using the HYXI Cloud app.
Homey can now retrieve available battery and energy information from HYXI Cloud.
Your HYXI Halo battery is now connected to your smart home!
Available Features
Battery Monitoring
- Battery state of charge (SoC)
- Charging and discharging power
- Battery operating status
- Available battery and energy measurements
Energy Monitoring
- Power and energy totals
- Grid information
- Available energy measurements
System Information
- Battery and device temperatures
- Device status
- Diagnostic information
- Available cloud measurements
Homey Flows
Use supported device measurements and status information in Homey Flows to build smart home automations.
Available capabilities depend on the device and the data exposed through the HYXI Cloud API.
Troubleshooting
My Access Key or Secret Key is not accepted
Verify that both credentials were copied correctly from the Authentication page. Do not enter your regular HYXI app password instead of the Secret Key.
My battery is not showing up
Make sure your developer account uses the same email address as your HYXI installation and that your device is online in the HYXI app. Check whether the correct owner account has access to the installation.
I can’t find my Secret Key
The Secret Key may only be visible when the application is created. If you didn’t save it, check whether the platform provides a regeneration option. Otherwise, create new credentials.
Some measurements are unavailable
Not every HYXI device exposes the same information through the cloud API. Certain values or operating modes may not be available.
Useful Links
Apps made by @LRvdLinden
See more apps below 👇🏻 or open the expandable section.
[quote=“LRvdLinden, post:1, topic:85452”]
Click to expand
[/quote]
Contribution
If you appreciate this app, fuel future development with a PayPal contribution, buy a round with iDeal or Bunq.me, or become a true supporter on Patreon.
Your support keeps the magic alive! 
have to fix pc one.
v1.1.5
Battery power direction: Fixed the HYXI Halo battery power direction so Homey correctly shows charging and discharging.
Enjoy the latest version of HYXI Cloud App with small improvements under the hood, ensuring a smoother experience for all users! 
Disclaimer 
