名称

書式

/boot/device.hints 中で:
hint.psm.0.at="atkbdc"
hint.psm.0.irq="12"

解説

基本的な PS/2 スタイルのポインティングデバイスには、2 つまたは 3 つのボタンがあります。いくつかのデバイスには、ローラまたはホイールおよび追加ボタンがあるかもしれません。

ドライバの設定

ローダ調整変数

ブート時に hw.psm.tap_enabled を 0 に設定することによって、tap と drag の gesture を無効にすることができます。現在、これは、無効にされた拡張サポートがある Synaptics タッチパッドでのみサポートされます。ブートの後に、同じ名前で sysctl を設定し、 /etc/rc.d/moused を使用して moused(8) を再開することによって、振る舞いを変更することができます。

IOCTL

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_UNKNOWN です。ドライバは、実際のところめったにデバイスタイプを識別できないので、ユーザは、このフィールドに頼り過ぎるべきではありません。

model は、操作レベル 0 で、常に MOUSE_MODEL_GENERIC です。それは、より高い操作レベルで MOUSE_MODEL_GENERIC または MOUSE_MODEL_XXX 定数の 1 つになります。この場合もやはり psm ドライバがこのフィールドに適切な値を設定するかどうか分かりません。

hwid は、デバイスによって返された ID 値です。既知の ID は、次に含まれます:

0

マウス (Microsoft, Logitech および他の多数のメーカ)

2

Microsoft Ballpoint マウス

3

Microsoft IntelliMouse

MOUSE_SYN_GETHWINFO synapticshw_t *synhw

Synaptics Touchpad (タッチパッド) に関連している特別の情報を検索します。サポートされたデバイスがデタッチされたときだけ、利用可能です。

typedef struct synapticshw { 
    int infoMajor; /* メジャーハードウェアリビジョン */ 
    int infoMinor; /* マイナハードウェアリビジョン */ 
    int infoRot180; /* タッチパッドは回転 */ 
    int infoPortrait; /* タッチパッドは縦方向 */ 
    int infoSensor; /* センサモデル */ 
    int infoHardware; /* ハードウェアモデル */ 
    int infoNewAbs; /* newabs 形式をサポート */ 
    int capPen;  /* ペン検出可能 */ 
    int infoSimplC; /* 単純コマンドをサポート */ 
    int infoGeometry; /* タッチパッド寸法 */ 
    int capExtended; /* 拡張パケットをサポート */ 
    int capSleep; /* サスペンド/レジューム可能 */ 
    int capFourButtons; /* 4 つのボタンあり */ 
    int capMultiFinger; /* 複数の finger 検出可能 */ 
    int capPalmDetect; /* palm 検出可能 */ 
    int capPassthrough; /* guest パケット通過可能 */ 
    int capMiddle; /* 物理的な中央ボタンがある */ 
    int nExtendedButtons; /* N 個の追加ボタンがある */ 
    int nExtendedQueries; /* N 個の拡張問い合わせをサポートする */ 
} synapticshw_t;

この構造のフィールドに関する詳しい情報に関しては、 Synaptics TouchPad Interfacing Guide を参照してください。

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 は、デバイスが移動通知をホストコンピュータに送る状態通知のレート (通知/秒) です。一般的にサポートされた値は、10、20、40、60、 80、100 と 200 です。いくつかのマウスは、他の任意の値も受け付けるかもしれません。

ポインティングデバイスの resolution (分解能) は、 MOUSE_RES_XXX 定数の 1 つか正の値でなければなりません。この値が大きければ大きいほど、マウスが選択するより細かな分解能になります。 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 は、データパケットの最初のバイトを検出するためにビットマスクとパターンを保持します。 syncmask[0] は、1 つのバイトと倫理積 (AND) を行うビットマスクです。結果が syncmask[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_GETSTATUS mousestatus_t *status

このコマンドは、 mouse(4) で説明されるようにボタンの現在の状態と移動のカウントを返します。

関連ファイル

/dev/psm0

`非ブロッキング' デバイスノード

/dev/bpsm0

`ブロッキング' デバイスノード

使用例

device atkbdc

device psm

を追加して、次の行を /boot/device.hints に書き込む必要があります。

hint.atkbdc.0.at="isa"

hint.atkbdc.0.port="0x060"

hint.psm.0.at="atkbdc"

hint.psm.0.irq="12"

利用者が次の文を /boot/device.hints に追加するなら、

hint.psm.0.flags="0x2000"

利用者は、`レジューム' イベントの後にポインティングデバイスを活性化するためにオプションのコードを追加します。

hint.psm.0.flags="0x24"

上記の行は、デバイス分解能を高く (4)、アクセラレーション係数を 2 に設定します。

診断

psm0: device ID X

ここで X は、見つけられたポインティングデバイスで返されたデバイス ID コードです。既知の ID については、 MOUSE_GETINFO を参照して下さい。

デバッグレベル 1 では、ドライバが補助ポート (マウスポート) をプローブしている間に詳しい情報がログに登録されます。メッセージは、LOG_DEBUG レベルのときに LOG_KERN ファシリティでログに登録されます ( 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

最初の行は、補助ポートがプローブされる直前のキーボードコントローラのコマンドバイト値を示します。それは、電源を入れる時にマザーボード BIOS がどのようにキーボードコントローラを初期化したかによって、通常、40、45、47 または 65 です。

2 行目は、補助ポートインタフェースでキーボードコントローラのテストの結果を示します。 0 は、エラーがないことを示します。しかしながら、いくつかのコントローラは、たとえポートがシステムに存在しなくてもエラーを通知しないことに注意してください。

3 行目から 5 行目は、ポインティングデバイスのリセット状態を示します。機能するデバイスは、FA AA <ID>の順序で返すはずです。この ID コードは、上で説明されています。

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

バイト 1

ビット 7

予約済み。

ビット 6

0 - ストリームモード、1 - リモートモード。ストリームモードでは、ポインティングデバイスは、状態が変化するときは、いつもデバイス状態を送ります。リモートモードでは、ホストコンピュータは、状態が送られるように要求しなければなりません。 psm ドライバは、デバイスをストリームモードにします。

ビット 5

ポインティングデバイスが現在有効であれば設定されます。そうでなければ 0 です。

ビット 4

0 - 1:1 スケーリング、1 - 2:1 スケーリング。 1:1 スケーリングがデフォルトです。

ビット 3

予約済み。

ビット 2

左ボタンの状態。押されているならセット。

ビット 1

中ボタンの状態。押されているならセット。

ビット 0

右ボタンの状態。押されているならセット。

バイト 2

ビット 7

予約済み。

ビット 6..0

分解能コード: 0 から 3。分解能コードの対する実際の分解能は、デバイスによって異なります。

バイト 3

デバイスが移動通知をホストコンピュータに送る状態通知レート (通知/秒)。

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

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

デバッグレベル 2 では、より詳細な情報がログに登録されます。

関連項目

作者

このマニュアルページは、 Kazutaka Yokota <yokota@FreeBSD.org>によって書かれました。

警告

ALPS GlidePoint、Synaptics Touchpad、IBM/Lenovo TrackPoint、と Interlink VersaPad は、サスペンド状態から復旧するために INITAFTERSUSPEND フラグを必要とすることが報告されています。このフラグは、これらのデバイスの 1 つが psm ドライバによって検出されるとき、自動的に設定されます。

MouseSystems 製のいくつかの PS/2 マウスモデルは、適切に動作するために高分解能モードにする必要があります。ドライバフラグを使用して分解能を設定してください。

いったん、データストリームとの同期がずれると、パケットの最初のバイトに再び同期するための保証された方法はありません。しかしながら、利用者が XFree86 サーバを使用して、X サーバが moused(8) を通してマウスにアクセスしていない、問題を抱えてているなら、利用者は、X サーバを仮想端末に切り替え X サーバに戻ることによって X サーバは、マウスと同期できるかもしれません。マウスを移動させないで任意のボタンをクリックしても動作するかもしれません。

バグ

Synaptics タッチパッドの拡張サポートを有効にすることは、特に guest デバイスがある Synaptics ハードウェアのいくつかの (より新しい) モデル上で応答速度で問題を起こすと報告されました。