hap-homematic icon indicating copy to clipboard operation
hap-homematic copied to clipboard

Dokumentation

Open thkl opened this issue 4 years ago • 33 comments

möchte vielleicht jemand hier etwas Dokumentation entwerfen ?

thkl avatar Jun 08 '20 18:06 thkl

Wenn ich helfen kann, gerne...

mike4president avatar Jun 08 '20 18:06 mike4president

ich hätte die Wiki Funktion hier dafür vorgesehen. Es geht im Prinzip um kurze Einträge, wie verschiedene Sachen gelöst werden können. Zb was beim Garagentor zu beachten ist, oder wenn Services mehrere Parameter haben, was diese bewirken.

thkl avatar Jun 08 '20 19:06 thkl

Ich könnte das mit der Alarmanlage beschreiben.

mike4president avatar Jun 09 '20 06:06 mike4president

Ich würde auch helfen - versuche gerade das Thema Garagentor zu verstehen, was ich bei homebridge-homematic ohne Probleme laufen haben. Wie bekomme ich den Typ "Schalter" als default geändert (den ich auch für HmIP-PSM bekomme, während homebridge-homematic die Steckdose zeigt)

ChrWi avatar Jun 11 '20 10:06 ChrWi

Die Settings fürs Tor sind die gleichen. Hier gibt’s nen länglichen Issue zum Tor. Da wurde das alles zusammengesucht und ausprobiert.

thkl avatar Jun 11 '20 10:06 thkl

Ich orientiere mich. HmIP-PSM habe ich gelöst. Insgesamt sehr intuitive Anwendung. Habe ich die Berechtigung für Einträge im Wiki?

ChrWi avatar Jun 11 '20 10:06 ChrWi

Invite folgt 🤓

thkl avatar Jun 11 '20 10:06 thkl

Prima. Habe das Garagentor nun unter besondere Geräte entdeckt. Kann das also mit Vorlage der funktionierenden Konfig im Homebridge angehen und parallel dokumentieren.

ChrWi avatar Jun 11 '20 11:06 ChrWi

Vielleicht blöde Frage: wie kann ich im Wiki Bilder hochladen/bereitstellen?

ChrWi avatar Jun 11 '20 20:06 ChrWi

Einfach im Browser reinpasten.

dkrizic avatar Jun 11 '20 20:06 dkrizic

Nee, leider nicht. Das geht hier in den Issues, aber das Wiki sieht bei mir "schlicht" aus.

ChrWi avatar Jun 11 '20 20:06 ChrWi

Ja, im Wiki sind leider keine Bilder ein"paste"bar wie in Issues. Daher lagere ich die alle in doc/wiki ... wenn Du alle Bilder zusammen hast mail sie mir. Ich stell sie ins Repo und dann kann man sie von dort verlinken.

thkl avatar Jun 12 '20 12:06 thkl

Ich habe mal einen Beitrag dazu gebaut, was eine Instanz ist und worum es da überhaupt geht und den in den Pages verlinkt

thkl avatar Jun 15 '20 17:06 thkl

Hallo Thomas, ich würde bei der Doku unterstützen wollen und mal was Struktur reinbringen. Gruß Marc

sailor79 avatar Sep 26 '20 11:09 sailor79

Hallo Thomas, ich würde bei der Doku unterstützen wollen und mal was Struktur reinbringen. Gruß Marc

😍

thkl avatar Sep 26 '20 11:09 thkl

Hallo Thomas, gibt es hier noch eine zusätzliche 1to1 Kommunikationsmöglichkeit?

sailor79 avatar Sep 26 '20 15:09 sailor79

So, der Anfang ist gemacht, siehe "Home". (Struktur und bisschen content), bitte mal checken ob das so grundsätzlich passt. Ich würde erstmal weiter mit den Anchors arbeiten. Wenn der Content dann doch überläuft wenn erstmal das meiste da ist , kann man Teile wieder in Subpages ausgliedern.

sailor79 avatar Sep 26 '20 18:09 sailor79

Oh coole Sache, vielen Dank. Ich habe nur eine Kleinigkeit zum CCU Addon ergänzt. Github erzeugt bei einem Release immer ein Paket des Codes. Das wird aber auf der CCU nicht benötigt, sondern nur der eigentliche Installer.

thkl avatar Sep 26 '20 19:09 thkl

Hallo Thomas, Du hast bestimmt eine Liste aller (kontextsensitiven) Services, z.B. "HomeMaticWindowsAccessory - This service provides a window device in HomeKit based on a CCU contact." ? Dann muss ich die nicht alles einzeln erforschen, sofern ich überhaupt alle möglichen Geräte habe.

sailor79 avatar Sep 27 '20 07:09 sailor79

Das ist recht einfach aus dem Code zu ermitteln. Jedes File hier https://github.com/thkl/hap-homematic/tree/master/lib/services stellt einen Service dar. Also fast jedes. Es muss so aussehen Homematic*Accessory.js Und im File steht die Description in der statischen Methode serviceDescription()

thkl avatar Sep 27 '20 08:09 thkl

Hallo Thomas, gibt es hier noch eine zusätzliche 1to1 Kommunikationsmöglichkeit?

https://join.slack.com/t/neuerworkspac-km37354/shared_invite/zt-hnlaon12-VoVmXUX7lzgOWYCnzb6QnA

thkl avatar Sep 27 '20 09:09 thkl

Done for this weekend. Please check.

sailor79 avatar Sep 27 '20 13:09 sailor79

Great, i very appreciate the work u've done.

thkl avatar Sep 27 '20 13:09 thkl

@sailor79 wenn ich meine damals in Deutsch geschriebenen HowTo übersetzen/umschreiben soll, können wir uns gern abstimmen

ChrWi avatar Oct 05 '20 19:10 ChrWi

@sailor79 wenn ich meine damals in Deutsch geschriebenen HowTo übersetzen/umschreiben soll, können wir uns gern abstimmen

Gerne. Einfach machen. Ich schlage vor du schreibst die englische Version unter die deutsche, ich kopiere mir sie dann rüber in entsprechender Formatierung. Bezieht sich auf eine Variante Garagentor, richtig?

sailor79 avatar Oct 05 '20 19:10 sailor79

Korrekt - eine Variante Garagentor. Die Seite mit der schaltbaren Steckdose kann ich dann auch gerade übersetzen. ABER: wo bekomme ich die Sprache der UI auf EN umgestellt: HM UI, HAP oder Browsersprache?

ChrWi avatar Oct 10 '20 12:10 ChrWi

Die Sprache hängt am Browser.

thkl avatar Oct 10 '20 13:10 thkl

Bei mir am System (macOS) - habe ich in 15 Jahren Mac bisher nicht gebraucht.

ChrWi avatar Oct 10 '20 15:10 ChrWi

@sailor79 die beiden wiki-pages für das Garagentor und die Steckdose habe ich kurzerhand übersetzt. Wir können die beiden Seiten nach Übernahme in deine (sehr gelungene!) Struktur gerne deaktivieren. @thkl die neuen Screenshots habe ich per Mail geschickt

ChrWi avatar Oct 10 '20 16:10 ChrWi

@ChrWi files liegen in https://github.com/thkl/hap-homematic/tree/master/doc/wiki/garage_en

thkl avatar Oct 11 '20 08:10 thkl

Hallo @thkl , HomeMaticSPVideoDoorBellAccessory scheint ja wohl zu funktionieren. Ich habe ebenfalls den HM-Sen-DB-PCB in der config hinterlegt, aber in Home kann ich das Ding nicht konfigurieren. Hast du mal eine Beispiel Konfig? Evtl. kann das ja mit die WiKi ;)

hillinator avatar Nov 22 '20 19:11 hillinator

@ChrWi: Sorry, dass ich so spät Antworte. Habe Deinen Input so vor einiger Zeit übernommen. Besten Dank für Deine Hilfe :-)

sailor79 avatar Dec 02 '20 12:12 sailor79

Hallo @thkl ich habe die "Internals" angepasst, da sich die Settings mittlerweile erweitert haben. Bitte schaue insb. bei Cache und Watchdog einmal drauf. Und tausche bitte das bestehende Bild gegen den angehängten Screenshot aus. Danke Dir! Screenshot 2021-09-06 131337

ChrWi avatar Sep 06 '21 11:09 ChrWi