Bog BOS: Использование пульта ДУ в Linux: Lirc
Пакет Lirc позволяет использовать пульт ДУ для управления операционной системой Linux и прикладными программами. В качестве пульта ДУ можно использовать как самодельные устройства (на сайте даются рекомендации по их изготовлению), так и промышленно изготавливаемые ИК передатчики. В частности, я использую пульт ДУ и ИК приёмник от ТВ тюнера AVerMedia TVPhone98 w/VCR и ТВ тюнера AverMedia AVerTV Studio 307. Пакет также позволяет использовать оборудование для передачи ИК сигналов.
- драйверы различных устройств (модули ядра)
- демон lircd, преобразующий ИК сигналы, полученные от драйвера, в стандартные сообщения, которые прикладные программы могут получить через сокет
- демон lircmd, получающий сообщения от lircd и имитирующий мышку в X Windows
- программы для управления приложениями, которые не имеют прямого интерфейса с lircd
- irexec — запуск программ по нажатию кнопки ДУ
- irxevent — посылка X Windows сообщения по нажатию кнопки ДУ
- irpty — псевдотерминал, запускает программу и имитирует нажатие клавиш клавиатуры
код число-повторений имя-клавиши имя-пульта-ДУ
- —nodaemon (отладочная печать, не уходить в фоновый режим)
- —permission=mode (0666; права доступа к сокету при его создании, если файл уже существует в момент запуска, то права доступа не изменяются)
- —driver=имя-драйвера (полный список имён можно получить запустив lircd с ключом «-H help»)
- —device=имя-файла (/dev/lirc)
- —listen=порт (8765; слушать сетевой порт)
- —connect=хост[:порт] (использовать сервер lircd на другом хосте)
- —output=имя-сокета (/dev/lircd)
- —pidfile=имя-файла (/var/run/lircd.pid)
- —logfile=имя-файла (syslog или /var/log/lircd в зависимости от параметров сборки)
Сервер lircmd получает сообщения от lircd и имитирует мышку типа MouseSystems, IntelliMouse или IMPS/2. Файл настройки — /etc/lircmd.conf. Ключ —nodaemon позволяет отлаживать работу сервера. Сообщения об ошибках выводятся на syslog.
- установить драйверы для AverMedia AVerTV Studio 307 (модуль saa7134 и пр.) и обеспечить их загрузку (в частности, saa7134 подгружает модуль ir_common:
saa7134[0]: registered input device for IR
cat /proc/bus/input/devices . I: Bus=0001 Vendor=1461 Product=9715 Version=0001 N: Name="saa7134 IR (Avermedia AVerTV St" P: Phys=pci-0000:02:02.0/ir0 H: Handlers=kbd event2 B: EV=100003 B: KEY=40fc310 82140000 0 0 0 0 2048000 180 4001 9e0000 7bb80 0 0 .
LIRCD_OPTIONS="-H dev/input -d /dev/input/event2"
chkconfig --level 345 lirc[d] on
- для моего пульта ДУ требуется предварительно установить, настроить и загрузить драйверы v4l и bttv
- скачать и развернуть архив
- при сборке пакета создаются модули ядра (непонятно зачем, если все непосредственное взаимодействие с аппаратурой производится драйверами btttv и i2c), поэтому ядро необходимо подготовить для сборки
- cd /usr/src/linux-2.4
- make distclean (может достаточно make mrproper?)
- make menuconfig (сразу выйти с сохранением)
- make dep
- make bzImage (warning: kernel is too big for standalone boot from floppy, но я и не собираюсь его устанавливать, но если ядро не собрать, то модуль потом не загружается)
- make modules (не компилируется drivers/addon/cipe, убрал ее и поменял drivers/addon/Makefile)
- Driver configuration -> TV card -> AverMedia TV card (TVCapture 98, TVPhone98; card 13/41)
- Software configuration -> Compile tools for X-Windows
- Save configuration & run configure
- /lib/modules/2.4.18-14/misc/lirc_dev.o
- /lib/modules/2.4.18-14/misc/lirc_gpio.o
- /dev/lirc (char 61, 0)
- /dev/lircd (named pipe)
- /dev/lircm (named pipe)
- /usr/local/sbin: lircd, lircmd
- /etc/lircd.conf (из remotes/avermedia/lircd.conf.avermedia98)
- /etc/lircmd.conf (из remotes/avermedia/lircmd.conf.avermedia98)
- /usr/local/lib: liblirc_client.a, liblirc_client.so.0.0.0, liblirc_client.so.0, liblirc_client.so, liblirc_client.la
- /usr/local/bin: irw, irpty, irexec, ircat, mode2, rc, irxevent, xmode2, irrecord
- /usr/local/include/lirc/lirc_client.h
- /usr/local/man/man1: irexec.1, ircat.1, irpty.1, irrecord.1, irw.1, irxevent.1, mode2.1, smode2.1, xmode2.1, rc.1
- /usr/local/man/man8: lircd.8, lircmd.8
Для FC3 и AverMedia AVerTV Studio 307 дополнительных модулей (кроме saa7134 и ir_common) не нужно.
- alias char-major-81 bttv # загрузка модуля для AverMedia TVPhone98
- alias char-major-89 i2c-dev # управление тюнером и ИК приемником через модуль bttv
- alias char-major-61 lirc_gpio # аппаратная часть lirc
- install lirc_dev insmod -f lirc_dev # т.к. собранное ядро я не стал устанавливать, то приходится бороться с разницей версий модуля и ядра
- install lirc_gpio insmod -f lirc_gpio # аналогично
- debug
- card — номер TV карты
- minor — младший номер char-устройства /dev/lirc (старший — 61)
- gpio_mask — маска для извлечения полезных значений из GPIO (0 — модуль автомагически распознает тип ТВ карты и все остальные параметры)
- gpio_lock_mask
- gpio_xor_mask
- soft_gap — минимальный промежуток в мс между сканкодами (0; 0 — отключение проверки)
- sample_rate — сколько раз в секунду опрашивать GPIO (10; 0 — использовать прерывания вместо опроса)
Для AverMedia TVPhone98 (хотя все настраивается автоматически)
lirc_gpio gpio_mask=0xf88000 gpio_lock_mask=0x10000 gpio_xor_mask=0x10000 soft_gap=0 sample_rate=10
Модуль lirc_dev имеет только параметр debug.
- запускаем /usr/local/sbin/lircd (это демон, журнал в /var/log/lircd)
- запускаем irw и жмем кнопки на пульте ДУ, на терминал должны выводиться названия клавиш
Настройка lircd производится с помощью файла /etc/lircd.conf (лучше не трогать без нужды ;).
Настройка lircmd производится с помощью файла /etc/lircmd.conf (я его удалил, чтобы lircmd не запускался совсем).
Чтобы обеспечить автоматический запуск lircd (и, если нужно, lircmd) копируем /etc/init.d/lircd из lirc-0.6.5-fr3.i386.rpm в /etc/rc.d/init.d (поправить с учетом /usr/local/sbin). Затем добавляем lircd в список сервисов:
/sbin/chkconfig --add lircd /sbin/chkconfig --level 2345 lircd on
Запускаем lircd (и lircmd) в первый раз вручную (при следующей загрузке это произойдет автоматически):
- TVPhone98: POWER, TV/FM, CD, TELETEXT, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, VIDEO, AUDIO, FULLSCREEN, PREVIEW, DISPLAY, LOOP, MUTE, AUTOSCAN, FREEZE, CAPTURE, PLAY, RECORD, PAUSE, STOP, YELLOW, RED, VOL_DOWN, VOL_UP
- TVPhone98_ext: BLUE, GREEN, CH_DOWN, CH_UP
- AverTV_307: TV, CD, TELETEXT, POWER, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, VIDEO, AUDIO, FULLSCREEN, DISPLAY, LOOP, PREVIEW, AUTOSCAN, FREEZE, CAPTURE, MUTE, RECORD, PAUSE, STOP, PLAY, RED, VOLDOWN, VOLUP, YELLOW, GREEN, CHDOWN, CHUP, BLUE
Для доступа к /dev/lircd большинство приложений использует входящую в состав пакета библиотеку liblirc_client. Так как в состав библиотеки входят подпрограммы разбора файлов конфигурации, то большинство приложений используют для настройки интерфейса с пультом ДУ файлы одного формата, точнее 1 файл. По умолчанию, этот файл называется ~/.lircrc, но приложение может позволять задавать отдельный файл конфигурации.
Файл конфигурации состоит из блоков строк, заключенных между скобками begin и end. Директива include вставляет содержимое указанного файла. После запуска каждое приложение находится с точки зрения библиотеки liblirc_client в основном режиме, при обработке очередного блока приложение может перейти в указанный в нем поименованный режим. Блоки, описывающие поведение программы в поименованном режиме, заключаются в файле конфигурации в скобки
begin имя-режима begin . end . end имя-режима
- prog = имя программы, к которой относится данный блок
- remote = имя приемника (по умолчанию — *, т.е. любой)
- button = имя клавиши
- repeat = число (что делать, если клавиша нажата несколько раз; по умолчанию — 0, т.е. игнорировать повторы, иначе учитывать каждое n-е нажатие)
- delay = число (по умолчанию — 0; сколько повторений пропустить прежде чем начать обработку директивы repeat)
- config = строка, передаваемая приложению (если задано несколько директив config, то значение каждой строки передается приложению по очереди при нажатии той же клавиши; непечатные символы записываются как в C — \n или \xFF)
- mode = переход в указанный режим (если имя режима совпадает с именем приложения, то оно переходит в данный режим при запуске; действия по переключениям режимов выполняются для всех клиентских программ независимо от значения prog (и похоже, что независимо от текущего режима); все приложения рекомендуется запускать одновременно, чтобы избежать рассогласования режимов)
- flags =
- startup_mode (при запуске приложение сразу переходит в указанный в директиве режим)
- mode (покинуть режим; только для блоков внутри поименованного режима)
- once (только в сочетании с директивой mode; строка config передается приложению только при входе и выходе из режима)
- quit (прекратить разбор блоков)
В одном блоке может быть задана последовательность директив remote и button, в этом случае для передачи строки приложению требуется последовательное нажатие указанных кнопок (удобно для задания пароля для poweroff ;).
Если приложение может самостоятельно обрабатывать команды ДУ (mplayer, xine, xawtv, tvtime), то для него задаются отдельные блоки в конфигурационном файле:
begin prog = mplayer button = FULLSCREEN config = vo_fullscreen end
Если приложение может управляться событиями X Windows, то интерфейс между Lirc и приложением осуществляется с помощью утилиты irxevent (в качестве параметра может задаваться имя файла конфигурации; irxevent надо запускать в начале сеанса вместе с другими lirc-приложениями):
begin prog = irxevent button = POWER config = Key Escape xawtv end
- config = Button кнопка-мышкиxyимя-окна
- config = xy_Key xyклавишаимя-окна
Вместо имени окна (часто совпадает с именем приложения, см. также xwininfo и xev) можно указывать идентификатор окна или CurrentWindow или RootWindow. Некоторые программы (xterm, xemacs) требуется настраивать, чтобы они позволяли прием сообщений (при этом создается дырка в безопасности!):
XTerm.vt100.allowSendEvents: true
Если приложение управляется нажатием клавиш клавиатуры (консольная программа), то ею можно управлять с помощью утилиты irpty (в данном случае для каждого приложения необходим отдельный файл конфигурации, утилита создает псевдотерминал):
irpty [--no-echo] [--ignore-eof ] [--non-interactive ] [--socket=имя-файла] \ конфигурационный-файл -- имя-программы параметры-программы
Запуск приложений по нажатию кнопок ДУ можно осуществлять с помощью утилиты irexec, для чего надо вставить в скрипт инициализации сеанса ( .bash_profile? ):
irexec --daemon [имя-файла-конфигурации]
Перед этим в ~/.lircrc надо записать:
begin prog = irexec button = VIDEO mode = mplayer config = gmplayer 1>/dev/null 2>/dev/null & flags = once end begin prog = irexec button = TV/FM config = xawtv -geometry 768x576 >/dev/null & mode = xawtv flags= once end begin xawtv begin prog = irxevent button = POWER config = Key Escape xawtv end end xawtv begin mplayer begin prog = mplayer button = FULLSCREEN config = vo_fullscreen end end mplayer
irexec можно также использовать для управления приложениями, имеющими вспомогательные управляющие программы:
begin prog = irexec button = power config = xawtv-remote quit flags = mode end
Bog BOS: Использование пульта ДУ в Linux: Lirc