/ioBroker.linkeddevices

Create linked objects (datapoints) of your devices with a self-defined structure. This makes it possible to create a structure in ioBroker, where all objects are centralized, e.g. to be used in the vis or scripts.

Primary LanguageJavaScriptMIT LicenseMIT

ioBroker.linkeddevices

NPM version Downloads Number of Installations Dependency Status Known Vulnerabilities

NPM

Tests:: Travis-CI

linkeddevices adapter for ioBroker

paypal

Create linked objects (datapoints) of your devices with a self-defined structure. This makes it possible to create a structure in ioBroker, where all objects are centralized, e.g. to be used in the vis or scripts. This offers the advantage, for example, that in a hardware exchange, only the linked objects must be recreated and all vis and scripts work again.

With the adapter you can convert objects or convert them to other types (not yet fully implemented).

This adapter is inspired at virtual devices script by Pman.

Objekt (Datenpunkt) verlinken

Ein Objekt (Datenpunkt) kannst du über den Button 'Einstellungen' im Menü 'Objekt' erstellen.

Objekt (Datenpunkt) Einstellungen

Die folgenden Grundeinstellungen müssen für das verlinkte Objekt vorgenommen werden:

Eingabefeld Beschreibung
Aktiviert ein Verlinkung für das Objekt aktivieren
Präfix für ID des verlinkten Objektes Bezeichung die der Id des verlinkten Objektes vorangestellt werden soll
ID des verlinkten Objekts Id des verlinkten Objektes
Zusammengesetze Id des verlinkten Objektes Zeigt an wie die Id des verlinkten Objektes aussehen wird - Zusammensetzung von 'Präfix für ID des verlinkten Objektes' & 'ID des verlinkten Objekts'

Weiter könnt ihr noch folgende Einstellungen vornehmen:

Eingabefeld Beschreibung
Name des verlinkten Objekts Hier könnt ihr einen Namen für das verlinkte Objekte festlegen
Experteneinstellungen für verlinktes Objekt vom Typ 'X' weitere Einstellungen die abhängig vom Typ des Objektes sind. (Zusätzliche Informationen hierzu findest du weiter unten)

Beispiel: Die oben im Screenshot dargestellten Eingaben erzeugen das folgende verlinkte Objekt:

Experteneinstellungen für verlinktes Objekt vom Typ 'X'

Abhängig vom Typ (Zahl, Logigwert, Zeichenkette, etc.) des zu verlinkenden Objektes, könnt Ihr weitere Einstellungen, wie z.B. Umrechnungen oder Umwandlungen in einen anderen Typ für das verlinkte Objekt einstellen.

Experteneinstellungen für verlinktes Objekt vom Typ 'Zahl (readonly)'

'Zahl (readonly)': Konvertiere in Typ 'nicht umwandeln'

Eingabefeld Beschreibung erlaubte Eingabe Beispiel (siehe Bild)
Ändere Einheit 'X' in Einheit für das verlinkte Objekt festlegen keine Beschränkung Objekt hat Einheit 'kWh', verlinktes Objekt hat Einheit 'Wh'
max. Anzahl der Nachkommastellen max. Anzahl der Nachkommastellen für das verlinkte Objekt festlegen Zahlen Wert des Objekts '100.561' ergibt für das verlinkte Objekt den Wert '101'
Ändere min 'X' in minimaler Wert der das verlinkte Objekt annehmen darf Zahlen -
Ändere max 'X' auf maximaler Wert der das verlinkte Objekt annehmen darf Zahlen -
Umrechnung für verlinktes 'read' Objekt mathematische Umrechnung des Wertes des Objektes + - / *,. () & Zahlen Wert des Objektes '279688.9' mit Umrechnung '/1000' zeigt beim verlinkten Objekt den Wert '280.6889' an

'Zahl (readonly)': Konvertiere in Typ 'Logikwert'

Eingabefeld Beschreibung erlaubte Eingabe Beispiel (siehe Bild)
Bedingung 'true' für verlinktes Objekt Wert des Objektes, für den das verlinkte Objekt auf 'true' gesetzt werden soll = != > < >= <= + Zahlen Für Werte '>100' des Objekt ist das verlinkte Objekt 'true'

Experteneinstellungen für verlinktes Objekt vom Typ 'Zahl'

'Zahl': Konvertiere in Typ 'nicht umwandeln'

Eingabefeld Beschreibung erlaubte Eingabe Beispiel (siehe Bild)
Ändere Einheit 'X' in Einheit für das verlinkte Objekt festlegen keine Beschränkung Objekt hat keine Einheit, verlinktes Objekt hat Einheit '%'
max. Anzahl der Nachkommastellen max. Anzahl der Nachkommastellen für das verlinkte Objekt festlegen Zahlen Wert des Objekts '100.561' ergibt für das verlinkte Objekt den Wert '101'
Ändere min 'X' in minimaler Wert der das verlinkte Objekt annehmen darf Zahlen -
Ändere max 'X' auf maximaler Wert der das verlinkte Objekt annehmen darf Zahlen -
Umrechnung für verlinktes Objekt mathematische Umrechnung des Wertes des Objektes / *,. & Zahlen Wert des Objektes '180' mit Umrechnung '*100/255' zeigt beim verlinkten Objekt den Wert '71' an. Umgekehrt wird der Kehrwert bei der Berechnung gebildet, d.h. wenn das verlinte Objekt den Wert '71' hat, hat das Objekt den Wert '180'. Das kann z.B. für Hue Lampen verwendet werden, um den Wertebereich von '0-255' in '0%-100%' umzuwandeln

'Zahl': Konvertiere in Typ 'Logikwert'

Eingabefeld Beschreibung erlaubte Eingabe Beispiel (siehe Bild)
Bedingung 'true' für verlinktes Objekt Wert des Objektes, für den das verlinkte Objekt auf 'true' gesetzt werden soll = != > < >= <= + Zahlen Für Werte '>30' des Objekt ist das verlinkte Objekt 'true'
Wert wenn verlinktes Objekt 'true' ist Wert des Objektes wenn das verlinkte Objekt 'true' ist Zahlen Wird das verlinkte Objekt auf 'true' gesetzt, wird der Wert des Objektes '30'
Wert wenn verlinktes Objekt 'false' ist Wert des Objektes wenn das verlinkte Objekt 'false' ist Zahlen Wird das verlinkte Objekt auf 'false' gesetzt, wird der Wert des Objektes '10'

Changelog

0.2.1

  • (Scrounger) boolean to string converter added
  • (Scrounger) bug fixes

0.2.0

  • (Scrounger) number to boolean converter added
  • (Scrounger) number expert settings for min, max added
  • (Scrounger) bug fixes

0.1.5

  • (Scrounger) expert settings properties renamed -> you must recreate your expert settings for all parent objects !!!
  • (Scrounger) custom dialog prepared for convert to other type
  • (Scrounger) bug fixes

0.1.0

  • (Scrounger) custom dialog layout changed
  • (Scrounger) conversion bug fixes
  • (Scrounger) change unit bug fixes

0.0.4

  • (Scrounger) main function added
  • (Scrounger) change unit for linked objects
  • (Scrounger) set number of decimal places for linked objects
  • (Scrounger) set conversion for read only linked objects

0.0.1

  • (Scrounger) initial release

License

MIT License

Copyright (c) 2019 Scrounger

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.