Navigation

    Logo
    • Register
    • Login
    • Search
    • Recent
    • Tags
    • Unread
    • Categories
    • Unreplied
    • Popular
    • GitHub
    • Docu
    • Hilfe
    1. Home
    2. Deutsch
    3. Entwicklung
    4. Adapter-Entwicklung Dokumentation

    NEWS

    • ioBroker@Smart Living Forum Solingen, 14.06. - Agenda added

    • ioBroker goes Matter ... Matter Adapter in Stable

    • Monatsrückblick - April 2025

    Adapter-Entwicklung Dokumentation

    This topic has been deleted. Only users with topic management privileges can see it.
    • Bluefox
      Bluefox last edited by

      @versteckt:

      Ach Doku ist doch was für Mädchen…

      Ich bin immer noch am überlegen wie ich am sinnvollsten eine Online Hilfe meiner Adapter baue.

      Gesendet von meinem iPhone mit Tapatalk `
      Und das sagt derjeniger, wer 4 Adapter entwickelt hat :lol:

      Leider ist Doku wichtig :? Um Einstieg zu erleichtern. Aber da ist so was: Doku oder Features 😉

      1 Reply Last reply Reply Quote 0
      • V
        versteckt last edited by

        Ich weiss, ich bekomms von meinen Leuten auch immer wieder zuhören, welche ich überzeugt

        habe ioBroker zu testen / verwenden.

        Und weil's so lustig ist, Nummer 5 wurde soeben hochgeladen: http://forum.iobroker.net/viewtopic.php … 644#p16644

        LG Christian
        2995_meross_log.txt

        1 Reply Last reply Reply Quote 0
        • Eisbaeeer
          Eisbaeeer Developer last edited by

          Ja, leider hält mich das auch davon ab, meine Adapter zu konvertieren. Ich hab einfach nicht die Zeit, mich da selbst einzuarbeiten und per try and error zu testen. Ich pack es einfach nicht, die neue Struktur zu kapieren. Es wäre prima, wenn mal jemand z.B. Ein youtube macht, welche Schritte nötig sind. Die Meisten Adapter nutzen ja die gleichen Funktionen, TCP/IP-Socket, Datei einlesen, etc. Was mich auch stark interessieren würde, wie ihr Eure Adapter debuggt? Nur über logfile wie bei ccu.io kann ja nicht sein. Vielleicht macht ja mal jemand ein Tutorial und ermöglicht dann auch Umsteigern den Einstieg in die IO.Broker Adapterprogrammierung. Ich hab das Gefühl, das nicht nur ich bei ccu.io bleiben, weil wir einfach den Umstieg nicht packen.

          Gruß Eisbaeeer

          Ich Supporte keine Anfragen per PM. Bitte immer im Forum Fragen stellen, eventuell hilft es auch den anderen!

          https://github.com/Eisbaeeer

          1 Reply Last reply Reply Quote 0
          • V
            versteckt last edited by

            Eh klar, kann dir nur beipflichten.

            Wenn über Weihnachten nicht viel los ist, werde ich mal meine Erkenntnisse bei der Adapter Entwicklung

            zusammenfassen.

            1 Reply Last reply Reply Quote 0
            • Eisbaeeer
              Eisbaeeer Developer last edited by

              Ich hab mir eben mal deinen Post mit rpi angesehen. Auch den Link von Bluefox zu der Adapterbeschreibung. Das Problem ist ja nicht, dass man sich dann die Zeit nimmt. Wer mal angefangen hat, den packt dann auch meist das Fieber, zumindest bei mir ist das so. Aber bis ich mich hinsetze und mir das selbst erarbeite, schreibe ich dann lieber einen neuen Adapter für ccu.io, weil ich schon weiß wie er funktioniert. Das kann doch nicht sein [emoji16]. Mein Ziel ist der Umstieg zu io.broker. Dafür schau ich mir auch gerne ein Tutorial an [emoji41]

              Ich Supporte keine Anfragen per PM. Bitte immer im Forum Fragen stellen, eventuell hilft es auch den anderen!

              https://github.com/Eisbaeeer

              1 Reply Last reply Reply Quote 0
              • H
                Headroom68 last edited by

                Hallo,

                genau das ist auch mein Problem. Unter ccu.io war ein Adapter schnell gemacht.

                Bei ioBroker mit Entwicklungsumgebung und Konfiguration von Github, npm, …. Alles Sachen, was ich eigentlich nicht machen möchte. Ich möchte einen Adapter schreiben. Ein Template kopieren, mit vi etwas tippern, Neustart der Applikation ... fertig 🙂

                Nun denn... iobroker hat auch Vorteile und missen möchte ich es nicht mehr (meine Frau ist anderer Ansicht)

                Daher ist das neue Template schonmal ein guter Anfang (hoffe ich 🙂 . Ich werde mich einarbeiten und versuchen die Doku zu erweitern.

                Ein Video wird es von mir sicher nicht geben, dass darf gern ein anderer machen 😄

                Eine gute Doku und ein paar Beispiele (die dann hoffentlich noch einfach sind) wird dann auch andere ermutigen von ccu.io auf iobroker umzusteigen.

                IMHO: Doku und Bugfix vor Features.

                1 Reply Last reply Reply Quote 0
                • Bluefox
                  Bluefox last edited by

                  @Eisbaeeer:

                  JWas mich auch stark interessieren würde, wie ihr Eure Adapter debuggt? `
                  Ich hoffe, dass das du noch nicht gesehen hast:

                  https://github.com/ioBroker/ioBroker/wi … nvironment

                  Sonst weiß ich nicht, wie man noch es erklären kann. 🙂

                  1 Reply Last reply Reply Quote 0
                  • V
                    versteckt last edited by

                    Naja, sooo schwierig ist ein Adapter nicht, habe erst heute einen neuen entwickelt.

                    Für mich sind immer die Fragen, was soll er können, global, multiple, dynamisch/statisch?!

                    Verwende auch eigentlich immer das gleiche Grundgerüst.

                    Gesendet von meinem iPhone mit Tapatalk

                    1 Reply Last reply Reply Quote 0
                    • Eisbaeeer
                      Eisbaeeer Developer last edited by

                      @Bluefox:

                      @Eisbaeeer:

                      JWas mich auch stark interessieren würde, wie ihr Eure Adapter debuggt? `
                      Ich hoffe, dass das du noch nicht gesehen hast:

                      https://github.com/ioBroker/ioBroker/wi … nvironment

                      Sonst weiß ich nicht, wie man noch es erklären kann. 🙂 `
                      Hatte ich noch nicht gesehen. Das sieht sehr vernünftig aus.

                      Aber das meine ich. Man muss sich irgend wie alle Infos zusammensuchen. Mir war auch neu, dass es eine Entwicklungsumgebung gibt. Ubuntu als Grundlage ist ja auch kein Problem. Es wird halt bei allen Wiki davon ausgegangen, dass man das Konstrukt schon kennt. Mir fehlt im Wiki z.B. Noch, "Was brauche ich, um einen Adapter zu entwickeln". Ich benötige Programm A, B und C. Früher reichte pseditor und node. Ich hoffe nicht, dass ich den Eindruck vermittel, hier rumzumosern. Ganz im Gegenteil. Ich will auf io.broker umsteigen und es auch anderen ermöglichen. Denn das System lebt von Adaptern. Um so mehr Adapter, um so mehr User. Und daran hapert es in meinen Augen Moment. Die meisten Adapter wurden von ccu.io migriert, aber sehr viel neues gibt es noch nicht.

                      Die neue io.broker Struktur ist eine geniale Basis. Das muss ich schon sagen. Da habt ihr einen riesen Schritt gemacht. Und ich möchte nicht wissen, wie viele Stunden Arbeit da reingeflossen sind. Meine Hochachtung.

                      Grüsse Eisbaeeer

                      Gesendet von meinem Z30 mit Tapatalk

                      1 Reply Last reply Reply Quote 0
                      • V
                        versteckt last edited by

                        Sollte meine Antwort negativ rübergekommen sein, war nicht so gemeint.

                        Ich komme auch von ccu.io und hab mich dann irgendwann hingesetzt und angefangen.

                        Aber ich gebe dir schon recht, es ist am Anfang etwas schwierig reinzukommen.

                        Wenn man dann aber mal alles hat, funktioniert es recht gut.

                        Gesendet von meinem iPhone mit Tapatalk

                        1 Reply Last reply Reply Quote 0
                        • S
                          smiling_Jack last edited by

                          @Eisbaeeer

                          es währe schön wenn du deine adapter auch in iobroker zum laufen brings.

                          Ich kann ja mal ein Video machen wie man mit einem neuen Adapter anfängt und ihn debugt und wo man welche Infos finden kann. Hast du wünsche auf die ich speziell eingehen soll ?

                          1 Reply Last reply Reply Quote 0
                          • Eisbaeeer
                            Eisbaeeer Developer last edited by

                            @smiling_Jack

                            Hey, das wäre super.

                            Ein einfacher Adapter, idealerweise der Beispieladapter, welcher schon oft angesprochen wurde. Wichtig wäre, wie man vom Beispiel zum fertigen Adapter mit npm Installation kommt. Früher war das so, Adapter geschrieben, wenn alles funktionierte, per Git zum Mergen bereitgestellt. Mir stellt sich zum Beispiel die Frage, wo die Adapter gehostet werden. Was muss ich Schritt für Schritt tun, um vom Konstrukt bzw. Von der Idee ( da kannst du auch gerne einfach eine Datei einlesen und einen Wert in die Datenbank schreiben, einen Wert aus der Datenbank lesen, etc. Einfache Sachen, es soll ja nicht um die Programmierung von Javascript gehen), bis zum fertig installierbaren Adapter. Ach ja, es wäre mir noch ganz wichtig, wie man die fertigen node-js Objekte (node modules) integriert, denn da verwende ich doch einige. Das wäre super cool, wenn du da ein Tutorial machst.

                            Gruß Eisbaeeer

                            Gesendet von meinem Z30 mit Tapatalk

                            1 Reply Last reply Reply Quote 0
                            • S
                              StefSign last edited by

                              Hallo,

                              ich habe damals viel Zeit in die Dokumentation von https://github.com/ioBroker/ioBroker/wi … nvironment reingesteckt

                              und freue mich sehr wenn es jemand gebrauchen kann.

                              Da wären wir auch schon bei der Frage:

                              • Was kann man noch verbessern?

                              Danke

                              Stefan

                              1 Reply Last reply Reply Quote 0
                              • C
                                Communicate last edited by

                                Hallo Stefan, der Link funktioniert leider nicht 😞

                                von unterwegs gesendet

                                1 Reply Last reply Reply Quote 0
                                • htrecksler
                                  htrecksler Forum Testing last edited by

                                  https://github.com/ioBroker/ioBroker/wiki

                                  im Link fehlt am Ende ein"ki" für "wiki"

                                  1 Reply Last reply Reply Quote 0
                                  • Eisbaeeer
                                    Eisbaeeer Developer last edited by

                                    Hallo zusammen.

                                    Ich hab noch keine Zeit gefunden, mich da reinzuarbeiten.

                                    Das Problem ist eben, dass das Wiki nicht wirklich ein Howto ist, an dem man sich durchangeln könnte.

                                    Hoffe ja immer noch auf ein Video oder ein Howto.

                                    Grüße Eisbaeeer

                                    1 Reply Last reply Reply Quote 0
                                    • Bluefox
                                      Bluefox last edited by

                                      Kann man das als HowTo betrachten?

                                      https://github.com/ioBroker/ioBroker.template

                                      Und für Widgets: http://forum.iobroker.net/viewtopic.php … ate#p13205

                                      1 Reply Last reply Reply Quote 0
                                      • htrecksler
                                        htrecksler Forum Testing last edited by

                                        Ich habe bereits einen eigenen Adapter der auch sehr zuverlässig läuft. Jetzt möchte ich einen weiteren Adapter entwickeln und diese Anleitung (Post von Bluefox) als Anleitung verwenden.

                                        Ich werde mich genau an die Schritte halten und Fragen die sich mir stellen hier posten. Ich denke, wenn ich die Fragen habe, werden andere diese Fragen auch haben. Vielleicht kann man auf diese Weise die Anleitung optimieren.

                                        Die Anleitung ist komplett in Englisch. Ich selber habe damit kein Problem, ich könnte mir aber vorstellen, das andere damit durchaus ihre Schwierigkeiten haben. Ich bin gerne bereit die Übersetzung zu übernehmen. Was muss ich dafür tun damit nicht irgendwer meine Übersetzung abtippen muss?

                                        Gleich zu Beginn stellt sich mir die erste Frage:

                                        unter Steps steht als erstes

                                        download and unpack this packet from github https://github.com/ioBroker/ioBroker.template/archive/master.zip or clone git repository git clone https://github.com/ioBroker/ioBroker.template.git
                                        
                                        

                                        Ich habe mich für die Download Variante entschieden und erhalte eine zip.Datei

                                        ioBroker.template-master.zip
                                        
                                        

                                        Wenn ich Sie "entpacken" will muss ich mich für ein Verzeichnis entscheiden in dem die Datei entpackt werden soll.

                                        Welches Verzeichnis muss das sein? A. auf einem Windows-System B. auf einem Raspi

                                        Auf einem Windows System vermute ich mal ist dieser Pfad der richtige?

                                        C:\Program Files\iobroker\node_modules
                                        
                                        
                                        1 Reply Last reply Reply Quote 0
                                        • Bluefox
                                          Bluefox last edited by

                                          @htrecksler:

                                          Ich habe bereits einen eigenen Adapter der auch sehr zuverlässig läuft. Jetzt möchte ich einen weiteren Adapter entwickeln und diese Anleitung (Post von Bluefox) als Anleitung verwenden.

                                          Ich werde mich genau an die Schritte halten und Fragen die sich mir stellen hier posten. Ich denke, wenn ich die Fragen habe, werden andere diese Fragen auch haben. Vielleicht kann man auf diese Weise die Anleitung optimieren.

                                          Die Anleitung ist komplett in Englisch. Ich selber habe damit kein Problem, ich könnte mir aber vorstellen, das andere damit durchaus ihre Schwierigkeiten haben. Ich bin gerne bereit die Übersetzung zu übernehmen. Was muss ich dafür tun damit nicht irgendwer meine Übersetzung abtippen muss?

                                          Gleich zu Beginn stellt sich mir die erste Frage:

                                          unter Steps steht als erstes

                                          download and unpack this packet from github https://github.com/ioBroker/ioBroker.template/archive/master.zip or clone git repository git clone https://github.com/ioBroker/ioBroker.template.git
                                          
                                          

                                          Ich habe mich für die Download Variante entschieden und erhalte eine zip.Datei

                                          ioBroker.template-master.zip
                                          
                                          

                                          Wenn ich Sie "entpacken" will muss ich mich für ein Verzeichnis entscheiden in dem die Datei entpackt werden soll.

                                          Welches Verzeichnis muss das sein? A. auf einem Windows-System B. auf einem Raspi

                                          Auf einem Windows System vermute ich mal ist dieser Pfad der richtige?

                                          C:\Program Files\iobroker\node_modules
                                          
                                          ```` `  
                                          

                                          Es ist schön wie du es angegangen bist. Ich denke am besten wäre die Anleitung auf github einfach erweitern, so dass eventuell keine Ungenauigkeiten bleiben.

                                          Man darf das Paket irgendwo entpacken, dabei unter Punkt 5 steht
                                          > 5\. to use this template you should copy it into …/iobroker/node_modules directory and then create an instance for it with iobroker.admin
                                          Dabei dachte ich kann ich beide systeme abdecken (Win/Linux), aber falls es doch unklar ist, dann konnte man das erweitern.

                                          ` > Under linux this is normally /opt/iobroker/node_modules

                                          and under windows C:\Program Files\ioBroker\node_modules (warning: you must be an administrator to copy files in this location) `

                                          Wirst du pull requests auf github stellen?

                                          Man konnte auch Readme.DE.md machen, ich bin nur froh.

                                          1 Reply Last reply Reply Quote 0
                                          • htrecksler
                                            htrecksler Forum Testing last edited by

                                            Ahhh… als ich bei Punkt 5 angekommen bin war mir das Verzeichnis auch klar.

                                            Erst komplett lesen und dann schreiben. 😄 😄

                                            Ich würde die "Readme.DE.md" gerne machen. In welchem Format hättest Du die gerne? Dürfen Screenshots enthalten sein?

                                            Ich bin gerade dabei einen neuen Adapter nach der Anleitung zu erstellen. Parallel dazu schreibe ich auf Basis Deiner Anleitung eine deutsche Übersetzung (allerdings etwas ausführlicher Schritt für Schritt - mit Hinweis auf eventuelle Fallen in die man tappen kann).

                                            Derzeit mache ich das in OneNote (Windows Fan eben 😄 )

                                            Aber ich nehme Dir gerne Arbeit ab. (Dann kannst Du Features machen)

                                            1 Reply Last reply Reply Quote 0
                                            • First post
                                              Last post

                                            Support us

                                            ioBroker
                                            Community Adapters
                                            Donate

                                            1.0k
                                            Online

                                            31.7k
                                            Users

                                            79.6k
                                            Topics

                                            1.3m
                                            Posts

                                            14
                                            51
                                            15987
                                            Loading More Posts
                                            • Oldest to Newest
                                            • Newest to Oldest
                                            • Most Votes
                                            Reply
                                            • Reply as topic
                                            Log in to reply
                                            Community
                                            Impressum | Datenschutz-Bestimmungen | Nutzungsbedingungen
                                            The ioBroker Community 2014-2023
                                            logo