homebridge-hsp

This is a homebridge plugin to control a Haas+Sohn pellet stoves like the HSP 2.17 Home II via the HomeBridge Platform. It has been implemented to be used with Hoobs as a plugin and tested with homebridge in development mode.

Installation

1. Install homebridge using: npm install -g homebridge
2. Install homebridge-octoprint using: npm install -g homebridge-hsp
3. Update your configuration file. See sample-config.json in this repository for a sample or below.

"platforms": [{
    "platform":"Hsp",
    "name":"HSP-2.17 II Home",
    "host":"192.168.0.1",
    "pin":"1234",
    "interval":60,
    "type":"HSP-1/2",
    "serial":"1234567"
}]

1. In order the device is not discovered automatically, follow this steps:

2. Open the Home App

3. Go to Add Accessory
4. On the bottom click Don't Have a Code or Can't scan?
5. Stove should appear on Nearby Accessories section
6. Click on it and follow the steps in order to add it
7. The HOME SETUP PIN is in the HOOBS Dashboard.

What does this plugin do?

This plugin adds a new platform to Homekit. Inside the platform it shows serval services:

1. the actual temperature around the stove
2. a switch to start/stop
3. a switch to start/stop the weekprogramm
4. a switch to run in Eco-Mode
5. a lightbulb that represents the heating process (Standby, Starting-Zones 1-20: 0-90%, Heating 100%, Cooling 100-0% counting down)
6. an input source that give you the possiblity to set a certain temperatur

Additionally there are some extra features planed:

a. Cleaning countdown/filtermaintenance: shows the time left for cleaning the stove (every 20h! with this model) b. Maintenance countdown/filtermaintenance: shows the kilograms left for making a big maintenance (every 1000kg with this model)

Notes for implementation

Possible Characteristics and Services

This plugin has been created based on the homebridge-plugin-template. Description of characteristics (available methods and how to build listener) can be found in the Homebridge-API

A special thanks to Github-User dwyschka, who inspired me to adapt his Red-Node Project to Homebridge.

Start in Developer Mode

To start the plugin in developer mode run homebridge -D -P . -U ~/.homebridge-dev/ while beeing in the root directory. A sample config has to be saved at ~/.homebridge-dev/.