hyperion.NG

Dieser Adapter kann HyperionNG steuern

Aktueller Release
0.1.23
Entwickler
felixganzer
Lizenz
MIT

hyperion_ng-Adapter für ioBroker

Mit diesem Adapter können Sie Ihre HyperionNG-Geräte steuern.

https://hyperion-project.org/

Handbuch

Allgemein

Der Adapter erstellt für jede Hyperion-Hardwareinstanz einen Ordner mit der Instanznummer. In diesem Ordner befinden sich die eigentlichen Einstellungen, alle Komponenten und alle aktiven Prioritäten.

Zusätzlich wird ein allgemeiner Ordner erstellt, der die Steuerung zum Senden von Befehlen an Hyperion, alle möglichen Effekte und Systeminformationen über Hyperion enthält.

Steuerkomponenten und Deaktivierung der Hyperion-Instanz

Sie können die Komponenten im Ordner „instance.components“ steuern, um den booleschen Wert festzulegen. Nach dem Festlegen des Parameters werden alle Komponentenparameter der gesteuerten Instanz und aller nachfolgenden Instanzen aktualisiert.

Zusätzlich können Sie den Parameter instance.running festlegen, um die gesamte Instanz zu aktivieren und zu deaktivieren.

Reglereinstellungen

Sie können die Einstellungen im Ordner „instance.components“ anpassen, um den Parameter festzulegen. Nach der Parametereinstellung werden alle Einstellungen der gesteuerten Instanz und aller nachfolgenden Instanzen aktualisiert.

Set-Effekte

Um einen Effekt festzulegen, müssen Sie unter `general.control.instance` eine Instanznummer angeben. Anschließend können Sie unter `general.control.setEffect` den korrekten Namen eines bestehenden Effekts eingeben. Nach der Festlegung des Effekts werden die Prioritäten der verwendeten Instanz und aller nachfolgenden Instanzen aktualisiert.

Über `general.control.durationEffectColor` können Sie die Dauer in Sekunden festlegen. Dieser Wert muss vor dem Aktivieren des Effekts eingestellt werden. Der Standardwert 0 bewirkt eine unendliche Effektdauer.

Farben festlegen

Um eine Farbe festzulegen, müssen Sie unter general.control.instance eine Instanznummer angeben. Anschließend können Sie unter general.control.setColorRGB einen RGB-Wert eingeben. Nach der Farbfestlegung werden die Prioritäten der verwendeten Instanz und aller nachfolgenden Instanzen aktualisiert.

Über `general.control.durationEffectColor` können Sie die Dauer in Sekunden festlegen. Dieser Wert muss vor der Farbauswahl eingestellt werden. Der Standardwert 0 bewirkt eine unendliche Effektdauer.

Eine weitere Möglichkeit zur Farbfestlegung bietet die Verwendung von HSL. Hierfür stehen drei Datenpunkte unter general.control.setColorHSL zur Verfügung. Wird einer dieser Datenpunkte geändert, wird die Farbe aktualisiert.

Greifer sichtbar machen

Sie können den internen oder USB-Video-Grabber als sichtbare Priorität festlegen, indem Sie `general.control.setinternalGrabberVisible` bzw. `setUSBGrabberVisible` auf `true` setzen. Zuvor müssen Sie die zu steuernde Instanz unter `general.control.instance` festlegen. Wenn Sie die Standardprioritäten in Hyperion geändert haben, müssen Sie die Werte auf der Adapterkonfigurationsseite entsprechend anpassen.

klare Effekte und Farben

Um eine Priorität zu löschen, müssen Sie unter `general.control.instance` eine Instanznummer festlegen. Anschließend können Sie den Parameter `general.control.clearAll` oder `general.control.clearVisible` auf `true` setzen, um die Prioritäten zu löschen. Nach erfolgreicher Löschung wird der boolesche Wert auf `false` gesetzt.

Aktualisierte Daten von Hyperion

Sie können die Daten des gesamten Adapters manuell aktualisieren, indem Sie `general.control.updateAdapter` auf `true` setzen. Mit dem Datenpunkt `general.control.updatePriorities` können Sie die Prioritäten aller Instanzen aktualisieren.

Changelog

0.1.23 (2022.01.09)

  • (felixganzer) bugfix read out and control components

0.1.22 (2021.10.14)

  • (felixganzer) add communication delay time to config, set default value to 200 ms
  • (felixganzer) add Version test for HyperioHDR

0.1.21 (2021.07.27)

  • (felixganzer) bugfix setColor with duration 0 used false JSON
  • (felixganzer) bugfix setEffect with duration 0 used false JSON

0.1.19 (2021.03.29)

  • (felixganzer) little bugfixing

0.1.18 (2021.03.06)

  • (felixganzer) increase stopTimeout to 3 seconds
  • (felixganzer) add communicationTimer object

0.1.17 (2021.02.26)

  • (felixganzer) bugfixing: add error event handler for socket connection
  • (felixganzer) bugfixing: change state roles of control states
  • (felixganzer) bugfixing: add try and catch at set RGB color

0.1.16 (2021.02.07)

  • (felixganzer) bugfixing: clear socket at adapter unload
  • (felixganzer) bugfixing: change logo
  • (felixganzer) bugfixing: fix testing for github
  • (felixganzer) bugfixing: remove all the stuff inserted by an npm install

0.1.13 (2021.02.03)

  • (felixganzer) add set Color over HSL values

0.1.12 (2021.02.02)

  • (felixganzer) bugfix: add type-of-is to dependencies

0.1.11 (2021.01.30)

  • (felixganzer) bugfix: reduce warning "state has no existing object" for js-controller 3.2
  • (felixganzer) bugfix: read out priority of color crash at js-controller 3.2

0.1.10 (2021.01.10)

  • (felixganzer) reorginize config page and add config parameter
  • (felixganzer) add set internal or USB Grabber Visible with boolean

0.1.9 (2021.01.09)

  • (felixganzer) bugfix: reduce warnings
  • (felixganzer) add set Grabber Visible without any error catching
  • (felixganzer) add start update whole adapter data points and update Priorities

0.1.8 (2021.01.07)

  • (felixganzer) add set duration of effect and color to set
  • (felixganzer) bugfix: clearVisible did not work

0.1.7 (2021.01.06)

  • (felixganzer) bugfix: only works with iobroker adapter instance 0
  • (felixganzer) updating the manual

0.1.6 (2021.01.03)

  • (felixganzer) add setColorRGB under general.control
  • (felixganzer) add controlling adjustments of hyperion
  • (felixganzer) add start and stop Instance

0.1.5 (2021.01.02)

  • (felixganzer) read out all possible effects
  • (felixganzer) add setEffect under general.control
  • (felixganzer) read out video Mode and LED Mapping
  • (felixganzer) read out adjustments of instance

0.1.4 (2021.01.01)

  • (felixganzer) add control clear of colors and effects

0.1.3 (2021.01.01)

  • (felixganzer) add read out priorities to see actual running colors and effects

0.1.2 (2020.12.30)

  • (felixganzer) add read out sysinfos to check Version of Hyperion

0.1.1 (2020.12.30)

  • (felixganzer) add controlling components of hyperion
  • (felixganzer) create first config to set IP, Port and Priority

0.1.0 (2020.12.29)

  • (felixganzer) creating api class to communicate with hyperion and adding read out instances of hyperionNG

0.0.1 (2020.12.29)

  • (felixganzer) initial release

License

MIT License

Copyright (c) 2020-2021 felixganzer felixganzer@web.de

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.