0.0.1 • Published 8 years ago
homebridge-digitalstrom v0.0.1
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
- Install homebridge using: npm install -g homebridge
- Install this plugin using: npm install -g homebridge-digitalSTROM
- 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: $HOME/data/locales/XX.json
Obtaining appToken
https://dss.local:8080/json/system/requestApplicationToken?applicationName=cFlatCreate 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.pemSiri 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
0.0.1
8 years ago