How to integrate your SunEnergyXT 500/500 PRO with Home Assistant
Before You Begin

Please make sure your SunEnergyXT 500/500 PRO meets the following requirements:

  • Local mode is enabled

Please operate in the App to enable this function:

  • Open the App and go to the "Device Setting" page.
  • Tap "Local mode".
  • Toggle on the "Enable Local mode" switch.

The device will automatically refresh local network information. Please note down the displayed IP Address and Port (Default is 80). (The device supports automatic scanning and adding by HA by default; entering the IP directly is supported in some exceptional cases.)

Prerequisites
01

Install Home Assistant

Please visit: https://www.home-assistant.io/installation/

02

Complete Home Assistant onboarding

Please visit: https://www.home-assistant.io/getting-started/onboarding/

03

Install the Home Assistant Conmmunity Store (HACS)

Please visit: https://hacs.xyz/docs/use/

icon_arrow
Step-1| On the Home Assistant page, click "Settings" in the left sidebar, then click "About".
Step-2| View the Home Assistant installation method on this page.
  • If the installation method is "Home Assistant OS", select "OS/Supervised".
  • If the installation method is "Home Assistant Container", select "Container".
  • If the installation method is neither of the above, select "Core".
04

Check network connectivity

Make sure the SunEnergyXT 500/500 PRO and Home Assistant are connected to the same local network.

Integration Procedure

To make the integration process easier, it is recommended to complete the setup on a PC.

Once integrated, you can view device information in Home Assistant on your PC or mobile device.

Step-1 | Access the Home Assistant web interface.

Open a web browser on your computer and go to:

http://homeassistant.local:8123

(Ensure your computer and Home Assistant are on the same local network.)

Step-2 | Install Integration via HACS

Step-3 | Integrate your device into Home Assistant

1. On the Home Assistant page, click "Settings" in the left sidebar, then click "Devices & services".

Case A: Auto Discovery

If the system has automatically identified the device and displayed the device serial number, please select the device directly on the current page and click .

Case B: Manual Configuration

If the interface does not show the device to be added, it means the device was not automatically discovered. You need to enter the integration and manually add the device.

The "Manual Configuration" process is as follows:

1. Please fill in the following information accurately:

  • Host: The IP address of the device

2. After filling out the form, click "SUBMIT".

Step 4 | Verify Integration

Once the integration is successful, you can view device data and controls in Home Assistant, as shown in the highlighted area below.

Privacy Preference

We need your consent before you can continue visiting our website.

We use cookies and other technologies on our website. Some of them are essential, while others help us improve this website and your experience. Personal data may be processed (e.g. IP addresses), e.g. for personalized ads and content or ad and content measurement. For more information about how we use your data, see our privacy policy. You can revoke or adjust your choices at any time under Settings.