A complete Home Assistant custom integration for Solakon ONE devices using Modbus TCP communication.

⚠️ IMPORTANT: This is a Home Assistant Integration, not an Add-on.

• Do NOT add this as an Add-on repository
• Install it through HACS as an Integration (see instructions below)

• Real-time monitoring of all inverter parameters
• PV string monitoring (voltage, current, power)
• Battery management (SOC, SOH, power, temperature)
• Grid import/export tracking
• Energy statistics (daily, monthly, yearly)
• Temperature monitoring
• Alarm and status monitoring
• Configurable update intervals
• Full UI configuration support

• PV Power (total from all strings)
• Active Power
• Reactive Power
• Load Power
• Battery Power

• PV1/PV2/PV3/PV4 Voltage & Current
• Grid Phase Voltages (R/S/T)
• Battery Voltage & Current
• Load Voltage & Current

• Total Energy Generated
• Daily Energy Generation
• Monthly/Yearly Generation
• Battery Charge/Discharge Today
• Grid Import/Export (Today & Total)

• Battery Power
• Battery Voltage
• Battery Current
• Note: Battery SOC (State of Charge) and SOH (State of Health) sensors will be available in a future update

• Internal Temperature
• Heatsink Temperature
• Power Factor
• Grid Frequency
• System Status
• Alarms

• Home Assistant 2024.1.0 or newer
• HACS (Home Assistant Community Store) installed
• Your Solakon ONE device connected to your network with Modbus TCP enabled

1. Open HACS in your Home Assistant instance
2. Click on "Integrations" (NOT Add-ons!)
3. Click the three dots menu in the top right → "Custom repositories"
4. Add this repository URL: https://github.com/solakon-de/solakon-one-homeassistant
5. Select category: "Integration" (⚠️ NOT "Add-on"!)
6. Click "Add"
7. Close the custom repositories dialog
8. Click "+ Explore & Download Repositories"
9. Search for "Solakon ONE" and install it
10. Restart Home Assistant
11. Go to Settings → Devices & Services
12. Click "+ Add Integration"
13. Search for "Solakon ONE" and configure it

1. Copy the custom_components/solakon_one folder to your Home Assistant's custom_components directory
2. Restart Home Assistant
3. Add the integration via Settings → Devices & Services

1. Go to Settings → Devices & Services
2. Click "Add Integration"
3. Search for "Solakon ONE"
4. Enter configuration:
   • Host: IP address of your Solakon ONE device
   • Port: Modbus TCP port (default: 502)
   • Device Name: Friendly name for your device
   • Modbus Slave ID: Usually 1 (range: 1-247)
   • Update Interval: How often to poll (10-300 seconds)

• Ensure your Solakon ONE device is connected to your network
• Modbus TCP must be enabled on the device
• Default Modbus TCP port is 502
• Device must be accessible from Home Assistant

1. Verify network connectivity:

   ping <device-ip>

2. Test Modbus connection:

   telnet <device-ip> 502

3. Check Home Assistant logs:

   Settings → System → Logs → Search for "solakon"
   

• Cannot connect: Verify IP address and port are correct
• No data: Check Modbus slave ID (usually 1)
• Intermittent data: Increase update interval if network is slow
• Missing sensors: Some sensors only appear if hardware is present (e.g., battery sensors)

To add Solakon ONE data to your Energy Dashboard:

1. Go to Settings → Dashboards → Energy
2. Configure:
   • Solar production: Select "Solakon ONE Daily Energy"
   • Grid consumption: Select "Solakon ONE Grid Import Today"
   • Return to grid: Select "Solakon ONE Grid Export Today"
   • Battery: Select battery charge/discharge sensors

automation:
  - alias: "Battery Discharging Alert"
    trigger:
      - platform: numeric_state
        entity_id: sensor.solakon_one_battery_power
        below: -5000  # Alert when discharging more than 5kW
    action:
      - service: notify.mobile_app
        data:
          message: "Battery is discharging at high rate!"

Note: Service functionality is currently under development and will be available in a future update. The following services are planned:

• solakon_one.refresh_data: Manually refresh all sensor data (coming soon)
• solakon_one.set_battery_charge_limit: Set max battery charge % (coming soon)
• solakon_one.set_battery_discharge_limit: Set min battery discharge % (coming soon)
• solakon_one.set_work_mode: Change inverter operation mode (coming soon)
• solakon_one.set_time_of_use: Configure TOU schedules (coming soon)

For issues or questions:

• Report issues on GitHub

This integration is provided as-is under the MIT License.