名前¶

citron - Citron 製赤外線型タッチパネル(CiTouch)用ドライバ

書式¶

Section "InputDevice"
  Identifier "idevname"
  Driver "citron"
  Option "Device"   "devpath"
  ...
EndSection

説明¶

citron は Citron Infrared Touch デバイス用の入力ドライバである。 citron ドライバはポインタ入力デバイスとして動作し、X サーバのコア ポインタとして使用できる。このデバイスは "RS232" 経由でホストに 接続される。

対応ハードウェア¶

現時点では以下のタッチパネルに対応している。これらのデバイスは ユーザのタッチ操作を ZPress として受け取ることもできる。 IRT6I5-V2.x 6.5 インチ赤外線型タッチパネル IRT10I4-V4.x 10.4 インチ赤外線型タッチパネル IRT12I1-V2.x 12.1 インチ赤外線型タッチパネル IRT15I1-V1.x
15.1 インチ赤外線型タッチパネル

詳細設定¶

詳細設定の一般的な部分と、全ての入力デバイスで利用できるオプションに ついては XF86Config(5x) を参照すること。 このセクションではこのドライバ固有の詳細設定のみを扱う。 さらに詳しい理解を得るためには、 CTS および各種 IRT のマニュアルを参照すること。これらは Citron のウェブページ( www.citron.de )から PDF 形式で入手できる。直接 Citron から入手することもできる。 ドライバは以下のオプションに対応している( Options 項目):

Option "Device" "devpath"

タッチパネルのデバイスへのパスを指定する。 有効なデバイスは

Option "ScreenNumber" "screennumber"

citron の入力デバイスとしてスクリーン番号 screennumber を設定する。

Option "MinX" "value"

Option "MinY" "value"

citron の入力デバイスに対し X, Y の最小値を指定する。

Option "MaxX" "value"

Option "MaxY" "value"

citron の入力デバイスに対し X, Y の最大値を指定する。

Option "ButtonNumber" "value"

この値は ボタン番号を設定する。この値は xf86PostButton イベントメッセージ 内に返される。

Option "ButtonThreshold" "value"

この値は ボタンの閾値 を設定する。 この値はタッチパネルの接触感度を変更する。 大きい値が大きい圧力に対応する。

Sleep-Mode

IRT が 仮眠モード であり、かつユーザ接触領域が一定時間のあいだ赤外線の遮断を受けなければ、 いわゆる スリープモード が有効になる。 スリープモード は 仮眠モード よりもさらに赤外線のスキャンの頻度を減らす(後述)。この機能により、 赤外線ビームの寿命が延び、また IRT の電力消費も抑えることができる。 ユーザ接触領域での赤外線の遮断が検出されると、 スリープモード は即座に無効となり、ユーザ接触領域は再び最大速度でスキャンされるように なる。 スリープモード が動作している場合、設定されているスキャンレートに応じて、 IRT の応答時間は通常の動作時よりもかなり長くなる。例えば、 スキャンレートを「500ms/スキャン」に設定している場合、 IRT が割り込みを検出して スリープモード をモードを無効にするまでには最大 0.5 秒かかることがある。

 

Option "SleepMode" "mode"

この値はタッチパネルの スリープモード を設定する。

Option "SleepTime" "time"

この値はタッチパネルの スリープまでの待ち時間 を設定する。有効化されるまでの時間を秒数で指定する ("0" = 即座に有効化される, "65535" = 常に無効のまま)。

Option "SleepScan" "scan"

この値はタッチパネルの スキャン時間 を設定する。これは、スリープモード時の 2 つのスキャン操作の時間間隔で ある。この時間間隔はミリ秒単位で設定する。

Option "PWMActive" "value"

この値は 通常動作時(スリープモード無効時)における PWM 出力パルスの on/off のレートを決める。 この値を大きくすると、パルスの幅が長くなる。 この出力信号は、 Citron AWBI と組み合わせて、タッチ時にバックライトの明るさを調整するために 利用できる。

Option "PWMSleep" "value"

この値は スリープモード有効時(→ SleepMode, SleepScan, SleepTime )における PWM 出力パルスの on/off のレートを決める。 この値を大きくすると、パルスの幅が長くなる。

Option "PWMFreq" "value"

この値は PWM の周波数をヘルツ単位で決める。

Option "ClickMode" "mode"

ClickModes を 5 つのモードから選択する。

 

"1" = ClickMode Enter

 

このモードでは、赤外線ビームの遮断のたびに毎回 ButtonPress イベント が送られ、遮断が終わると毎回 ButtonRelease イベントが送られる。

 

"2" = ClickMode Dual

 

このモードでは、赤外線ビームの遮断があると毎回 Proximity イベントが送 られ、1 回おきに ButtonPress イベントが送られる。遮断が終わると (片方の遮断がまだ有効であっても)ButtonRelease イベントが送られる。

 

"3" = ClickMode Dual Exit

 

このモードでは、赤外線ビームの遮断があると毎回 ProximityIn イベントが 送られ、1 回おきに ButtonPress イベントが送られる。遮断が終わっても (片方の遮断がまだ有効であっても)ButtonRelease イベントが送られない。 全ての遮断が終わったときだけ、ButtonRelease イベントが送られ、その後に ProximityOut イベントが送られる。

 

"4" = ClickMode ZPress

 

このモードでは、赤外線ビームの遮断があると毎回 ProximityIn イベントが 送られる。 圧力がある一定値を超えた場合だけ ButtonPress イベントが送られる。 圧力がこの一定値より小さくなると ButtonRelease イベントが送られる。 さらに遮断も終わると ProximityOut イベントが送られる。

 

"5" = ClickMode ZPress Exit

 

このモードは "Clickmode Dual Exit" モードに似ている。 このモードでは、赤外線ビームの遮断があると毎回 ProximityIn イベントが 送られる。 圧力がある一定値を超えた場合だけ ButtonPress イベントが送られる。 圧力がこの一定値より小さくなると ButtonRelease イベントが送られる。 さらに遮断も終わると、ButtonRelease イベントが送られ、その後に ProximityOut イベントが送られる。

Option "Origin" "value"

この値は画面の 4 隅のいずれかを原点として設定する。 指定できる値は以下の通りである: "0" TOPLEFT: 左上隅を原点とする "1" TOPRIGHT: 右上隅を原点とする "2" BOTTOMRIGHT: 右下隅を原点とする "3" BOTTOMLEFT: 左下隅を原点とする

Doze-Mode

ある一定時間ユーザ接触領域で赤外線の遮断が起こらなければ、 いわゆる仮眠モードが自動的に有効となる。 仮眠モードが有効になると、赤外線ビームのスキャンレートが少し落ちる。 これにより、IRT の電力消費が抑えられる。 ユーザ接触領域で赤外線の遮断が検出されると、仮眠モードは即座に解除され、 ユーザ接触領域は最大速度でスキャンされる。

 

Option "DozeMode" "mode"

この値はタッチパネルの 仮眠モード を設定する。

Option "DozeTime" "time"

この値はタッチパネルの 仮眠までの待ち時間 を設定する。有効化されるまでの時間を秒数で指定する ("0" = 即座に有効化される, "65535" = 常に無効のまま)。

Option "DozeScan" "scan"

この値はタッチパネルの スキャン時間 を設定する。これは、仮眠モード時の 2 つのスキャン操作の時間間隔で ある。この時間間隔はミリ秒単位で設定する。

Option "DeltaX" "value"

この値は、現在のカーソル位置の左右の端に、カーソルが動いていないとみな す仮想的な領域を設定する。 この領域の中では "MotionNotify" イベントは送られない。

Option "DeltaY" "value"

この値は、現在のカーソル位置の上下の端に、カーソルが動いていないとみな す仮想的な領域を設定する。 この領域の中では "MotionNotify" イベントは送られない。

Option "Beep" "value"

この値は、"ButtonPress" イベントや "ButtonRelease" イベントで ブザーをならすかどうかを設定する。"0" でブザーが無効になる。 他の値であればブザーは有効になる。

Option "PressVol" "value"

この値は、"ButtonPress" イベントが送られた時の ブザーの音量を設定する(0-100%)。

Option "PressPitch" "value"

この値は、"ButtonPress" イベントが送られた時の 音の高さを設定する。

Option "PressDur" "value"

この値は、"ButtonPress" イベントが送られた時の 音の長さをミリ秒単位で設定する。

Option "ReleaseVol" "value"

この値は、"ButtonRelease" イベントが送られた時の ブザーの音量を設定する(0-100%)。

Option "ReleasePitch" "value"

この値は、"ButtonRelease" イベントが送られた時の 音の高さを設定する。

Option "ReleseDur" "value"

この値は、"ButtonRelease" イベントが送られた時の 音の長さをミリ秒単位で設定する。

Option "BeamTimeout" "value"

赤外線ビームが故障していると判断し、ビームを止め、 座標評価の対象外とするまでに待つ時間の長さを決める(秒単位)。

Option "TouchTime" "value"

有効な赤外線遮断の最小時間を 10 ミリ秒きざみで指定する。 遮断を有効なものとしてホストコンピュータにレポートさせるためには、 少なくともここで宣言した時間は同じ位置で遮断が起こる必要がある。

Option "EnterCount" "count"

スキップする「入力レポート」の数を指定する。 レポートは約 20 ミリ秒ごとに送られる。

Option "ZEnterCount" "count"

圧力感知モードにおいてスキップする「入力レポート」の数を指定する。 レポートは約 20 ミリ秒ごとに送られる。

Option "DualCount" "count"

スキップする「二重タッチエラー」の数を指定する。 レポートは約 20 ミリ秒ごとに送られる。 このオプションは "ZPress" モードと "ZPress Exit" モードでしか 利用できない。

関連項目¶

XFree86(1), XF86Config(5x), xf86config(1), Xserver(1), X(7)

作者¶

2000-2001 - Citron GmbH (support@citron.de) により作成。