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

"accessories": [
     {
       "accessory": "EcoforestThermostat",
       "name": "My Heater",
       "apiroute": "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": 9,
       "pullInterval": 60000
     }
]

Structure

Key	Description
accessory	Must be EcoforestHeater
name	Name to appear in the Home app
apiroute	URL of your Ecoforest heater
username	Username for HTTP authentication
password	Password for HTTP authentication
pullInterval (optional)	This property expects an interval in milliseconds in which the plugin pulls updates from your Ecoforest heater (10000 is default)
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
model (optional)	Appears under "Model" for your accessory in the Home app
serialNumber (optional)	Appears under "Serial Number" for your accessory in the Home app
manufacturer (optional)	Appears under "Manufacturer" for your accessory in the Home app

HeatingCoolingState Key

Number	Name
0	Off
1	Heat