Skip to content

CyberMrProper/homebridge-ecoforest-thermostat

Repository files navigation

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)