Homebridge FoxESS

⚠️ Deprecated and archived. This plugin is no longer maintained, and there is no direct Homebridge replacement. Existing installations will continue to work, but no new releases will follow this one. The GitHub repository has been archived. Forks are welcome — the underlying foxess-lib wrapper around the FoxESS OpenAPI still works and can be used as a starting point.

This plugin exposes HomeKit to solar data provided by FoxESS and those who use its platform, such as Energizer Solar.

Created are various accessories that help power-optimising automations in HomeKit.

Currently, only a light sensor is exposed that indicates the current solar generation.

This plugin is still in early development.

Example config.json:

    "platforms": [
        {
            "name": "FoxESS",
            "platform": "HomebridgeFoxESS",
            "apiKey": "<your-api-key>",
            "interval": "60000"
        }
    ]

Parameters

| Parameter | Description | Required | Default | --------- | ----- | ------- | ------ | | apiKey| API Key provided by FoxESS Cloud. | true | | | interval| How often to update current usage | false | 300000 (5 minutes) |

Obtaining an API Key

1. Login to FoxESS Cloud
2. Click on the top-right user icon, and select User Profile
3. Under 'API Management', hit 'Generate API Key'.

Note: There is currently a limit of 1440 calls per day for an API Key, equating to once per minute.