Homebridge-hsp NPM

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

Install homebridge using: npm install -g homebridge
Install homebridge-octoprint using: npm install -g homebridge-hsp
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"
}]

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/.