Growatt Server Upstream

Upstream development version of the Growatt Server integration for Home Assistant.

About

This repository serves as an upstream testing ground for improvements to the Growatt Server integration before they are submitted to Home Assistant Core. From version 1.5.0 it should be compatible with the Growatt BESS (Battery Energy Storage System) Manager

Features (v1.5.0)

Base Version: Home Assistant Core 2025.9.0 Growatt Server integration

Changes from Base Version:

1. manifest.json updated for custom component distribution
2. API Token authentication support - Official V1 API for MIN/TLX devices
3. MIN inverter control - Number and switch entities for controlling inverter settings
4. Adds 5 min rate limit to login to prevent account locking - aims to fix account locking issue
5. Fixed sensor naming issue - Sensors now display proper translated names instead of generic device class names
6. Fixed timezone handling in API throttling - Fixed bug that could cause very long throttling times (500 minutes)
7. Enhanced TLX sensor coverage - Added 14 new sensors for power and energy monitoring
8. Proper implementation of read / write Time Of Use (TOU) settings using service calls: growattserver.read_time_segments, growattserver.update_time_segment

MIN/TLX Inverter Control Features (V1 API)

When using token authentication with MIN/TLX inverters, you get:

Number Entities (0-100%):

• Charge power
• Charge stop SOC
• Discharge power
• Discharge stop SOC

Switch Entities:

• AC charge enable/disable

All control entities provide real-time feedback and proper error handling.

Enhanced TLX Sensor Coverage (v1.4.6)

Added 14 new sensors for power and energy monitoring:

Power Flow Monitoring:

• Solar generation today
• Local load power, import power, export power
• System power, self power

Energy Accounting:

• System production (today/total)
• Self-consumption (today/total)
• Grid import/export (today/total)
• Battery charging from grid (today/total)

These sensors provide complete visibility into energy flows and system performance for TLX/MIN inverters.

Installation

Note: Remove the core Growatt Server integration first to avoid conflicts.

HACS (Recommended)

Step 1: Add Custom Repository

1. Open HACS in Home Assistant
2. Go to "Integrations"
3. Click the 3-dot menu → "Custom repositories"
4. Add repository URL: https://github.com/johanzander/growatt_server_upstream
5. Select category: "Integration"
6. Click "Add"

Step 2: Download the Integration

7. Search for "Growatt Server Upstream" in HACS
8. Click on it and select "Download"
9. Restart Home Assistant

Step 3: Configure the Integration

10. Go to Settings → Devices & Services
11. Click "Add Integration"
12. Search for "Growatt Server Upstream"
13. Follow the configuration steps

Manual Installation

1. Download the custom_components folder
2. Copy to your Home Assistant config/custom_components/ directory
3. Restart Home Assistant

Contributing

Contributions welcome! Create feature branch, implement changes, test thoroughly, submit PR. All contributions considered for submission back to Home Assistant Core.

Debug Logging

To enable debug logging for troubleshooting issues, add the following to your Home Assistant configuration.yaml:

logger:
  default: info
  logs:
    custom_components.growatt_server: debug

After adding this configuration:

1. Restart Home Assistant
2. Reproduce the issue
3. Check the logs in Settings → System → Logs or in your home-assistant.log file
4. Include relevant log entries when reporting issues

Support

• 🐛 Issues: GitHub Issues
• 📖 Documentation: Home Assistant Docs

---