HowTo: Creiamoci i nostri script Acpi personalizzati

Il supporto del Kernel Linux ai nostri EeePc in questi ultimi tempi è aumentato notevolmente, si veda come per la maggior parte dei netbook di casa Asus (e non solo) molti dei tastini funzione ora funzionino nativamente; mi riferisco in particolare al tasto per accendere/spegnere il wifi, a quello per la sospensione e a quelli per il volume e la luminosità.
Purtroppo i restanti tasti non vengono nativamente riconosciuti (e mi riferisco soprattutto al Super Hybrid Engine) ed è per questo che sono nati alcuni software per sopperire a questa mancanza (vedasi eee-control e Jupiter), inoltre alcune distro (vedasi Archlinux e Debian) hanno creato script propri.
In questo articolo vi spiegherò come interagire con il demone Acpid per costruirsi i propri script fatti su misura.


Una domanda a questo punto sorge spontanea, perché dovrei perdere tempo a farmi degli script quando i vari eee-control, Jupiter e compagnia bella funzionano a dovere?
Ecco qualche motivo (personale) che mi ha indotto a questa scelta:

1. Non sempre eee-control o Jupiter funzionano a dovere o fanno ciò che vogliamo.
2. Non tutte le distribuzioni offrono nei loro repository i software sopracitati a meno di rocamboleschi adattamenti (vedete la mia guida per installare Sabayon su EeePc), quindi se vi piace provare le distribuzioni più esotiche non avrete problemi.
3. Perchè una volta fatti sono portabili, li potrete usare su una qualsiasi distribuzione con il minimo sforzo e senza grandi modifiche (anche nessuna se siete come me).
4. Perché eee-control e Jupiter si basano comunque sul demone Acpid, quindi perché avere un programma in più che beve dalla nostra ram quando possiamo delegare il tutto a Acpid (e si sà che certe persone sono molto brave a delegare)?
5. Perché chi fa da se fa per tre ed è servito meglio di un re!!!

AVVISO!!!
In questa guida non ci sarà manna che scende dal cielo fornendovi degli script Acpi, sarete voi a farveli quindi è necessario che conosciate un minimo di alfabetizzazione dello scripting da terminale, in particolare l'unica cosa veramente indispensabile è avere manegevolezza con le variabili e sapere cos'è una condizionale e come si usa (if-else).

Fatta questa premessa prima di buttarci a capofitto assicuriamoci che sia caricato il modulo eeepc_laptop e che il demone Acpid sia in esecuzione, aprite un terminale e digitate:

lsmod | grep eeepc

nel caso non compaia il suddetto modulo per avviarlo date il seguente comando

su -c 'modprobe eeepc_laptop'

per acpid invece:

ps -e | grep acpid

e nel caso non compaia niente sempre da terminale per avviarlo date

su -c 'acpid'

Inoltre ricordatevi che nel caso facciate qualche modifica all'interno della cartella /etc/acpi/events dovrete riavviare Acpid affinché abbia effetto.
Ora nel caso in cui abbiate altri software quali eee-control, Jupiter e compagnia bella, prima di procedere premuratevi di disabilitarli/disinstallarli in modo che non vadano in conflitto.

INIZIAMO
Tutto ciò che faremo ora avverrà all'interno della cartella /etc/acpi, nonostante sia possibile mettere gli script in altre cartelle io consiglio di metterli qui, sia perché in questo modo solo l'utente root potrà modificarli, sia perché così è piu facile copiarli da una distro ad un altra nel caso ne abbiate la necessità. Per quanto appena detto tutte le operazioni che verranno fatte di seguito necessiteranno dei privilegi di root, quindi non lo ripeterò in seguito, ma quando non esplicitamente specificato sentitevi liberi di usare quello che preferite tra su e sudo.

Ora bisognerà dire ad Acpid che alla pressione di un dato tasto (e quindi quando si genera un evento acpi) bisogna associare un determinato script e per fare ciò per ogni tasto che si vuole intercettare basterà mettere un file di testo nella cartella /etc/acpi/events adeguatamente formattato come vi spiegherò di seguito (più in basso vi spiegherò anche come mettere tutto in un unico file in modo da essere ancora più compatti).
Ogni file che create nella cartella /etc/acpi/events dovrà avere il seguente contenuto:

event=XXXXXXXX
action=script-da-eseguire

Dove al posto di quelle XXXX ci va inserito l'evento acpi del tasto in questione; come reperire questo codice?
Semplice aprite il vostro fido terminale e digitate il seguente comando (in questo caso non sono necessari i privilegi di root):

acpi_listen -c 1

ora il terminale rimarrà in attesa che voi premiate la combinazione di tasti e quando lo farete vi restituirà in output il codice, ad esempio quando io premo Fn+F7 (che è il tasto per spegnere lo schermo) ottengo questo:

hotkey ATKD 00000016 00000002

tralasciando l'ultimo gruppo di numeri che indica il numero di volte che è stato premuto quel tasto (nel mio caso 2) copiate tutto il resto e inseritelo al posto delle XXXX di prima... quindi sempre per fare un esempio nel mio caso avrò creato dentro la cartella /etc/acpi/events un file chiamato schermo con il seguente contenuto:

# potete anche inserire un commento anteponendo il cancelletto
event=hotkey ATKD 00000016
action=/etc/acpi/schermo.sh

il file schermo.sh è lo script che viene eseguito alla pressione del tasto, è scritto in Bash e deve essere reso eseguibile, per tutto il resto può contenere tutto quello che vi passa per la testa.
Sempre a titolo esemplificativo vi posto il mio schermo.sh:

#!/bin/bash
#qualche commento fa sempre comodo
#la prima riga non è obbligatoria ma è buon costume metterla
xset dpms force off

Semplice no? Ricordatevi di rendere eseguibile il suddetto file dando da terminale chmod +x file, nel mio caso:

chmod +x /etc/acpi/schermo.sh

(come ho già specificato sopra queste operazioni vanno fatte da root)

ATTENZIONE!!!
Il demone Acpid viene eseguito da root, quindi qualsiasi script da esso eseguito avrà i privilegi di amministratore. Non è obbligatorio ma è caldamente consigliato che le operazioni per cui non siano strettamente necessari questi privilegi elevati vengano eseguite da utente normale, per fare ciò è sufficiente che al posto di dare un comando usiate la seguente sintassi:

su utente -c 'comando'

dove al posto di utente dovrete mettere il nome dell'utente che utilizzate, mentre al posto di comando ci va naturalmente il comando che volete sia eseguito (qui fate attenzione agli apici, se il comando che dovete lanciare richiede dei parametri tra virgolette utilizzate le virgolette "" e non gli apici, se volete vedere un esempio date un'occhiata più in basso alla parte riguardante le notifiche).
Inoltre se fate lanciare dagli script un programma con interfaccia grafica potreste avere qualche problema (il problema è che non succede niente quando invece dovrebbe aprirsi il programma), se questo è il vostro caso dovrete aggiungere in cima ai vostri script questa riga:

export DISPLAY=:0

UNO SGUARDO AI FILE DI SISTEMA
Ora che avete visto come fare affinché il demone Acpid esegua un'azione da voi voluta alla pressione di un tasto, vi mostrerò quali sono i file di sistema su cui dovrete agire per poter gestire correttamente le periferiche del vostro EeePc (webcam, cardreader, SHE ecc) e si trovano tutti nella cartella /sys/devices/platform/eeepc.

AVVISO!!!
Nella seguente trattazione ometterò alcuni tasti funzione in quanto sono correttamente riconosciuti dall'ultimo Kernel, questi sono i tasto per la sospensione, wifi, luminosità e volume, nel caso il vostro Desktop Environment non li assegni di default dovreste poter comunque impostarli tra i settaggi del DE in questione.


Super Hybrid Engine
Se avete un EeePc con il processore Intel Atom potrete usare lo SHE per regolare le prestazioni della vostra CPU in base alle vostre esigenze.
Il file a cui dovete far riferimento si chiama cpufv e se andate a vedere il suo contenuto troverete qualcosa del tipo 0x30? dove al posto del punto interrogativo ci sarà un numero trà 0 1 o 2 a seconda se siete rispettivamente su Performance, Normal o Powersave.
Cambiare lo scaling è quindi molto semplice, vi basterà mettere il numero desiderato in questo file e il modo più semplice per farlo è usare il comando echo, da terminale e con i privilegi di amministratore (attenzione qui non va bene usare sudo, dovrete per forza usare su) date:

echo X > /sys/devices/platform/eeepc/cpufv

mettendo al posto di X il numero che rappresenta il regime scelto.

NOTA!!
Il Super Hybrid Engine e lo scaling della cpu effettuato da cpufreq (le varie applet di gnome e kde per regolare la cpu) sono due cose diverse, infatti uno agisce sul moltiplicatore mentre l'altro sul Front Side Bus, quindi potrete usare entrambi senza conflitti.

Vediamo ora per completezza uno script che legge lo stato attuale dello SHE e scorre ciclicamente i vari profili:

#!/bin/bash
she="/sys/devices/platform/eeepc/cpufv"

case "$(cat $she)" in
   0x300)
      echo 2 > $she
      ;;
   0x301)
      echo 0 > $she
      ;;
   0x302)
      echo 1 > $she
      ;;
esac

WEBCAM
Il file di sistema relativo alla webcam è chiamato camera, è molto semplice e può assumere solo due valori: 0 per off e 1 per on, per cambiarne lo stato come già fatto per lo SHE potete usare il comando echo, inoltre quando spegnete la webcam potete anche rimuovere il modulo uvcvideo.
Vediamo un rapido esempio:

#!/bin/bash
camera="/sys/devices/platform/eeepc/camera"

if [ $(cat $camera) = 1 ]; then
   modprobe -r uvcvideo
   echo 0 > $camera
else
   modprobe uvcvideo
   echo 1 > $camera
fi

CARDREADER
Per il cardreader vale lo stesso discorso della webcam, il file di riferimento è cardr e assume il valore 0 per off e 1 per on. L'amico Valantin ci propone uno script per abilitarlo/disabilitarlo che nel secondo caso si assicura che il cardreader non sia in uso.

#!/bin/bash
CARDR=`cat /sys/devices/platform/eeepc/cardr`

case $CARDR in
   0)
      echo 1 > /sys/devices/platform/eeepc/cardr
      /usr/bin/notify-send "Cardreader" "Abilitato" -t 5000 2>/dev/null
      ;;
   1)
      SECURE=`ls -l /dev/disk/by-id/ | grep -c Single_Flash_Reader`
      if [ $SECURE -gt 1 ]; then
      /usr/bin/notify-send "Cardreader" "Ancora in uso" -t 5000 2>/dev/null
      elif [ $SECURE -le 1 ]; then
      echo 0 > /sys/devices/platform/eeepc/cardr
      /usr/bin/notify-send "Cardreader" "Disabilitato" -t 5000 2>/dev/null
      fi
      ;;
   *)
      /usr/bin/notify-send "Errore" "Problemi Cardreader" 2>/dev/null
      ;;
esac

In questo script viene fatto uso delle notifiche, per maggiori dettagli vedete la relativa sezione.

WIFI
Per quanto riguarda il wifi come ho già detto sopra dovrebbe già essere riconosciuto, per i più curiosi però anche il wifi ha uno switch on-off così come per la webcam e il cardreader.
Per trovarlo, partendo sempre dalla cartella /sys/devices/platform/eeepc, andate nella cartella rfkill, dentro questa troverete un'altra cartella (o due se avete anche il bluetooth) all'interno della quale c'è il file state che è lo switch desiderato, potete farne uso nel caso vogliate farvi delle notifiche per il wifi visto che non tutti i DE ce l'hanno. Nel caso invece abbiate la necessità di attivare disattivare il wifi tramite script (se non viene automaticamente riconosciuto il tasto) vi consiglio di usare il comando rfkill che come vedrete è utile anche se avete il bluetooth.


BLUETOOTH
Il caro amico Valantin propone uno script per gestire il bluetooth, richiede però di aver installato il pacchetto rfkill, quindi nel caso non lo abbiate usate il vostro package manager di fiducia per procurarvelo.

#!/bin/bash
for i in /sys/class/rfkill/*; do
   if [ -f "$i/name" ] && [ "$(cat "$i/name")" = "eeepc-bluetooth" ]; then
      BT_STATE=`cat "$i/state"`
   fi
done

case $BT_STATE in
   0)
      rfkill unblock bluetooth
      /usr/bin/notify-send "Bluetooth" "Abilitato" -t 5000 2>/dev/null
      ;;
   1)
      rfkill block bluetooth
      /usr/bin/notify-send "Bluetooth" "Disabilitato" -t 5000 2>/dev/null
      ;;
   *)
      /usr/bin/notify-send "Errore" "Problemi Blutooth" 2>/dev/null
      ;;
esac

Questo script fa uso anche delle notifiche, per maggiori dettagli vedete la relativa sezione.

SPEGNERE IL MONITOR
Riguardo lo spegnimento del monitor ho già fatto un esempio all'inizio, comunque non necessita la modifica di alcun file ma basta dare il seguente comando:

xset dpms force off

DISABILITARE IL TOUCHPAD
Anche per quanto riguarda il touchpad il controllo è molto semplice, in questo caso useremo il comando synclient in questo modo:

synclient TouchpadOff=1

per spegnerlo, mentre basterà sostituire 0 a 1 per riattivarlo;
vediamo uno script di esempio:

#!/bin/bash
touchpad=$(synclient -l | grep TouchpadOff | awk '{print $3}')
if [ "$touchpad" = "0" ]; then
   synclient TouchpadOff=1
else
   synclient TouchpadOff=0
fi

CAMBIARE RISOLUZIONE
Nel caso abbiate la necessità di switchare la risoluzione a 1024x768 Valantin nel primo commento ha postato un utile script per farlo.

#!/bin/bash
RESOLUTION=`xrandr | grep LVDS1 | awk '{print $3}'`

case "$RESOLUTION" in
   '1024x600+0+0')
      xrandr --output LVDS1 --panning 1024x768
      /usr/bin/notify-send "LCD Panning" "1024x768" -t 5000 2>/dev/null
      ;;
   '1024x768+0+0')
      PANNING=`xrandr | grep LVDS1 | awk '{print $15}'`
      if [ "$PANNING" = 'panning' ]; then
         xrandr --output LVDS1 --scale 1x1.28 --panning 0x0
         /usr/bin/notify-send "LCD Scaling" "1024x768" -t 5000 2>/dev/null
      else
         xrandr --output LVDS1 --scale 1x1
         /usr/bin/notify-send "LCD Default" "1024x600" -t 5000 2>/dev/null
      fi
      ;;
   *)
      /usr/bin/notify-send "Errore" "impossibile cambiare risoluzione" 2>/dev/null
      ;;
esac

VARIE ED EVENTUALI
Potremmo andare avanti all'infinito a fare script, comunque ritengo che già questi coprano quasi la totalità delle necessità di un comune essere umano.
Se avete bisogno di altro vi consiglio caldamente di fare qualche ricerca su internet in quanto sicuramente l'argomento sarà stato ampiamente trattato, inoltre siccome credo che si impari più dalla pratica che dalla teoria vi consiglio di dare un'occhiata agli script acpi delle maggiori distribuzioni Gnu/Linux, in particolare a quelli di Archlinux reperibili sul relativo sito di googlecode http://code.google.com/p/acpi-eeepc-generic/.


NOTIFICHE
Siamo quasi giunti a conclusione...
Vediamo ora come aggiungere le notifiche ai vostri script in modo che vi appaia un bel messaggio quando spegnete la webcam o quando cambiate il profilo dello SHE.
Ci sono vari programmi per mandare a schermo delle notifiche ma in genere il più gettonato (presente in tutte le distro maggiori e minori) è notify-send facente parte del pacchetto libnotify, vediamo qual'è la sintassi:

notify-send "Titolo notifica" "testo notifica" -t 3000 -i "icona"

dove il numero dopo -t è il tempo espresso in millisecondi per il quale la notifica rimarrà a schermo, mentre l'ozione -i vi permette di aggiungere un'immagine alla notifica (naturalmente il parametro tempo e l'icona non sono indispensabili, possono anche essere omessi). Inoltre potete impostare anche l'urgenza della notifica, vi basterà aggiungere l'opzione -u seguita da un parametro a scelta tra low, normal e critical.

Per gli utenti di Kde c'è a disposizione anche un'altro comando, integrato nel DE:

kdialog --passivepopup "testo notifica" 10

dove il numero finale stavolta rappresenta il tempo espresso in secondi.

Vediamo ora un esempio di come sarebbe il mio script per spegnere il touchpad postato in precedenza con l'aggiunta delle notifiche:

#!/bin/bash
export DISPLAY=:0
touchpad=$(synclient -l | grep TouchpadOff | awk '{print $3}')
if [ "$touchpad" = "0" ]; then
   synclient TouchpadOff=1
   su melko -c 'notify-send "EeePc" "Touchpad disabilitato" -t 4000'
else
   synclient TouchpadOff=0
   su melko -c 'notify-send "EeePc" "Touchpad abilitato" -t 4000'
fi

Notate che ho utilizzato la sintassi su utente -c 'comando' e ho anche messo export DISPLAY=:0


COMPATTARE IL TUTTO
Come vi avevo promesso all'inizio ora vi mostrerò come compattare il tutto in un unico file.
Il procedimento non è difficile... basta dire al demone Acpid di indirizzare tutti gli eventi che intercetta in un unico file.
Per fare questo torniamo nella cartella /etc/acpi/events
e creiamo un file con il seguente contenuto:

event=hotkey.*
action=/etc/acpi/eeepc_script.sh %e

in questo modo Acpid ogni qual volta intercetta un evento di tipo hotkey invoca lo script eeepc_script.sh (potete metterci quello che volete, l'importante è che vi ricordiate di rendere eseguibile lo script attraverso l'uso di chmod +x nomefile) passandogli quattro variabili che sono semplicemente le stesse che vi dava acpi_listen...

Riprendendo l'esempio iniziale con il tasto per spegnere lo schermo con acpi_listen ottenevamo:

hotkey ATKD 00000016 00000002

quindi le quattro variabili sono:

$1 = hotkey
$2 = ATKD
$3 = 00000016
$4 = 00000002

ora se mi avete seguito fin qui saprete che l'unico dato che ci interessa è il codice del tasto che è rappresentato dal terzo gruppo di numeri, quindi l'unica variabile che vi interessa è $3.

detto ciò basterà utilizzare il costrutto if-else oppure case
e far eseguire i comandi relativi al tasto premuto;
inoltre per facilitarvi le cose vi consiglio caldamente l'uso delle funzioni in modo da rendere più leggibile il codice.

Vediamo ora un piccolo esempio del file eeepc_script.sh (per brevità ho inserito solo il comando per spegnere lo schermo, ma potete inserire tutti gli altri che sono stati elencati sopra):

#!/bin/bash

toggle_display()
{
   su melko -c 'xset dpms force off'
}
export DISPLAY=:0
case "$3" in
   00000016) #questo è il codice relativo al tasto per spegnere il display
      toggle_display
      ;;
   00000037) #qui ci va il codice di un altro tasto
      #e qui ci mettete l'azione che dove essere eseguita
      ;;
   00000018) #cosi andate avanti finché non avete messo tutti i tasti
      #con le relative azioni, ricordatevi la comodità delle funzioni
      ;;
esac