ACPI : Configuration avancée et interface pour la gestion d'énergie

	Important
	Le texte ci-dessous est la version française de la licence de ce document. Seule la version originale de cette licence, présentée dans la section suivante, fait foi.

Copyright © 2003, 2004 Emma Jane Hogbin

Vous est autorisé à copier, distribuer ou modifier la version originale de ce document selon les termes de la licence de documentation libre GNU (GFDL), version 1.1 ou ultérieure, telle que publiée par la Free Software Foundation ; sans section inaltérable, ni texte de première de couverture, ni texte de quatrième de couverture.

Une copie en anglais de cette licence est incluse à la fin de ce document (cf. Annexe D, GNU Free Documentation License). Une traduction française officieuse de cette licence est disponible sur http://cesarx.free.fr/gfdlf.html.

Copyright © 2003, 2004, 2005 Guillaume Lelarge, Vanessa Conchodon et Jean-Philippe Guérard pour la version française

La version française de ce document a été réalisée par Guillaume Lelarge, Vanessa Conchodon et Jean-Philippe Guérard. Elle est publiée en accord avec les termes de la licence de documentation libre GNU (GFDL), version 1.1 ou ultérieure, telle que publiée par la Free Software Foundation ; sans section invariante, sans texte de première de couverture ni texte de quatrième de couverture.

Une copie en anglais de cette licence est incluse à la fin de ce document (cf. Annexe D, GNU Free Documentation License). Une traduction française officieuse de cette licence est disponible sur http://cesarx.free.fr/gfdlf.html.

	Important
	Le texte ci-dessous est la licence de ce document. Ce texte fait foi. Il est composé de la licence (en anglais) du document original, suivi de la licence (en français) de sa traduction.

Copyright (c) 2003, 2004 Emma Jane Hogbin.

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in Annexe D, GNU Free Documentation License.

Copyright © 2003, 2004 Guillaume Lelarge, Vanessa Conchodon et Jean-Philippe Guérard pour la version française

La version française de ce document a été réalisée par Guillaume Lelarge, Vanessa Conchodon et Jean-Philippe Guérard. Elle est publiée en accord avec les termes de la licence de documentation libre GNU (GFDL), version 1.1 ou ultérieure, telle que publiée par la Free Software Foundation ; sans section invariante, sans texte de première de couverture ni texte de quatrième de couverture.

Une copie en anglais de cette licence est incluse à la fin de ce document (cf. Annexe D, GNU Free Documentation License). Une traduction française officieuse de cette licence est disponible sur http://cesarx.free.fr/gfdlf.html.

Les nouvelles éditions françaises de ce document sont disponibles sur http://www.traduc.org/.

Ce document est aussi disponible dans les langages suivants :

Si vous connaissez d'autres traductions, contactez-moi (NdT : en anglais !) par courrier électronique à l'adresse <emmajane CHEZ xtrinsic POINT com>.

Lorsque j'ai commencé le passage de l'APM à l'ACPI, je n'ai pas réalisé que je devais appliquer un correctif au noyau. Mon problème (un ventilateur assourdissant) a été corrigé simplement en mettant à jour mon noyau en version 2.4.20 (noyau préparé par Debian avec un correctif antérieur provenant de acpi.sourceforge.net). Malheureusement, après la première mise à jour, je n'étais pas capable d'arrêter (halt) mon ordinateur sans utiliser le bouton d'arrêt. Ce n'est que bien après que j'ai réalisé que j'avais un vieux correctif ACPI inefficace. Ce guide pratique a été écrit pour résumer le processus d'installation que j'ai suivi et, je l'espère, aider d'autres personnes ayant elles-aussi des difficultés à trouver les bonnes informations sur l'ACPI. Merci de noter que l'article se base principalement sur la façon Debian de faire les choses. Il existe aussi une partie générique dans Annexe B, Compiler des noyaux sans utiliser la méthode Debian pour ceux d'entre vous préférant… un moyen générique.

J'ai compris que toute une communauté était nécessaire pour écrire un guide technique. Je suis à jamais redevable pour toute l'aide que j'ai reçu tout au long de l'écriture de ce document. Sans ce groupe de personnes (augmentant en permanence), notre document n'existerait pas.

Vous avez trouvé quelque chose de mauvais dans ce document ? (ou peut-être quelque chose de bien ?) J'adorerais le savoir. Merci de me contacter (NdT : en anglais) par mon courrier électronique (<emmajane CHEZ xtrinsic POINT com>.

N'hésitez pas à faire parvenir tous commentaires relatifs à la version française de ce document à <commentaires CHEZ traduc POINT org>

Les conventions typographiques suivantes apparaissent dans ce texte :

Vue d'un terminal

Tous les systèmes ne sont pas compatibles à la fois avec APM et ACPI. Je suis passée à l'ACPI car mon système n'était compatible qu'avec ce mode de gestion de l'énergie. Du coup, la décision a été assez facile. Si vous pensez changer pour pouvoir utiliser le mode S3 (système suspendu en RAM — suspend to RAM) et que vous utilisez un noyau 2.4.x, oubliez cette idée. Cela n'est pas possible.

ACPI4Linux a une liste de machines et BIOS compatibles sur leur Wiki. Merci de contribuer à cette liste !

Pour plus d'informations sur la gestion d'énergie dans les portables, vous trouverez certainement utile le mini guide pratique sur les batteries gérées par Linux.

Au fur et à mesure que l'ACPI mûrit sur Linux, il pourrait y avoir des points spécifiques à connaître pour votre distribution. Actuellement, il y a peu d'informations à partager mais j'espère que cette section va grandir avec le temps. Merci de me contacter à mon adresse de courier électronique (<emmajane CHEZ xtrinsic POINT com> si quelque chose devrait être indiquée dans cette section !

Merci à Erich pour la rédaction de cette section.

Vous aurez peut-être besoin de passer outre la DSDT lorsque certaines informations, comme l'état de la batterie, sont transmises de façon incorrecte (causant habituellement des messages d'erreur dans syslog). Les portables DELL ont généralement besoin de ce type de palliatifs. Les DSDT corrigées sont disponibles pour de nombreux systèmes sur la page DSDT avec un correctif indiquant au noyau d'ignorer la table du BIOS et d'utiliser la DSDT corrigée.

Vous aurez simplement besoin de copier la table corrigée dans les sources du noyau avec un nom de fichier particulier (ou en modifiant le nom du fichier dans le correctif donné sur la page DSDT). Passer outre la DSDT est donc assez facile : au lieu de charger la table DSDT du BIOS, le noyau est compilé avec et utilise sa propre table DSDT. C'est tout.

Ce document a été écrit au départ pour le noyau 2.4.20 et a été mis à jour pour inclure des informations sur la série 2.6 du noyau. À l'heure de cette mise à jour, les noyaux de la série 2.6 ont montré une certaine facilité pour certaines personnes.

Si vous le pouvez, je vous recommende d'attendre avant de mettre à jour votre noyau vers la série 2.6 jusqu'à ce qu'un bon nombre de bogues ne soit éliminé et que plus de documentation soit disponible. Il y a eu beaucoup de changement sur la série 2.6. Quand j'ai mis à jour vers la version 2.6.5 pour revoir ce document, j'ai rencontré quelques problèmes avec ma connexion sans fil, ma carte graphique nVidia, mon pavé tactile et l'ACPI. Vos expériences peuvent différer de la mienne. J'ai eu personnellement de bons succès avec la 2.4.20 et son dernier correctif ainsi qu'avec la 2.4.22 sans correctif. (Et j'ai ensuite mise à jour directement de la 2.4.22 à la 2.6.5.) Une recherche via Google sur la liste de diffusion de votre distribution et sur la liste acpi-devel devrait vous aider à faire le bon choix pour votre noyau.

Quelque soit le noyau que vous utilisez, s'il nécessite un correctif, il est important d'utiliser la dernière version du correctif ACPI. Certaines distributions ont déjà appliqué des correctifs à leur(s) noyau(x). C'est le cas pour Debian et certainement pour d'autres. Pour plus d'informations sur les correctifs qui ont été appliqués aux sources du noyau telles qu'elles sont livrées par Debian, lisez /usr/src/kernel-source-<version>/README.Debian. Si vous n'utilisez pas Debian, cherchez dans le répertoire /usr/src/kernel-source-<version> le fichier équivalent pour votre distribution.

	Utiliser des noyaux pré-compilés
	Je n'utilise pas les noyaux pré-compilés de Debian. J'opte toujours pour la compilation de mes propres noyaux en utilisant la méthode Debian. SI vous utilisez le noyau pré-compilé de votre distribution, merci de vérifier qu'il dispose de tous les correctifs ACPI adéquats avant de l'installer.

Si vous avez un serveur de production et/ou servez des pages web sur Internet, merci d'appliquer aussi tout correctif supplémentaire de sécurité. Vous pourrez aussi avoir des correctifs supplémentaires à appliquer pour des problèmes matériels ou logiciels spécifiques à votre système. La plupart des utilisateurs de portable devraient pouvoir se contenter des correctifs ACPI mais, si possible, les utilisateurs de portable devraient aussi appliquer tout correctif de sécurité supplémentaire.

Corriger un noyau déjà modifié

Si un noyau dispose d'autres correctifs, vous pourriez avoir quelques soucis pour appliquer le correctif ACPI. Bien sûr, un correctif ACPI ne devrait pas être appliqué à un noyau disposant déjà d'un correctif ACPI. À priori, tant qu'aucun autre correctif ACPI n'a été appliqué au noyau, il devrait être possible d'en appliquer un maintenant. Suivant les correctifs appliqués, vous pourrez avoir besoin de modifier certains fichiers Makefile pour que le correctif s'installe avec succès. Ceci est bien au-delà de mes compétences et n'est donc pas traité dans ce document.

Si vous avez déjà un noyau fonctionnel de la même version que celui que vous souhaitez corriger, je vous recommande de créer un nouveau répertoire pour le nouveau noyau corrigé. Vous devriez faire une sauvegarde de tous les fichiers importants de configuration du noyau ou relatifs au noyau, qui pourraient être affectés par votre travail. Rappelez-vous que les sauvegardes ne sont jamais une mauvaise chose et peuvent être facilement supprimées après que votre système ait été correctement modifié.

	Commencer par appliquer le correctif à votre noyau
	Si vous utilisez un ancien noyau, vous aurez besoin de le corriger avant de continuer. Les instructions pour corriger votre noyau sont disponibles dans l'Annexe A, Modifier les noyaux. Toujours vérifier si votre noyau a besoin d'un correctif.

Utilisez make oldconfig pour configurer votre nouveau noyau. Utiliser oldconfig à la place de menuconfig vous permet de commencer avec les options que vous avez sélectionnées dans votre noyau actuel et vous demande de sélectionner vos préférences parmi toutes les nouvelles options du noyau. Ceci est bien plus facile que de chercher manuellement parmi toutes les nouvelles options. Pour tout ce qui est spécifique à l'ACPI et à votre matériel (si vous utilisez du matériel Toshiba, sélectionnez les options Toshiba, pour Asus, choisissez les options Asus), choisissez M pour module. Il existe environ dix options différentes en relation avec l'ACPI que vous devrez sélectionner.

Il est maintenant temps de compiler le noyau. Ces instructions ont pour cible les utilisateurs de Debian. Si vous n'utilisez pas une Debian ou si vous ne voulez pas compiler votre noyau à la manière Debian, merci de lire Annexe B, Compiler des noyaux sans utiliser la méthode Debian pour plus d'aide.

Si vous avez des modules supplémentaires qui ne font pas partie du répertoire principal des sources, vous devrez ajouter modules_image pour la compilation des paquetages Debian. Ceci est pratiquement inévitable si vous utilisez un portable et un ancien noyau. J'ai toujours besoin de cette option dans le noyau 2.6.6 à cause de ma carte graphique nVidia.

À ce moment, vous devez redémarrer votre machine. Lorsque le système est relancé (en supposant que tout s'est passé correctement et que vous avez toujours un système), vous aurez aussi besoin de vous assurer que vous utilisez le nouveau noyau avec le bon correctif.

Vérifiez que chaque module ACPI a bien été chargé après le démarrage de votre machine. Vous pouvez faire ceci en utilisant la commande lsmod. Vous recherchez les options suivantes : button, battery, fan, ac, thermal et processor. Si vous choisissez « Y » au lieu des modules lorsque vous compilez votre noyau, vous ne verrez pas cette liste. La sortie sur mon ordinateur ressemble à ceci :

Module                  Size  Used by    Tainted: P  
button                  2420   0 (unused)
battery                 5960   0 (unused)
ac                      1832   0 (unused)
fan                     1608   0 (unused)
thermal                 6664   0 (unused)
processor               8664   0 [thermal]
NVdriver              945408  11 

Le dernier module est ma carte graphique, qui utilise des pilotes propriétaires. C'est pourquoi j'ai la lettre « P » à côté du mot Tainted sur la première ligne.

Si vous avez compilé le support de l'ACPI en tant que « M »odules et que vous ne voyez pas les modules ACPI, vous devez les charger à la main. Ils devraient être dans /lib/modules/<version>.<un_nom_unique_et_intelligent>/kernel/drivers/acpi/ et s'appellent :

-rw-r--r--    1 root     root         4.1k Jun  3 23:57 ac.o
-rw-r--r--    1 root     root         9.5k Jun  3 23:57 battery.o
-rw-r--r--    1 root     root         5.2k Jun  3 23:57 button.o
-rw-r--r--    1 root     root         3.7k Jun  3 23:57 fan.o
-rw-r--r--    1 root     root          14k Jun  3 23:57 processor.o
-rw-r--r--    1 root     root          11k Jun  3 23:57 thermal.o
-rw-r--r--    1 root     root         6.2k Jun  3 23:57 toshiba_acpi.o

	Extensions des modules
	Le nom du module est la partie du nom du fichier, précédant l'extension .o. processor.o est le fichier, processor est le nom du module. Pour installer un module du noyau, utilisez insmod processor. Les noyaux de la série 2.4 utilisent l'extension .o ; néanmoins, les noyaux de la série 2.6 utilisent l'extension .ko.

La première fois où j'ai redémarré, je les ai chargé à la main en tapant insmod <nom_module>. Je charge tout d'abord processor, bien que les sentiments soient partagés quant à l'importance de l'ordre.

	Gestion d'énergie du système d'exploitation (OSPM ou Operating System Power Management)
	La première fois où j'ai essayé ceci, les modules étaient tous dans des répertoires séparés et se nommaient ospm_<nom>. C'est probablement dû au fait que j'utilisais un ancien correctif, mais c'est important de le savoir. Les modules OSPM sont maintenant abandonnés, donc vous ne devriez plus les voir.

Pour ne pas avoir à charger les modules dans le noyau à chaque fois que vous démarrez, vous devez soit les compiler directement dans le noyau (un peu tard, n'est-ce-pas ?) soit les ajouter dans votre fichier /etc/modules. Si vous n'avez pas déjà une copie de ce fichier, créez-le et ajoutez un nom de module (rappelez-vous, pas de .o) par ligne. Vous pouvez aussi essayer de lancer update-modules ce qui devrait automatiquement mettre à jour votre fichier de configuration /etc/modules.conf.

Ne laissez pas apmd et acpid fonctionner en même temps sauf si vous savez réellement ce que vous faites. Debian ne s'assurera pas qu'un seul est en cours d'exécution à la fois. Vous devez le vérifier.

APM essaiera de placer votre système en mode S3. Sur les noyaux de la série 2.4.x (et avant), ceci aurait causer un verrouillage de votre machine. S3 n'est pas supporté au moins jusqu'au 2.5.x. Même le correctif ne fournira pas de support pour S3 dans les noyaux de la série 2.4.x. J'ai complètement supprimé le support d'APM à partir du noyau et supprimé le démon apmd de mon système. Sur Debian, cela a été aussi simple que apt-get remove apmd.

Vous pouvez aussi regarder dans chaque fichier ACPI individuellement pour des informations sur votre système. Regardez dans le répertoire /proc/acpi afin de vérifier différents points importants. Si je veux vérifier ma batterie, je lis le fichier suivant comme ceci cat /proc/acpi/battery/BAT0/state . La sortie ressemble à ceci :

present:                 yes
capacity state:          ok
charging state:          discharging <-- fonctionne sur batteries
present rate:            unknown
remaining capacity:      3920 mAh <-- surveillez ce nombre
present voltage:         14800 mV

present:                 yes
capacity state:          ok
charging state:          discharging
present rate:            unknown
remaining capacity:      3840 mAh <-- la capacité diminue
present voltage:         14800 mV

present:                 yes
capacity state:          ok
charging state:          charging <-- adaptateur secteur branché
present rate:            unknown
remaining capacity:      3840 mAh
present voltage:         14800 mV

Si je veux de l'information sur ma batterie en général, je testerais ceci cat /proc/acpi/battery/BAT0/info.

present:                 yes
design capacity:         3920 mAh
last full capacity:      3920 mAh
battery technology:      rechargeable
design voltage:          14800 mV
design capacity warning: 30 mAh
design capacity low:     20 mAh
capacity granularity 1:  10 mAh
capacity granularity 2:  3470 mAh
model number:            Bat0
serial number:              
battery type:            Lion
OEM info:                Acer

Pour plus d'informations sur chacun de ces fichiers, merci de lire http://acpi.sourceforge.net/documentation/index.html.