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"
}]

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

• Open the Home App
• Go to Add Accessory
• On the bottom click Don't Have a Code or Can't scan?
• Stove should appear on Nearby Accessories section
• Click on it and follow the steps in order to add it
• 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/.