All Projects → mdzio → ccu-jack

mdzio / ccu-jack

Licence: GPL-3.0 license
CCU-Jack bietet einen einfachen und sicheren REST- und MQTT-basierten Zugriff auf die Datenpunkte der Zentrale (CCU) des Hausautomations-Systems HomeMatic. Zudem können einfach Fremdgeräte an die CCU angebunden werden.

Programming Languages

go
31211 projects - #10 most used programming language
javascript
184084 projects - #8 most used programming language
CSS
56736 projects
HTML
75241 projects

Projects that are alternatives of or similar to ccu-jack

ccu-addon-mosquitto
Mosquitto packaged as Addon for the Homematic CCU3 and RaspberryMatic
Stars: ✭ 23 (-63.49%)
Mutual labels:  smarthome, broker, ccu, homematic
node-red-contrib-homematic
🏠 Control your Homematic devices using Node-Red
Stars: ✭ 18 (-71.43%)
Mutual labels:  homeautomation, ccu, homematic
HomeAssistant-Config
Here is my current Home Assistant config. Hope this helps who needs it!!
Stars: ✭ 87 (+38.1%)
Mutual labels:  smarthome, homeautomation, tasmota
HomeApp
A little smart home app for Philips Hue and other devices
Stars: ✭ 54 (-14.29%)
Mutual labels:  smarthome, tasmota, shelly
ioBroker.hm-rpc
Connects HomeMatic Interface-Processes to ioBroker
Stars: ✭ 55 (-12.7%)
Mutual labels:  smarthome, ccu, homematic
ccu-historian
Der CCU-Historian erfasst die Betriebsdaten des Hausautomations-Systems HomeMatic der Firma eQ-3.
Stars: ✭ 105 (+66.67%)
Mutual labels:  smarthome, ccu, homematic
Streamdeck Homeassistant
🏠 Use the Elgato Stream Deck as Home Assistant controller. Call any available service and toggle lights or resume your music.
Stars: ✭ 69 (+9.52%)
Mutual labels:  smarthome, homeautomation
Homeassistant Config
Configuration for @brianjking & @KinnaT's Home Assistant Installation
Stars: ✭ 80 (+26.98%)
Mutual labels:  smarthome, homeautomation
ioBroker.sonoff
Control Sonoff-Tasmota devices via ioBroker
Stars: ✭ 34 (-46.03%)
Mutual labels:  smarthome, tasmota
binrpc
HomeMatic xmlrpc_bin:// protocol server and client
Stars: ✭ 15 (-76.19%)
Mutual labels:  smarthome, homematic
Home Assistantconfig
🏠 Home Assistant configuration & Documentation for my Smart House. Write-ups, videos, part lists, and links throughout. Be sure to ⭐ it. Updated FREQUENTLY!
Stars: ✭ 3,687 (+5752.38%)
Mutual labels:  smarthome, homeautomation
Gbridge
gBridge.io allows you to control (almost) anything with Google Assistant, by translating voice commands to MQTT messages.
Stars: ✭ 152 (+141.27%)
Mutual labels:  smarthome, homeautomation
hm2mqtt.js
Node.js based Interface between Homematic and MQTT
Stars: ✭ 20 (-68.25%)
Mutual labels:  smarthome, homematic
Openhab Distro
The binary distribution of openHAB
Stars: ✭ 1,037 (+1546.03%)
Mutual labels:  smarthome, homeautomation
Haswitchplate
LCD touchscreen for Home Automation
Stars: ✭ 666 (+957.14%)
Mutual labels:  smarthome, homeautomation
Fritzctl
A lightweight, easy to use console client for the AVM FRITZ!Box Home Automation.
Stars: ✭ 84 (+33.33%)
Mutual labels:  smarthome, homeautomation
Openhab Android
openHAB client for Android
Stars: ✭ 457 (+625.4%)
Mutual labels:  smarthome, homeautomation
XML-API
HomeMatic CCU Addon implementing a xml request functionality
Stars: ✭ 106 (+68.25%)
Mutual labels:  smarthome, homematic
ioBroker.shelly
Shelly ioBroker Adapter
Stars: ✭ 108 (+71.43%)
Mutual labels:  smarthome, shelly
ioBroker.hm-rega
Connects HomeMatic CCU "Logic Layer" ("ReGaHSS") to ioBroker
Stars: ✭ 36 (-42.86%)
Mutual labels:  ccu, homematic

CCU-Jack

CCU-Jack bietet einen einfachen und sicheren REST- und MQTT-basierten Zugriff auf die Datenpunkte der Zentrale (CCU) des Hausautomations-Systems HomeMatic der Firma eQ-3. Er implementiert dafür das Very Easy Automation Protocol, welches von vielen Programmiersprachen leicht verwendet werden kann, und das MQTT-Protokoll, welches im Internet-of-Things weit verbreitet ist. Zudem können mit den genannten Protokollen auch Fremdgeräte an die CCU angebungen werden.

Folgende Ziele verfolgt der CCU-Jack:

Der CCU-Jack soll anderen Applikationen einen einfachen Zugriff auf die Datenpunkte der CCU ermöglichen. Beispielsweise werden für den Zugriff auf eine CCU mit HM-, HM-Wired- und HM-IP-Geräten insgesamt 9 Netzwerkverbindung, teilweise als Rückkanal und mit unterschiedlichen Protokollen, benötigt. Zudem sind die Netzwerkschnittstellen der CCU unverschlüsselt, wodurch sie nicht in der Firewall der CCU freigeschaltet werden sollten. Der CCU-Jack standardisiert den Zugriff auf alle Geräte und Systemvariablen mit einem einheitlichen Protokoll und über eine verschlüsselte Verbindung.

Zudem sollen möglichst einfach Fremdgeräte (z.B. WLAN-Steckdosen) an die CCU angebunden und mit dieser automatisiert werden. Angebundenen Fremdgeräte werden auf der CCU wie originale HM-Geräte dargestellt. Sie können über die Web-UI der CCU genauso bedient und beobachtet werden. Zudem können sie ohne Einschränkungen in CCU-Programmen verwendet werden.

Mehrere CCUs und andere Automatisierungsgeräte mit MQTT-Server können über den CCU-Jack untereinander vernetzt werden und Wertänderungen austauschen. Dafür stellt der CCU-Jack eine MQTT-Bridge zur Verfügung. CCUs können auch mit einem MQTT-Server in der Cloud verbunden werden.

Funktional ist der CCU-Jack eine Alternative zum XML-API Add-On. Das XML-API Add-On wird seit längerer Zeit nicht mehr weiter entwickelt und enthält nicht behobene Fehler und Sicherheitslücken. Zudem kann der CCU-Jack die Kombination der zwei Add-Ons hm2mqtt und Mosquitto ersetzen. Das Add-On hm2mqtt wird ebenfalls seit längerer Zeit nicht mehr weiter entwickelt.

Bezügliche der Anbindung von Fremdgeräten ersetzt der CCU-Jack viele komplizierte und aufwändige Lösungen und bietet gleichzeitig mehr Funktionaliät.

Anwenderhandbuch

Alle Informationen für Anwender (z.B. Installation, Konfiguration) sind im Anwenderhandbuch zu finden. Dies sollte vor der Installation gelesen werden!

Entwicklung

Bauen aus den Quellen

Der CCU-Jack ist in der Programmiersprache Go (min. Version 1.17) geschrieben. Alle Distributionen des CCU-Jacks können sehr einfach und schnell auf allen möglichen Plattformen (u.a. Windows, Linux, MacOS) gebaut werden. Dafür in einem beliebigen Verzeichnis das Git-Repository klonen, oder die Quellen hinein kopieren. Danach in diesem Verzeichnis eine Kommandozeile öffnen, und folgende Befehle eingeben:

cd build
go run .

In dem Hauptverzeichnis werden dann alle Distributionen gebaut.

Für die Entwicklung bietet sich die Entwicklungsumgebug Visual Studio Code an. Einfach das Hauptverzeichnis öffnen. Die nötigen Extensions werden automatisch zur Installation angeboten.

Mitwirkung

Mitwirkende sind natürlich gerne gesehen. Sei es für die Dokumentation, das Testen, den Support im HomeMatic-Forum, die Fehlerbehebung oder die Implementierung neuer Funktionalität. Für Code-Beiträge ist die Lizenz (GPL v3) zu beachten. Code-Beiträge sollten immer auf einem neuen Branch separat vom master-Branch entwickelt werden.

Autoren

Lizenz und Haftungsausschluss

Lizenz und Haftungsausschluss sind in der Datei LICENSE.txt zu finden.

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].