homebridge-digitalstrom

0.0.1 • Public • Published

homebridge-digitalSTROM

Homebridge platform plugin for the digitalSTROM Smart Home System

Notes:

  • Tested and works on cFlat - Smart Home Gateway cFlat is an docker integration platform on RPI for easy integration of various devices into the Apple Home Kit universe.

  • homebridge-digitalSTROM 0.0.x is a preliminary release intended primarily for developers and advanced users only

Supports the following types

digitalSTROM-Scenes

Scene Description Note
Apartment Represents a digitalSTROM Apartment-Scene
Zone Represents a digitalSTROM Zone-Scene
Group Represents a digitalSTROM Group-Scene
Named Represents a digitalSTROM Named-Scene (todo)
Device Represents a digitalSTROM Device-Scene

digitalSTROM-Devices

Group Color HW-Info Output-Mode ModeID Class
- (all) -TK Push button interface - nop
Light Yellow GE-KL200 Switched - LightDevice
GE-* Switched 16 LightDevice
Dimmed (rest) LightDevice
Shade Grey GR-KL200 Blinds (Rolladen) ShadeDevice (Horizontal noSet)
GR-KL210 Curtains (Markise) ShadeDevice
GR-KL220 Shutter (Jalousie) ShadeDevice (Vertical noSet)
Climate Blue BL-* ? ? todo
dS-iSens200 ? ? todo
Security Red RT-* ? ? todo
Access Green GN-* ? ? todo

digitalSTROM-Sensors

Name Class Note
dSMeter EnergyMeter only Eve-App

Installation

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

Configuration

Configuration sample:

    "platforms"[
        {
            "platform":     "digitalSTROM",
            "name":         "digitalSTROM",
            "url":          "https://dss.local:8080",
            "caFile":       "cert/cert.pem",
            "appToken":     "myapptoken",
            "lang":         "de",
            "refreshEvent": "60",
            "exclude": []
        }
    ],

i18n Translation

File-Documentation

File: $HOME/data/locales/XX.json

Obtaining appToken

https://dss.local:8080/json/system/requestApplicationToken?applicationName=cFlat

Create Certs

openssl s_client -connect {HOSTNAME}:{PORT} -showcerts </dev/null 2>/dev/null|openssl x509 -outform PEM >cert.pem
 
openssl s_client -connect testrack2.aizo.com:58080 -showcerts </dev/null 2>/dev/null|openssl x509 -outform PEM >cert.pem

Siri digitalSTROM Commands (Deutsch)

Command Sample Note
Typen
Schalte mein/e Lampen im [Raum] ein/aus Schalte meine Lampen im Wohnzimmer ein Homekit Raum
Scene
Schalte mein/e [dSS-Scene-Name] ein Schalte Wohnung Abwesend ein
Aktiviere [Scene-Name] Aktiviere Abwesend Homekit Szene
Light-Device
Schalte [dSS-Device-Name] ein/aus Schalte Wohnzimmer-Sofalampe ein/aus
Dimme mein/e [dSS-Device-Name] auf XX % Dimme meine Wohnzimmer-Sofalampe auf 50%
Shade-Device
Öffne [dSS-Device-Name] Öffne den den Schlafzimmer-Rolladen
Setze [dSS-Device-Name] auf xx % Setze den Schlafzimmer-Rolladen auf 50%

Roadmap / ToDo

  • Work with self signed cert (tempfix see dss.js)
  • Enhance multi-language support.

Following things are to be developed next:

  • Add/Remove device to Homekit-Room
  • Change Device-Name
  • NamedScenes
  • Climate (blue) devices
  • Joker (black) devices
  • Access (green) devices
  • digitalSTROM-Sensor

Copyright and license

Copyright 2017, 2017 cgHome under MIT License

Package Sidebar

Install

npm i homebridge-digitalstrom

Weekly Downloads

0

Version

0.0.1

License

MIT

Last publish

Collaborators

  • cghome