irattach - привязка стека Linux-IrDA к порту IrDA
НАЗВАНИЕ
irattach − привязка стека Linux−IrDA к порту IrDA
ОБЗОР
irattach [ <устройство> ] [ −s ] [ −d брелок ] [ −v ] [ −h ]
ОПИСАНИЕ
irattach привязывает стек Linux−IrDA к порту IrDA. Программа выполняет низкоуровневую настройку стека
Linux−IrDA в ядре. Обычно этот шаг необходим перед тем как вы (или приложения) сможете воспользоваться верхним слоем стека IrDA.
Команда irattach загружает необходимый драйвер Linux−IrDA, который настраивает оборудование IrDA, и
настраивает стек IrDA для взаимодействия с новым портом IrDA. Несколько портов IrDA могут быть задействованы с помощью нескольких команд irattach.
irattach по умолчанию использует драйвер irtty, который подсоединяется к терминальной подсистеме
Linux и использует стандартный последовательный драйвер Linux. Это работает достаточно хорошо на большинстве машин и конфигураций, но ограничивает скорость
передачи до 115200 бит в секунду (IrDA в режиме SIR). Этот режим позволяет работать с большинством оборудования FIR (как оказалось, в ноутбуках этот режим
предоставляет эмуляцию последовательного порта) и с большинством последовательных брелоков (при предоставлении брелоком правильного типа), позволяя сделать
безопасный выбор. Однако, брелоки USB и несколько адаптеров FIR не поддерживают эмуляцию последовательного порта и не могут использоваться с драйвером
irtty.
irattach также может использовать один из драйверов FIR для Linux (включая драйверы брелоков USB) вместо
драйвера irtty. Большинство драйверов FIR требуют правильной настройки параметров модуля (это описано далее). Драйверы FIR позволяют вам использовать
более высокие скорости передачи данных (обычно до 4 мегабит в секунду). В общем, поддержка FIR в Linux не настолько стабильная и зрелая, чтобы можно было
обойтись без документации и затрат времени.
irattach нужно запускать от пользователя root или установить атрибут setuid для пользователя root, поскольку
требуются привилегии пользователя root. Если вы собрали стек IrDA в виде модулей (рекомендуется), то вам нужно отредактировать файл /etc/modules.conf.
Обратитесь к Infrared−HOWTO за подробностями.
ОПЦИИ
<устройство>: Название терминала или интерфейса IrDA или драйвера IrDA. irattach принимает
решение воспользоваться драйвером irtty или одним из драйверов FIR, основываясь на этом аргументе.
•
Название терминала: Это последовательный порт, для настройки с помощью драйвера irtty, например /dev/ttyS0. irattach
воспользуется драйвером irtty, поэтому порт будет доступен только режим SIR. Вам нужно проверить настройку вашего последовательного порта или BIOS,
чтобы узнать какой последовательный порт является портом IrDA. Его и нужно передать в irattach.
•
Название интерфейса: Это имя устройства интерфейса IrDA, например irda0. irattach воспользуется одним из драйверов FIR (включая драйверы
брелоков USB). Выбранный драйвер FIR должен быть загружен до вызова irattach, или для устройства должен быть установлен подходящий псевдоним в
/etc/modules.conf.
•
Название модуля: Это название модуля драйвера FIR, например nsc−ircc (смотри список ниже). Будут настроены все новые интерфейсы IrDA,
созданные после загрузки модуля, поэтому они не будут работать, если модуль уже загружен. Эта возможность всё ещё является экспериментальной.
−s: Запускает обнаружение удалённого устройства IrDA (отметим, что опция вида "−s 1" больше не
поддерживается).
−v: Показать информацию о версии (это также произойдёт, если опции не указаны).
−h: Показать справочную информацию.
−d брелок: Подключить дополнительный драйвер брелока к порту IrDA.
Вам необходим драйвер брелока, если у вас есть инфракрасное устройство, которое присоединяется к последовательному
порту вашего компьютера (обычный 9−игольчатый разъём последовательного порта). Эти устройства называются брелоками (dongles) и в настоящее время используются
любым драйвером SIR (IrTTY или irport). Эта опция не совместима с драйверами FIR и работает только с драйверами irtty и irport.
В настоящее время известны следующие (последовательные) брелоки:
•
esi Extended Systems JetEye PC ESI−9680
•
tekram Брелок Tekram IrMate IR−210B
•
actisys Брелок ACTiSYS IR−220L
•
actisys+ Брелок ACTiSYS IR−220L+
•
girbil Брелок Greenwich GIrBIL
•
litelink Брелок Parallax LiteLink и Extended Systems JetEye PC ESI−9680B
•
airport Без описания.
•
old_belkin Брелок Belkin (old) SmartBeam или любой брелок, поддерживающий только скорость передачи 9600 бит в секунду
•
ep7211 Драйвер инфракрасного порта процессора Cirrus Logic EP7211 (основанного на ARM)
•
mcp2120 Брелоки на основе MCP2120 (Microchip)
•
act200l Брелоки ACTiSYS Ir−200L
•
ma600 Брелоки Mobile Action ma600
•
toim3232 Брелоки на основе Vishay/Temic TOIM3232 и TOIM4232
МОДУЛИ ДРАЙВЕРА FIR
Если вы один из счастливчиков, имеющих набор микросхем FIR или брелок USB, который поддерживается одним из
драйверов Linux−IrDA, для их настройки вы можете воспользоваться irattach с названием интерфейса порта IrDA. Вам нужно настроить соответствующим образом
/etc/modules.conf, по крайней мере нужно создать псевдоним irda0 для названия драйвера, или заранее загрузить драйвер вручную.
Вам не настолько уж и необходимо использовать irattach для драйверов FIR, вы можете воспользоваться
modprobe для загрузки драйвера, ifconfig для активации интерфейса и задать необходимые переменные ядра вручную с помощью sysctl, но
irattach позволяет сделать это более удобным способом.
Конечно, вам нужно знать как драйвер FIR влияет на ваше оборудование. Вы можете воспользоваться findchip,
чтобы получить информацию о микросхеме FIR. Если это не поможет, Infrared−HOWTO подскажет вам другие способы получения этой информации.
А также, вам скорее всего нужно будет настраивать драйвер последовательного порта Linux для игнорирования
порта IrDA, иначе оба драйвера будут конфликтовать. Обычно это делается с помощью setserial /dev/ttySx uart none.
В настоящее время известны следующие драйверы FIR:
•
ali−ircc Драйвер контроллера ALi FIR для ALi M5123 (опции: io, irq, dma). Этот драйвер поддерживает скорости SIR, MIR и FIR
(4 мегабита в секунду). Этот набор микросхем используется, например, в:
Контроллере ALi M5123 FIR встроенном в южные мосты ALi M1543C, M1535, M1535D, M1535+, M1535D.
•
irda−usb Драйвер устройства IrDA−USB, для устройств/брелоков USB, совместимых с официальной спецификацией класса IrDA−USB.
Замечание: USB 2.0 ещё не проверен. (опции: qos_mtt_bits − целое, описание − "Минимальное время переключения"). Он используется, например, для:
ACTiSYS ACT−IR2000U
KC Technology KC−180
Extended Systems XTNDAccess ESI−9685
Отметим, что существует другой драйвер USB для этих устройств, который называется ir−usb. Он НЕ совместим со
стеком IrDA и конфликтует с irda−usb. Поскольку он всегда загружается первым, вы можете удалить ir−usb полностью.
Устройства, основанные на микросхеме SigmaTel не совместимы со спецификацией класса IrDA−USB и поэтому не
поддерживаются этим драйвером.
•
nsc−ircc Драйвер устройства NSC IrDA (опции: io, irq, dma, dongle_id, qos_mtt_bits). Этот набор микросхем используется,
например, в:
IBM ThinkPad dongle_id=0x09
HP OmniBook 6000 dongle_id=0x08
•
sa1100_ir Инфракрасный драйвер для устройств, основанных на встраиваемом микропроцессоре StrongARM SA1100 (опции:
power_level, tx_lpm). Этот драйвер может поддерживать FIR на устройствах, которые его поддерживают. Этот набор микросхем используется, например, в:
Samsung YOPY, COMPAQ iPAQ, SHARP Zaurus SL5000/5500
•
smc−ircc Драйвер контроллера SMC IrCC (опции: ircc_dma, ircc_irq). Этот набор микросхем используется, например, в:
Fujitsu−Siemens Lifebook 635t Sony PCG−505TX
•
w83977af_ir Драйвер устройства Winbond W83977AF IrDA (опции: io, irq, qos_mtt_bits). Этот набор микросхем используется,
например, в:
Corel NetWinder
•
toshoboe Драйвер устройства Toshiba OBOE IrDA, поддерживает набор микросхем Toshiba Type−O IR. (опции: max_baud). Этот набор
микросхем используется, например, в:
Toshiba Libretto 100CT. и во многих более старых ноутбуках Toshiba.
•
donauboe Это новая версия toshoboe и она имеет более хорошую поддержку FIR и совместима с микросхемой Donauoboe
http://libxg.free.fr/libirda.html. Этот набор микросхем используется, например, в:
Toshiba Libretto 100CT., Tecra 8100, Portege 7020 и многих других ноутбуках Toshiba.
•
vlsi_ir Драйвер устройства VLSI 82C147 SIR/MIR/FIR. Этот набор микросхем используется, например, в:
HP Omnibook 800
(опции: ..).
•
clksrc − целое, описание − "выбор источника времени"
•
ringsize − массив целых (минимум = 1, максимум = 2), описание − "размер дескриптора кольца tx, rx"
•
sirpulse − целое, описание − "пульс sir с подстройкой"
•
mtt_bits − целое, описание − "битовое поле IrLAP представляющее минимальное−время−переключения"
ПРИМЕРЫ
Присоединить стек IrDA ко второму последовательному порту (встроенный порт IrDA, использующий эмуляцию) и запустить
обнаружение:
•
irattach /dev/ttyS1 −s
Присоединить стек IrDA к первому последовательному порту, на котором у вас подключен внешний последовательный
брелок ACTiSYS и запустить обнаружение:
•
irattach /dev/ttyS0 −d actisys+ −s
Присоединить стек IrDA к первому брелоку IrDA−USB и запустить обнаружение:
•
modprobe irda−usb ; irattach irda0 −s
Присоединить стек IrDA к драйверу устройства NSC FIR (4 мегабита в секунду) на ноутбуке Thinkpad:
•
modprobe nsc−ircc dongle_id=0x9 ; irattach irda0 −s.
Присоединить стек IrDA к драйверу устройства NSC FIR (4 мегабита в секунду) на ноутбуке Thinkpad:
•
Присоединить стек IrDA к драйверу устройства NSC FIR (4 мегабита в секунду) на ноутбуке Thinkpad:
Это подразумевает, что вы добавили в файл /etc/modules.conf следующие записи:
options nsc−ircc dongle_id=0x09
alias irda0 nsc−ircc
ПРЕДОСТЕРЕЖЕНИЯ
Следующие подсказки − это очень короткое введение в настройку Linux/IrDA. Если это не поможет, прочитайте учебник
Linux/IrDA и/или Infrared−HOWTO. Перед настройкой Linux/IrDA разберитесь, что вы хотите настроить: SIR или FIR. Рекомендуется сначала попробовать SIR, если
ваше устройство совместимо с SIR (например, брелок USB).
Для получения "последовательного" устройства SIR посмотрите в BIOS. Затем запустите dmesg | grep tty чтобы
найти терминальные устройства, поддерживаемые вашей машиной. Теперь попробуйте выбрать одно из них, которое возможно является устройством IrDA и воспользуйтесь
irattach /dev/ttySx −s.
Если вам не удалось подключить SIR (что происходит в редких случаях) вы можете попробовать FIR. Сначала посмотрите
в BIOS. Затем запустите findchip для получения информации о микросхеме управляющей IrDA. Воспользуйтесь setserial /dev/ttySx uart none для
избежания конфликтов с последовательным драйвером. Замечание: не используйте setserial, если вы настроили SIR. Теперь можно воспользоваться
irattach.
Наконец, irdadump должен показать по меньшей мере ваш компьютер. Если это не так, начните сначала.
Эта страница руководства затрагивает только низкий уровень стека IrDA (порта IrDA и драйверам IrDA). После
выполнения этого шага, вам потребуется установить ваше любимое приложение для доступа к высокому уровню стека IrDA (через IrCOMM, IrLPT, IrNET, IrLAN или
IrSOCK), которое описано в соответствующей документации.
Эта страница руководства не описывает использование драйвера irport. Драйвер irport поддерживает то же
оборудование, что и драйвер irtty, но настраивается как драйвер FIR.
ДИАГНОСТИКА
В настоящий момент этот раздел содержит только сообщения об ошибках из исходного кода.
""ioctl(TIOCGETD): %m""
""irattach: tty: set_disc(%d): %s""
""tcsetattr: %m""
""Failed to open %s: %m" (Не удалось открыть %s: %m)"
""Couldn’t get device fd flags: %m" (Не могу получить флаги дескриптора файла устройства: %m)"
""Couldn’t set device to non−blocking mode: %m" (Не могу перевести устройство в неблокирующий режим: %m)"
НЕИСПРАВНОСТИ
Нет.
СМОТРИ ТАКЖЕ
irattach(8), irdaping(8), irdadump(8), findchip(8), irpsion5(8), modprobe(8)
Проект Linux/IrDA http://irda.sourceforge.net −*− Учебник Linux/IrDA
http://www.hpl.hp.com/personal/Jean_Tourrilhes/IrDA/index.html −*− Рецепт инфракрасной связи (Infrared−HOWTO) http://tuxmobil.org/howtos.html −*− Обзор
поддерживаемых инфракрасных устройств (Infrared−Hardware−Survey ) http://tuxmobil.org/ir_misc.html
АВТОР
Эта страница руководства написана Вернером Хеусером (Werner Heuser) <tuxmobil.org>. Она основана на файлах
README из пакета irda−utils проекта Linux/IrDA и учебнике Linux/IrDA. Она была частично обновлена и изменена Джином Туррилхесом (Jean Tourrilhes)
<jt@hpl.hp.com>.
АВТОР ПЕРЕВОДА
Перевод на русский язык выполнил Владимир Ступин <vladimir@stupin.su>.
АВТОРСКОЕ ПРАВО
Copyright © 2001 Вернер Хеусер (Werner Heuser) Copyright © 2002 Джин Туррилхес (Jean Tourrilhes)
Разрешается копирование, распространение и/или изменение этого документа в соответствии с лицензией на свободную
документацию GNU Free Documentation License (GFDL), версии 1.1 или любой более поздней версией, опубликованной Фондом Свободного Программного Обеспечения (Free
Software Foundation); без неизменных разделов, без текстов на обложке или вкладыше.
