psm(4)

PSM(4) FreeBSD/i386 カーネルインタフェースマニュアル PSM(4)

名称

書式

                                                                     ドライバの設定 を参照) か、または後で ioctl(2) コマンドの MOUSE_SETMODE (                                                                        IOCTLを参照) を用いて分解能を変更することができます。
通知レート     デバイスがホストシステムに移動とボタン状態の報告を行なう頻度、即ち通知レートの設定も変更可能です。一般的にいって PS/2 方式のポインティングデバイスは毎秒 10、20、40、60、80、100、200 回の報告を送信することができます。 60 回または 100 回毎秒の通知レートが多数のデバイスについてのデフォルト値であると思われます。何の移動もなく、且つどのボタンもその状態を変更していない時は、そのデバイスはホストシステムに何も通知しないということに注意してください。通知レートは ioctl コールを用いて変更できます。
動作レベル     psm ドライバには 3 段階の動作レベルがあります。現在の動作レベルは ioctlコールを用いて設定できます。
レベル 0 では基本的なサポートが行なわれます。即ち、デバイスドライバは接続されたデバイスの水平方向と垂直方向の移動及び最高 3 個までのボタンの状態を報告します。移動とボタンの状態は一連の固定長データパケット (                                                                   データパケット形式 参照) に符号化されます。レベル 0 はデフォルトの動作レベルであって、ユーザプログラムがドライバをオープンしたとき、最初はこのレベルにあります。
動作レベル 1、即ち「拡張」レベルでは、もし存在するならローラ (又はホイール)、及び最高 11 個迄のボタンがサポートされます。ローラによる移動は  Z 軸に沿った移動として報告されます。このレベルでは 8 バイトのデータパケットがユーザプログラムに送られます。
動作レベル 2 では、ポインティングデバイスからのデータはそのままユーザプログラムに渡されます。最新の PS/2 方式のポインティングデバイスはしばしば固有のデータ形式を用いています。その為、ユーザプログラムではこのレベルでドライバを操作するときに特殊なデバイスからのデータ形式に関する知識に精通していることが求められます。このレベルを「ネイティブ」レベルといいます。
データパケット形式     psm ドライバから引き渡されるデータパケットは動作レベルによって異なった形式になっています。
PS/2 マウス方式のポインティングデバイスからのデータパケットは、動作レベル0 では 3 バイトあります:
       Byte 1               bit 7                    1 は垂直移動カウントの算術あふれを示します。               bit 6                    1 は水平移動カウントの算術あふれを示します。               bit 5                    垂直移動カウントが負の場合にセットされます。               bit 4                    水平移動カウントが負の場合にセットされます。               bit 3                    常に 1 です。               bit 2                    中ボタンの状態; 押下されていればセットされます。中ボタンがないデバイスでは、このビットは常に 0 です。               bit 1                    右ボタンの状態; 押下されていればセットされます。               bit 0                    左ボタンの状態; 押下されていればセットされます。       Byte 2             2 の補数での水平移動カウント; -256 から 255 まで。符号ビットは第1 バイトにあることに注意してください。       Byte 3             2 の補数での垂直移動カウント; -256 から 255 まで。符号ビットは第1 バイトにあることに注意して下さい。
    レベル 1 では、 mouse(4) に定義されている標準形式であるMOUSE_PROTO_SYSMOUSE 形式が用いられます。
レベル 2、即ちネイティブレベルでは、データパケットの長さと形式には標準がありません。
加速     psm ドライバはポインティングデバイスの移動をある程度「加速」することができます。デバイスを速く動かすほど、ポインタは画面上をより遠くまで移動します。ドライバには加速の効果を支配する内部変数があります。その変数の値はドライバフラグを用いるか又は ioctl コールを用いて変更できます。
デバイス番号     psm のマイナデバイス番号は次式により生成されます。
          minor = (‘unit’ << 1) | ‘non-blocking’

ここで、「unit」とはデバイス番号 (通常 0) です。そして「非ブロッキング」 ビットがセットされるのは「プロセスブロックを行なうことでマウス入力がある までウェイトせずに、直ちに復帰する」ことを示す為です。「非ブロッキング」 ビットは XFree86 についてはセットされなければならず、その為 XFree86 につ いて通常用いられるマイナデバイス番号は 1 です。デバイスノード名については 関連ファイル を参照して下さい。

ドライバの設定

                                               config(8) を参照) に設定できます。
       PSM_HOOKAPM            ラップトップコンピュータの中には、システムが省電力モードから「レジューム」した直後、どういう訳か組み込まれた PS/2 ポインティングデバイスが操作不能になっているものがあります。もっとも、結局は使用可能にはなります。入出力操作を実行してデバイスを刺激すればデバイスを早く目覚めさせることができるらしいという報告があります。このオプションは、一連のコードを psm ドライバに追加してAPM「レジューム」イベントをフックし、デバイスに無害な入出力操作を施します。
       PSM_RESETAFTERSUSPEND            このオプションにより上述の問題に対しもっと強力な動作を加えます。このオプションを指定すると、APM レジュームイベントの後 psm ドライバはデバイスをリセットします。このオプションを使うには PSM_HOOKAPMオプションもまた一緒に指定して下さい。
       KBD_RESETDELAY=X, KBD_MAXWAIT=Y            psm ドライバは起動の過程でポインティングデバイスをリセットしようとします。時々リセット後にデバイスが応答するまで時間がかかることがあります。これらのオプションによりドライバがどのくらいの時間待つべきかを制御します。ドライバは最高で X * Y ミリ秒の間ウェイトします。ドライバがユーザのポインティングデバイスを検出できないように見える場合には、ユーザはこれらの値を増加させたいと考えるかも知れません。デフォルト値は X に対しては 200 ミリ秒で Y に対しては 5 です。
       PSM_DEBUG=N, KBDIO_DEBUG=N            これはデバッグレベルを N に設定します。デフォルトのデバッグレベルは 0 です。デバッグログについては 診断 を参照して下さい。
  ドライバフラグ     psm ドライバは以下のようなフラグを受け付けます。カーネル設定ファイルの中かまたは起動時のユーザ設定メニュー (                                           boot(8) を参照) でこれらのフラグを設定して下さい。
       bit 0..3 RESOLUTION            このフラグはポインティングデバイスの分解能を指定します。 0 から 4迄でなければなりません。この値が大きければ大きいほど、デバイスは分解能が高くなります。このフィールドにより指定される実際の分解能はデバイスのモデルにより異なります。一般的な分解能は以下の通りです。
              1 (low)                               25 パルス毎インチ (ppi)              2 (medium low)                               50 ppi              3 (medium high)                               100 ppi              4 (high)                               200 ppi
           このフラグを 0 のままにしておけば、(それが何であれ) デバイスのデフォルトの分解能となります。
       bit 4..7 ACCELERATION            このフラグは加速効果の程度を加減します。このフラグの値が小さければ小さいほど、移動の感度は上がります。許容される最小値は 1 であり、この値で最も感度が高い設定となります。このフラグを 0 に設定すれば完全に加速効果を無効にします。
       bit 8 NOCHECKSYNC            psm ドライバはデータパケットの第 1 バイトの検出をそのバイトのビットパターンを検査することにより行なおうとします。このやり方は大抵のPS/2 ポインティングデバイスでは旨く行きます。しかし既知のデバイスとあまり互換性のないデバイスの中にはこのやり方と相容れないものがあるかも知れません。もし、あなたのポインティングデバイスが期待通りには機能していないと考えられ、且つカーネルが頻繁に
                 psmintr: out of sync (xxxx != yyyy).

のようなメッセージをコンソールに表示する場合には、同期検査を無効に する為にこのフラグをセットして効果があるかどうかを調べて下さい。

       bit 9 NOIDPROBE            このフラグが指定されると、 psm ドライバはポインティングデバイスのモデルを調査しようとしたりモデル固有の初期化をしません。その場合、デバイスは標準的な PS/2 マウスのように振舞うはずです。ホイールや追加されたボタンのような特別な機能は psm ドライバには認識されないでしょう。
       bit 10 NORESET            このフラグがセットされていれば、デバイスを初期化するときに psm ドライバはポインティングデバイスをリセットしません。もし FreeBSDカーネルが他の OS の起動した後に立ち上がったなら、ポインティングデバイスは以前の OS の設定を継承することになります。しかし、 psm ドライバにはその設定を知る為の方法がないので、デバイスとドライバは正しく動作しないかも知れません。このフラグは正常な環境下では決して必要とはならないはずです。
       bit 11 FORCETAP            パッドデバイスの中には、デバイスの表面をユーザが「軽く叩く(タップする)」と、あたかも 4 番目のボタンが押されたかのように報告するものがあります (                          警告 参照) 。このフラグにより psm ドライバはデバイスがこのように振舞うと仮定します。このフラグがなければ、本ドライバはALPS GlidePoint モデルに対してのみこのような振舞いを仮定します。
       bit 12 IGNOREPORTERROR            このフラグによって、PS/2 マウスポートを検査するときに psm ドライバは若干のエラー状態を無視します。これは正常な環境下では決して必要にはならないはずです。

IOCTL

                                     machine/mouse.h⟩ に定義されています。コマンドの一般的な解説は mouse(4) に与えられています。このセクションでは psmドライバに固有の機能について解説します。
       MOUSE_GETLEVEL int *level       MOUSE_SETLEVEL int *level            これらのコマンドで psm ドライバの動作レベルを操作します。
       MOUSE_GETHWINFO mousehw_t *hw            これは接続されたデバイスのハードウェア情報を以下の構造体で返します。
           typedef struct mousehw {
                int buttons;    /* ボタンの数 */
                int iftype;     /* I/F の種類 */
                int type;       /* マウス/トラックボール/パッド... */
                int model;      /* I/F に固有のモデル ID */
                int hwid;       /* I/F に固有のハードウェア ID */
            } mousehw_t;

buttons フィールドはデバイスにあるボタンの数を保持します。現在 psm ドライバは Logitech 製の 3 ボタンマウスを検出してそのように報告す ることができます。他のメーカ製の 3 ボタンマウスについては正しく報 告されるかどうかは分かりません。しかし、ボタンの数が正しく検出され てもされなくてもドライバの運用には影響しません。

iftype フィールドは常に MOUSE_IF_PS2 です。

type フィールドは次のようなデバイスの種類を示します。即ち MOUSE_MOUSE, MOUSE_TRACKBALL, MOUSE_STICK, MOUSE_PAD, MOUSE_UNKNOW です。ユーザはこのフィールドに頼り過ぎてはいけません。というのは、 ドライバは必ずしも常にデバイスの種類を識別できる訳ではないからで す。実際のところデバイスの種類を識別できることは稀なのです。

model フィールドは動作レベル 0 では常に MOUSE_MODEL_GENERIC です。 これはより高次の動作レベルでは MOUSE_MODEL_GENERIC かまたは MOUSE_MODEL_XXX のうちのどれか 1 つになるかも知れません。この場合 にも psm ドライバがこのフィールドに適切な値をセットするかどうかは 分かりません。

hwid フィールドはデバイスにより返された ID の値です。一般的な ID は以下の通りです。

              0

              MOUSE_RES_LOW

       /dev/psm0

診断

      psm0: device ID X

                                    syslogd(8) を参照) ログされます。
          psm0: current command byte:xxxx
           kbdio: TEST_AUX_PORT status:0000
           kbdio: RESET_AUX return code:00fa
           kbdio: RESET_AUX status:00aa
           kbdio: RESET_AUX ID:0000
           [...]
           psm: status 00 02 64
           psm0 irq 12 on isa
           psm0: model AAAA, device ID X, N buttons
           psm0: config:00000www, flags:0000uuuu, packet size:M
           psm0: syncmask:xx, syncbits:yy

第 1 行目は補助ポートが検査される直前のキーボードコントローラのコマンドバ イトの値を示します。これは通常は、4D, 45, 47, 65 のいずれかで、通電時にマ ザーボード BIOS がキーボードコントローラを初期化した方法により決まりま す。

第 2 行目は補助ポートインタフェースに対してキーボードコントローラがテスト した結果を示し、0 でエラーが無いことを示します。しかしながら、たとえシス テムにポートが存在しなくてもエラーが無いと報告するコントローラも中にはあ ることに注意して下さい。

第 3 行目から第 5 行目まではポインティングデバイスのリセット状態を示しま す。機能しているデバイスであれば FA AA <ID> という順序に並んだデータを返 すはずです。この ID コードは上で解説したものです。

第 7 行目は現在のハードウェアの設定を示します。これらのバイトは次のように フォーマットされます:

       Byte 1

バグ

関連項目

作者