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%||

• Siri Commands - Apple
• Siri Commands - Eve
• Siri Commands - Sample

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