LIRCのソースを表示

[[Category:他のハードウェア]]
[[Category:マルチメディア]]
[[en:LIRC]]
この記事ではシリアル・USB 赤外線デバイスを使って [http://lirc.org/ LIRC] "Linux Infrared Remote Control" を設定・使用する方法を説明しています。

==概要==
LIRC はサポートしているリモコンのキーが押されたのをプログラムにあわせてコマンドに変換することができるデーモンです。ここで、「プログラムにあわせて」とは実行しているプログラムによってキーの押下で異なる動作をさせることができることを意味します。

=== LIRC の役割 ===
LIRC を使ってリモコンからの情報がプログラムに流れる過程は以下の通りです:
* ユーザーがリモコンのボタンを押すことで IR または RF 信号が送信されます。
* 信号が Linux が入ったパソコンに接続されたレシーバーによって受信されます。
* カーネル (の適切なモジュール) は {{ic|/dev/lirc0}} でレシーバーからのパルス幅の情報をキャラクタライズします。
* {{ic|/usr/bin/lircd}} は {{ic|/etc/lirc/lircd.conf.d/foo.conf}} からの情報でパルス幅をボタンの押下情報に変換します。
* LIRC を使用するプログラムは {{ic|/usr/bin/lircd}} のボタン押下情報を {{ic|~/.lircrc}} によってユーザーが定義した操作に解釈します。

=== 必要なファイル ===
* {{ic|/etc/lirc/lircd.conf.d/foo.conf}} - スキャンコード --> キーに変換するシステムレベルの設定。このディレクトリには複数の conf ファイルを入れることができ、それぞれがシステムの各リモートコントローラ・レシーバー固有です。
{{Note|これらはユーザーが作成する設定ファイルであり、パッケージによって直接作られるファイルではありません。}}

=== 任意のファイル ===
LIRC を使用するアプリケーションによっては、以下のファイルは任意です。例えば {{Pkg|mplayer}} や {{Pkg|mythtv}} は以下のファイルを使ってキーマップやアクションを定義します。全てのアプリケーションが必要とするわけではありません。例として、{{Pkg|kodi}} は自分の xml ファイルを使ってマッピングを行います。
* {{ic|~/.lircrc}} - プログラムごとの lirc マップ ({{ic|~/.lirc/foo}}, {{ic|~/.lirc/bar}} など) を指定する '''include''' ステートメントを記述するファイル。
* {{ic|~/.lirc/foo}} - キー --> 操作に翻訳するユーザーレベルの設定。各リモコンとアプリケーション foo の固有設定。

==インストール==
[[公式リポジトリ]]にある {{Pkg|lirc}} パッケージを[[インストール]]します。

{{Note|古いリモコンのサポートは公式で上流から落とされています。サポートされていないハードウェアを使用する場合は [[AUR]] のパッケージを検索してモジュールをビルドしてください。}}

==設定==
リモコンによっては LIRC がなくても"キーボード"として認識されそのように動作することがあります。このように認識されているとコマンドを二重に実行してしまう可能性があります。シェルやテキストエディタを開いて、リモコンのボタンを押してキーボードとして認識されていないかテストして下さい。文字や数字が打ち込まれたり、物理キーボードの上・下・右・左矢印キーのように動く場合、無効にする必要があります。次に進む前に [[#リモコンがキーボードとして機能する]] を見て下さい。

=== LIRC の設定ファイル ===
LIRC がリモコンを扱えるようにするにはスキャンコードとキーマップの定義が必要です。適当な conf ファイルを {{ic|/etc/lirc/lircd.conf.d}} にコピーすることでマッピングできます。

{{Note|Common configs are provided by {{Pkg|lirc}}, like those bundled with TV cards that can be installed automatically.  The primary source of config files is the LIRC homepage.  Check the [http://lirc.org/html/table.html official list of supported hardware] to know, which kernel modules and lircd drivers are required.}}

==== 選択肢 1. 上流の設定ファイル ====
使用するリモコン/レシーバを確認して {{ic|/usr/share/lirc/configs}} に設定済みの設定ファイルが存在しないか見てください。存在したら、デーモンが初期化をできるように、必要な conf を {{ic|/etc/lirc/lircd.conf.d}} にコピーします。

==== 選択肢 2. ユーザーが作成した設定ファイル ====
サポートされていないハードウェアを使用する場合、誰かが作った設定ファイルを  (google) 検索するか自分で作成する必要があります。{{ic|/usr/bin/irrecord}} を使うことでとても簡単に作成することができ、必要な手順についてガイドが出て来ます。認識されているリモコンを使用する場合、以下のように起動してください:

 # irrecord --device=/dev/lirc0 MyRemote

プログラムを実行するとリモコンにあるボタンを押して学習させるように表示されます。最終的には全てのボタンとスキャンコードがマッピングされます。全ての操作に10分もかからないはずです。完了したら、{{ic|/etc/lirc/lircd.conf.d/foo.conf}} に作成したファイルが保存されます。

{{Note|他の人もあなたの設定が使えるように、プログラムに記述されているメールアドレスに作成された設定ファイルを送ってみてもいいでしょう。}}

== リモコンのテスト ==
{{ic|lircd.service}} を[[起動]]してブート/シャットダウン時に実行されるように[[有効化]]してください ('''強く推奨''')。

{{ic|/usr/bin/irw}} を使ってリモコンをテストしてください、リモコンのボタンを押した時に LIRC が受信したものを全て標準出力に流します。

例:
 $ irw
 000000037ff07bfe 00 One mceusb
 000000037ff07bfd 00 Two mceusb
 000000037ff07bfd 01 Two mceusb
 000000037ff07bf2 00 Home mceusb
 000000037ff07bf2 01 Home mceusb

このコマンドが動作しない場合 (irw が何も出力をしない): {{ic|/etc/lirc/lircd.conf.d/}} 内の config ファイルに間違いがないか再度確認してください。

==プログラムごとの設定 ==
LIRC では同じキーを使ってプログラムごとに別々のコマンドになるように設定することができます。つまり、特定のキーを押した時に mplayer と vlc で挙動を変えられます。

プログラムを決めてから LIRC のコマンドを使って下さい。一般的なプログラムの例: {{Pkg|mplayer}}, {{Pkg|mythtv}}, {{Pkg|totem}}, {{Pkg|vlc}}, {{Pkg|kodi}}。

{{Note|Kodi は非標準的な方法で LIRC を実装しています。他のプログラムが使用する LIRC の標準ファイルではなく、特別な xml ファイルである {{ic|~/.xbmc/userdata/Lircmap.xml}} を編集する必要があります。Kodi を使用するユーザーは [[Kodi#リモートコントロールの使用]] の記事を読んでください。}}

Users should create the expected files showing LIRC where the various program-specific maps reside:
 $ mkdir ~/.lirc
 $ touch ~/.lircrc

* {{ic|~/.lirc}} に各プログラムの名前が付いた設定ファイルを作成してください。

例:
 $ ls ~/.lirc
 mplayer
 mythtv
 vlc

{{Note|Providing an exhaustive listing of keymaps for each program is beyond the scope of this wiki article.  Many pre-made files unique to each remote/program are available via googling.}}

* {{ic|~/.lircrc}} を編集して LIRC でコントロールするプログラムの数だけ {{ic|~/.lirc/foo}} を指定する ''include'' ステートメントを記述してください。

例:
{{hc|~/.lircrc|
include "~/.lirc/mplayer"
include "~/.lirc/mythtv"
include "~/.lirc/vlc"
}}

==トラブルシューティング==
=== リモコンがキーボードとして機能する ===
Streamzap USB PC Remote など、リモコンによっては Xorg によって Human Interface Device (HID) と認識されるものがあり、物理キーボードからの入力のようにキーの一部または全てがキーストロークとして認識されます。この挙動は LIRC でデバイスを管理しようとしたときに問題になります。無効にするには、以下のファイルを作成して X を再起動してください:

{{hc|/etc/X11/xorg.conf.d/90-streamzap.conf|
Section "InputClass"
  Identifier "Ignore Streamzap IR"
  MatchProduct "Streamzap"
  MatchIsKeyboard "true"
  Option "Ignore" "true"
EndSection}}

次のコマンドで得られる出力の {{ic|Name}} に合わせて {{ic|MatchProduct}} は適切に変更するようにしてください:
 $ cat /proc/bus/input/devices | grep -e IR
例えば {{ic|<nowiki>N: Name="cx88 IR (WinFast DTV2000 H rev."</nowiki>}} の場合 {{ic|WinFast}} にします。

== 参照 ==

* [http://lirc.sourceforge.net/lirc.org/html/index.html 開発元のドキュメント]
* [http://lirc-remotes.sourceforge.net/remotes-table.html リモコンデータベース]
* [http://sf.net/p/lirc プロジェクトサイト]
* [http://lirc.org/html/configuration-guide.html 開発元の設定ガイド]
* [http://www.mythtv.org/wiki/Category:Remote_Controls MythTV Wiki:Remotes article]
* [http://lirc-remotes.sourceforge.net/remotes-table.html サポートしているハードウェアの公式リスト]
* [https://github.com/graysky2/streamzap Linux Streamzap config files]