Anleitung: Konfiguration des USB-BAT von ELV mit wakeboX

Aus wakeboX - Wiki

Das USB-BAT (Bedien-Anzeige-Terminal) von ELV kann in der wakeboX Software flexibel und individuell konfiguriert werden. Diese Anleitung beschreibt das Einbinden des USB-BAT in das wakeboX System und erklärt die Eingabekonfiguration, um übliche Funktionen wie Lautstärke ändern, Titel wechseln, Menu aufrufen, usw. über die Taster und den Inkrementalgeber aufzurufen.

Voraussetzung: Das USB-BAT von ELV wird ab wakeboX Version 0.74.1 unterstützt. Sollten Sie eine ältere Version von wakeboX installiert haben, muss die Software durch erneutes Herunterladen und Installieren des Servers und des Clients aktualisiert werden.

Inhaltsverzeichnis 1 Anschließen 2 Grundkonfiguration 3 Konfiguration der Taster und des Inkrementalgebers 3.1 Die Eingabesignale des BAT 3.2 Das Funktionsmenü des BAT 3.3 Belegungsbeispiele

Anschließen

Nach elektronischer und mechanischer Fertigstellung des USB-BAT gemäß beiliegender Bauanleitung stecken Sie nun das Gerät in eine freie USB-Buchse des PCs, auf welchem der wakeboX Server läuft. Auf dem LCD erscheint daraufhin die Produktbezeichnung und die Version der Firmware des verbauten Mikrocontrollers. Tastendrücke und Drehen am Inkrementalgeber bleiben zu diesem Zeitpunkt noch wirkungslos.

Die Mikrocontrollerfirmware des USB-BAT benutzt das standardisierte auf USB aufbauende Protokoll 'USB HID'. Dieses Protokoll wurde ursprünglich für Tastaturen und Mäuse konzipiert, wird aber auch für zahlreiche andere USB-Geräte mit verhältnismäßig geringem Datenaufkommen verwendet. Hierdurch ist für das USB-BAT kein zusätzlicher Treiber nötig und Linux erkennt das Gerät auf Anhieb. Sie können nun mit der Grundkonfiguration (nächster Abschnitt) fortfahren.

Optional: Wenn Sie möchten, können Sie das Erkennen des USB-BATs durch Linux an einer Linux-Shell durch das Kommando dmesg überprüfen:

$ dmesg
...
usb 1-1.3: new full speed USB device using orion-ehci and address 73
usb 1-1.3: New USB device found, idVendor=18ef, idProduct=e01a
usb 1-1.3: New USB device strings: Mfr=1, Product=2, SerialNumber=0
usb 1-1.3: Product: Bedien-Anzeige-Terminal USB-BAT
usb 1-1.3: Manufacturer: ELV Elektronik AG
usb 1-1.3: configuration #1 chosen from 1 choice
generic-usb 0003:18EF:E01A.002A: hiddev0,hidraw0: USB HID v1.01 Device [ELV
Elektronik AG Bedien-Anzeige-Terminal USB-BAT] on usb-orion-ehci.0-1.3/input0
...
$

Je nach Linux-Distribution kann es sein, dass Sie den Befehl dmesg nur als Benutzer root ausführen können.

Grundkonfiguration

Nun sollte das USB-BAT dem wakeboX System bekannt gemacht werden. Verbinden Sie hierzu den Client mit dem Server und wechseln anschließend zur Serverkonfiguration.

Die Serverkonfiguration erreichen Sie über die Schaltflächen + .

In der Ansicht der Serverkonfiguration erstellen Sie nun eine neue Komponente durch Anklicken von Hinzufügen. Im darauf folgenden Dialog tragen Sie den Namen der neuen Komponente in das Feld Namen ein. Der Name kann prinzipiell beliebig gewählt werden und könnte beispielsweise ELV USB-BAT lauten. Wählen Sie anschließend den Typ elvusbbat aus der Liste der verfügbaren Typen und bestätigen den Dialog mit OK.

Die neue Komponente erscheint nun in dunklem Gelb im Konfigurationsbaum und Sie sehen rechts die Konfigurationseigenschaften der neuen Komponente. Die vorgeschlagenen Werte sind gute Startwerte und brauchen zunächst nicht verändert werden.

Drücken Sie nun die Schaltfläche Anwenden, um die neue Komponente zu aktivieren. Die Komponente wechselt nun von Gelb nach Weiß und die Konfigurationseigenschaften verschwinden (da nun keine Komponente im Baum angewählt ist). Auf dem LCD des USB-BAT sollten Sie nun Uhrzeit und Datum sehen können, welche vom wakeboX Server an das USB-BAT übertragen wird. Die Taster und der Inkrementalgeber sind bisher noch unbelegt und zeigen daher noch keine Wirkung. Die Belegung der Taster und des Inkrementalgebers wird im nächsten Abschnitt beschrieben.

Hinweis: Konnte aus irgendeinem Grund das USB-BAT von wakeboX nicht erreicht oder initialisiert werden erscheint der Name der Komponente im Baum in roter Schrift. Bitte überprüfen Sie in diesem Fall, ob das USB-BAT ordnungsgemäß am Server PC eingesteckt ist und drücken anschließend erneut Anwenden, um das Initialisieren der Komponente erneut zu versuchen.

Konfiguration der Taster und des Inkrementalgebers

Genau wie bei einer FS20-Fernbedienung oder IR-Fernbedienung kann auch den Tastern und dem Inkrementalgeber des USB-BAT beliebige Aktionen zugeordnet werden. Wechseln Sie dazu in die Ansicht der Eingabegeräte.

Zu den Eingabegeräten gelangen Sie über die Schaltflächen + .

Erstellen Sie nun durch Drücken der Schaltfläche neu ein neues Eingabegerät. Im darauf folgenden Dialog benennen Sie das Eingabegerät beispielsweise mit BAT und wählen Sie den Typ HID. Bestätigen Sie den Dialog anschließend mit OK.

Die Eingabesignale des BAT

Erstellen Sie nun eine Eingabezuordnung durch Klicken von Eingabe hinzufügen. Eine neue Zeile erscheint. Führen Sie nun einen Doppelklick auf dem leeren Feld unter Eingabe ID aus. Dies öffnet einen Dialog, der die zuletzt empfangene Eingabe anzeigt.

Drücken Sie nun beispielsweise den Taster A des BAT. Hierauf erscheint die Eingabe B1_S im Dialog des Client. Drücken Sie den Taster B des BAT und es erscheint die Eingabe B2_S. Ein Druck auf den Inkrementalgeber erzeugt B3_S. Eine Rotation des Inkrementalgebers erzeugt ROT_U bzw. ROT_D.

Um die Anzahl der Eingabemöglichkeiten zu erhöhen unterscheidet der wakeboX Server zwischen langem und kurzem Drücken aller Taster. Dies wird durch den Anhang _S für kurz (englisch short) und den Anhang _L für lang (englisch long) unterschieden. Drücken Sie beispielsweise den Taster A lange, erscheint die Eingabe B1_L. Um die Anzahl der Eingabemöglichkeiten noch weiter zu erhöhen sind auch kombinierte Tastendrücke möglich: Drücken Sie beispielsweise den Taster A und B gemeinsam, erzeugt dies die Eingabe B1_B2_S bzw. B1_B2_L - je nach Tastendrucklänge des zuletzt gedrückten Tasters. Ebenfalls möglich sind Tastenkombinationen zusammen mit einer Inkrementalbewegung: Halten Sie hierzu bespielsweise den Taster A gedrückt und drehen dabei den Inkrementalgeber. Hierdurch werden die Eingaben B1_ROT_U bzw. B1_ROT_D erzeugt. Dies funktioniert natürlich für alle beliebigen Tastenkombinationen des BATs.

Das Funktionsmenü des BAT

Wie andere Komponenten auch, bietet das USB-BAT Funktionen, die durch Eingaben oder Abläufe getriggert werden können. Die wohl wichtigste Funktion hierbei ist der Aufruf des Funktionsmenüs des BAT.

Um die erste Eingabezuordnung nun zu vervollständigen, drücken Sie nochmals den Inkrementalgeber kurz und übernehmen die dadurch erzeugte Eingabe B3_S im Client durch Klicken von Übernehmen.

Wählen Sie nun in der Spalte Gerät das ELV USB-BAT an und wählen die Funktion Menu. Um die Änderungen permanent zu machen, drücken Sie Speichern rechts unten in der Ansicht. Durch anschließendes Drücken des Inkrementalgebers des BAT können Sie nun das Funktionsmenü des BAT aufrufen.

Sie sehen nun das Hauptmenü auf dem LCD des BAT, von welchem sie alle wichtigen Funktionen des wakeboX Systems erreichen. Die Taster und der Inkrementalgeber haben innerhalb dieser Funktionsmenüs feste Bedeutungen:

• Inkrementalgeber rechts/links: 'Wählen' - hiermit wechseln Sie zwischen den einzelnen Menüpunkten.
• Inkrementalgeber drücken: 'Aktivieren' - dies aktiviert den gewählten (hervorgehobenen) Menüpunkt, wodurch sich entweder ein Untermenü öffnet oder die entsprechende Funktion ausgeführt wird (je nach Kontext).
• Taster A: 'Zurück' - hiermit gelangen Sie in das vorherige Menü bzw. verlassen das Funktionsmenü des BAT.
• Taster B: 'Alternatives aktivieren' - führt in manchen Situationen eine alternative Aktion aus (je nach Kontext).

Sobald Sie das Funktionsmenü verlassen, haben die durch den Client definierten Eingabezuordnungen wieder ihre Gültigkeit.

Belegungsbeispiele

Um nun häufig genutzte Funktionen wie nächster MP3 Titel / vorheriger MP3 Titel, Lautstärke + / Lautstärke - oder LCD Beleuchtung an ohne das Funktionsmenü zu erreichen, definieren Sie im Client weitere Eingabezuordnungen:

Falls noch nicht geschehen, wechseln Sie hierzu im Client in die Ansicht der Eingabegeräte und wählen das zuvor erstellte Eingabegerät BAT (HID).

• vorheriger/nächster MP3 Titel via Inkrementalgeber erreichen Sie durch Hinzufügen folgender 2 Eingabezuordnungen:

Eingabe ID	Gerät	Funktion	Parameter
ROT_D	Musik (Typ mp3player)	Play Relative Index	-1
ROT_U	Musik (Typ mp3player)	Play Relative Index	1

• Lautstärke +/- 2dB via Taster 'A' + Inkrementalgeber erreichen Sie durch folgende 2 Eingabezuordnungen:

Eingabe ID	Gerät	Funktion	Parameter
B1_ROT_D	AudioMixer (Typ audiomixer)	Volume Relative dB	-2
B1_ROT_U	AudioMixer (Typ audiomixer)	Volume Relative dB	2

• LCD Beleuchtung für 5 Sekunden an via Taster A (um Nachts die Uhrzeit abzulesen) erreichen Sie durch folgende Eingabezuordnung:

Eingabe ID	Gerät	Funktion	Parameter
B1_S	ELV USB-BAT (Typ elvusbbat)	Trigger Light	5