====== ALSA Tools  ======

++++ Version History... |

**V 0.1.1**

  * erste Veröffentlichung

**V 0.1.2**

  * Fix eines Logfile-Bugs

**V 0.2.0**

  * Erfordert LoxBerry 1.0
  * Kein Neustart nach Installation erforderlich
  * Speichern der Einstellungen im Webinterface werden sofort aktiv (kein Neustart erforderlich)
  * Fehler korrigiert bei der Erkennung, ob das Mixer-Service läuft oder nicht
  * Der Link zum Webinterface ist jetzt größer

++++

===== Konfigurationsoptionen =====

Im Plugin kann derzeit das ALSA Mixer Webservice aktiviert und deaktiviert, sowie der Port dieses Webservices geändert werden. Die Änderung wird erst nach Neustart des LoxBerrys aktiv.

== Download ==

  * Alle Releases: https://github.com/christianTF/LoxBerry-Plugin-ALSATools/releases
  * Letzte Version für //LoxBerry 0.2.3//: https://github.com/christianTF/LoxBerry-Plugin-ALSATools/archive/0.1.2.zip
  * Source: https://github.com/christianTF/LoxBerry-Plugin-ALSAMixer

===== Funktion des Plugins =====

Das Plugin stellt ein Webinterface für den ALSA Mixer bereit. Das Webinterface wird als eigener Dienst am LoxBerry gestartet und kann über eine eigene URL aufgerufen werden. Der Link befindet sich oben in den Konfigurationseinstellungen und kann auch direkt aufgerufen werden.

Das eigentliche Webinterface des ALSA Mixers stammt von Ji?í Škorpil. Vor der Übernahme seines Programms habe ich noch Änderungen in dessen Sourcecode eingebracht, um den Mixer mit einem Raspberry Pi lauffähig zu machen. Der Mixer hat trotzdem noch Eigenheiten (siehe Tipps).

===== Tipps =====

==== Raspberry: PCM Playback Route ====

"**PCM Playback Route**" - Damit kann die Standardausgabe (Auto, Klinke, HDMI) eingestellt werden:

  * Regler links (0) → Automatik
  * Regler Mitte (1) → Klinkenstecker
  * Regler rechts (2) → HDMI

==== Raspberry: Lautstärke Minus Zehntausend? ====

Am Raspberry kann man den Regler zwischen -10239 bis +400 einstellen. Das ist nicht etwa ein Bug, sondern ein "Feature", zurückzuführen auf eine zweifelhaft kluge Idee von den Soundtreiber-Entwicklern des Raspberry, und der Konzeption des Webinterfaces von Jiri.

ALSA spezifiziert ein __absolutes__ Minimum und Maximum der Lautstärke für die Entwickler von Treibern. Während die meisten Soundtreiber hier 0 bis 100 (Prozent) verwenden, hat man sich beim Raspberry-Treiber für eine Angabe von -10239 bis +400 (angelehnt an dB und die Hörkurve) entschieden.

Das Mixer-Webinterface verwendet diese absoluten Angaben, daher kommt diese negative Zahl. 

===== Road Map =====

Aktuell sind noch folgende Erweiterungen vorgesehen:

  * Direkt aus den Konfigurationsoptionen heraus soll der Audio-Output des Raspberrys umgestellt werden können zwischen Auto, Klinke und HDMI (derzeit über PCM Playback Route).
  * Die aktuellen Lautstärkeeinstellungen sollen auf Knopfdruck explizit gespeichert werden (das passiert derzeit durch ALSA beim Shutdown).

===== Fehler melden / Fehlersuche / Troubleshooting =====

Eindeutige Fehler bitte direkt als GitHub Issue melden: https://github.com/christianTF/LoxBerry-Plugin-ALSATools/issues

Fragen und Diskussionen zur Funktionsweise bitte im [[https://www.loxforum.com/forum/german/software-konfiguration-programm-und-visualisierung/64602-loxberry-alsa-tools-plugin|Forumsthread]].

==== Änderungen ====

TIPP! Beobachte diese Seite (rechts oben), um sofort über Änderungen informiert zu werden.

Fehlerberichte bitte direkt im [[https://github.com/christianTF/LoxBerry-Plugin-ALSATools/issues|Repository auf GitHub]] melden.