名称

acpi_ibm — IBM ラップトップのための ACPI 特別ドライバ

書式

このドライバをカーネルにコンパイルするためには、次の行を利用者のカーネル設定ファイルに置きます:

device acpi_ibm

もう一つの方法として、ブート時にモジュールとしてドライバをロードするためには、次の行を loader.conf(5) に置きます:

acpi_ibm_load="YES"

解説

acpi_ibm ドライバは、IBM ラップトップのホットキーおよび他のコンポーネントのサポートを行います。このドライバの主な目的は、アプリケーションが様々なラップトップコンポーネントの状態を決定することができるために、 sysctl(8) と devd(8) を通して、アクセス可能なインタフェースを提供することです。

ドライバをロードした後に sysctl(8) インタフェースが自動的に有効にされている間、 devd(8) インタフェースは、特定のキーのデフォルト動作を変更できるように、明らかに有効にされなければなりません。以下に説明されているように events sysctl を設定することによってこれは行われます。どのキーがイベントを生成するべきであるかの指定は、各ビットが 1 つのキーまたはキーの組み合わせを表す、ビットマスクを設定することによって行われます。 eventmask sysctl を通してアクセス可能なこのビットマスクは、特定の ThinkPad モデルですべての起こり得る keypress イベントを表す値である、デフォルトの availmask に設定されます。

devd(8) Ss イベント

devd(8) によって受け付けられたホットキーイベントは、次の情報を提供します:

ThinkPad モデルにより、イベントコードは異なります。 ThinkPad T41p では、これらは次の通りです:

led(4) Ss インタフェース

acpi_ibm ドライバは ThinkLight のための led(4) インタフェースを提供します。 ThinkLight は、 /dev/led/thinklight デバイスに ASCII 文字列を書き込むことによって、点滅を行うことができます。

SYSCTL 変数

次の sysctl が現在、実装されています:

これらの sysctl のためのデフォルトは、 sysctl.conf(5) で設定することができます。

使用例

ボタンのイベントを /usr/local/sbin/acpi_oem_exec.sh スクリプトに渡すために devd.conf(5) に次を追加することができます:

notify 10 { 
        match "system"          "ACPI"; 
        match "subsystem"       "IBM"; 
        action "/usr/local/sbin/acpi_oem_exec.sh $notify ibm"; 
};

利用可能な /usr/local/sbin/acpi_oem_exec.sh スクリプトは次に似ているかもしれません:

#!/bin/sh 
# 
if [ "$1" = "" -o "$2" = "" ] 
then 
        echo "usage: $0 notify oem_name" 
        exit 1 
fi 
NOTIFY=`echo $1` 
LOGGER="logger" 
CALC="bc" 
BC_PRECOMMANDS="scale=2" 
ECHO="echo" 
CUT="cut" 
MAX_LCD_BRIGHTNESS=7 
MAX_VOLUME=14 
OEM=$2 
DISPLAY_PIPE=/tmp/acpi_${OEM}_display 
 
case ${NOTIFY} in 
        0x05) 
                LEVEL=`sysctl -n dev.acpi_${OEM}.0.bluetooth` 
                if [ "$LEVEL" = "1" ] 
                then 
                        sysctl dev.acpi_${OEM}.0.bluetooth=0 
                        MESSAGE="bluetooth disabled" 
                else 
                        sysctl dev.acpi_${OEM}.0.bluetooth=1 
                        MESSAGE="bluetooth enabled" 
                fi 
                ;; 
        0x10|0x11) 
                LEVEL=`sysctl -n dev.acpi_${OEM}.0.lcd_brightness` 
                PERCENT=`${ECHO} "${BC_PRECOMMANDS} ; \ 
                         ${LEVEL} / ${MAX_LCD_BRIGHTNESS} * 100" |\ 
                         ${CALC} | ${CUT} -d . -f 1` 
                MESSAGE="brightness level ${PERCENT}%" 
                ;; 
        0x12) 
                LEVEL=`sysctl -n dev.acpi_${OEM}.0.thinklight` 
                if [ "$LEVEL" = "1" ] 
                then 
                        MESSAGE="thinklight enabled" 
                else 
                        MESSAGE="thinklight disabled" 
                fi 
                ;; 
        0x15|0x16) 
                LEVEL=`sysctl -n dev.acpi_${OEM}.0.volume` 
                PERCENT=`${ECHO} "${BC_PRECOMMANDS} ; \ 
                        ${LEVEL} / ${MAX_VOLUME} * 100" | \ 
                         ${CALC} | ${CUT} -d . -f 1` 
                MESSAGE="volume level ${PERCENT}%" 
                ;; 
        0x17) 
                LEVEL=`sysctl -n dev.acpi_${OEM}.0.mute` 
                if [ "$LEVEL" = "1" ] 
                then 
                        MESSAGE="volume muted" 
                else 
                        MESSAGE="volume unmuted" 
                fi 
                ;; 
        *) 
                ;; 
esac 
${LOGGER} ${MESSAGE} 
if [ -p ${DISPLAY_PIPE} ] 
then 
        ${ECHO} ${MESSAGE} >> ${DISPLAY_PIPE} & 
fi 
exit 0

次の使用例は、イベントコード 0x04 (RAM をサスペンドする)、 0x10 (輝度をアップ) と 0x11 (輝度をダウン) が acpi_ibm によって操作されることを指定します。

sysctl dev.acpi_ibm.0.handlerevents='0x04 0x10 0x11'

次の sysctl.conf(5) で:

dev.acpi_ibm.0.handlerevents=0x04\ 0x10\ 0x11

歴史

acpi_ibm デバイスドライバは FreeBSD 6.0 ではじめて登場しました。

作者

acpi_ibm ドライバは Takanori Watanabe <takawata@FreeBSD.org>によって書かれ、後で Markus Brueffer <markus@FreeBSD.org>よってほとんど書き直されました。このマニュアルページは Christian Brueffer <brueffer@FreeBSD.org>と Markus Brueffer <markus@FreeBSD.org>によって書かれました。

June 24, 2012

FreeBSD

YOS OPENSONAR

名称

書式

解説

devd(8) Ss イベント

led(4) Ss インタフェース

SYSCTL 変数

関連ファイル

使用例

関連項目

歴史

作者