Manpages

名 前

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" タ ッ チ パ ネ ル の デ バ イ ス へ の パ ス を 指 定 す る 。 有 効 な デ バ イ ス は

/dev/ttyS0, /dev/ttyS1, ... で あ る 。 こ の オ プ シ ョ ン は 必 須 で あ る 。 正 し い デ バ イ ス を 指 定 す る こ と が 重 要 で あ る 。 参 考 : com1 → /dev/ttyS0, com2 → /dev/ttyS1, …の 対 応 関 係 が あ る 。

Option "ScreenNumber" "screennumber"

citron の 入 力 デ バ イ ス と し て ス ク リ ー ン 番 号 screennumber を 設 定 す る 。 デ フ ォ ル ト 値 : ScreenNumber: "0"

Option "MinX" "value"
Option "MinY" "value"

citron の 入 力 デ バ イ ス に 対 し X, Y の 最 小 値 を 指 定 す る 。 注 意 : MinX, MinY は MaxX, MaxY よ り も 小 さ い 値 で な け れ ば な ら な い 。 範 囲 : "0" - "65535" デ フ ォ ル ト 値 : MinX: "0" MinY: "0"

Option "MaxX" "value"
Option "MaxY" "value"

citron の 入 力 デ バ イ ス に 対 し X, Y の 最 大 値 を 指 定 す る 。 注 意 : MaxX, MaxY は MinX, MinY よ り も 大 き い 値 で な け れ ば な ら な い 。 範 囲 : "0" - "65535" デ フ ォ ル ト 値 : MaxX: "65535" MaxY: "65535"

Option "ButtonNumber" "value" こ の 値 は ボ タ ン 番 号 を 設 定 す る 。 こ の 値 は xf86PostButton イ ベ ン ト メ ッ セ ー ジ 内 に 返 さ れ る 。 範 囲 : "0" - "255" デ フ ォ ル ト 値 : "1"
Option "ButtonThreshold" "value" こ の 値 は ボ タ ン の 閾 値 を 設 定 す る 。 こ の 値 は タ ッ チ パ ネ ル の 接 触 感 度 を 変 更 す る 。 大 き い 値 が 大 き い 圧 力 に 対 応 す る 。 注 意 : こ の 機 能 は 圧 力 感 度 に 対 応 し た ハ ー ド ウ ェ ア で し か 使 え な い 。 範 囲 : "0" - "255" デ フ ォ ル ト 値 : "20"
Sleep-Mode

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

Option "SleepMode" "mode" こ の 値 は タ ッ チ パ ネ ル の ス リ ー プ モ ー ド を 設 定 す る 。 ス リ ー プ モ ー ド の 動 作 は 以 下 の よ う に 設 定 さ れ る :

0x00 有 効 化 、 無 効 化 の 際 に メ ッ セ ー ジ を 出 さ な い

0x01 有 効 化 の 際 に メ ッ セ ー ジ を 出 す

0x02 無 効 化 の 際 に メ ッ セ ー ジ を 出 す

0x03 有 効 化 、 無 効 化 の 際 に メ ッ セ ー ジ を 出 す

0x10 ス リ ー プ モ ー ド の 状 態 に 応 じ て GP_OUT 出 力 を 設 定 す る 値 : "0" "1" "2" "3" "16" デ フ ォ ル ト 値 : "0"

Option "SleepTime" "time" こ の 値 は タ ッ チ パ ネ ル の ス リ ー プ ま で の 待 ち 時 間 を 設 定 す る 。 有 効 化 さ れ る ま で の 時 間 を 秒 数 で 指 定 す る ("0" = 即 座 に 有 効 化 さ れ る , "65535" = 常 に 無 効 の ま ま )。 範 囲 : "0" - "65535" 秒 デ フ ォ ル ト 値 : "65535" → 無 効 化
Option "SleepScan" "scan" こ の 値 は タ ッ チ パ ネ ル の ス キ ャ ン 時 間 を 設 定 す る 。 こ れ は 、 ス リ ー プ モ ー ド 時 の 2 つ の ス キ ャ ン 操 作 の 時 間 間 隔 で あ る 。 こ の 時 間 間 隔 は ミ リ 秒 単 位 で 設 定 す る 。 範 囲 : "0" - "65535" [ミ リ 秒 ] デ フ ォ ル ト 値 : "500"
Option "PWMActive" "value" こ の 値 は 通 常 動 作 時 (ス リ ー プ モ ー ド 無 効 時 )に お け る PWM 出 力 パ ル ス の on/off の レ ー ト を 決 め る 。 こ の 値 を 大 き く す る と 、 パ ル ス の 幅 が 長 く な る 。 こ の 出 力 信 号 は 、 Citron AWBI と 組 み 合 わ せ て 、 タ ッ チ 時 に バ ッ ク ラ イ ト の 明 る さ を 調 整 す る た め に 利 用 で き る 。 範 囲 : "0" - "255" デ フ ォ ル ト 値 : "255" (明 る さ 最 大 )
Option "PWMSleep" "value" こ の 値 は ス リ ー プ モ ー ド 有 効 時 (→ SleepMode, SleepScan, SleepTime )に お け る PWM 出 力 パ ル ス の on/off の レ ー ト を 決 め る 。 こ の 値 を 大 き く す る と 、 パ ル ス の 幅 が 長 く な る 。 範 囲 : "0" - "255" デ フ ォ ル ト 値 : "255" (明 る さ 最 大 )
Option "PWMFreq" "value" こ の 値 は PWM の 周 波 数 を ヘ ル ツ 単 位 で 決 め る 。 範 囲 : "39" - "9803" デ フ ォ ル ト 値 : "9803" (最 大 周 波 数 )
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 イ ベ ン ト が 送 ら れ る 。 範 囲 : "1" - "5" デ フ ォ ル ト 値 : "1" (ClickMode Enter)

Option "Origin" "value" こ の 値 は 画 面 の 4 隅 の い ず れ か を 原 点 と し て 設 定 す る 。 指 定 で き る 値 は 以 下 の 通 り で あ る : "0" TOPLEFT: 左 上 隅 を 原 点 と す る "1" TOPRIGHT: 右 上 隅 を 原 点 と す る "2" BOTTOMRIGHT: 右 下 隅 を 原 点 と す る "3" BOTTOMLEFT: 左 下 隅 を 原 点 と す る 範 囲 : "0" - "3" デ フ ォ ル ト 値 : "0" (TOPLEFT)
Doze-Mode あ る 一 定 時 間 ユ ー ザ 接 触 領 域 で 赤 外 線 の 遮 断 が 起 こ ら な け れ ば 、 い わ ゆ る 仮 眠 モ ー ド が 自 動 的 に 有 効 と な る 。 仮 眠 モ ー ド が 有 効 に な る と 、 赤 外 線 ビ ー ム の ス キ ャ ン レ ー ト が 少 し 落 ち る 。 こ れ に よ り 、 IRT の 電 力 消 費 が 抑 え ら れ る 。 ユ ー ザ 接 触 領 域 で 赤 外 線 の 遮 断 が 検 出 さ れ る と 、 仮 眠 モ ー ド は 即 座 に 解 除 さ れ 、 ユ ー ザ 接 触 領 域 は 最 大 速 度 で ス キ ャ ン さ れ る 。
Option "DozeMode" "mode" こ の 値 は タ ッ チ パ ネ ル の 仮 眠 モ ー ド を 設 定 す る 。 仮 眠 モ ー ド の 動 作 は 以 下 の よ う に 設 定 さ れ る :

0x00 有 効 化 、 無 効 化 の 際 に メ ッ セ ー ジ を 出 さ な い

0x01 有 効 化 の 際 に メ ッ セ ー ジ を 出 す

0x02 無 効 化 の 際 に メ ッ セ ー ジ を 出 す

0x03 有 効 化 、 無 効 化 の 際 に メ ッ セ ー ジ を 出 す

0x10 仮 眠 モ ー ド の 状 態 に 応 じ て GP_OUT 出 力 を 設 定 す る ス リ ー プ モ ー ド が 既 に GP_OUT を 制 御 し て い る 場 合 は 、 出 力 ポ ー ト は 利 用 で き な い 。 値 : "0" "1" "2" "3" "16" デ フ ォ ル ト 値 : "0"

Option "DozeTime" "time" こ の 値 は タ ッ チ パ ネ ル の 仮 眠 ま で の 待 ち 時 間 を 設 定 す る 。 有 効 化 さ れ る ま で の 時 間 を 秒 数 で 指 定 す る ("0" = 即 座 に 有 効 化 さ れ る , "65535" = 常 に 無 効 の ま ま )。 範 囲 : "0" - "65535" [秒 ] デ フ ォ ル ト 値 : "65535" → 無 効 化
Option "DozeScan" "scan" こ の 値 は タ ッ チ パ ネ ル の ス キ ャ ン 時 間 を 設 定 す る 。 こ れ は 、 仮 眠 モ ー ド 時 の 2 つ の ス キ ャ ン 操 作 の 時 間 間 隔 で あ る 。 こ の 時 間 間 隔 は ミ リ 秒 単 位 で 設 定 す る 。 範 囲 : "0" - "65535" [ミ リ 秒 ] デ フ ォ ル ト 値 : "500"
Option "DeltaX" "value" こ の 値 は 、 現 在 の カ ー ソ ル 位 置 の 左 右 の 端 に 、 カ ー ソ ル が 動 い て い な い と み な す 仮 想 的 な 領 域 を 設 定 す る 。 こ の 領 域 の 中 で は "MotionNotify" イ ベ ン ト は 送 ら れ な い 。 範 囲 "0" - "255" デ フ ォ ル ト 値 "0" (deltaX な し )
Option "DeltaY" "value" こ の 値 は 、 現 在 の カ ー ソ ル 位 置 の 上 下 の 端 に 、 カ ー ソ ル が 動 い て い な い と み な す 仮 想 的 な 領 域 を 設 定 す る 。 こ の 領 域 の 中 で は "MotionNotify" イ ベ ン ト は 送 ら れ な い 。 範 囲 "0" - "255" デ フ ォ ル ト 値 "0" (deltaY な し )
Option "Beep" "value" こ の 値 は 、 "ButtonPress" イ ベ ン ト や "ButtonRelease" イ ベ ン ト で ブ ザ ー を な ら す か ど う か を 設 定 す る 。 "0" で ブ ザ ー が 無 効 に な る 。 他 の 値 で あ れ ば ブ ザ ー は 有 効 に な る 。 範 囲 "0" - "1" デ フ ォ ル ト 値 "0" (無 効 )
Option "PressVol" "value" こ の 値 は 、 "ButtonPress" イ ベ ン ト が 送 ら れ た 時 の ブ ザ ー の 音 量 を 設 定 す る (0-100%)。

"0" - "100" デ フ ォ ル ト 値 "100"

Option "PressPitch" "value" こ の 値 は 、 "ButtonPress" イ ベ ン ト が 送 ら れ た 時 の 音 の 高 さ を 設 定 す る 。 範 囲 "0" - "3000" デ フ ォ ル ト 値 "880"
Option "PressDur" "value" こ の 値 は 、 "ButtonPress" イ ベ ン ト が 送 ら れ た 時 の 音 の 長 さ を ミ リ 秒 単 位 で 設 定 す る 。 範 囲 "0" - "255" デ フ ォ ル ト 値 "15"
Option "ReleaseVol" "value" こ の 値 は 、 "ButtonRelease" イ ベ ン ト が 送 ら れ た 時 の ブ ザ ー の 音 量 を 設 定 す る (0-100%)。

"0" - "100" デ フ ォ ル ト 値 "100"

Option "ReleasePitch" "value" こ の 値 は 、 "ButtonRelease" イ ベ ン ト が 送 ら れ た 時 の 音 の 高 さ を 設 定 す る 。 範 囲 "0" - "3000" デ フ ォ ル ト 値 "1200"
Option "ReleseDur" "value" こ の 値 は 、 "ButtonRelease" イ ベ ン ト が 送 ら れ た 時 の 音 の 長 さ を ミ リ 秒 単 位 で 設 定 す る 。 範 囲 "0" - "255" デ フ ォ ル ト 値 "10"
Option "BeamTimeout" "value" 赤 外 線 ビ ー ム が 故 障 し て い る と 判 断 し 、 ビ ー ム を 止 め 、 座 標 評 価 の 対 象 外 と す る ま で に 待 つ 時 間 の 長 さ を 決 め る (秒 単 位 )。 範 囲 "0" - "65535" デ フ ォ ル ト 値 "30" (30 秒 )
Option "TouchTime" "value" 有 効 な 赤 外 線 遮 断 の 最 小 時 間 を 10 ミ リ 秒 き ざ み で 指 定 す る 。 遮 断 を 有 効 な も の と し て ホ ス ト コ ン ピ ュ ー タ に レ ポ ー ト さ せ る た め に は 、 少 な く と も こ こ で 宣 言 し た 時 間 は 同 じ 位 置 で 遮 断 が 起 こ る 必 要 が あ る 。 範 囲 "0" - "255" デ フ ォ ル ト 値 "0" (=6.5 ミ リ 秒 )
Option "EnterCount" "count" ス キ ッ プ す る 「 入 力 レ ポ ー ト 」 の 数 を 指 定 す る 。 レ ポ ー ト は 約 20 ミ リ 秒 ご と に 送 ら れ る 。 範 囲 "0" - "31" デ フ ォ ル ト 値 "3" (メ ッ セ ー ジ を 3つ ス キ ッ プ = 60 ミ リ 秒 )
Option "ZEnterCount" "count" 圧 力 感 知 モ ー ド に お い て ス キ ッ プ す る 「 入 力 レ ポ ー ト 」 の 数 を 指 定 す る 。 レ ポ ー ト は 約 20 ミ リ 秒 ご と に 送 ら れ る 。 範 囲 : "0" - "31" デ フ ォ ル ト 値 : "1" (メ ッ セ ー ジ を 1 つ ス キ ッ プ = 20 ミ リ 秒 )
Option "DualCount" "count" ス キ ッ プ す る 「 二 重 タ ッ チ エ ラ ー 」 の 数 を 指 定 す る 。 レ ポ ー ト は 約 20 ミ リ 秒 ご と に 送 ら れ る 。 こ の オ プ シ ョ ン は "ZPress" モ ー ド と "ZPress Exit" モ ー ド で し か 利 用 で き な い 。 範 囲 "0" - "31" デ フ ォ ル ト 値 "2" (メ ッ セ ー ジ を 2つ ス キ ッ プ = 40 ミ リ 秒 )

関 連 項 目

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

作 者

2000-2001 − Citron GmbH (support [AT] citron.de) に よ り 作 成 。