manページ  — PSM

レベル 1 では、 mouse(4) に定義されている標準形式である MOUSE_PROTO_SYSMOUSE 形式が用いられます。

レベル 2、即ちネイティブレベルでは、データパケットの長さと形式には標準が ありません。

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 ドライバは若干のエラー状態を無視します。 これは正常な環境下では決して必要にはならないはずです。

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	マウス (Microsoft, Logitech 及び他の多数のメーカ)
2	Microsoft Ballpoint mouse
3	Microsoft IntelliMouse

MOUSE_GETMODE mousemode_t *mode
	このコマンドによりマウスドライバの現在の動作パラメータを得ます。 typedef struct mousemode { int protocol; /* MOUSE_PROTO_XXX */ int rate; /* 通知レート (毎秒)、不明の時は -1 */ int resolution; /* MOUSE_RES_XXX、不明の時は -1 */ int accelfactor; /* 加速因子 */ int level; /* ドライバの動作レベル */ int packetsize; /* データパケットの長さ */ unsigned char syncmask[2]; /* 同期ビット */ } mousemode_t; protocol フィールドは動作レベル 0 と 2 では MOUSE_PROTO_PS2 です。 動作レベル 1 では、 MOUSE_PROTO_SYSMOUSE です。 rate フィールドは状態を通知する頻度 (1 秒当りに報告する回数) で、 この頻度でデバイスはホストコンピュータに移動の報告を送ります。 サポートされている一般的な値は、10, 20, 40, 60, 80, 100, 200 です。 中には他の任意の値をも受容するマウスもあるでしょう。 resolution フィールドはポインティングデバイスの分解能で、定数 MOUSE_RES_XXX の中のいずれかひとつの値かまたはある正の値です。 この値が大きいほど、マウスは分解能が細密になります。 定数 MOUSE_RES_XXX によって指定される実際の分解能はマウスのモデルによって異なります。 一般的な分解能は次の通りです:

MOUSE_RES_LOW	25 ppi
MOUSE_RES_MEDIUMLOW	50 ppi
MOUSE_RES_MEDIUMHIGH	100 ppi
MOUSE_RES_HIGH	200 ppi

accelfactor フィールドは加速機能 ( 加速 を参照 ) を管理する為の値を保持します。 この値は 0 か正でなければなりません。 もしこの値が 0 であれば、加速は無効となります。

packetsize フィールドはデータパケットの長さを示します。 これは動作レベルやポインティングデバイスのモデルによって変わります。

level 0	3 バイト
level 1	8 バイト
level 2	デバイスのモデルで決まります

配列である syncmask フィールドはデータパケットの第 1 バイトを検出する為の ビットマスクとビットパターンを保持します。 syncmask[0] フィールドは各バイトと AND をとるためのビットマスクです。 その結果が syncmask[1] フィールドに等しい場合には、恐らくそのバイトはデータパケットの第 1 バイト であろう思われます。 注意すべきことは、この検出方法は 100% 信頼できるものではなく、そのため、 単に参考となる手段でしかないと見なすべきことです。

MOUSE_SETMODE mousemode_t *mode
	このコマンドはマウスドライバの現在の動作パラメータを mode フィールドに指定された通りに変更します。 rate, resolution, level, accelfactor の各フィールドだけが変更できます。 その他のフィールドに値をセットしても エラーを生成しませんし効果もありません。 あるフィールドの現在の設定を変更したくない場合には、 そのフィールドに -1 を入れて下さい。 resolution フィールドと rate フィールドには 0 を入れることもでき、この場合にはそのフィールドのデフォルト値 が設定されます。
MOUSE_READDATA mousedata_t *data MOUSE_READSTATE mousedata_t *state
	これらのコマンドについては、現在 psm ドライバはサポートしていません。
MOUSE_GETSTATE mousestatus_t *status
	このコマンドは mouse(4) に記述されているようにボタンの現在の状態と移動カウントを返します。

psm0: device ID X

デバッグレベル 1 ではドライバが補助ポート (マウスポート) を検査している間により多くの情報がログされます。 メッセージは LOG_DEBUG の level で LOG_KERN を facility として (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
bit 7	予約済み。
bit 6	0 - ストリームモード、1 - リモートモード。 ストリームモードでは、ポインティングデバイスはその状態が変わる度に デバイス状態を送ります。 リモートモードでは、ホストコンピュータはデバイスの状態が送られるように 要求しなければなりません。 psm ドライバはデバイスをストリームモードにします。
bit 5	ポインティングデバイスが現在有効であればセットされます。 有効でなければ 0 です。
bit 4	0 - 1:1 スケーリング、1 - 2:1 スケーリング。 1:1 スケーリングがデフォルトです。
bit 3	予約済み。
bit 2	左ボタン状態; 押下されていればセット。
bit 1	中ボタン状態; 押下されていればセット。
bit 0	右ボタン状態; 押下されていればセット。

Byte 2

bit 7	予約済み。
bit 6..0	分解能コード: 0 から 3 迄。 分解能コードに対応する実際の分解能はデバイスにより異なります。

Byte 3	状態通知レート (1 秒当りに報告する回数) で、この頻度でデバイスは 移動報告をホストコンピュータに送ります。

psm ドライバがユーザプログラムによりオープンされるまでは ポインティングデバイスは有効にならないことに注意して下さい。

残りの行についてはデバイス ID コード、検出されたボタンの数、及び 内部変数を表示します。

デバッグレベル 2 では、ずっと多くの詳細な情報がログされます。