From 3c455e6498bb4038ae1f6da143b2740b1ec5cf46 Mon Sep 17 00:00:00 2001 From: Bjoern Heidotting Date: Tue, 26 Jul 2016 21:15:01 +0000 Subject: [PATCH] Update to r44561: Finish editorial review of ACPI chapter. Some shuffling of ASL/AML stuff to improve flow. Remove Japanese and Russian references. --- .../books/handbook/config/chapter.xml | 347 +++++++----------- 1 file changed, 135 insertions(+), 212 deletions(-) diff --git a/de_DE.ISO8859-1/books/handbook/config/chapter.xml b/de_DE.ISO8859-1/books/handbook/config/chapter.xml index b433f49e36..75f9806bf4 100644 --- a/de_DE.ISO8859-1/books/handbook/config/chapter.xml +++ b/de_DE.ISO8859-1/books/handbook/config/chapter.xml @@ -5,7 +5,7 @@ $FreeBSD$ $FreeBSDde: de-docproj/books/handbook/config/chapter.xml,v 1.151 2011/12/19 14:55:31 bcr Exp $ - basiert auf: r44556 + basiert auf: r44561 --> Damit ACPI richtig funktioniert, müssen alle Teile funktionieren. Im Folgenden finden Sie eine Liste mit Problemen und möglichen - Umgehungen oder Korrekturen. Die Liste ist nach + Abhilfen oder Korrekturen. Die Liste ist nach der Häufigkeit, mit der die Probleme auftreten, sortiert. Wenn eine Korrektur das Problem nicht behebt, finden Sie in @@ -3467,11 +3467,9 @@ hw.acpi.s4bios: 0 Normalerweise wird der unerwünschte Neustart des Systems durch Setzen dieser Variablen behoben. - - - <acronym>ASL</acronym>, &man.acpidump.8; und - <acronym>IASL</acronym> + + BIOS mit fehlerhaftem Bytecode ACPI @@ -3490,36 +3488,23 @@ hw.acpi.s4bios: 0 einspielen. Die meisten Meldungen auf der Konsole sind harmlos, wenn aber beispielsweise der Batteriestatus falsch angezeigt wird, können Sie in den - Meldungen nach Problemen mit der - AML-Machine-Language - (AML) suchen. Der Bytecode der - AML wird aus der - ACPI-Source-Language - (ASL) übersetzt und in einer Tabelle, der - DSDT, abgelegt. Eine Kopie der - ASL können Sie mit dem Befehl - &man.acpidump.8; erstellen. Verwenden Sie mit diesem Befehl - sowohl die Option (die Inhalte der - statischen Tabellen anzeigen) als auch die Option - (die AML in - ASL zurückübersetzen). Ein Beispiel für - die Syntax finden Sie in - . + Meldungen nach Problemen suchen. + - Sie können einfach prüfen, ob sich die - ASL übersetzen lässt. - Für gewöhnlich können Sie Warnungen - während des Übersetzens ignorieren. - Fehlermeldungen führen normal dazu, dass - ACPI fehlerhaft arbeitet. - ASL übersetzen Sie mit dem - nachstehenden Kommando: - - &prompt.root; iasl ihre.asl - - Die <acronym>ASL</acronym> reparieren + + Die voreingestellte <acronym>ASL</acronym> + überschreiben + + Der BIOS-Bytecode, bekannt als + ACPI Maschine Language + (AML) wird aus der Sprache namens + ACPI Source Language + (ASL) übersetzt. Die + AML ist in einer Tabelle, bekannt als + Differentiated System Description Table + (DSDT), abgelegt. ACPI @@ -3528,7 +3513,7 @@ hw.acpi.s4bios: 0 Es ist das Ziel von &os;, dass ACPI ohne Eingriffe des Benutzers - läuft. Zurzeit werden allerdings noch Umgehungen für Fehler + läuft. Zurzeit werden allerdings noch Abhilfen für Fehler der BIOS-Hersteller entwickelt. Der µsoft;-Interpreter (acpi.sys und acpiec.sys) prüft die @@ -3539,70 +3524,43 @@ hw.acpi.s4bios: 0 hoffen, dass sie das vom Standard abweichende Verhalten des µsoft;-Interpreters dokumentieren und in &os; replizieren können. Dadurch müssen Benutzer ihre - ASL nicht selbst reparieren. - Sie können Ihre ASL selbst reparieren, - wenn Sie ein Problem umgehen und uns helfen möchten. - Senden Sie bitte die mit &man.diff.1; erstellte Differenz - zwischen alter und neuer ASL. Die - Entwickler werden versuchen, den Interpreter - ACPI-CA zu korrigieren. + ASL nicht selbst reparieren. - - ACPI - Fehlermeldungen - + Um bei der Fehlersuche zu helfen und das Problem + möglicherweise zu beheben, kann eine Kopie der + ASL gemacht werden. Dazu nutzen Sie + acpidump zusammen mit , + um den Inhalt der Tabelle anzuzeigen und , + um die AML zu zerlegen: - Die nachfolgende Liste enthält häufige - Fehlermeldungen, deren Ursache und eine Beschreibung, - wie die Fehler korrigiert werden: - - - Abhängigkeiten vom Betriebssystem + &prompt.root; acpidump -td > my.asl Einige AMLs gehen davon aus, dass der Anwender eine &windows;-Versionen benutzt. Versuchen Sie das Betriebssystem, das Sie in der ASL finden, in /boot/loader.conf anzugeben: - hw.acpi.osname="Windows 2001". - + hw.acpi.osname="Windows 2009". - - Fehlende Return-Anweisungen + Manche Abhilfen erfordern eine Anpassung von + my.asl. Wenn diese Datei bearbeitet + wird, erstellen Sie die neue ASL mit dem + folgenden Befehl. Warnung können meistens ignoriert werden, + aber Fehler verhindern die ordnungsgemäße Funktion von + ACPI. - Einige Methoden verzichten auf die vom Standard - vorgeschriebene Rückgabe eines Wertes. Obwohl - der Interpreter ACPI-CA dies nicht - beheben kann, besitzt &os; die Möglichkeit, den - Rückgabewert implizit zu setzen. Wenn Sie - wissen, welcher Wert zurückgegeben werden muss, - können Sie die fehlenden Return-Anweisungen - selbst einsetzen. Die Option - zwingt &man.iasl.8;, die ASL - zu übersetzen. - - - - Überschreiben der vorgegebenen - <acronym>AML</acronym> - - Nachdem Sie Ihre ASL in der - Datei ihre.asl angepasst haben, - übersetzen Sie die ASL wie folgt: - - &prompt.root; iasl ihre.asl + &prompt.root; iasl -f my.asl Die Option erzwingt das Erstellen der AML auch dann, wenn während der Übersetzung Fehler auftreten. Einige Fehler, wie - fehlende Return-Anweisungen, werden automatisch vom + fehlende Return-Anweisungen, werden automatisch vom &os; Interpreter umgangen. - In der Voreinstellung erstellt der Befehl - &man.iasl.8; die Ausgabedatei - DSDT.aml. Wenn Sie diese Datei - anstelle der fehlerhaften Kopie des BIOS - laden wollen, editieren Sie + Die voreingestellte Ausgabedatei von + iasl ist DSDT.aml. + Wenn Sie diese Datei anstelle der fehlerhaften Kopie des + BIOS laden wollen, editieren Sie /boot/loader.conf wie folgt: acpi_dsdt_load="YES" @@ -3610,13 +3568,46 @@ acpi_dsdt_name="/boot/DSDT.aml" Stellen Sie bitte sicher, dass sich DSDT.aml in - /boot befindet. - + /boot befindet und starten Sie das + System neu. Wenn dadurch das Problem behoben wird, schicken + Sie einen &man.diff.1; der alten und der neuen + ASL an &a.acpi.name;, damit die + Entwickler dsa Problem in acpica + umgehen können. - - <acronym>ACPI</acronym>-Meldungen zur - Fehlersuche erzeugen + + + Abrufen und Einreichen von Informationen zur + Fehlersuche + + + + + Nate + Lawson + + Geschrieben von + + + + + + + Peter + Schultz + + Mit Beiträgen von + + + + + Tom + Rhodes + + + + ACPI @@ -3632,24 +3623,23 @@ acpi_dsdt_name="/boot/DSDT.aml" flexible Möglichkeiten zur Fehlersuche. Sie können sowohl die zu untersuchenden Subsysteme als auch die zu erzeugenden Ausgaben festlegen. Die zu - untersuchenden Subsysteme werden als so genannte - layers angegeben. Die Subsysteme sind in - ACPI-CA-Komponenten + untersuchenden Subsysteme werden als layer + angegeben und in Komponenten (ACPI_ALL_COMPONENTS) und ACPI-Hardware - (ACPI_ALL_DRIVERS) aufgeteilt. Welche - Meldungen ausgegeben werden, wird über - level gesteuert. level reicht - von ACPI_LV_ERROR (es werden nur Fehler + (ACPI_ALL_DRIVERS) aufgeteilt. + Welche Meldungen ausgegeben werden, wird über + level gesteuert. Die Level reichen von von + ACPI_LV_ERROR (es werden nur Fehler ausgegeben) bis zu ACPI_LV_VERBOSE (alles - wird ausgegeben). level ist eine Bitmaske, - sodass verschiedene Stufen auf einmal (durch Leerzeichen - getrennt) angegeben werden können. Die erzeugte - Ausgabemenge passt vielleicht nicht in den Konsolenpuffer. - In diesem Fall sollte die Ausgabe mithilfe einer - seriellen Konsole gesichert werden. Die möglichen Werte - für layers und level - werden in &man.acpi.4; beschrieben. + wird ausgegeben). Das Level ist eine Bitmaske, sodass + verschiedene Stufen auf einmal (durch Leerzeichen getrennt) + angegeben werden können. Die erzeugte Ausgabemenge passt + vielleicht nicht in den Konsolenpuffer. In diesem Fall sollte + die Ausgabe mithilfe einer seriellen Konsole gesichert werden. + Die möglichen Werte für layers und + level werden in &man.acpi.4; + beschrieben. Die Ausgaben zur Fehlersuche sind in der Voreinstellung nicht aktiviert. Wenn ACPI im Kernel @@ -3661,19 +3651,16 @@ acpi_dsdt_name="/boot/DSDT.aml" acpi.ko können Sie wie folgt neu übersetzen: - &prompt.root; cd /sys/modules/acpi/acpi -&& make clean && -make ACPI_DEBUG=1 + &prompt.root; cd /sys/modules/acpi/acpi && make clean && make ACPI_DEBUG=1 - Installieren Sie anschließend - acpi.ko im Verzeichnis + Kopieren Sie anschließend + acpi.ko ins Verzeichnis /boot/kernel. In /boot/loader.conf stellen Sie level und layer ein. Das folgende Beispiel aktiviert die Ausgabe von Fehlern für - alle ACPI-CA-Komponenten und alle - ACPI-Hardwaretreiber (wie - CPU, LID): + alle ACPI-Komponenten und alle + Hardwaretreiber: debug.acpi.layer="ACPI_ALL_COMPONENTS ACPI_ALL_DRIVERS" debug.acpi.level="ACPI_LV_ERROR" @@ -3685,111 +3672,29 @@ debug.acpi.level="ACPI_LV_ERROR" Kommando sysctl vornehmen. In diesem Fall müssen Sie /boot/loader.conf nicht editieren. Auf der Kommandozeile geben Sie über - &man.sysctl.8; dieselben Variablennamen wie in + sysctl dieselben Variablennamen wie in /boot/loader.conf an. - - - - ACPI-Informationsquellen - - Weitere Informationen zu ACPI - erhalten Sie an den folgenden Stellen: - - - - die &a.acpi; Mailingliste, - - - - die Archive der ACPI-Mailingliste: - http://lists.FreeBSD.org/pipermail/freebsd-acpi/, - - - - die alten Archive der ACPI-Mailingliste: - http://home.jp.FreeBSD.org/mail-list/acpi-jp/, - - - - die ACPI-Spezifikation (Version 2.0): - http://acpi.info/spec.htm, - - - - &man.acpi.4;, &man.acpi.thermal.4;, &man.acpidump.8;, - &man.iasl.8; und &man.acpidb.8;, - - - - - DSDT debugging resource. - - - - - - - <acronym>ACPI</acronym>-Fehlersuche - - - - - Nate - Lawson - - Verfasst von - - - - - - - Peter - Schultz - - Mit Beiträgen von - - - - Tom - Rhodes - - - - ACPI Probleme mit - ACPI ist ein gänzlich neuer - Weg, um Geräte aufzufinden und deren Stromverbrauch - zu regulieren. Weiterhin bietet ACPI - einen einheitlichen Zugriff auf Geräte, die vorher - vom BIOS verwaltet wurden. Es werden - zwar Fortschritte gemacht, dass ACPI - auf allen Systemen läuft, doch tauchen immer wieder - Fehler auf: fehlerhafter Bytecode der - ACPI-Machine-Language - (AML) einiger Systemplatinen, - ein unvollständiges &os;-Kernel-Subsystem oder - Fehler im ACPI-CA-Interpreter - von &intel;. - - Dieser Abschnitt hilft Benutzern, zusammen mit den Betreuern - des &os;-ACPI-Subsystems, Fehlerquellen - zu finden und Fehler zu beseitigen. + Sobald Sie die Fehlerinformationen gesammelt haben, schicken + Sie diese an &a.acpi.name;, sodass die Betreuer des + &os;-ACPI-Subsystems diese Informationen zur + Analyse und für die Entwicklung einer Lösung verwenden + können. - Bevor Sie einen Fehlerbericht einreichen, stellen - Sie bitte sicher, dass das BIOS - und die Firmware des Controllers aktuell sind. + Bevor Sie einen Fehlerbericht an diese Mailingliste + einreichen, stellen Sie bitte sicher, dass das + BIOS und die Firmware des Controllers + aktuell sind. - Wenn Sie einen Fehlerbericht einsenden wollen, - schicken Sie bitte die folgenden Informationen an - die Mailingliste freebsd-acpi: + Wenn Sie einen Fehlerbericht einsenden, fügen Sie bitte + die folgenden Informationen ein: @@ -3802,17 +3707,17 @@ debug.acpi.level="ACPI_LV_ERROR" - Die Ausgabe von &man.dmesg.8; nach der Eingabe - von boot -v. + Die Ausgabe von dmesg nach der + Eingabe von boot -v. Geben Sie auch alle Fehlermeldungen an, die erscheinen, wenn Sie den Fehler provozieren. - Die Ausgabe von &man.dmesg.8; nach der Eingabe - von boot -v und mit deaktiviertem - ACPI, wenn das Problem ohne - ACPI nicht auftritt. + Die Ausgabe von dmesg nach der + Eingabe von boot -v und mit + deaktiviertem ACPI, wenn das Problem + ohne ACPI nicht auftritt. @@ -3823,8 +3728,7 @@ debug.acpi.level="ACPI_LV_ERROR" Die URL, unter der die - ACPI-Source-Language - (ASL) liegt. Schicken Sie + ASL liegt. Schicken Sie bitte nicht die ASL an die Mailingliste, da die ASL sehr groß sein kann. Eine Kopie @@ -3856,5 +3760,24 @@ debug.acpi.level="ACPI_LV_ERROR" Es kann sein, dass der Fehler schon von jemand anderem gemeldet wurde. + + + Referenzen + + Weitere Informationen über ACPI finden + Sie hier: + + + + Die ACPI 2.0 Spezifikation (http://acpi.info/spec.htm) + + + + &man.acpi.4;, &man.acpi.thermal.4;, &man.acpidump.8;, + &man.iasl.8; und &man.acpidb.8; + + +