README.md

homebridge-ecoforest-heater

Homebridge plugin to control an Ecoforest heater device as a thermostat

Installation

1. Install homebridge
2. Install this plugin: npm install -g homebridge-ecoforest-thermostat
3. Update your config.json file (See below).

Configuration example

{
    "name": "Ecoforest Thermostat",
    "accessories": [
        {
            "name": "My Thermostat",
            "apiEndpoint": "https://<ecoforest_heater_ip>:8000/recepcion_datos_4.cgi",
            "username": "ecoforest_username",
            "password": "ecoforest_password",
            "temperatureFilePath": "/home/user/temperature.txt",
            "temperatureColdTolerance": 1,
            "temperatureHotTolerance": 0,
            "minPowerLevel": 1,
            "maxPowerLevel": 7,
            "pullInterval": 60000
        }
    ],
    "platform": "EcoforestThermostatPlatform"
}

Structure

Key	Description
name	Name to appear in the Home app
apiEndpoint	URL of your Ecoforest heater
username	Username for HTTP authentication
password	Password for HTTP authentication
temperatureFilePath (optional)	A path to a file containing a number that represents the current temperature reported to the accessory.
temperatureColdTolerance (optional)	sets the allowable variance between the target and current temperatures for a heater device, triggering high-power mode when surpassed.
temperatureHotTolerance (optional)	sets the allowable variance between the target and current temperatures for a heater device, triggering low-power mode when surpassed.
minPowerLevel (optional)	Default low-power mode configuration
maxPowerLevel (optional)	Default high-power mode configuration
pullInterval (optional)	This property expects an interval in milliseconds in which the plugin pulls updates from your Ecoforest heater (10000 is default)