"Homematic Manager Adapter" First Steps

[versteckt]

@Homoran (Rainer): Den Port kannst du dir normalerweise im Admin Fenster einstellen.

Der Link in Instances wird im Moment nicht automatisch angepasst, nachdem du gespeichert hast.

Das ist noch ein offener Punkt.

Die fehlenden Infos kommen erst, wenn es im offiziellen Repo enthalten ist.

@StefSign (Steve): Der Plan war, das ich dokumentiere wie ich diesen Adapter entwickelt habe,

sodass wir eine "Doku für Adapter Anfänger" haben.

[Homoran]

Hier kannst du z.B. Direktverknüpfungen erstellen ohne CCU.

Wird interessant, wenn auch eine CCU-freie Umgebung funktioniert, z.B. mit Homegear.

Gruß

Rainer

[versteckt]

@Bambo:

Das soll jetzt nicht blöd klingen auch wenn es das vielleicht tut…aber wofür ist dieser Adapter gut?

Was macht der, was hm_rega /hm-rpc nicht machen? Ich raff das komplett nicht. `

Mir ging es hauptsächlich darum, zu zeigen, wie einfach es ist, einen neuen Adapter zu entwickeln und

dabei gleich ein paar "Standardfunktionen" zu verwenden.

Wie z.B.

.) IP-Adressen auslesen

.) Objekte auslesen (hm-rpc) und diese einbinden

.) Externe nodejs Programme über ioBroker zu "steuern" und "konfigurieren" soweit einfach machbar.

[versteckt]

@Homoran:

Hier kannst du z.B. Direktverknüpfungen erstellen ohne CCU.

Wird interessant, wenn auch eine CCU-freie Umgebung funktioniert, z.B. mit Homegear.

Gruß

Rainer `

Ich setze bereits seit Anfang Jänner Homegear mit Homematic und Max! Thermostaten produktiv ein.

[Bambo]

@Homoran:

Hier kannst du z.B. Direktverknüpfungen erstellen ohne CCU.

Wird interessant, wenn auch eine CCU-freie Umgebung funktioniert, z.B. mit Homegear.

Gruß

Rainer `

Danke, also quasi Homematic Manager ohne CCU.

Steht ja irgendwie auch im Titel… :lol:

[Arminhh]

moin, moin

wollte eben auf die schnelle auch installieren. Unter windows wird curl angemeckert. Muss ich Curl erst installieren?

mfg

Arminhh

[StefSign]

Morgen Arminhh,

ich denke man kann auch wget nutzen bzw. ganz normal von HMM Webseite herunterladen und im richtigen Verzeichnis ablegen.

Steve

[Arminhh]

jetzt ist erst der Groschen gefallen was überhaupt Curl ist! Danke für den Hinweis!!

mfg

Arminhh

[versteckt]

Sorry, das ist eine Anleitung für Linux!

Gesendet von meinem iPhone mit Tapatalk

[Arminhh]

Funktioniert ! auch unter Windows!!

[Bluefox]

@versteckt:

Es ist vollbracht, eine initiale Version des iobroker.hmm ist in Git bzw. npm zu finden.

Bitte nicht erschlagen, es ist noch nichts dokumentiert und sicherlich Fehler behaftet.

Ausserdem sind beide Abhängigkeiten im Git mitdrinnen.

Könnt ihr trotzdem mal versuchen diesen zu installieren (im ioBroker Root-Dir einfach "npm install iobroker.hmm" eingeben)?

Dann weiss ich zumindest gleich mal, was ich alles noch machen muss. `
Es ist toll!!

Das was jetzt kommt ist jammern auf hochem Niveau:

• man kann homematic-manager direkt aus npm installieren (pull request ist schon da)

• node_modules sollte man nicht in git einchecken. Dafür kann man eine Datei ".gitignore" kreieren, mit dem Inhalt:

.idea
node_modules

• package.json sollte repository, homepage und keywords Felder haben:

"repository": {
    "type": "git",
    "url": "https://github.com/husky-koglhof/ioBroker.hmm"
  },
  "homepage": "https://github.com/husky-koglhof/ioBroker.hmm",
  "keywords": [
    "ioBroker",
    "homematic",
    "homematic manager"
  ],

Dann wird npm Seite automatisch mit readme und github link befüllt.

• io-package.json, da gibt es 4 Anmerkungen:

version sollte mit package.json übereinstimmen.

"version":                  "0.0.1",

Link ist falsch:

        "extIcon":                  "https://raw.githubusercontent.com/ioBroker/ioBroker.js-controller/master/adapter/example/admin/example.png",

Am besten auf "info" umstellen, sonst "by default" alle werden "debug" level haben.

       "loglevel":                 "debug",

Das hier funktioniert nur wenn in "native" ein "port" existiert (bei dir ist es "webServerPort". Ich empfehle es umzubenennen)

        "localLink":                "http://%ip%:%port%",

• Lizenz ist unklar:

in package.json - GPL,

in hmm.js - Apache,

es gibt aber kein LICENSE file in git.

Ich rate von GPL sowieso ab. Im schlimmsten Fall LGPL.

Ich denke, dass du gleiche Lizenz verwenden solltest wie homematic-mamanger, weil du Adapter praktisch auf dem aufbaust. Und homematic-manager hat CC BY-NC-SA 4.0 http://creativecommons.org/licenses/by-nc-sa/4.0/

Ansonsten es ist wirklich super noch einen Adapter zu haben.

[versteckt]

Alles klar, hab kein Problem mit jammern.

Werde das am Wochenende alles einbauen.

Ich bin froh über konstruktives Feedback!!!

Gesendet von meinem iPhone mit Tapatalk

[versteckt]

Hallo, habe mal versucht, alle offenen Punkte soweit möglich zu erfüllen.

@BlueFox: kannst du dies bitte kontrollieren und mir Bescheid geben, falls ich etwas

vergessen bzw. falsch gemacht habe?

Danach würde ich mit der Doku anfangen.

[StefSign]

Hallo Versteckt,

klasse, die Sourcen schau ich mir gerade an.

Fragen:

• Wie komme ich an Npm Git heran? Momentan lade ich die hmm sourcen mit "nmp install iobroker.hmm" herunter.

• Wie machst Du Debugging? Mit Webstorm? Wenn ja, ich habe ein Problem mit Breakpoints. Hat jetzt aber nichts direkt mit Deinem sourcen zu tun.

• Ist es Dir Recht wenn ich Deine Sourcen als Beispiel fürs Webstorm Debugging hernehme? Oder machst Du schon etwas in dieser Richtung?

• Beschreibst Du auch wie man npm Pakete erzeugt? Ist für mich noch Neuland.

Danke

Steve

[versteckt]

Hallo,

• Wie komme ich an Npm Git heran? Momentan lade ich die hmm sourcen mit "nmp install iobroker.hmm" herunter.

-> Was meinst du genau damit? Momentan ist mein Adapter noch nicht offiziell in ioBroker drinnen, deshalb noch manuell zu installieren / upgraden.

• Wie machst Du Debugging? Mit Webstorm? Wenn ja, ich habe ein Problem mit Breakpoints. Hat jetzt aber nichts direkt mit Deinem sourcen zu tun.

-> Im Moment noch gar nicht, das habe ich mir erst für morgen vorgenommen.

• Ist es Dir Recht wenn ich Deine Sourcen als Beispiel fürs Webstorm Debugging hernehme? Oder machst Du schon etwas in dieser Richtung?

-> Tu dir keinen Zwang an

• Beschreibst Du auch wie man npm Pakete erzeugt? Ist für mich noch Neuland.

-> Ja kann ich machen.

Das wäre dann z.B. wie "programmiere" ich einen Adapter, hinzufügen des Pakets in GitHub und NPMJS

[Bluefox]

@versteckt:

Hallo, habe mal versucht, alle offenen Punkte soweit möglich zu erfüllen.

@BlueFox: kannst du dies bitte kontrollieren und mir Bescheid geben, falls ich etwas

vergessen bzw. falsch gemacht habe?

Danach würde ich mit der Doku anfangen. `
Habe einen Pull Request gemacht.

• node_modules waren noch drin,

• Image Pfad war noch falsch.

• datastore Pfad geändert, weil sonst wird datastore beim jedem Update gelöscht.

Ansonsten der Adapter macht guten, fertigen, funktionierenden Eindruck und ist bei mir auf Anhieb angelaufen.

Super Job.

[Bluefox]

@StefSign:

• Wie komme ich an Npm Git heran? Momentan lade ich die hmm sourcen mit "nmp install iobroker.hmm" herunter. `
  Npm und Git sind zwei unterschiedliche Ressourcen. Für die beide brauchst du Logins. Ist alles frei.

Ich arbeite mit git.

Installieren unter Linux.

sudo apt-get install git 

Ich empfehle erst einen Fork zu machen:

cd myWorkDir
git clone https://github.com/DeinLogin/ioBroker.hmm.git

Nachdem du die Änderungen gemacht hast:

git commit

und

git push

Danach du gehst auf WebSeite und erzeugst einen PullRequest:

Falls du keine Änderungen machen willst dann kannst du Schritt mit fork weg lassen und direkt:

cd myWorkDir
git clone https://github.com/husky-koglhof/ioBroker.hmm.git

Schreiben.

Alle git Befehle müssen in dem Verzeichnis myWorkDir/ioBroker.hmm aufgerufen werden (außer "clone")
@StefSign:

• Wie machst Du Debugging? Mit Webstorm? Wenn ja, ich habe ein Problem mit Breakpoints. Hat jetzt aber nichts direkt mit Deinem sourcen zu tun. `
  Habe wo anders schon Frage gestellt. http://forum.iobroker.org/viewtopic.php?f=8&t=334#p2652

[versteckt]

N'Abend!

Wollte eigentlich nur mitteilen, das ich auf die Wiki Doku nicht vergessen habe, bin nur diese

Woche ein "wenig" im beruflichen Stress.

Werde aber das Wochenende etwas zusammenstellen und dann mal im Wiki hochladen.

[StefSign]

Morgen "Versteckt",

nachdem der HMM Adapter sehr gut gelungen und vor allem sehr wichtig ist…

• Wollen wir ihn nicht in die normale Auswahlliste der Adapter aufnehmen? Müßte dies Bluefox machen?

• Wäre ein eigener Tab wie bei Node-Red auch für HMM denkbar?

BTW, ich will jetzt mit einem Adapter für den Spark Core anfangen, nachdem ich so "lazy" bei HMM war.

Danke

Steve

[versteckt]

Morgähn,

Ich vermute mal das Bluefox das macht.

Eigener Tab wie Node-red; ja die Idee hatte ich auch schon.

Soweit ich gesehen habe ist der fix codiert.

Da habe ich bereits überlegt, dies dynamisch zu steuern.

Gesendet von meinem iPhone mit Tapatalk