v1.1

Major Updates Made:

Precise File Placement: Clear instructions for placing the script in /config/custom_components/foxess/ or /homeassistant/custom_components/foxess/ with explanation that both work

Step-by-Step Configuration: Detailed instructions for editing the script with API key and serial number

Enhanced Testing Section:

Start with direct script testing via terminal before using HA
Clear commands to test each function
Then test through HA Developer Tools
Updated Working Modes: Highlighted that Backup mode is recommended for EV charging since it prevents battery discharge while allowing solar charging

Complete Automation Example: Included the EV charging automation

Flexible Path Notes: Added clarification about /config/ vs /homeassistant/ paths

The documentation now provides a complete, step-by-step guide that matches exactly what was developed and tested

Full Changelog: v1.0...v1.1

v1.0 - FoxESS K Series Inverter Control via API

🎉 Initial Release v1.0

Complete solution for controlling FoxESS K series inverters through their Open API with Home Assistant integration.

✨ Features

• API Control: Python script for direct inverter mode switching (Self-Use, Backup, Feed-in, Peak Shaving)
• Home Assistant Integration: Shell command integration with automation examples
• Command Line Interface: Easy-to-use CLI for manual control
• Comprehensive Documentation: Step-by-step setup guide, troubleshooting, and API details
• Security: MD5 signature authentication with API key protection

📦 What's Included

• foxess_control.py - Main Python script for API interaction
• configuration.yaml - Home Assistant configuration example
• requirements.txt - Python dependencies
• README.md - Complete documentation
• LICENSE - MIT License

🚀 Getting Started

1. Clone the repository
2. Install dependencies: pip install -r requirements.txt
3. Configure your API key and inverter serial number
4. Run commands or integrate with Home Assistant

🔧 Requirements

• Python 3.x
• FoxESS cloud account with API key
• Home Assistant (optional, for automation)

This release provides a stable, documented solution for FoxESS K series inverter control with full Home Assistant compatibility.