Skip to content

Repository files navigation

Anker Solix Official Integration for Home Assistant

HACS Badge GitHub Release License

The official Home Assistant integration for Anker Solix devices, developed and maintained by Anker Innovations.

This integration connects to your Anker Solix devices locally via Modbus TCP on your home network. All communication stays on your LAN — no cloud servers, no API keys, no internet dependency.

Features

  • Local Modbus TCP — Direct communication over LAN, no cloud dependency, no internet required
  • Real-time monitoring — Live device status, power metrics, and diagnostics updated every 5 seconds
  • Device control — Operating mode switching, power setpoints, and output control via Home Assistant UI

Preview

Supported Devices

This integration is built for select Anker Solix products, designed to take full advantage of their enhanced local Modbus TCP capabilities.

Device Firmware Support
Anker SOLIX Smart Plug Coming Soon
Anker SOLIX Smart Plug Gen 2 Firmware 0.0.8.4+
Anker SOLIX Solarbank Max AC All Firmware Versions
Anker SOLIX XE AC All Firmware Versions
Anker SOLIX Solarbank Max All Firmware Versions
Anker SOLIX XE All Firmware Versions
Anker SOLIX Solarbank 4 E5000 Pro All Firmware Versions
Anker SOLIX Smart Meter Gen 2 All Firmware Versions

More Anker Solix devices are being added progressively. Stay tuned for updates.

Other Anker Solix Products

Due to current product roadmap prioritization, this project focuses on select Anker SOLIX products to ensure stability, compatibility, and feature completeness. The following products are not part of the active integration scope. Anker provides official Modbus protocol documentation for reference:

Product Modbus Documentation
Anker SOLIX X1 Series Modbus Protocol Reference
Anker SOLIX V1 Smart EV Charger Modbus Protocol Reference

Prerequisites: Enable Modbus TCP in Anker App

Before setting up this integration, you must enable Modbus TCP on your device through the Anker App.

Step 1: Open the Anker App and go to the Devices tab. Select your device.

Step 2: Tap the Settings icon (gear icon in the top right corner) to enter the device settings page.

Step 3: Tap Three‑Party Control Settings.

Step 4: Enable the Modbus TCP toggle. Note down the IP address displayed — you will need it when adding the integration in Home Assistant.

Installation

HACS (Recommended)

  1. Open HACS in Home Assistant
  2. Go to Integrations and click +
  3. Search for Anker Solix Official
  4. Click Install and restart Home Assistant

Manual

  1. Download the latest release
  2. Copy custom_components/anker_solix_official/ into your Home Assistant config/custom_components/ directory
  3. Restart Home Assistant

Setup

  1. Go to Settings > Devices & Services
  2. Click Add Integration
  3. Search for Anker Solix Official
  4. Enter your device's local IP address (Modbus TCP port 502 is used by default)
  5. The integration auto-detects the device model and loads the matching configuration

FAQ

What network port does this use? Modbus TCP on port 502 (standard Modbus port).

How often does data refresh? Every 5 seconds via local polling.

Can't connect to my device? Check that: the device is powered on and on the same network, the IP address is correct, Modbus TCP is enabled on the device, and no firewall is blocking port 502.

The Communication Settings option is greyed out and cannot be tapped? Possible reasons:

  1. The device has been added to a power station — you need to configure it from the power station settings page instead
  2. The device is currently offline — wait for the device to come back online
  3. The device firmware does not support this feature — check for firmware updates in the Anker App

Will Home Assistant control conflict with Anker App control?

  • When "Third-Party Controlled" mode is enabled, the device will execute commands from Home Assistant
  • When "Third-Party Controlled" mode is disabled, the device will follow the mode set in the Anker App
  • It is recommended to clearly define your control method to avoid frequent switching

Can I control multiple devices? Yes. You can add multiple Anker devices in Home Assistant, each configured and controlled independently.

Can I use the Anker App and Home Assistant at the same time?

  • Yes, both can be used simultaneously, but be aware of control priority
  • When "Third-Party Controlled" mode is enabled, Home Assistant commands take higher priority
  • Recommended division of responsibilities:
    • Anker App: Device configuration, firmware updates, detailed statistics
    • Home Assistant: Daily automation, control, and monitoring
  • Avoid modifying the same parameter on both platforms simultaneously, as this may cause conflicts

Q: Does the P1 Meter in the Netherlands support Home Assistant?

A: Since the Anker P1 Meter is designed as a plug-and-play meter reader (no electrician required for installation), it does not support the Modbus protocol. For Home Assistant integration, you can use third-party P1 meters such as the HomeWizard P1 or EcoTracker P1.

For more instructions on using Home Assistant and FAQs, please visit: https://anker-webview-eu.anker.com/home-assistant

Data Security

  • Local communication — All device control and data reading are performed over local LAN connections. No dependency on cloud servers. Data is transmitted directly between your local Home Assistant instance and the device.
  • Standard protocol — Uses the Modbus TCP standard protocol for communication.
  • Access control — Modbus access can be enabled or disabled at any time through the Communication Settings toggle in the Anker App. When disabled, no external platform can access the device via Modbus.

Troubleshooting

Connection Issues

Cannot discover the device:

  • Confirm the device and Home Assistant are on the same LAN
  • Confirm the Modbus TCP toggle is enabled in the Anker App
  • Verify the device IP address is correct (it may have changed)
  • Try pinging the device IP to test network connectivity
  • Check if the router firewall is blocking port 502

Connection drops frequently:

  • Check if the device's Wi-Fi connection is stable
  • Confirm the router is working properly
  • Set a static IP or DHCP reservation for the device
  • Check if the Wi-Fi signal strength is sufficient
  • Confirm the device firmware is up to date

Data Issues

Sensor data not updating:

  • Check if the network connection is normal
  • Confirm the Modbus TCP toggle is enabled in the Anker App
  • Restart the Home Assistant integration
  • Check if the device has entered standby mode
  • Check the Home Assistant logs for communication errors

Contributing

Contributions are welcome. Please open an issue to report bugs or suggest features, or submit a pull request.

License

MIT License — see LICENSE for details.

About

Official Home Assistant integration for Anker Solix devices via local Modbus TCP. No cloud required.

Topics

Resources

Stars

227 stars

Watchers

29 watching

Forks

Releases

Packages

Contributors

Languages