Konfiguration von Komponenten
Aus wakeboX - Wiki
Einleitung
Nachdem Sie eine Verbindung zum Server hergestellt haben, wechseln Sie mit dem Knopf
in das Konfigurationsmenü und mit Server
in die Ansicht der Serverkonfiguration.
Hier sehen Sie alle derzeit konfigurierten Komponenten in einem Baum strukturiert. Durch Anklicken der einzelnen Komponenten sehen Sie auf der rechten Seite die entsprechenden Eigenschaften der Komponente. Dies sind die Konfigurationsparameter, welche jede Komponente zum ordnungsgemäßen Betrieb benötigt.
Hinweis: Eingabegeräte, wie FS20 Fernbedienungen werden separat unter Eingabegeräte
definiert. Siehe dazu Eingabegeräte definieren.
Farbcodes
Die Farben der Komponentenbezeichnungen innerhalb des Baumes auf der linken Seite haben bestimmte Bedeutungen:
| Farbe | Bedeutung |
|---|---|
| Komponente | Die Komponente ist aktiviert und betriebsbereit. |
| Komponente | Die Komponente ist fehlerhaft und wurde deaktiviert. Den Grund erfahren Sie durch Anklicken der Komponente. |
| Komponente | Die Eigenschaften der Komponente wurden verändert. Die Änderungen sind noch nicht aktiviert. |
| Komponente | Die Komponente wurde neu hinzugefügt. Sie ist noch nicht aktiviert. |
| Komponente | Die Komponente ist zur Löschung vorgemerkt. Die Löschung wurde noch nicht durchgeführt. |
Hinzufügen einer Komponente
Um eine neue Komponente hinzuzufügen, klicken sie auf Hinzufügen. Dies öffnet einen Popup-Dialog mit den folgenden Feldern:
| Feld | Bedeutung |
|---|---|
| Name | Dies ist der Name der neu hinzuzufügenden Komponente. Dieser muss innerhalb der gesamten Konfiguration eindeutig sein. Sollte bereits eine Komponente mit diesem Namen vorhanden sein, erscheint ein entsprechender Hinweis und die Erstellung der Komponente wird verhindert. |
| Typ | Wählen Sie hier den Komponententyp aus. Bisher sind alle Typbezeichnungen in englisch. Eine Liste aller erzeugbaren Komponenten und Ihrer Eigenschaften finden Sie weiter unten. Manche Typen (bsp. communicator) sind nur einmal erzeugbar, da sie nur einmal im System vorkommen dürfen. In diesem Fall erscheint ein entsprechender Hinweis und die Erstellung der Komponente wird verhindert. |
| Elternkomponente | Alle Komponenten sind hierarchisch innerhalb eines Baumes organisiert. Um diese Ordnung aufrecht zu erhalten kann jeder Komponententyp nur unterhalb gewisser anderer Komponententypen erzeugt werden. Die Auswahlliste zeigt alle möglichen Elternknoten an, unter welchem die neue Komponente erzeugt werden kann (oft nur eine Möglichkeit). Hierdurch wird sichergestellt, dass Beispielsweise Dimmer, Schalter und MP3-Player immer unter Aktoren angelegt werden. |
Sobald Sie alle Felder ausgefüllt haben und den Dialog mit OK bestätigt haben, erscheint die neue Komponente im Konfigurationsbaum. Die Eigenschaften (Konfigurationswerte) der Komponente sind bereits mit Standardwerten gefüllt (eventuell auch leer). Um die Komponente nun nach eigenen Bedürfnissen zu konfigurieren, klicken sie innerhalb des Baumes auf diese, und editieren Sie die rechts erscheinenden Felder. Bitte beachten Sie, dass die Komponente noch nicht aktiviert und betriebsbereit ist. Eine Aktivierung neuer oder geänderter Komponenten erfolgt erst nach Drücken von Anwenden.
Editieren der Konfigurationsparameter
Die Konfigurationsparameter einer Komponente ändern Sie, indem Sie auf die Komponente innerhalb des linken Baumes klicken und anschließend die recht erscheinenden Felder Ihren Bedürfnissen anpassen. Eine Beschreibung der meisten Felder finden Sie weiter unten ausgeführt. Bitte beachten Sie, dass Änderungen an einer Komponente erst durch Klicken von Anwenden aktiviert werden.
Löschen einer Komponente
Zum Löschen einer Komponente klicken Sie auf die entsprechende Komponente innerhalb des Konfigurationsbaumes und klicken anschließend Entfernen. Die Komponente ist nun zur Löschung vorgemerkt. Bitte beachten Sie, dass die tatsächliche Löschung erst durch Klicken von Anwenden durchgeführt wird. Bitte beachten Sie auch, dass manche Komponenten zum Betrieb von wakeboX zwingend notwendig sind und von daher nicht gelöscht werden können.
Die Komponententypen
Hier eine Übersicht der wichtigsten verfügbaren Komponententypen:
| Typ | (englische) Bezeichnung | Beschreibung |
|---|---|---|
| FS20 Schalter | switch | Diese Komponente repräsentiert einen FS20 Schalter, der insbesondere durch eine FS20 Adresse beschrieben wird. Dieser Schalter kann später in Abläufen oder auch direkt über den Client geschaltet werden. |
| FS20 Dimmer | dimmer | Diese Komponente repräsentiert einen FS20 Dimmer, der insbesondere durch eine FS20 Adresse beschrieben wird. Dieser Dimmer kann später in Abläufen oder auch direkt über den Client gedimmt werden. Außerdem stehen bei dieser Komponente Funktionen wie Dimmen über Zeitraum zur Verfügung, mit denen beispielsweise Sonnenauf- oder Untergänge nachgebildet werden können. |
| FS20 Einmalschalter | oneshotswitch | Diese Komponente ist eine Spezialisierung des FS20 Schalters. Er muss scharf geschaltet sein, bevor er eingeschaltet werden kann. Nachdem er ausgeschaltet wurde, muss er erneut scharf geschaltet werden bevor er wieder einschalten kann. Hierdurch können Geräte, die eine Vorbereitung benötigen, wie zum Beispiel Kaffeemaschinen, sicher geschaltet werden. Auch wenn beispielsweise jeden Morgen um 6:00 Uhr der FS20 Schalter der Kaffeemaschine programmatisch durch die wakeboX eingeschaltet wird, wird das Einschalten nur ausgeführt, wenn die Kaffeemaschine vorbereitet wurde (Kaffeefilter, Kaffee, Wasser) und dies dem Einmalschalter durch scharf machen mitgeteilt wurde. |
| MP3 Player | mp3player | Diese Komponente steuert einen MP3 Player, welcher in der Lage ist Audiodateien und Internetradio abzuspielen. Es können mehrere MP3 Player erzeugt werden und deren Ausgaben in einem Mischer (audiomixer) zusammengeführt werden. Hierdurch können beispielsweise Musik, Atmosphäre und Stimme gleichzeitig ablaufen. |
| Lautstärkenregler | volumecontrol | Diese Komponente regelt die Lautstärke einer Soundkarte über ein externes Programm namens amixer. Das Programm amixer muss installiert sein. Unter Debian und Ubuntu ist es im Installationspaket alsa-utils enthalten. |
| Audio-Mischer | audiomixer | Diese Komponente führt die Ausgaben verschiedener MP3 Player zusammen und leitet sie auf eine Soundkarte. Die Komponente kann und sollte anstatt eines alsa-Mischers verwendet werden, da sie effizienter ist und in einer späteren Version von wakeboX um gewisse Merkmale erweitert werden soll. Sie kann dann als Aktor angesprochen werden. Sollte Ihr System über mehrere Soundkarten verfügen, können sie für jede Soundkarte einen eigenen Audio-Mischer erzeugen. |
| PC Lautsprecher | beeper | Diese Komponente steuert den PC Lautsprecher (soweit dieser vorhanden ist) an. Hierdurch können einfache Töne (definiert durch Frequenz und Tonlänge) in Abläufe eingebunden werden. |
| Multimedia Infrarot Fernbedienung | hid_rem | Diese Komponente repräsentiert eine Multimedia Infrarot Fernbedienung, mit deren Eingabe beliebige Aktionen verknüpft werden können. |
| Wecken über Netzwerk | wakevialan | Diese Komponente schaltet entsprechend konfigurierte PCs über das Netzwerk ein. Hierbei sendet die Komponente über das Netzwerk ein spezielles Paket (Magic Packet) mit der MAC Adresse des entsprechendes Gerätes. Der zu weckende PC muss das Merkmal Wake on LAN unterstützen und er muss entsprechend konfiguriert sein. Siehe hierzu http://de.wikipedia.org/wiki/Wake_On_LAN. |
| Ablaufkontrolle | programplayer | Diese Komponente kontrolliert Programmabläufe. Ein Ablauf ist gekennzeichnet durch zeitlich hintereinander gereihte (durch Aktoren ausgeführte) Aktionen. Durch diesen Aktor ist es möglich Abläufe zu starten und innerhalb von Abläufen weitere Abläufe aufzurufen. Es kann genau eine Komponente von diesem Typ geben. |
| Netzwerk | communicator | Diese Komponente ist für die Kommunikation zwischen Client und Server zuständig. Es kann genau eine Komponente von diesem Typ geben. |
| FHZ1000 / FHZ1300 | fhz | Diese Komponente steuert alle definierten FS20 Schalter und Dimmer über die FHZ1000 bzw. FHZ1300 an. Außerdem werden hierüber FS20 Signale von FS20 Fernbedienungen empfangen, die dann wiederum auf konkrete Aktionen oder Abläufe abgebildet werden können. Die FHZ ist ein zentrale Komponente, ohne der Schalter, Dimmer, FHT80, etc. nicht funktionieren. Es kann höchstens eine Komponente von diesem Typ geben. |
| FHT80b Heizungssteuerung | fht80 | Diese Komponente kommuniziert mit einer Heizungssteurungseinheit vom Typ FHT80b. Es kann damit die Zieltemperatur, sowie die Tages- und Nachttemperatur gestellt werden. |
| FHT80b Temperaturabschnitt | fht80table | Diese Unterkomponente einer Heizungssteurungseinheit sorgt für bestimmte Temperaturen zu bestimmten Zeitabschnitten in der Woche. So können mehr Abschnitte, als von einer FHT80b vorgesehen, definiert werden. |
| Dateibrowser | filebrowser | Diese Komponente ist für das Durchsuchen des Dateisystems zuständig. Sie wird für das Öffnen von Audiodateien benötigt. Die Hauptaufgabe dieser Komponente besteht in der Abbildung von virtuellen zu tatsächlichen Verzeichnissen. |
| Dateiverzeichnis | location | Diese Unterkomponente des Dateibrowsers definiert ein virtuelles Verzeichnis, welches auf ein reales Verzeichnis abbildet. So kann beispielsweise ein virtuelles Verzeichnis Musik definiert werden, welches auf das reale Verzeichnis /var/mp3 abbildet. |
| ELV USB-BAT | elvusbbat | Diese Komponente steuert das USB Bedien-Anzeige-Terminal von ELV. Alle Knöpfe des Bedienteils können als frei programmierbare Eingaben verwendet werden. Hier wird insbesondere auch zwischen langem und kurzen Drücken und sogar Knopfkombinationen unterschieden. Auch das Drehen des Encoderknopfes kann auf Abläufe und andere Aktoren, wie beispielsweise Lautstärke, nächster/vorheiger Titel, etc abbilden. Als Aktionen des Bedienteils stehen beispielsweise das Schalten der LCD-Beleuchtung, das Ansteuern des Summers, als auch das Betreten der Steuerungsmenüs zur Verfügung. |
| USB Bedienteil | hid | Diese Komponente steuert das selbst entwickelte USB Bedienteil. Alle Knöpfe des Bedienteils können als frei programmierbare Eingaben verwendet werden. Hier wird insbesondere auch zwischen langem und kurzen Drücken und sogar Knopfkombinationen unterschieden. Auch das Drehen des Encoderknopfes kann auf Abläufe und andere Aktoren, wie beispielsweise Lautstärke, nächster/vorheiger Titel, etc abbilden. Als Aktionen des Bedienteils stehen beispielsweise das Schalten der LCD-Beleuchtung als auch das Betreten der Steuerungsmenüs zur Verfügung. |
Im Folgenden finden Sie für die oben gelisteten Komponententypen eine detaillierte Beschreibung der Konfigurationsparameter.
FS20 Schalter, FS20 Dimmer und FS20 Einmalschalter
MP3 Player
Lautstärkenregler
Audio-Mischer
| Feld | Beschreibung |
|---|---|
| AudioDevice | Dieser Wert bestimmt das Ausgabegerät des Audio-Mischers. Dies kann wahlweise die Standard ALSA-Ausgabe oder eine bestimmte Soundkarte sein. Durch Klicken von |
| NoOfChannels | Dieser Wert definiert die maximale Anzahl an eingehenden Kanälen des Mischers. Der Standardwert ist 4, wodurch bis zu maximal 4 MP3-Player an diesem Mischer angeschlossen werden können. |
| InitialOutputVolume | Dieser Wert bestimmt die Ausgabelautstärke ("Master Volume") des Audio-Mischers beim Start des Servers (0% ... 100%). Der Wert wurde mit Serverversion 0.73.1 eingeführt. Werte über 100% sind nicht möglich. Für höhere Pegel erhöhen Sie bitte die Lautstärkenregler der Soundkarte. Zusätzlich ist es auch möglich, den Ausgabepegel ("Volume") der MP3 Player über 100% anzuheben. |
| InitialOutputBalance | Dieser Wert bestimmt die Ausgabebalance (Lautstärkeverhältnis von linkem und rechtem Ausgabekanal) beim Start des Servers (-100% ... 100%). Der Wert wurde mit Serverversion 0.73.1 eingeführt. |
PC Lautsprecher
Diese Komponente besitzt keinerlei Konfigurationsparameter.
Multimedia Infrarot Fernbedienung
| Feld | Beschreibung |
|---|---|
| USBVendorProduct | Dies ist die USB Vendor und Product ID des Eingabegerätes. Ein Klick auf '...' zeigt alle vorhandenen Eingabegeräte an. Bitte beachten Sie, dass hier auch Eingabegeräte wie einfache Tastaturen angezeigt werden. Wenn Sie nicht sicher sind, welche ID Ihrem gewünschten USB-Gerät entspricht, ziehen Sie dieses heraus, und prüfen die Liste durch erneutes Öffnen. Das Fehlende Gerät ist das von Ihnen gewünschte. Stecken Sie es wieder ein und wählen Sie es durch erneutes Öffnen des Browserdialogs aus. |
| Prefix | Dies ist das Präfix, dass jedem durch dieses Eingabegerät erzeugte Symbol vorangestellt wird. |
| NumericCodes | Wenn Sie diese Option aktivieren, können durch die numerischen Tasten Ihres Eingabegerätes (IR Fernbedienung) und der Eingabetaste numerische Kombinationen erzeugt werden. Sie können dann beispielsweise die Kombination 2-5-8-Enter auf Ihrer Fernbedienung tippen, die dann in ein einzelnes Symbol IR_258 umgewandelt wird. |
| IgnoreKeys | Dies ist eine mit Doppelpunkten getrennte Liste von zu ignorierenden Tasten. Manche IR-Fernbedienungen benutzen beispielsweise die NUMLOCK Taste für jede numerische Eingabe, wodurch diese als zusätzliches Ereignis an das System gesendet wird und damit die numerische Eingabe überdeckt. Dises Feld wurde mit Serverversion 0.73.1 eingeführt. |
Wecken über Netzwerk
Diese Komponente besitzt keinerlei Konfigurationsparameter.
Ablaufkontrolle
Diese Komponente besitzt keinerlei Konfigurationsparameter.
Netzwerk
| Feld | Beschreibung |
|---|---|
| Port | Dies ist der TCP/IP Port an welchem der Server auf eingehende Verbindungen wartet. Der Standardwert ist 5250 und sollte nur geändert werden, wenn der Port bereits von einem anderen Dienst verwendet wird. |
FHZ1000 / FHZ1300
| Feld | Beschreibung |
|---|---|
| Driver | Dieser Wert bezeichnet den Namen des Treiber, der zur Steuerung der FHZ geöffnet werden muss. Der Standradwert ist /dev/ttyUSB0, kann aber bei Verwendung von weiteren USB-zu-seriell Adaptern auch anders lauten. |
| EmulateIfNotPresent | Wenn dieses Feld eingeschaltet ist, bleibt die Komponente auch bei nicht gefundener FHZ Hardware aktiv. Somit bleiben alle Komponenten wie Schalter, Dimmer, etc. aktiv. Natürlich können in diesem Fall weder FS20 Signale gesendet, noch empfangen werden. |
| DeadTime | Die FHZ Hardware muss zwischen dem Senden von 2 aufeinander folgenden FS20 Signalen eine Mindestzeit (Totzeit) einhalten (in der Regel 0,25 Sekunden). Beim Versuch schneller zu senden, gehen Signale verloren. Die Zeit kann bei Verwendung von FS20 Repeatern angehoben werden. |
| InitializeKS300 | Wenn Sie eine FHZ1300 haben, initialisieren Sie damit das KS300 Protokoll. Hierdurch kann wakeboX Wetterdaten von entsprechenden Wetterstationen empfangen. |
FHT80b Heizungssteuerung
| Feld | Beschreibung |
|---|---|
| AddressCode | Code, der beim Einschalten der FHT80 angezeigt wird (Format WX:YZ) |
FHT80b Temperaturabschnitt
| Feld | Beschreibung |
|---|---|
| Day | |
| StartHour | |
| StartMinute | |
| EndHour | |
| EndMinute | |
| Temperature |
Dateibrowser
Diese Komponente besitzt keinerlei Konfigurationsparameter.
Dateiverzeichnis
| Feld | Beschreibung |
|---|---|
| Name | Dies ist der virtuelle Name des unter Path genannten Verzeichnisses. Dieser virtuelle Name wird im Dateibrowser des Clients angezeigt und zur Referenzierung auf Audiodateien verwendet. |
| Path | Dies ist der tatsächliche Pfad auf dem Dateisystem zu welchem der virtuelle Name (siehe oben) abbildet. |
ELV USB Bedien-Anzeige-Terminal
| Feld | Beschreibung |
|---|---|
| LightLatency | Dies ist die LCD Beleuchtungszeit. Nach Ablauf dieser Zeit nach dem letzten Tastendruck innerhalb von Menüs erlischt diese. |
| RootJump | Ist dieser Wert größer als 0, erfolgt ein automatischer Rücksprung zur Hauptanzeige nach dieser Zeit (Einheit: Sekunden) nach dem letzten Tastendruck am Bedienteil (innerhalb von Menüs). |
| EndlessMenus | Wenn eingeschaltet: Bei Erreichen des letzten Eintrages eines Menüs springt dieses automatisch zum ersten Eintrag des Menüs und umgekehrt. |
| LightTitleChange | Ist dieser Wert größer als 0, leuchtet die LCD Beleuchtung für diese Zeit beim Wechsel des Musiktitels. |
| CenterTitle | Ist dieser Schalter eingeschaltet, werden Musiktitel zentriert anstatt linksbündig angezeigt. |
| ButtonThresholdTime | Dies ist der Schwellwert, der einen langen von einem Kurzen Knopfdruck auf dem Bedienteil unterscheidet. |
| MenuUpDeadTime | Ist dieser Wert größer als 0, bleibt die Taste Menü hoch nach Erreichen der Hauptanzeige für diese Zeit gesperrt. Hierdurch wird vermieden, dass bei schnellem wiederholtem Drücken der Menü hoch Taste bei Erreichen der Hauptanzeige versehentlich die mit dieser Taste verknüpfte Aktion ausgelöst wird. |
| Prefix | Diese Zeichenkette wird vor jede erzeugte Eingabe ID des BAT eingefügt (Standard = leere Zeichenkette). Die Verwendung eines Präfixes ist zur Unterscheidung mehrerer USB-BATs nötig: Hierdurch kann unterschieden werden, auf welchem USB-BAT eine Taste gedrückt wurde bzw. der Inkrementalgeber betätigt wurde. |
| InvertMenuNavigation | Dieser Schalter invertiert die Scrollrichtung beim Navigieren durch Menüs. Ist dieser Schalter eingeschaltet, gelangt man durch Linksdrehen des Inkrementalgebers zum nächsten Menüpunkt. Ist dieser Schalter ausgeschaltet, gelangt man durch Rechtsdrehen des Inkrementalgebers zum nächsten Menüpunkt. |
| VolumeIncrement | Dieser positive ganzzahlige Wert beschreibt das Inkrement (in %-Punkten bzw. dB), welches beim Drehen des Inkrementalgebers um eine Position auf eine Lautstärke (z.B. MP3Player/Gesamtlautstärke/Audiomischer) aufaddiert bzw. abgezogen wird. Durch größere Werte kann die Lautstärke schneller auf Kosten der Feinabstufung geändert werden. In jedem Fall jedoch kann durch zusätzliches Drücken der 'B'-Taste während des Drehen des Inkrementalgebers ein Feineinstellen (Inkrement=1) bewirkt werden. |
| DefaultMP3Player | Dieser Wert definiert den Namen des aktiven MP3-Players beim Starten des Servers. Der aktive MP3-Player ist der Player, dessen Zustand und gegenwärtiger Titel auf dem BAT im Ruhezustand angezeigt wird und auf welchen sich sämtliche MP3-Player Einstellungen in den Menüs beziehen. Wenn dieses Feld leer bleibt oder einen ungültigen Namen enthält, wird der erste gefundene MP3-Player als aktiver Player verwendet. Der aktive Player kann während des Betriebes innerhalb des MP3-Menüs geändert werden (Menüpunkt MP3 -> Spieler wählen). |
| EnumerationID | Dieser Wert definiert den Geräteindex (Standardwert = 0). Für ein zweites USB-BAT muss dieser Wert 1 sein. Für ein drittes USB-BAT muss dieser Wert 2 sein. Und so weiter. Durch diesen Index kann wakeboX den jeweils zum Gerät gehörigen Systemtreiber öffnen. |
USB Bedienteil
Das selbst gebastelte USB Bedienteil hat die selben Konfigurationsfelder wie das ELV USB Bedien-Anzeige-Terminal (siehe oben). Die Felder werden daher hier nicht nochmal aufgeführt. Zusätzlich definiert das selbst gebastelte USB Bedienteil folgendes Feld:
| Feld | Beschreibung |
|---|---|
| Driver | Dies ist der Treiber, der vom Server geöffnet werden soll, um das USB Bedienteil anzusteuern. Standard ist /dev/wbxhid. |
