Linux IR HOWTO

Werner Heuser, < wehe@snafu.de >

v2.8, 20 September 1999


An introduction to Linux and infrared devices and how to use the software provided by the Linux/IrDA project. This package uses IrDA(TM) compliant standards. IrDA(TM) is an industrial standard for infrared wireless communication, and most laptops made after January 1996 are equipped with an IrDA(TM) compliant infrared transceiver. Infrared ports let you communicate with printers, modems, fax machines, LANs, and other laptops. Speed ranges from 2400bps to 4Mbps. The Linux/IrDA stack supports IrLAP, IrLMP, IrIAS, IrIAP, IrLPT, IrCOMM, IrOBEX, and IrLAN. Several of the protocols are implemented as both clients and servers. There is also support for multiple IrLAP connections, via several IrDA(TM) devices at once. The Linux/IrDA project started at the end of 1997 and its status is still experimental, so please don't expect every feature working straight. AFAIK Linux/IrDA is the _only_ open source IrDA implementation currently available. Remote Control (RC) via infrared is not the aim of the project, though partly treated in this HOWTO.

1. Introduction

2. Prerequisites

3. Kernel

4. Linux/IrDA-Utils

5. Configuration

6. Specific Connections and IrDA - Protocols

7. Hardware Supported by Linux/IrDA

8. Graphical User Interface (GUI)

9. Power Saving

10. Beyond IrDA

11. Troubleshooting, Mailing List

12. IrDA Network Neighborhood

13. Linux/IrDA and APM

14. Known Bugs

15. FAQ

16. Infrared Remote Control

17. Infrared and Eye Safety

18. Credits

19. Revision History

20. Copyright and Disclaimer

21. Appendix A - Configuration Script

22. Appendix B - Serial Infrared Port Sniffers

23. Appendix C - User space application for Psion 5 Palmtop Computers: psion.c


1. Introduction

Better red, than dead. - Unknown AuthorEss

IrDA support for Linux started at the end of 1997. For 2.0.x kernels Linux/IrDA support worked in a totally other way and is no longer supported by the Linux/IrDA project. Since 2.1.131 and 2.2.0 Linux/IrDA is part of the kernel. Please note that the status of the project just changed from experimental to stable with 2.2.10 kernels.

Companies and developers which are interested in joining these efforts should contact the at Linux/IrDA Project or me at < wehe@snafu.de >.

Some history about Linux/IrDA. The project started at the end of 1997 with the name Linux/IrDA. Due to some troubles with the name IrDA, which is trademarked by the Infrared Data Association <idx>IrDA</idx>, the name was changed to Linux/IR. At the end of 1998 the the relationship between both became better and the name was changed to Linux/IrDA again. Since February 1999 the project is an official member of IrDA .

This document is based on the "How to use" part of the Linux/IrDA project homepage. I also included material provided by the Linux/IrDA core team, the Linux/IrDA mailing list and other sources.

The document is included in the LINUX DOCUMENTATION PROJECT.

The latest version of this document is available at LiLAC - Linux with Laptop Computers .

Mathieu Arnold <arn_mat@club-internet.fr> provides the IR-HOWTO in French .

The latest kernel I used is 2.2.3 and the latest irda-utils version is 0.8.8 .

I tried to check all information but I don't have all the necessary infrared hardware yet, so if something doesn't work for you, please don't blame me.

Please feel free to contact me for comments or questions about the HOWTO. I know this material is not finished or perfect, but I hope you find it useful anyway. For other questions and current information about Linux/IrDA please ask in the Linux/IrDA mailing list as explained below.

<Werner Heuser>


2. Prerequisites

  1. BIOS

    - Make sure your infrared port is enabled in the BIOS and check what interrupt and port address it uses. With some laptops it seems necessary to have Window$x installed to be able to set BIOS parameters.

  2. Docking Station

    I have got reports, that connected to a docking station the infrared port was disabled.

  3. Infrared Controller Chip

    - Make sure your infrared port is detected by the Linux kernel. For detailed information see the "Hardware Survey" section below.

  4. modutils

    - Make sure you use modutils 2.1.x by insmod --version. I use version 2.1.121.

  5. Shared Library

    - The shared library glibc2 aka libc6 is recommended. There are also efforts to use glibc2.1, you may get this at ftp://ftp.funet.fi/pub/gnu/funet/ .

    - In some files you maybe have to change #include <net/if_packet.h> to #include <linux/if_packet.h> to get things to compile. This means using kernel headers instead of glibc headers. Please consult the mailing list archive, if your are interested in further information.

    - But libc.so.5 should work, too.

    - I am not sure wether you need the zlib library if you use the data compression features.

  6. IrLAN The latest release of net-tools (package netbase for Debian/GNU-Linux) is recommended, if you want to use an IrLAN connection. It's available from: ftp://ftp.netwinder.org/users/p/philb/net-tools/, http://www.tazenda.demon.co.uk/phil/net-tools/ and shortly from ftp://ftp.cs-ipv6.lancs.ac.uk/pub/Code/Linux/Net_Tools/ .

  7. Graphical User Interface (GUI)

    Currently there are two graphical user interfaces for Linux/IrDA under development one for KDE and one for GNOME. See GUI chapter below. For the GNOME application you will need the Perl-GTK+ module and Python. You must also install all the development packages. To run Linux/IrDA I recommend to check the command line tools first, because the GUIs don't seem to be finished yet.

  8. Security

    - Most important, you must sync your disks!!! Maybe you have to reboot your machine. Have you read the disclaimer?

  9. Miscellaneous

    - Other useful progs: APSFILTER, EZ-Magic, MagicFilter or something similar for the printer configuration.


3. Kernel

Please read the Kernel-HOWTO to get more information about the compilation process. You'll find the Linux/IrDA code in:

/usr/src/linux/net/irda (protocol stuff)

/usr/src/linux/drivers/net/irda (device drivers)

/usr/src/linux/include/net/irda (header files)

3.1 General Parameters

- Make sure you use kernel 2.2.x sources. If unsure about your kernel version try uname -r.

- Get the latest kernel patch from the Linux/IrDA project http://www.cs.uit.no/linux-irda/snapshots/. Or from the Alan Cox kernel series at ftp.linux.org.uk/pub/linux/alan/2.2/ . Put it into /usr/src or where else your kernel sources live and apply something like (replace patch-2_2.0-irdaXXX with the actual file name):


cd /usr/src
tar xvzf patch-2_2.0-irdaXXX.tar.gz
cd linux
patch -p1 -l < ../patch-2_2.0-irdaXXX 

- Experimental support has to be enabled CONFIG_EXPERIMENTAL.

- Enable sysctl in "General Setup" CONFIG_SYSCTL.

- You should have proc file system support CONFIG_PROC_FS.

- Also serial support for the SIR features CONFIG_SERIAL.

- I am not sure wether there has to be printer support for using a printer with Linux/IrDA CONFIG_PRINTER. But I assume this feature is not necessary.

- Networking support _must_ be enabled CONFIG_NET.

- Make sure you have module support CONFIG_MODULES in your kernel! Test it e.g. with lsmod.

- Also kerneld support CONFIG_KERNELD. But kmod (CONFIG_KMOD) also works. A monolithic kernel seems to work, too. But modules are highly recommended.

- To use irdadump you probably have to set CONFIG_PACKET.

If you only apply the Linux/IrDA patch, you should not have to do a make clean, so that should save you some time. I suggest you do something like this:


make dep && make all && make modules && make install && make modules_install

If you get really strange errors, then try to rebuild from scratch after a make clean.

3.2 IrDA Specific Parameters

The following is my draft for ../linux-2.2.3/Documentation/Configure.help, parts are from Dag Brattli and Andreas Butz. Please consult the latest available kernel documentation for current information and new drivers.

IrDA subsystem support

CONFIG_IRDA

IrDA(TM) is an industrial standard for infrared wireless communication. Infrared ports let you communicate with printers, modems, fax machines, LANs, and laptops. Speed ranges from 2400bps to 4Mbps. To use this features you need the irda_utils provided by the Linux/IrDA project http://www.cs.uit.no/linux-irda/ Further information you may find there and in the Linux/IR-HOWTO at http://www.snafu.de/~wehe/index_li.html Currently it is recommended to build IrDA support as modules only. Please see Documentation/modules.txt. Please note the status of Linux/IrDA is still experimental.

IrDA protocols

IrDA protocol options

CONFIG_IRDA_OPTIONS

You may define some IrDA protocol options.

IrDA compressors

CONFIG_IRDA_COMPRESSION

You may use the compression methods BZIP2 and BSD. These are not IrDA standard. This will allow two linux boxes to handshake compression. It should be compatible with other IrDA devices, although communication will not be compressed then.

Infrared-port device drivers

Three sorts of low level infrared drivers are available: serial, dongle and FIR. They will show up in /proc/net/dev (irda0) after initialisation.

IrTTY (uses serial driver)

Most IrDA chips support StandardInfraRed (SIR), which works up to 115200bps and emulates a serial port (16550A UART). On many laptops this port is detected by the serial support of the kernel, see ``dmesg''. IrTTY connects the Linux/IrDA services to this port. - You should say Y here.

Dongle support

CONFIG_DONGLE

Currently four dongles (infrared adapters for the serial port) are supported. The dongle is an infrared device which may be connected to serial port, if you don't have built-in infrared support for your machine. If you use a dongle together with a laptop you maybe have to disable the IrDA support in the BIOS.

FIR support

FastInfraredSupport (FIR) needs a specific controller chip, which supports up to 4Mps. - Just say Y


4. Linux/IrDA-Utils

4.1 Compilation

A recommendation from Bjoern Hansson <Bjorn.Hansson@signal.uu.se>: If make depend fails on stdef.h and stdarg.h just add -I/usr/lib/gcc-lib/i586-linux/egcs-2.90.29/include/ or the according path for your system to the SYS_INCLUDES line in Makefile.

To compile irdadump and irdaping (which are not necessary to get Linux/IrDA to work) you probably to tweek the source a little:

Dag Brattli: " The problem is that I'm including kernel header files which conflicts with the libc header files. So why do I need to include kernel header files? Well, the libc/glibc header files does not know that much about IrDA (yet). The reason is just that IrDA is quite new. I could have just defined the stuff in the program itself, but then people would be able to compile the stuff even if the definitions had changed in the kernel. I think its better that you get a compile error than some possible strange behaviour. If you don't want to wait until I figure out how to solve this stuff, you can just remove the linux header files and define the constants in your program yourself:


#define PF_IRDA          23
#define AF_IRDA          PF_IRDA

#define ARPHRD_IRDA      783
#define ETH_P_IRDA       0x0017

All the stuff above should not be changed, so it is probably safe to just hardcode them. I'll change the programs so they just includes the normal header files, and then defines these constants only if the header files didn't know about them. It should however be safe to include linux/irda.h ."

Though I never succeeded to compile all utilities without errors, I recommend to use at least the latest packages of libtool, m4, autoconf, and automake if you want to compile irdadump, irdaping, etc.

4.2 Precompiled Packages

NOKUBI Takatsugu provides an unofficial irda-utils Debian package (needs libc2.1). Efforts are on the way to include this package into the next Debian release, codename Potato.

4.3 Contents of Linux/IrDA-Utils

irmanager

The irmanager is user-space daemon that is inspired and quite similar to the cardmgr used in the PCMCIA distribution. For example, if IrLMP discovers a remote device with IrLAN provider capabilities and no local IrLAN client has registred, then IrLMP will send an event to the IrManager and make it modprobe the module required. When application level clients are ready for communication and user-space configuration, they can also notify IrManager about this, so that it can execute the right script. For example will IrLAN send the event EVENT_IRLAN_START when the data channel is ready for exchanging Ethernet frames. When IrManager receives this event, it will execute /etc/irda/network start <devname> to configure the network interface. If you use the RedHat variant of it, it will in turn execute /sbin/ifup<devname> .

irattach

Usually irattach is started by irmanager. irattach attaches an IrDA capable tty to the basic services of Linux/IrDA. If kerneld or kmod are running, the modules irda and irtty are loaded automatically, if not you have to load them by hand in that order. It is recommended to start irattach in the background. To stop irattach just kill the process.

load_misc

A Perl script which loads a Linux/IrDA module and builds the according device in /dev using mknod.

/etc/irda

Configuration files, e.g. contains the serial port of the SIR driver:


drivers
network
network.opts
obex

You should at least configure the IR driver drivers:


#! /bin/sh
#
# drivers
#
# Initialize and shutdown IrDA device drivers.
#
# This script should be invoked with two arguments. The first is the
# action to be taken, either "start", "stop", or "restart".
#

action=$1
device=$2

case "${action:?}" in
start)
    irattach /dev/ttyS2          # The third serial port is an IrDA port
    # irattach /dev/ttyS0 -d esi # Attach a ESI dongle to the first serial port
    # insmod pc87108             # If your machine as a pc87108 FIR chipset
    ;;
stop)
    killall irattach             # ... or something. Currently not used
    ;;
restart)
    /sbin/ifconfig ${device:?} down up
    ;;
esac

irdaping

This is a program similar to ping(8). It sends IrDA test frames (added some userdata which contains the frame number and the time the frame was sent). You can also change the size of the frame by using the -s option. You must supply an IrDA device address, and not an IP address. You have to be able to get that device address by some method irdadump?

Here is one output sample (pinging an ACTiSYS IR-100M):


dagbnb /home/dagb/linux/irda-utils/irdaping/ # ./irdaping 0xf7be8388 
IrDA ping (0xf7be8388): 32 bytes
32 bytes from 0xf7be8388: irda_seq=0 time=102.466003 ms.
32 bytes from 0xf7be8388: irda_seq=1 time=102.202003 ms.
32 bytes from 0xf7be8388: irda_seq=2 time=102.170998 ms.
32 bytes from 0xf7be8388: irda_seq=3 time=101.633003 ms.

4 packets received by filter

irdadump

One advantage of implementing IrDA device drivers as network device drivers is that you should be able to attach sniffers to the device (or actually the packet type). That way, it is possible to use a really handy utility called irdadump (instead of tcpdump). This will make debugging MUCH easier. Linux-2.2 implements the BPF (Berkeley Packet Filter), so its possible to filter out exactly the frames you want to see.

Note: You probably have to be root for using irdadump . CONFIG_PACKET has to be enabled in the kernel. If compiled as a module you might load the module manually. irdadump has been coverted into a library, so it can be used from GUI applications as well.

Here is a sample output of a small session between Linux and a Palm III. This log shows that the local irobex layer is not responding, so the Palm III sends a disc frame.


dagbnb /home/dagb/linux/irda-utils/irdadump/ # ./irdadump 

20:18:15.305711 xid:cmd:saddr=0x05c589 > daddr=0xffffffff,S=6,s=0
20:18:15.385597 xid:cmd:saddr=0x05c589 > daddr=0xffffffff,S=6,s=1
20:18:15.465568 xid:cmd:saddr=0x05c589 > daddr=0xffffffff,S=6,s=2
20:18:15.545953 xid:cmd:saddr=0x05c589 > daddr=0xffffffff,S=6,s=3
20:18:15.625574 xid:cmd:saddr=0x05c589 > daddr=0xffffffff,S=6,s=4
20:18:15.705575 xid:cmd:saddr=0x05c589 > daddr=0xffffffff,S=6,s=5
20:18:15.785601 xid:cmd:saddr=0x05c589 > daddr=0xffffffff,S=6,s=255,info=Linux
20:18:18.075526 xid:cmd:saddr=0xb50c14b > daddr=0xffffffff,S=6,s=0
20:18:18.225498 xid:cmd:saddr=0xb50c14b > daddr=0xffffffff,S=6,s=1
20:18:18.375495 xid:cmd:saddr=0xb50c14b > daddr=0xffffffff,S=6,s=2
20:18:18.526355 xid:cmd:saddr=0xb50c14b > daddr=0xffffffff,S=6,s=3
20:18:18.675614 xid:cmd:saddr=0xb50c14b > daddr=0xffffffff,S=6,s=4
20:18:18.676364 xid:rsp:saddr=0x05c589 > daddr=0xb50c14b,S=6,s=4
20:18:18.765506 xid:cmd:saddr=0xb50c14b > daddr=0xffffffff,S=6,s=5
20:18:18.927221 xid:cmd:saddr=0xb50c14b > daddr=0xffffffff,S=6,s=255,info=Palm III
20:18:18.975796 snrm:cmd,ca=0xfe,pf=1
20:18:18.976534 ua:rsp,ca=0x58,pf=1
20:18:18.977145 ua:rsp,ca=0x58,pf=1
20:18:19.585627 rr:rsp,ca=0x58,nr=0,pf=1
20:18:19.585810 rr:rsp,ca=0x58,nr=0,pf=1
20:18:19.606413 i:cmd,ca=0x58,nr=0,ns=0,pf=1
20:18:19.606582 rr:rsp,ca=0x58,nr=1,pf=1
20:18:19.627708 rr:cmd,ca=0x58,nr=0,pf=1
20:18:19.627871 i:rsp,ca=0x58,nr=1,ns=0,pf=1
20:18:19.650571 disc:cmd,ca=0x58,pf=1
20:18:19.650736 ua:rsp,ca=0x58,pf=1
20:18:21.165524 xid:cmd:saddr=0xb50c14b > daddr=0xffffffff,S=6,s=0
20:18:21.315608 xid:cmd:saddr=0xb50c14b > daddr=0xffffffff,S=6,s=1
20:18:21.315793 xid:rsp:saddr=0x05c589 > daddr=0xb50c14b,S=6,s=1
20:18:21.395499 xid:cmd:saddr=0xb50c14b > daddr=0xffffffff,S=6,s=2
20:18:21.545516 xid:cmd:saddr=0xb50c14b > daddr=0xffffffff,S=6,s=3
20:18:21.695500 xid:cmd:saddr=0xb50c14b > daddr=0xffffffff,S=6,s=4
20:18:21.845840 xid:cmd:saddr=0xb50c14b > daddr=0xffffffff,S=6,s=5
20:18:22.007222 xid:cmd:saddr=0xb50c14b > daddr=0xffffffff,S=6,s=255,info=Palm III
20:18:22.056143 snrm:cmd,ca=0xfe,pf=1
20:18:22.056310 ua:rsp,ca=0xc8,pf=1
20:18:22.056381 ua:rsp,ca=0xc8,pf=1

37 pacckets received by filter

gnobex

GNOME GUI for using the IrOBEX protocol, to connect to Palm III.

irkbd

Support for infrared keyboard (and mouse?) protocol IrKBD.

irdalib

Linux/IrDA library.

obex

Please compile irdalib before compiling obex. Contains irobex_test, irobex_receive and irobex_palm3 . And obex_tcp which makes it possible to use OBEX over TCP/IP.


5. Configuration

5.1 General Configuration

5.2 IrManager

Dag Brattli wrote: " IrManager [...].is a user-space daemon that is inspired and quite similar to the cardmgr used in the PCMCIA distribution.

The IrManager will receive events from the kernel level side of the protocol stack. When the IrManager receives an event it can execute shell commands and scripts, so I have added the /etc/irda directory which will contain such scripts. [...]

For example, if IrLMP discovers a remote device with IrLAN provider capabilities and no local IrLAN client has registered, then IrLMP will send an event to the IrManager and make it "modprobe" the module required. [...]

When application level clients are ready for communication and user-space configuration, they can also notify IrManager about this, so that it can execute the right script. For example IrLAN will send the event EVENT_IRLAN_START when the data channel is ready for exchanging Ethernet frames. When IrManager receives this event, it will execute /etc/irda/network start <devname> to configure the network interface. This network script is actually the same as used by the PCMCIA code and since I'm using the Redhat variant of it, it will in turn execute /sbin/ifup <devname>.

So by using the IrManager, I "only" have to do this when I start the stack:


irattach /dev/ttyS2 &
irmanager -d 1           # -d 1 means: start discovery process

and then when my laptop discovers the IrLAN provider (HP Netbeamer in my case) it will ask IrManager to load the module irlan_client. When the connection is up and ready, it will ask it to execute /etc/irda/network start eth0. When the connection is broken, it will again ask it to take down the interface using /etc/irda/network stop eth0.[...]

That's all to get it working if you are using Redhat. If you are using some other distribution which doesn't have /sbin/ifup, then you better copy /etc/pcmcia/network.opts to /etc/irda/network.opts or configure the file yourself.

If you want to use the IrLAN server, you will still have to modprobe irlan_server before you start the irmanager _without_ -d 1.

And just like the cardmgr, you will (if you want to) get the beeps when the connection is up and running and when it is disconnected!!!

I hope that we can add such scripts for all the other clients/services that need user level configuration. It would be really cool to have a /etc/irda/printer script for configuring IrDA(TM) capable printers. So if you get in range of an IrDA(TM) capable printer, then IrManager should load the irlpt_client module, and also configure the other stuff that needs to be done for using this printer.

I also hope that we can use the config file for configuring IrDA(TM) ports and device drivers. Something like:


Device Drivers
  module "irtty" script="irattach /dev/ttyS2"
  module "smc_ircc" irq=11 port=0x34f

So that IrManager can load and start all these when it is executed. In this way we would only have to start IrManager in /etc/rc.d/init.d/irda and the rest would be plug and play. There would be no need for manually starting programs and configuring devices. When irmanager receives the following events for a device <dev> it will currently do:

EVENT_IRLAN_START, start and configure the device using /sbin/ifup <dev>

EVENT_IRLAN_STOP, close the device using /sbin/ifdown <dev>

This can however be easily changed by the user, if this is not what is the prefered behaviour.

5.3 Low Level Drivers

There are three sorts of low level drivers: SIR, dongle and FIR. If the right driver is detected by the kernel you get a message like:


IrDA irda_device irda0 registered.

SIR

Dongle Connection - Infrared Adapters for the Serial Port

The currently supported dongles are the Extended Systems Inc. ESI-9680 JetEye, the Tekram IRmate 210B, the ACTiSYS IR220L and 220L+, the Greenwich GIrBIL. dongle.

Dag Brattli wrote (modified by wh): "To use dongles you have to do something like this:


modprobe tekram         # or esi or actisys
irmanager -d 1          # 
irattach -d tekram      # or -d esi or -d actisys

As you can see, you must still use the -d option with irattach since it is possible to have two serial ports using different dongles at the same time (so the tty you are binding must know which dongle it is supposed to use). So if you have two dongles and two serial ports, you could do something like this:
modprobe tekram
modprobe esi
irattach /dev/ttyS0 -d esi &
irattach /dev/ttyS1 -d tekram &

PS: I would not try to turn the two dongles against each other, since I really don't know how the stack would react :-) ... Since I don't have any of these new ACTiSYS 220L+ dongles, I'm not able to test it. Since the new dongle has support for one extra speed (38400bps), you must specify the dongles differently with irattach so that the kernel knows which dongle you are using (and what QoS can be used):
irattach /dev/ttyS0 -d actisys     # for the 220L dongle 
irattach /dev/ttyS0 -d actisys+    # for the 220L+ dongle

The current implementation of dongle support does not have any state associated with it, so its not possible to use both ACTiSYS dongles (220L and 220L+) at the same time (connected to two serial ports) for now. If someone needs to be able to do so, please mail me (Dag Brattli) and I will think about it!"

Note: When I tried to use an infrared modem (Swissmod 56Ki, manufactured by Telelink AG) connected to my laptop (IrDA works with Window$95 only, due to non standard hardware) I had to remove the infrared support in the BIOS to get it working!

Dag Brattli: "It is now possible to use irport instead of irtty! I have moved all the dongle stuff out of irtty and into irda_device, so it will also be possible to attach dongles to irport. Need however to make a small user-space utility dongle_attach that can be used to attach dongles to a specific driver instance. BTW. irattach is still working as before, and you will not notice the difference even when attaching dongles to irtty (I've just redirected the dongle ioctl to irda_device). Irport may be interesting since you avoid one software interrupt (bh) level, and it's also forced to work in half duplex mode so you don't get any echo if the irda port itself don't have echo-cancellation (girbil dongle and HP-4000 etc) ... To use it, you must supply the parameters to insmod like this: insmod irport io=0x3f8 irq=4, or whichever values you use. You can also add these parameters to /etc/conf.modules like this: options irport io=0x3f8 irq=4, but then you must remember to do a depmod -a and use modprobe irport instead of insmod."

Dongle Connection - Infrared Motherboard Adapter

Support for the ACTiSYS IR2000 dongle has been implemented in a file called pc87108 which you can either compile into the kernel or insmod/modprobe to insert the module:


irmanager -d 1
modprobe pc87108

or insert modprobe pc87108 into the /etc/irda/drivers file (I think).

From James <james@esc.cam.ac.uk> I have this description about setting up the hardware: There are two configurations, a five pin in line connector and a 6 pin DIL (at the end of a 18 pin DIL header). Basically any IrDA conpatible transceiver will work (I have a stack of old IRM3001 these are now obselete) you need to hook a capacitor (use a tantalum about ~1uF) between 5V and 0V near the transceiver and then connect everthing else up (RX->RX, TX->TX, 5V->5V, and 0V-0V). If you don't like soldering irons, lots of companies do sell IR modules for the 5 pin connectors that fit into a hole in your case.

Fast InfraRed (FIR)

The IrDA(TM) standard knows three kinds of speeds:

  1. SIR = Standard IrDA, up to 115kbps IrDA,
  2. MIR = Medium Speed IrDA,
  3. FIR = Fast IrDA (4Mbps),
  4. VFIR = Very Fast IrDA(16Mbps), seems to become a future standard
Up to 115.200bps (SIR) many (probably all) infrared controllers work like a serial port and use a RZI (return to zero, inverted) modulation. Not every infrared controller supports 4Mps (FIR), up to 4Mbps they have to use 4PPM (4 pulse position) modulation technique. Currently there are two FIR chips supported: NationalSemiConductor NSC PC87108 e.g. used in IBM Thinkpad 560X and Winbond W83977AF (IR) FIR chip e.g. used in the Corel Netwinder PC. You may start the FIR service by loading the according module. Linux/IrDA will probe your hardware then. More drivers are under development.

So what speeds can you expect? Using SIR, you should be able to get about 10 Kbytes/s. Using FIR (4Mbps) you can get over 300 Kbytes/s (if you are lucky).


6. Specific Connections and IrDA - Protocols

6.1 Printer Connection - IrLPT, IrTTP

IrLPT support is under heavy construction at the moment. Maybe it will be replaced by IrCOMM. Please see mailing list archive.

Takahide Higuchi reported: " I have been debugging IrCOMM with a printer ( Canon BJC-80v ) with IrDA port and IrCOMM protocol (not IrLPT). I can print a short e-mail text though, it easily causes dead lock when I try to print a postscript with gs."

From the page of Thomas Davis http://www.jps.net/tadavis/irda : To use the IrLPT server, you need to perform the following steps:


/sbin/insmod irlpt_server 
/sbin/mknod /dev/irlptd c 10 `grep irlptd /proc/misc|cut -f 1` 

At this point, the IrLPT server is ready to recieve print jobs; now; all you need is this simple shell script
#/bin/sh
#
while (true)
do
cat /dev/irlptd | lpr
done

Dag Brattli: I hope that this will make it easier for all you that prefer to live in user-space, to make your own IrDA applications and try it out. Some printers actually use IrTTP (because of the limitations of IrLPT), so now you can write your own small user-space printer client so you can talk to it:


int discover_devices(int fd)
{
    struct irda_device_list *list;
    unsigned char buf[sizeof(struct irda_device_list) +
                      sizeof(struct irda_device_info) * MAX_DEVICES];
    int len;
    int daddr;
    int i;

    len = sizeof(struct irda_device_list) +
          sizeof(struct irda_device_info) * MAX_DEVICES;
    list = (struct irda_device_list *) buf;
        
    if (getsockopt(sfd, SOL_IRLMP, IRLMP_ENUMDEVICES, buf, &len)) {
        perror("getsockopt");
        exit(-1);
    }
    if (len > 0) {
        /* 
         * Just pick the first one, but we should really ask the 
         * user 
         */
        daddr = list->dev[0].daddr;

        printf("Discovered: (list len=%d)\n", list->len);

        for (i=0;i<list->len;i++) {
            printf("  name:  %s\n", list->dev[i].info);
            printf("  daddr: %08x\n", list->dev[i].daddr);
            printf("  saddr: %08x\n", list->dev[i].saddr);
            printf("\n");
        }
    }
    return daddr;
}

void client()
{
    struct sockaddr_irda peer;
    int addrlen = sizeof(struct sockaddr_irda);
    int daddr, actual;
    char buf[1024];

    fd = socket(AF_IRDA, SOCK_STREAM, 0);

    daddr = discover_devices(fd);

    peer.sir_family = AF_IRDA;
    strcpy(peer.sir_name, "P1284");
    peer.sir_addr = daddr;
        
    connect(fd, (struct sockaddr *) &daddr, sizeof(struct sockaddr_irda));

    /* Try to send something */
    actual = send(fd, "Testing", 8, 0);

    /* Try to read reply */
    actual = recv(fd, buf, 1024, 0); 
}

6.2 LAN Connection - IrLAN

For an ACTiSYS FIR board and dongle you may do:


irmanager -d1
/sbin/modprobe pc87108  # remove irattach from /etc/irda/drivers, or
                        # substitute irattach with the modprobe!

On machine 1:


modprobe irlan_client # not really necessary since irmanager should do this!

On machine 2 (if you don't have an access-point)
modprobe irlan_server

Do not compile irlan_server into the kernel, since it currently does not like that! You should have configured /etc/sysconfig/network-scripts/ircfg-eth0 with a proper ad-hoc network if you are using two machines. If you have an access-point, then the normal setup should be fine.

Notice that in the latest patch (2.2.0-irda1) irlan_client will call the device irlan0 by default, but you can change this by giving eth=1 as an option to irlan_client (modprobe irlan_client eth=1 or options irlan_client eth=1 in /etc/conf.modules). The next release of IrLAN will be only one module, so you don't need to think about if you need to have the client and/or the server installed.

It's possible to do ifconfig irlan0 -broadcast to stop the AP from flooding you with broadcast frames! That can be a problem if you are connected to a very large Ethernet segment. The only problem is that your machine will then have to initiate all communications and can therefore not function as a server (well, you could probably make a stationary machine somewhere answer ARP requestes on your behalf).

When using the IrLAN software from HP, you maybe have to name your computer "HP NetbeamIR" in the IAS entry to make it connect. Also I have heard rumors that a "Psion 3c" also wanted to connect only to another IR device if it had the same or a similar name.

6.3 HP NetBeamer Connection

From Renaud Waldura: All the IrDA stuff is compiled in as modules.

6.4 Palm III Connection - IrOBEX

The IrOBEX stuff seems under rapidly improving changing development. So the applications change, too. Therefore I just can't give quite exact information. Please see also the report by Dag Brattli at http://www.cdpubs.com/hhsys/archives/66/10brattl.pdf .

Please note: IrOBEX now is in user-space and uses IrDA sockets. Remember that when using sockets, you don't need to have irobex enabled in the kernel, and /dev/irobex is not used anymore!The /etc/irda script is really only good for configuration of the devices, making the right mknod for /dev/irobex etc., not for starting applications.

Wessel de Roode wrote: The Palmpilot is default locked on 57k. You can however if you write your own software for the Pilot, use the 115k line settings. I quote a part from the irlib.h:


---------- irlib.h from the SDK 3.0 from palmpilot -----
// Options values for IrOpen
#define irOpenOptBackground     0x80000000              // Unsupported background task use
#define irOpenOptSpeed115200    0x0000003F              // sets max negotiated baud rate
#define irOpenOptSpeed57600     0x0000001F              // default is 57600
#define irOpenOptSpeed9600      0x00000003
-------------- end quote --------------------------------

Peter Pregler reported: If the Palm enters the range of the irda-device a popup appears with the text "Transmission: waiting for sender"

Ron Choy answered: There is a software called ShutupIR that is supposed to help with this problem of annoying popup http://hp.vector.co.jp/authors/VA005810/irda/shutup10.zip I haven't tried it but it looks like it would fix your problem.

6.5 Palm III Connection to IBM Thinkpad 600

This chapter is a courtesy of Harald Milz - SuSE. Minor changes by Werner Heuser to fit into the HOWTO.

This document describes how to set up Linux/IrDA on an IBM Thinkpad 600. This works for my machine. Your mileage may vary with other machines.

Prerequisites

Adding support for IrDA

Starting IrDA - First Steps

Call /etc/rc.d/irda start and watch the console messages. ps should show irattach and irmanager running. Check /proc/net/irda to see what is there. ircomm will only be available and show reasonable stuff when an application accesses the irnine port (and loads ircomm_tty through kmod).

Start PilotManager or sync-plan and be happy :-) IR should run fine at 57600 bps.

See SuSE Munich PalmIIIx pages, too.

Configuration Files

/etc/irda/drivers:


#! /bin/sh
#
# drivers
#
# Initialize and shutdown IrDA device drivers.
#
# This script should be invoked with two arguments.  The first is the
# action to be taken, either "start", "stop", or "restart".
#

action=$1
device=$2

case "${action:?}" in
start)
        /usr/local/sbin/irattach /dev/ttyS0          # The third serial port is an IrDA port
        # irattach /dev/ttyS0 -d esi # Attach a ESI dongle to the first serial port
        # irattach /dev/ttyS0 -d tekram
        # insmod pc87108             # If your machine as a pc87108 FIR chipset
        # modprobe uircc             # Sharp UIRCC chipset
    ;;
stop)
        killall irattach             # ... or something. Currently not used
    ;;
restart)
        /sbin/ifconfig ${device:?} down up
    ;;
esac

/etc/rc.d/irda


#! /bin/sh
# Copyright (c) 1995-1998 SuSE GmbH Nuernberg, Germany.
#
# Author: hm
#
# /sbin/init.d/irda
#
#   and symbolic its link
#
# /sbin/rc<skeleton>
#

. /etc/rc.config

# Determine the base and follow a runlevel link name.
base=${0##*/}
link=${base#*[SK][0-9][0-9]}

# Force execution if not called by a runlevel directory.
test $link = $base && START_IRDA=yes
test "$START_IRDA" = yes || exit 0

# The echo return value for success (defined in /etc/rc.config).
return=$rc_done
case "$1" in
    start)
        echo -n "Starting service irda"
        ## Start daemon with startproc(8). If this fails
        ## the echo return value is set appropriate.

        startproc /usr/local/sbin/irattach /dev/ttyS0 || return=$rc_failed
        startproc /usr/local/sbin/irmanager -s1 -d0 || return=$rc_failed

        echo -e "$return"
        ;;
    stop)
        echo -n "Shutting down service irda"
        ## Stop daemon with killproc(8) and if this fails
        ## set echo the echo return value.

        killproc -TERM /usr/local/sbin/irmanager || return=$rc_failed
        killproc -TERM /usr/local/sbin/irattach || return=$rc_failed
        for i in ircomm_tty ircomm irtty irda ; do 
                rmmod $i; 
        done

        echo -e "$return"
        ;;
    restart)
        ## If first returns OK call the second, if first or
        ## second command fails, set echo return value.
        $0 stop  &&  $0 start  ||  return=$rc_failed
        ;;
    reload)
        ## Choose ONE of the following two cases:

        ## First possibility: A few services accepts a signal
        ## to reread the (changed) configuration.

        #echo -n "Reload service foo"
        #killproc -HUP /usr/sbin/foo || return=$rc_failed
        #echo -e "$return"

        ## Exclusive possibility: Some services must be stopped
        ## and started to force a new load of the configuration.

        #$0 stop  &&  $0 start  ||  return=$rc_failed
        ;;
    status)
        echo -n "Checking for service foo: "
        ## Check status with checkproc(8), if process is running
        ## checkproc will return with exit status 0.

        #checkproc /usr/sbin/foo && echo OK || echo No process
        ;;
    probe)
        ## Optional: Probe for the necessity of a reload,
        ## give out the argument which is required for a reload.

        #test /etc/foo.conf -nt /var/run/foo.pid && echo reload
        ;;
    *)
        echo "Usage: $0 {start|stop|status|restart|reload[|probe]}"
        exit 1
        ;;
esac

# Inform the caller not only verbosely and set an exit status.
test "$return" = "$rc_done" || exit 1
exit 0

6.6 Psion 5 Connection

Andrew Chadwick <andrew.chadwick@symbian.com> wrote: A nifty way to check that the baud rates for SIR are set up properly (if you have a Psion Series 5) is to point the S5 at your Linux box's IR window and try to beam a file. While the beamer dialog's on the screen, the S5 will try to make an IrDA connection (even when it claims it can't find another IR machine). You should be able to do a cat < /dev/ttyS3 and if the serial parameters are right on both machines, you should see the words "Symbian EPOC" (machine ident) scroll past amidst the spew.

Fons Botman wrote: " Maybe someone with a Psion 5 would like to test this program. It emulates the protocol for the Psion 5 IR send and receive command for files on linux. You can now exchange files with simple commands. The transfer rate is 9.7 KBytes/sec on a 115KB SIR link for big files which is not bad methinks. It is beta, so be sure to backup the Psion first, I did get a soft reset once (no data loss). ;-)" I have put the source into Appendix C.

6.7 Cellular Phone Connection

As far as I know some cellular phones use the IrCOMM standard, e.g. Ericsson SH888 and NOKIA 6110 (I'm not sure about the NOKIA 8110). Maybe other cellular phones use the IrOBEX standard (see the Palm III section for information about setting up a connection) or IrMC.

Ericsson

To start a communication session with /dev/irnine (/dev/ircomm), for instance, say:


dip -t
> port irnine
> term

Probably you may use cu or xc instead of dip, too (cu -l /dev/irnine or xc -l /dev/irnine). There are also reports about some efforts with the Ericsson GF768 and IR Modem DI 27.

Benny Amorsen wrote: The SH888 emulates an IRDA-port when you connect it using the serial cable. Why someone would think up something weird like that is beyond me, but that is the way you get it to work in Windows. Not that I ever managed to make it work in Windows, though.

Ales Dryak has send this survey (looks like a Debian/GNU Linux distribution, please modify your configuration accordingly). Mobile Ericsson SH888 (ati1 = 980408 1035 PRGCXC125101):

  1. mknod /dev/ircomm c 60 64
  2. /etc/conf.modules:
    alias tty-ldisc-11 irtty
    alias char-major-60 ircomm_tty
    

  3. /etc/irda/drivers: irattach /dev/ttyS0 # (IrDA port in SIR mode)
  4. running irmanager
  5. /etc/chatscripts/sh888
    <ABORT stuff>
    "" \d\d\d\d\d\dATZE0
    OK ATD<phone number to call)
    CONNECT \d\c
    

  6. /etc/ppp/peers/sh888
    noauth
    connect "/usr/sbin/chat -v -f /etc/chatscripts/sh888"
    /dev/ircomm
    115200
    defaultroute
    noipdefault
    user <your username> # don't forget to add your password to chap secrets or chat script
    

A few seconds (app. 30) after executing pppd call sh888 I get connected to our Intranet/Internet having full IP connectivity (telnet, ftp, www, icmp tested). Futhermore I can connect to /dev/ircomm using minicom and play with AT command. Great! And looks stable!

NOKIA

Carlos Vidal wrote: Correct me if I'm wrong, but it seems to me that Nokia telephones do not contain a genuine hardware modem, but something which is similar in principle to WinModems for PC. Whenever Nokia writes about modem communication, they use the name "Windows software modem" (or something similar). Which is actually backed up by the need to use special Nokia software for Windows (called Nokia Cellular Data Suite).

Joonas Lehtinen wrote: This is true with 61xx models. Models: 8810, 9000(i) and 9110 should work fine. (They have inbuilt modem). My Nokia 9000 reports IrCOMM with linux.

Some suggestion by Carlos Vidal carlos@tarkus.se : "I'm doing some tests trying to see how far can I get with my Nokia 6110 on Linux. I've just compiled gnokii-0.2.4 (gnokii is Nokia mobile phones connected via serial cable support for Linux and *BSD http://multivac.fatburen.org/gnokii/ , WH), but it doesn't work. As I have Nokia Data Suite I did the following connection:

Nokia 6110 <-- Nokia Cable --> PC/Linux <-- Null-modem cable --> PC/W95

In the PC/Linux I run the program snooper (by Jun-ichiro itojun Itoh <itojun@mt.cs.keio.ac.jp>, sorry couldn't find an URL maybe some other sniffer will do it also, e.g. sniffit, see also appendiy about serial sniffers, WH) with small modifications in order to configure the serial port correctly.

Normally, if snooper has the correct baud rate, the phone and the PC/W95 should communicate as if there was no snooper in between. This worked pretty well when I cracked the protocol of my Minolta camera. The problem here is that the phone doesn't answer or hangs after a while.

It seems that the timing is quite important during the initial phase of the communication. The log I obtain is:


0>1: UUUUUUUUUUUUUUUUUUUUUUUU
line 0: LE *DTR *RTS ST SR CTS CD RI *DSR
line 1: LE *DTR *RTS ST SR CTS CD RI *DSR
0>1: UUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUU
UUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUU
UUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUU
UUUUUUUUUUUUUUU\x1e\x00\x0c\x02\x00\x09\x00\x01\x00\x0d\x00\x00\x02\x01@\x00P\x
06
1>0: \x18\x00\x00\x00\xfc\x18\x00\x00\x00\x00\x00\x00\xc0\xf0
0>1: \x1e\x00\x0c\x02\x00\x09\x00\x01\x00\x0d\x00\x00\x02\x01@\x00P\x06
1>0: \x18\x00\x00\x00\x18\x00\x00\xc0\xf0\x18\x00\x00\x00\x00\x00\x00\xc0\xf0
0>1: \x1e\x00\x0cd\x00\x06\x00\x01\x00\x10\x01`\x13\x13
1>0: \x18\x00\x00\xf0\x00\x00\xfc
0>1: \x1e\x00\x0cd\x00\x06\x00\x01\x00\x10\x01`\x13\x13

0 is the PC/95 and 1 is the phone. The communication starts with a stream of 'U' (0x55) and with DSR/DTR on. The phone answers with '0x18 0x00 ...'. This dialog continues for a while as if both were deaf and finally the phone crashes and the only way to reset it is to remove the batteries!

I guess that what happens is that the phone is trying to find the correct baud-rate and fails because of the delays introduced by snooper. This probably has to do with some IrDA protocol used with also with the infrared connection."

Wessel de Roode <J.W.deRoode@student.utwente.nl> "I manged to get the Discovery IR hint bits (with my Palm Pilot):


Discover:
0:xxxxxxxx:81.01
        01  IR_HINT_PNP     01  IR_HINT_TELEPHONY (IrMC ?)
        80  IR_HINT_EXT

Device info query:
\006Device\012DeviceName
        4e 6f 6b 69 61 20 36 31 30 30           Nokia 6100

I also managed to query the PNP device of the Nokia. It has one PNP device. It's PNPC100 which equalt a 9600 baud modem. I deleted the query, if somene can send me a hint to restore it. was somthing like IrDA:<dunno>:PNP:Comp#01 The same query with IrDA:<dunno>:PNP:CompCnt gives the number of PNP-devices are available in the Nokia. Which is here only one."

Maybe it is necessary to load the irlpt_server module for connections to a NOKIA.

6.8 Digital Camera Connection

Markus Schill wrote: "Great that there are also other people who are interested in using the SONY DSC-F1 IR adapter under linux. Up to now I have only toyed around with the linux-irda software and the serial IR adapter from PuMa Technologies that came with the camera. This is the status. I am using linux 2.0.33 and the latest linux-irda... If I use:


insmod irda 
insmod irtty 
irattach /dev/cua0

the adapter starts talking to the camera. /var/log/messages says that SONY-DSC-F1 was found, but no service is started. (Please note, this probably doesn't apply to the 2.2.x kernel versions of Linux/IrDA, wh).

There are two programs for linux available that can be used for the communication with the camera via cable: (1) chotplay and (2) stillgrab. They both take a tty as commandline option, so I guess that they should work if the irtty layer of the protocol stack works correctly ... I have not looked at anything in the linux-irda code, yet!). I am not sure whether I understand the stack but shouldn't the irtty make the thing look like a normal tty? What service should be started. "

Dag Brattli wrote: "I'm not sure which application level protocol the camera uses, but it is possible that it implements the IrDA(TM) Infrared Transfer Picture Specification (IrTran-P). If you take a look at http://www.irda.org/standards/pubs/IrTran-P_10.pdf, you will see that it is a protocol which is implemented above IrCOMM (not IrTTY!). IrTTY is something we use just to be able to talk to the Linux serial driver. "

6.9 Window$9x/NT and Linux/IrDA

Introduction

Why this? Unfortunately Linux users are not always supported with the necessary hardware information. Sometimes it is possible to look at this informations in Window$95. Sometimes its even useful to connect the two. Linux could also provide occasional access point services to a Window95 laptop of a friend dropping by.

Where to get it from? At http://www.microsoft.com/windows95/info/irda.htm you will find a support pack "Infrared Transfer 2.0". It is a self-extracting archive W95IR.EXE with 331KB. Note: MicroSoft seems to change the location of this file (and others) at random.

Microsoft(tm) has three versions of IrDA support for Windows95. The version number can be found in the "Software" icon in the Control Panel and the file infrared.inf.

Version 1.0 is still delivered with some hardware.

Version 2.0 is the version they currently offer at their web site. It is in the self-extracting file W95IR.EXE. The last time I looked (1999-02-21) it was 434KB and was found at http://support.microsoft.com/download/support/mslfiles/W95IR.EXE . Their website is frequently changing, so do not be surprised to find the file (also) in another location or not at all.

Version 3.0 can/could be found in their downloadable Infrared development kit IRDDK30, but is mostly useful for developers. It is internally different from 2.0, it is based on "miniport" network drivers, just like the Linux version. It exists for some time and has some support for NT, but it clearly did not make it into the mainstream NT4.0 distributions. For 95 you are probably better off with 2.0. The choice may depend on the documentation of the drivers you get with your specific hardware.

MS website also used to contain a nice utility IrXfer, contained in the archive IRXFER.EXE, This is the Infrared Transfer utility, which uses an IrOBEX variant I think, it is referenced in the IrOBEX protocol description. The utility was freely downloadable, but I could not find it the last time. It is a nice graphical utility which can be used to transfer files over IrDA between computers.

With some machines, e.g. a HP Omnibook 800 it is necessary to use a vendor specific version of this package (for the HP Omnibook 800 you may find it on the recovery CD).

Especially the ..\windows\inf\*.inf files and the device manager are of interest to look for configuration details.

As far as I know Window$NT doesn't support IrDA(TM). About Window$98 I have heard there is no IrDA(TM) support yet. Countersys on http://www.countersys.com claims to sell an IrDA solution for NT4.0 to support their JetBeam product, Microsoft refers to them for it.

AFAIK:

There are also some non M$ products available. Note: Some of them use proprietary infrared protocols:

Connection between Linux/IrDA and Window$95 IrDA(TM)

I suppose there are four ways to connect Linux/IrDA and Window$95:

1) A network connection between two PC's. If you have set up Infrared Transfer 2.0, you will find an IrDA(TM) network device in the <Network Device Section>. But I couldn't get a working connection yet.

Some information by Fons Botman: MS does not support PEER mode, which is strange, because it would fit their workgroup model. I have had success with IrLAN DIRECT mode when I removed the COMPUTER entry in the hints bits from the Linux side. Windows95 will recognise the Linux box as a lan access point and will try to install a driver for it but cannot find it. At this point I install the network adapter driver named Microsoft IrDA Lan Driver (you can also do this beforehand). You now should have a new active network driver which can be seen with WINIPCFG. To make it work with TCPIP I give the linux side an address using the redhat configuration tools and start a dhcp server on the linux box which hands out leases on the IrDA subnet. Sometimes I have to use WINIPCFG to explicitly ask for a lease. After this you can freely network between the two computers. Try to telnet or use explorer from Windows95 to linux.

Open points:

a. write a proper /etc/sysconfig/network/irlan-up script.

b. solve the direct/peer mode problem and the peer mode dhcp problem (zero, one, too many dhcp servers on the irda sublan), maybe borrow leases from a dhcpserver on the eth0 lan (dhcrelay).

c. Make the Microsoft IrDA Lan Driver install automatically, maybe this is a problem in the PnP configuration. This seemed to work better on Windows98.

d. I sometimes get a TCP configuration problem after disconnect, which can be solved by a Windows95 reboot. Maybe tune the dhcp configuration.

2) Maybe it is also possible to use the IrOBEX protocol. But I don't know which software to use and where to get it. I supposed the necessary software comes with a Palm III, but this seems not to be true.

3) Takahide Higuchi <thiguchi@pluto.dti.ne.jp> provided IrCOMM support. From his page at http://www.pluto.dti.ne.jp/~thiguchi/irda/ I have taken the following description (I have modified it at little): "With IrCOMM support you can send or receive short messages between a linux box and a terminal program on a win95 laptop! Please add this line to /etc/conf.modules:


alias char-major-60 ircomm_tty

Next, make a device file mknod /dev/irnine c 161 0. Now Linux/IrDA services can be started as usual with irattach /dev/ttyS? &. /dev/irnine can be used as a serial device. ircomm and ircomm_tty modules will be loaded automatically by kerneld/kmod when a program uses /dev/irnine. NOTE: I think "setserial" utility will not work on /dev/irnine. Tips:

4) From Fons Botman: IrLPT works fine. Make Linux the IrLPT server, and in Windows95 configure a printer to use the virtual LPT port defined when you installed MS-IrDA. Windows95 periodically sends some short sequence to the printer, I still have to figure out what that is.

6.10 Linux to Linux Connection

Connection Methods

There should be three ways to get two Linux machines connected via Linux/IrDA.

Compression

Please note this feature is still quite experimental! Dag Brattli wrote: "Just wanted you to know I have just added COMPRESSION support to IrLAP! As you may know, this is _not_ part of the IrDA(TM) standard, but Linux can now negotiate with its peer and check if it has the same compression capabilities). So obviously if you are talking to Win95, Palm III or whatever, you will _not_ get compression!!! This is something which is exclusive for Linux as far as I know! The IrDA(TM) standard says that devices should ignore unknown field in the negotiation header, so we are still "compatible" with IrDA(TM) (have just borrowed an unused header value).

If you want to try using the compression code (Linux <-> Linux) you will have to insert the irda_deflate module some time before you actually make the connection. I do it before irattach.

The compression standard I have added is the deflate format used by the zlib library which is described by RFCs (Request for Comments) 1950 to 1952 in the files ftp://ds.internic.net/rfc/rfc1950.txt (zlib format), rfc1951.txt (deflate format) and rfc1952.txt (gzip format).

The compression interface is similar to PPP, so you can add as many different compressors as you want. Currently there is only support for GZIP, but BSD compression will be added later. ... Have just tested GZIP compression at 4Mbps. It was a really bad idea! Compressing the frames takes so much time that the performance is actually worse than when not using compression at all. The conclusion is that compression should only be used for SIR speeds, ..."

6.11 Multiple Instances

Dag Brattli wrote: "The IrLAP layer has been enhanced to allow more than one instance (so I can use IrLAN on my built-in ir-port, and communicate with the Pilot over the IrDA dongle at the same time) ... So how do you make two Linux/IrDA connections? Well, you just fire up irattach for each of the IR ports you have like this:


irattach /dev/ttyS0 &    (my ESI dongle)
irattach /dev/ttyS2 &    (my builtin IrDA port)

insmod irlan_client
insmod irobex

They will not see each other if you run them on the same machine, since they will initiate discovery exactly at the same time. You should however be able to use them against two other laptops. I can run a dongle, builtin IrDA port and a IrDA pcmcia card at the same time with three other IrDA devices without any problems.

You should notice that if the devices can interfere with each other then it might be difficult to obtain a connection, since a device is not allowed to transmit if the media is busy. I sometimes have to put a book between them."

6.12 Connection to Docking Station

Dag Brattli: "Connection to the Tekram IRDocking IR-660 http://www.tekram.com/Hot_Products.asp?Product=IR-660 . This device is a docking station with LAN access, printer, mouse and keyboard. You can also use them at the same time as the internal mouse and keyboard! Just fire up gpm -t ps2 /dev/irkbd and the laptop will make a keyboard/mouse connection to the IR-660. Now I just have to make gpm read both /dev/psaux and /dev/irkbd, and then make X11 read /dev/gpmdata, and I should have the thing configured!

... one problem: gpm can handle multiple mice, but Linux cannot handle multiple different keyboards. So if you have one norwegian keyboard and one remote US keyboard like I have, then things will be a little bit confusing. I got a hint from Alan Cox about a project that is implementing real support for multiple keyboards, so I'll check that out.

... OK, I sort of worked it out. By using TIOCSTI on /dev/console, you can insert scancodes directly into the tty queue. This can be a problem for virtual consoles that expect to receive some translated and cooked keycodes, but X happens to like raw scancodes, so this will work quite nice when using X but not for other virtual consoles. Anyway this is good enough for me, so I will not use a lot of time converting the scancodes to keycodes and index them with some keymap just to make it work with text only virtual consoles. As I see it the irkbd driver has now been successfully been ported to user-space :-)

... the Tekram IR-660 device can, in addition to attach a keyboard and mouse, also print using IrTTP (it can print using IrLPT, but that is not so funny since it requires exclusive use of IrLMP, and you don't wan't to stop the network, mouse and keyboard just to print a document). I'll try and see if I can get IrTTP printing working using a fifo as well.

... Tekram has added a control channel in addition to the data channel so that you can get some status information about what is going on. The name of their own protocol is P1248. It's published through the "P1248" class and "IrDA:TinyTP:LsapSel" LM-IAS entry, so you can try to find it.

... Canon is using the P1248 protocol, and their printer monitor program BrintBuddy2 (Japanese version) is using this protocol now. I don't know what they use for the data channel. Maybe they support TinyTP directly in addition to the other methods. You can try and look up the "IrLPT" class with the "IrDA:TinyTP:LsapSel" in the LM-IAS and see if you can find it."

6.13 Connection to Keyboard

The Linux/IrDA keyboard driver is now in user-space. Please see chapter Connection to Docking Station above.

Lichen Wang: "The so called IrDA-D standard is designed to transfer Data. It is not suitable for IR Keyboard. IrDA-D is what Dag ported to Linux OS and what MS ported to Windows OS.

The so called IrDA-C (Control) is designed for Keyboard, Joy-stick, etc. I am not aware that there is any product in the market that is using it yet.

IrDA-D cannot talk to IrDA-C. IrDA-C cannot talk to IrDA-D either. Both the physical encoding/decoding and the software protocol are very different.

It is possible to implement both IrDA-D and IrDA-C in the same device. Sharp says that IrDA-D and IrDA-C can coexist -- as long as both of them are not used at the same time in the same IR space. This sounds rather funny to me. According to this definition, anything can co-exist with anything as long as you do not destroy the universe permanently in the process ;-)

Seriously, what SHARP says is that they can tailor the IrDA-D so that there are some unused time between the negotiated maximum turnaround time and the actual transmission. They then squeeze the IrDA-C frames in those unused time. The IrDA-D Primary and IrDA-C Master must be implemented in the same device. The keyboards will work, but mice and joysticks may be sluggish at times."

6.14 Connection via Serial Cable

For some reasons it may be useful to connect via serial cable instead of using a real infrared link. Bjorn Hanson wrote: "Using a cable, I managed to get a PPP connection through my Ericsson SH888. I did the following (maybe some steps are wrong but they worked for me :-)

Everything worked fine for ping and ssh (doing ls -l a couple of times) but the computer hang when I tried to mail (Netscape) this through that PPP. After reboot I tried both Netscape and lynx. Both were able to establish contact but none got any data."

Another way by Claudiu Costin <claudiuc@calderon.pcnet.ro>:

This has to be done for both machines.

Please note this is not the recommended stuff to connect two machines. Use PPP instead. Though I cannot see how this approach is useful I have included it beause it was asked sometimes in the mailing list.

6.15 Peer-to-Peer Mode / Direct Mode

IrCOMM and IrLAN work in both modes, but currently I don't have further information about the differences between these modes and how to set them up.


7. Hardware Supported by Linux/IrDA

7.1 Obtaining Information about the Infrared Port in Laptops

To get the IrDA port of your laptop working with Linux/IrDA you may use StandardInfraRed (SIR) or FastInfraRed (FIR).

SIR

Up to 115.200bps, the infrared port emulates a serial port like the 16550A UART. This will be detected by the kernel serial driver at boot time, or when you load the serial module. If infrared support is enabled in the BIOS, for most laptops you will get a kernel message like:


Serial driver version 4.25 with no serial options enabled
ttyS00 at 0x03f8 (irq = 4) is a 16550A     #first serial port /dev/ttyS0
ttyS01 at 0x3000 (irq = 10) is a 16550A    #e.g. infrared port
ttyS02 at 0x0300 (irq = 3) is a 16550A     #e.g. PCMCIA modem port

FIR

If you want to use up to 4Mbps, your machine has to be equipped with a certain FIR chip. You need a certain Linux/IrDA driver to support this chip. Therefore you need exact information about the FIR chip. You may get this information in one of the following ways:

  1. Read the specification of the machine, though it is very rare that you will find enough and reliable information there.
  2. Try to find out wether the FIR chip is a PCI device. Do a cat /proc/pci . The according files for 2.2.x kernels are in /proc/bus/pci . Though often the PCI information is incomplete. You may find the latest information about PCI devices and vendor numbers in the kernel documentation usually in /usr/src/linux/Documentation or at the page of Craig Hart http://members.hyperlink.net.au/~chart . From kernel 2.1.82 on, you may use lspci from the pci-utils package, too.
  3. Use the DOS tool CTPCI330.EXE provided in ZIP format by the German computer magazine CT ftp://www.heise.de/pub/ct/ctsi/ctpci330.zip . The information provided by this program is sometimes better than that provided by the Linux tools.
  4. Try to get information about Plug-and-Play (PnP) devices. Though I didn't use them for this purpose yet, the isapnp tools, could be useful. At the page from Craig Hart I found this PNP IDs:
    IBM0002   IBM Thinkpad Infrared Port
    IBM0034   IBM Thinkpad Infrared Port
    PNP0510   Generic IRDA-compatible device
    PNP8294   IrDA Infrared NDIS driver (Microsoft-supplied)
    PNP8389   Peer IrLAN infrared driver (Microsoft-supplied)
    

  5. If you are running Linux-2.3.x and PCMCIA-CS-3.1.x, turn on the PnP BIOS in PCMCIA-CS. Then, do a lspnp -v (from Thomas Davis).
  6. If you have installed the Linux/IrDA software load the FIR modules and watch the output of dmesg, whether FIR is detected or not.
  7. Another way how to figure it out explained by Thomas Davis (modified by WH): "Dig through the FTP site of the vendor, find the Windows9x FIR drivers, and they have (for a SMC chip):
    -rw-rw-r--   1 ratbert  ratbert       743 Apr  3  1997 smcirlap.inf 
    -rw-rw-r--   1 ratbert  ratbert     17021 Mar 24  1997 smcirlap.vxd 
    -rw-rw-r--   1 ratbert  ratbert      1903 Jul 18  1997 smcser.inf 
    -rw-rw-r--   1 ratbert  ratbert     31350 Jun  7  1997 smcser.vxd 
    

    If in doubt, always look for the .inf/.vxd drivers for Windows95. Windows95 doesn't ship with _ANY_ FIR drivers. (they are all third party, mostly from Counterpoint, who was assimilated by ESI)."
  8. Also Thomas Davis found a package of small DOS utilities made by SMC. Look at http://www.smsc.com/ftppub/chips/appnote/ir_utils.zip . The package contains FINDCHIP.EXE. And includes a FIRSETUP.EXE utility that is supposed to be able to set all values except the chip address. Furthermore it contains BIOSDUMP.EXE, which produces this output:

    Example 1 (from a COMPAQ Armada 1592DT)


         In current devNode:
               Size      = 78
               Handle    = 14
               ID        = 0x1105D041 = 'PNP0511' -- Generic IrDA SIR
               Types:  Base = 0x07, Sub = 0x00,  Interface = 0x02
                    Comm. Device, RS-232, 16550-compatible
               Attribute = 0x80
                    CAN be disabled
                    CAN be configured
                    BOTH Static & Dynamic configuration
          Allocated Resource Descriptor Block TAG's:
               TAG=0x47, Length=7 I/O Tag, 16-bit Decode
                                       Min=0x03E8, Max=0x03E8
                                       Align=0x00, Range=0x08
               TAG=0x22, Length=2 IRQ Tag, Mask=0x0010
               TAG=0x79, Length=1 END Tag, Data=0x2F
    

    Result 1:

    Irq Tag, Mask (bit mapped - ) = 0x0010 = 0000 0000 0000 0001 0000 so, it's IRQ 4. (start at 0, count up ..), so this is a SIR only device, at IRQ=4, IO=x03e8.

    Example 2 (from an unknown machine)


         In current devNode:
              Size      = 529
              Handle    = 14
              ID        = 0x10F0A34D = 'SMCF010' -- SMC IrCC
              Types:  Base = 0x07, Sub = 0x00,  Interface = 0x02
                   Comm. Device, RS-232, 16550-compatible
              Attribute = 0x80
                   CAN be disabled
                   CAN be configured
                   BOTH Static & Dynamic configuration 
    
         Allocated Resource Descriptor Block TAG's:
              TAG=0x47, Length=7 I/O Tag, 16-bit Decode
                                      Min=0x02F8, Max=0x02F8
                                      Align=0x00, Range=0x08
              TAG=0x22, Length=2 IRQ Tag, Mask=0x0008
              TAG=0x47, Length=7 I/O Tag, 16-bit Decode
                                      Min=0x02E8, Max=0x02E8
                                      Align=0x00, Range=0x08
              TAG=0x2A, Length=2 DMA Tag, Mask=0x02, Info=0x08
              TAG=0x79, Length=1 END Tag, Data=0x00
    

    Result 2:

    a) it's a SMC IrCC chip

    b) one portion is at 0x02f8, has an io-extent of 8 bytes; irq = 3

    c) another portion is at 0x02e8, io-extent of 8 bytes; dma = 1 (0x02 =0000 0010)

    Thomas Davis has placed some device information at http://www.jps.net/tadavis/irda/devids.txt .

    WARNING: The package is not intended for the end user, and some of the utilities could be harmful. The only documentation in the package is in M$ Word format. Linux users may read this with catdoc, available at http://www.fe.msk.ru/~vitus/catdoc/ .

  9. Use the Device Manager of Windows9x/NT or WINMSD (Windows NT Diagnostics) in Windows NT 4.0, WINMSD is quite useful, and a bit more informative than Windows9x's Device Manager.
  10. You may also use the hardware surveys mentioned below.
  11. And as a last ressort, you may even open the laptop and look at the writings at the chipsets itselfs. Here is an probably incomplete list of manufacturers: Chrystal, Hewlett Packard (HP, chipsets are marked HSDL), Hitachi, IBM, National Semi Conductor (NSC), NEC, Philips, Sharp, Standard Micro Systems Corporation (SMC/SMSC), Texas Instruments (TI), VLSI, Winbond. As an example of application circuits the HSDL-7001 (from a HP brochure, modified by WH):
        LEDs        Encode/Decode        SIR/FIR
    
       HSDL-1001    HSDL-7001          UART 16550/
                                      MicroController
       ______      ______________      ____________
      |      |    |              |    |            |
    (||   TXD|<---|IR_TXD     TXD|<---|SOUT        |
      |      |    |              |    |            |
      |      |    |           RCV|--->|SIN         |
      |      |    |              |    |            |
    (||   RCV|--->|IR_RCV  16XCLK|<---|BAUDOUT     |
      |      |    |          NRST|-+  |            |
       ------      --------------  |   ------------
                                   V
    

7.2 Big Endian

Though the source is build to work with big endian machines, I didn't get any reports about actually using it. It would be interesting if it's actually working or not. You will probably need an IrDA dongle or something to test it.

i386 and alpha are little endian, arm can choose (but the NetWinder has been wired as a little endian machine). m68k, sparc and ppc are big-endian! mips can choose I think. If unsure, look in /usr/src/linux/asm/byteorder.h and check if it includes <linux/byteorder/big_endian.h> or <linux/byteorder/little_endian.h> .

7.3 SMP

Dag Brattli: "The problem ... has not been analyzed yet. It may be unsafe, and it may work pretty well. All upstream traffic should be safe (bh's), but downstream traffic _may_ be dangerous. I really don't know. ... All list operations irqueue.c in Linux-IrDA is currently SMP safe!". Please check the source code for the current status.

7.4 Hardware Surveys

There are some surveys about Linux and infrared capable devices in the WWW:


8. Graphical User Interface (GUI)

Currently there are two graphical user interfaces for Linux/IrDA under development:

8.1 GNOBEX

A GNOME application developed by Dag Brattli http://www.cs.uit.no/linux-irda/irda.html with support for drag'n drop from the GNOME file manager gmc. It will also show the progress of the file transfer and give some better error messages when something goes wrong. The GUI isn't finished yet, but if you want to try the GUI you will need the Perl-GTK+ module.

Annotations about CORBA by Dag Brattli: I have just had the first successful test running ORBit/CORBA over IrDA sockets/IrTTP! ORBit is btw. the GNU CORBA implementation used by the GNOME project. The goal is to make it possible for GNOME applications to work between your laptop and your stationary PC without having to first set up a TCP/IP link. Applications on the laptop can then make use of CORBA exported services on your stationary machine.

IrDA (as a one hop technology) fits nicely into the network hierarchy since ORBit will now choose which profile to use in this order:

  1. Same process (same address space), Some short circut mechanism is used that I don't know much about. It should however be nearly as fast as a procedure call.
  2. Same machine (different address space), UNIX domain sockets are used
  3. One hop away, IrDA is used (if IrDA is available and a ORBit/CORBA capable device is discovered)
  4. Multiple hops away (if all other methods fails). IIOP, TCP/IP will be used.

I use my laptop and a NetWinder for testing. The machines are connected by both Ethernet and IrDA. It's really nice to start a CORBA session and see that the IrDA does discovery, IAS-query, and connects if a CORBA capable device is discovered. If somethings goes wrong, IIOP (TCP/IP) will automagically be used instead. When the transaction if finished, the link goes down again."

There is also OBEX support to the gnome-calendar application gncal. Just click on an event and beam it to your Palm Pilot! Still needs to do some cleanup, and support for beaming the other way as well.

8.2 KDE

A KDE application developed by Thomas Davis. Look at his page http://www.jps.net/tadavis/irda.

Here's your chance to contribute! Both GUI's need some icons. Any icons need to be:

Please contact the developers.


9. Power Saving

In the specifications of my HP OmniBook 800 it is recommended to turn off the IR port, if it is not in use, because it may consume up to 10 percent of the battery time.

If necessary, you may also try to disable the Fast RRs feature in the IrDA section of the kernel. This option will give you much better latencies but will consume more power.


10. Beyond IrDA

10.1 Extending Transmission Distance

According to the IrDA specification the range is up to 1 meter. From the "IrDA Data Link Design Guide" p. 20 by Hewlett-Packard http://www.hp.com/go/ir : " In some cases it may be desired to increase link distance beyond the 1 meter guaranteed by IrDA. The two ways to do this are to increase transmitted light intensity, or to increase receiver sensitivity. In order to extend the link distance, both sensitivity and intensity must be increased for both ends of the IR link. If it is desired to communicate with a standard IrDA device that may have minimum transmitter intensity, the receiver intensity must be increased. The standard IrDA device may also have minimum receiver sensitivity, so transmitter intensity must also be increased."

Andreas Butz wrote: "This might be a silly question, but has anyone an idea whether the whole IrDA stack really relies on a two-way connection, or whether there are some parts of it that could be abused for a one-way connection, ideally for unreliable data? We're trying to modify some IR dongles to broadcast information to palm pilots over several meters distance (cover a whole room), and since we don't want to modify the pilots themselves, and increasing the sensitivity on the receiver side seems unlikely to work, we're stuck with a one way link.". Please see the mailing list archive for details of the discussion.

Sent by Marc Bury <Marc.Bury@NETGEM.com> " .. just heard about some Philips new scheme for remote controls: they call it IRDA - Control. This is supposed to be bi-directional, 75 kbps data rate, multiple simultaneous devices (up to 8) and with a minimum 6 meter range!" More information at http://www.irda.org/ .

The german magazine ELEKTOR issued a guide to build a Long Distance IrDA Dongle (20m, RS232, IrDA 1.0), ELEKTOR 5/97 p. http://www.elektor.de .

<tzeruch@ceddec.com>: The main problem is that you generally have to make the receiver more sensitive. Basic physics has the inverse square law: the intensity drops with the SQUARE of the distance, so going from 1 to 5 meters requires 25x the power (and battery drain on a portable device), or 25x the sensitivity (and dynamic range - it still has to be able to work at 3 inches). And if you want to do it on the other end, it doesn't simply have to be 25x more sensitive, it must pick up the tiny IrDA pulse needle in a haystack of florescent lights, screen savers, moving shadows ...

Someone tried it with a Palm III upgrade board http://home.t-online.de/home/PSPilot/ppppiii.htm .

Also laser diodes (pulsable) were recommended by K-H.Eischer: But they are more expensive. And the laser diodes are also dangerous if they have more than 1 mW. A better solution would be to use lenses to focus the beam. There is a minimum of absorbtion in the air (I don't know the right frequency) and you should use IR diodes with this frequency.

James wrote: " Who ever it was wanting to do long distance with IrDA, we've tried this before. The best approaches are:

Whatever you choose IrDA might very well be a good choice for a protocol, given it's one of the few that sensibly copes with simplex."

10.2 Upcoming Standards (Bluetooth and IrDA)

"More and more people now think that IrDA and Bluetooth will live happily side by side, and the idea of Bluetooth as the IrDA killer just don't work anymore. IrDA is still unbeatable in price/performance and with the new additions to the standards family like AIR and VFIR, it's really good to see that IrDA is moving in the right direction."


11. Troubleshooting, Mailing List

11.1 General Information

If you encounter problems. Try the following:

11.2 Troubleshooting Techniques

Although I'm not much of a hacker I collected some tricks to track errors or bugs in the Linux/IrDA software.


12. IrDA Network Neighborhood

12.1 Laptop-Printer-PDA

You can take a little peek at http://www.cs.uit.no/linux-irda/snapshots/ircc.gif Drag-n-drop stuff, so you will be able to drop files to your PDA (uses IrOBEX) or drop files to your printer (uses IrLPT) etc.

12.2 Bridging/Routing

James wrote: " ... there is a much better way of doing the briding which is routing. This is entirely user land and requires no kernel patches.

It's in two parts (you may only need one your milage may vary...) the first called irdaipcfg does the following:

1) First part is executed as irdaipcfg ifeth ifirlan daemonizes, then looks for ARP packets on ifirlan, checks that the arp was not generated by the machine on which it is running. The arp contains the ip address of the machine on the other end of the irlan (it was generated by the gratuatous arp in the irlan code). The program then sets up a host route to this ip address via ifirlan, adds a proxy arp to ifeth for it and generates a gratuatous arp on ifeth. It writes the ip address of the client in /var/run/host.ifirlan so you can easily undo all of this from a script.

2) Second part is executed as gratarp ifirlan. Sometimes the gratuatous arp seems to get lost in the pipe work, gratarp deamonizes and spits out a whole stream of the things...

I use them as follows: (you can use them to do whatever you like)

On my host (the machine bolted to my local net) irlanx is brought up as 10.192.0.1 with a netmask of 255.255.255.255 and a broadcast of 10.192.0.1 by my ifup script from /etc/irda/network by irmanager. /etc/irda/network then runs irdaipcfg eth0 irlanx and this does the routing.

From /etc/irda/network


"start")
        echo 1 >/proc/sys/net/ipv4/conf/all/forwarding
        ./ifup ifcfg-${device} 
        /sbin/irdaipcfg ${localnet} ${device} 
    ;;
"stop")
        host=`cat /var/run/host.${device}`
        if [ .$host != . ]; then
          /sbin/arp -d ${host} dev ${localnet}
          /sbin/route delete ${host} dev ${device}
        fi
        ./ifdown ifcfg-${device}
        /sbin/ifconfig ${device} down
    ;;

on the client I set up irlan to use an address on my normal subnet 10.32.32.51 but with netmask 255.255.255.255 (not my usual netmask) I have some static routes which are host 10.192.0.1 dev irlan, and net default gw 10.192.0.1 dev irlan. I run gratarp from the /etc/irda/network, and I can wander arround my house and not lose telnet and ssh sessions ... they are sitting in ftp://bullard.esc.cam.ac.uk/pub/irda "

12.3 IPv6

AFAIK IPv6 has neighbor discovery mechanismem, but I don't have information about Linux/IrDA used with IPv6. Please see the mailing list archive for a discussion of this topic under the subject :"patch-2.2.7-ac1-irda4" .

12.4 DHCP

I have got reports that it is possible to use dhcpcd with IrLAN. Please use latest DHCP software.


13. Linux/IrDA and APM

Fons Botman wrote: "When I hibernate my HP OmniBook 2000CT, (Fn-12 diskimage is written to disk, machine turns off completely) with irtty active and turn it on again, irda does not work. I can see it trying to reply to discovery frames it receives from a windows box, using irdadump on the OmniBook. but the windows PC does not see the replies. If I just kill irattach and remove irtty and serial, and start irattach again, it starts working again. Does this occur with other linux laptops also? Is it a problem in the serial device driver? " Also Pedro Figueiredo reported this problem for a Fujitsu LifeBook 735DX.

Answer by Dag Brattli: "Could you all check if the same thing is happening when your're using PPP (and not using IrDA). I guess the APM stuff shuts down the serial port, so that the driver will need to reinitialize it when waking up again. This is properly implemented by some of the PCMCIA drivers I know about, but I really don't think the serial driver gets any events from the APM system.

So here you have your own little kernel project. Start adding APM support to irport which will be the easiest thing (and also to the FIR drivers), then you can start adding a patch to the serial driver (if needed). Again I think the PCMCIA subsystem may be a good source on how to fix it properly."


14. Known Bugs

If you find a bug, please send a bug report to the mailing list, including dmesg output, and which Linux version, and hardware you are using. Thank you!

Sometimes IrCOMM fails to connect (especially when both devices discover each other. You can disable discovering with echo 0 >/proc/sys/net/irda/discovery)

A CR (carriage return) character cannot be transfered between two linux boxes via IrCOMM with cat file >/dev/irnine and cat /dev/irnine. It causes a strange thing and freezes your Linux box. Compiling the pc87108 device driver non modular crashes the kernel on boot. Temporary solution: compile the driver as a module

IrOBEX may eat some data on receive. The bug is most probably in the user-space side of IrOBEX.


15. FAQ


16. Infrared Remote Control

16.1 Resources

Remote control via infrared is not the aim of the Linux/IrDA project but is included in this HOWTO to cover "Linux and Infrared" more completely. I found three projects which worked on this topic. You may find some links to current information at http:// www.snafu.de/~wehe/index_li.html.

16.2 Infrared Remote Control - IrDA

Two of the above mentioned projects use some kind of selfmade dongle for infrared remote control. There is also a description to build a serial IrDA dongle by yourself in the german ELEKTOR 5/97 p. 28 magazine. Maybe someone can merge these two kind of dongles together.

For a discussion of the relation between Infrared Remote Control and IrDA I quote from the Linux/IrDA mailing list (shortend and modified by wh):

Ryan Shillington wrote: "Remote IR and ASK-IR are very different from FIR or MIR or SIR.

Remote IR and ASK-IR are very low speed and low frequency (but very long range) uses for IR. They operate around 2400 baud.

SIR operates at higher rates, and is meant for long range transmission where you need more than a few characters pass through (unlike a remote control).

MIR is a little faster (less range), but with speeds up to 1.15 Mbps, and FIR (where the devices have to be practically touching) is 4Mbps. The range is inversely proportional to the speed you can send data at.

I'm working on drivers for Remote-IR, but you should know that your IR stuff has to support it. Look for protocols like NEC, RC-5 or RC-0 (those are the most common ones).

You can use SIR to receive Remote Control signals. Set your baud rate nice and low and data will come through. BUT, from my experience, it's not the RIGHT data. It's not being analyzed in the right way, and as such, you can't compute the checksums or check it with its complement.

I have managed to get data in (using SIR) with remote controls. I have been told that SIR will read the remote control stuff differently depending on temperature (although I have never had that experience). "

Lichen Wang <lwang1@ix.netcom.com> wrote in response: "The so-called ASKIR in most laptops etc. is not meant for remote IR devices. ASKIR is meant for Sharp Wizard and Zauaus PDAs and some of Sharp's notebook PCs. Sharp stated this long before IrDA was established and is still supporting it to maintain backward compatibility. Apple's Newton had this capability at one time, too.

Briefly, ASKIR uses 9.6 Kbps (19.2 and 38.4 Kbps are also possible) asynchronous data format of 8 data bits, 1 stop bit, and odd parity. The start bit as well as all 0 bit in data/parity are transmitted as IR square wave at 500 KHz (DASK sub-carrier). The stop bit as well as all 1 bit in data/parity are represented by the absence of any IR transmission.

As you can see, this is totally incompatible with existing IR remote control.

[..]

True. Not only can you use SIR hardware to receive, you can transmit, too. Of course, there are some limitations.

Most IR remote controls use 38 KHz sub-carrier. 3 times 38 is 114, very close to 115.2. You can set the UART to operate at 115.2 Kbps, 7 data bits, no parity, and 1 stop bit - a total of 9 bits. Each 3 cycles of the 38 KHz sub-carrier can be received or transmitted as a byte of 0x5B.

There are some physical limitations in addition to the fact that the sub-carrier must be 38 KHz. The SIR receiver is not as sensitive to 38 KHz as the IR remote receiver designed for that. The SIR transmitter has a much lower duty cycle and thus can not emit a strong sub-carrier either.

IR remote encodes the control signal by turning on and off the sub-carrier at certain specific patterns. Now that you can transmit and receive the sub-carrier, what remains is all in timing.

For transmit, you have to know how many consecutive bytes of 0x5B to send for each burst of the sub-carrier, and how long to be quiet between the bursts.

For receive, you have to know how many of the 0x5Bs you received are consecutive, and how long the gaps were between these groups of consecutive bytes.

[..]

My experience with the IrDA link distance of SIR, MIR and FIR is somewhat different from what Ryan said.

[..]

SIR, MIR and FIR should all work from 0 to 100 cm but in practice:

(a) Some devices may have problems at LONG distances.

When possible, place the two communicating devices no more than 50 cm apart. Low power devices, such as pagers, phones, etc. may have even shorter ranges despite the fact that they use SIR instead of MIR or FIR.

(b) Some devices may have problems at SHORT distances.

Place the two devices at least a few cm apart. Putting the two devices too close to each other can cause troubles.

It is somewhat intuitive that when the link is not reliable we put the two devices closer together. But it is counterintuitive that too close is not good either. The reason is that the light intensity at 1 cm is 10.000 times brighter than that at 100 cm. At 0.5 cm, it is 40.000 times, etc. The IR receiver manufacturers have difficulties to cover this huge dynamic range. We all have problems reading under a 10 W light bulb, but imagine how it feels under a 100.000 W light!

[..]

The IrDA Physical Layer is totally incompatible with the DASK modulation used in IR remote controls. Thus it is not possible to use the same controller function for both FIR and remote control. However, practically all FIR controller chips do include some additional functions to support remote control. National, SMC, and Winbond (just to name a few) all have such I/O chips.

The IR transmitter for FIR and remote control are very similar. I have tried a standard FIR transmitter. It can reach 10 meters for remote control purpose. Thus it performs just as good as transmitters designed for remote control.

The IR receiver for FIR and remote control are somewhat different. A FIR receiver can receive remote control signals but can reach only 1 meter whereas receivers designed for remote control typically can reach 10 meters.

I have an ISA bus adapter with a National I/O chip that supports both FIR and remote control. I also have IR Dongles that include both FIR and remote control receivers. (Plus a transmitter for both modes.) I cannot find any software to support remote control functions. I did my own experiments in DOS (I cannot run Linux yet.) Anybody interest in this? "

Benny Amorsen wrote: "I have a laptop that is supposed to support ASKIR. The mode of the infrared port can be switched to ASKIR in the BIOS. Having to reboot to switch the mode in the BIOS makes it useless, though, so someone would have to find a way to switch on the fly. "

Dag Brattli wrote: It should be possible to use IrControl (formerly IrBus) for IrDA compliant remote controls. I currently don't know about any remote controls using IrControl standard, but there should be some out there (anyone else who knows better?). You should go to the IrDA site (http://www.irda.org) and get the physical layer standard (which includes IrControl I think).

"Normal" IrDA (using IrLAP) is _not_ well suited for remote control because of the connection oriented nature (and just supports 9600bps for connectionless use). The reason for the limited range is eye-safety they say (but I currently don't know why CIR works better using the same power). I have however seen laptops connect at 4-5 meters (but I don't think that any high speed communication would be possible).

Most IrDA chipsets are capable of CIR operation, and it is quite easy to modify the drivers so they talk CIR. Takahide Higuchi has started to look at IrSockets and it would be great if we could open a "raw" Ir(DA) socket which then could send and receive CIR packets. Then all the CIR applications could live in userspace.

I know that Corel is interested in using CIR for controlling the NetWinder (and they actually have running code). Take a look at http://www.slashdot.org/articles/98/12/05/0916216.shtml or http://www.netwinder.org/~ryansh

From the "IrDA Data Link Design Guide" p. 21 by Hewlett-Packard http://www.hp.com/go/ir : " It is possible to transmit and receive signals other than IrDA signals with Hewlett-Packard IR transceivers. For implementation details, please refer to the Application Note, Transceiver Performance with ASK and TV Remote Signals."

From the IR-MAN page http://www.usuarios.com/ib308564/irda.html :

Fortunately, many IrDA devices are compatible with the 38-kbps ASK modulation used in TV remotes. This means that they can work with such kind of infrared type signals. ... However, it seems that there are still many portable computers that can't receive TV infrared stuff.

For desktop computers, there exist two options, depending on the motherboard you have. Usually a Pentium MoBo has an I/O chipset ready for infrared communication. There is a special connector where you can connect the transducer. The other option is buying a serial type transceiver that connects to the standard serial port (RS-232) of the computer. ... PC Remote Control has been tested with success using both type of IrDA devices:

1) IRmate IR-210 Serial Port Infrared Adapter. ... The serial port speed at wich the device sends recognizable data values is 2400 bps. I don't know if this speed will be the same for all the adapters of this type or is an unique characteristic of this model.

Look at the examples of data values received to see how similar are them. There are some infrared commands that change a lot every time, difficulting the recognition. In such cases, a great tolerance in the comparison could be used, but the risk of confusion between different commands will be increased. An apropiate tolerance value for almost all cases is 20.

2) Actisys IR2000L connected to an Asus P2B motherboard. ... There are several serial port speeds that work well, although 4800 bps seems to be the best one. Other adapters of this same type work also well using this speed. Take a look at the samples of data sequences received using this device. Some remote buttons send exactly the same sequence and it's impossible to distinguish between them at all.

3) Asus IR-eye connected to the same MoBo as above. It works as well as the Actisys device.

TV remotes send commands only one way, in a low-speed burst for distances of up to 30 feet. They use directed IR with LEDs that have a moderate cone angle to improve ease-of-use characteristics. Cordless connectivity via IrDA transfers files, point-to-point and bidirectionally, in a high-speed burst for short distances using directed IR with LEDs having a narrow cone angle. IrDA transmissions require relatively careful aiming, and they're easy to block. For this reason, don't expect a great distance while working with the remote unit.

Alessio Massaro <Alessio.Massaro@cern.ch>: wrote: " IrDA doesn't talk to tv-remotes, but it does have the IrCOMM layer to emulate a serial i/f. My guess is that to get LIRC working with it, you should just need ... to read from the IrCOMM virtual serial device (as you would with a /dev/cua or whatever) and use a remote that can be seen by your dongle+IrDAheader pair."

Answer by Dag Brattli: "You are talking about being normal serial ports, but that is something at least I have choosen IrDA not to be. I have implemented all the device drivers as network device drivers, so things are a bit different (more frame oriented). The device drivers deliver IrDA frames and currently nothing else.

But I don't think that we must have a tty interface to the IrDA device drivers in order to support more RAW reads and writes. And btw. forget about IrCOMM, it has nothing to do with this issue.

I have actually already implemented support for raw reads and writes for the device drivers, since some of the dongles require this."


17. Infrared and Eye Safety

This section summarizes some ideas and thoughts that were exchanged on the Linux/IrDA mailing list. It is not medically wellfounded, and whoever has better evidence or some more wellfounded source of information is encouraged to contribute it to this HOWTO.

The IrDA spec says that the range of IrDA devices has been limited to 1m for reasons of eye safety. Another plausible assumption is that power consumption and IR pollution/crosstalk were reasons for this limitation. In principle there could be danger for the eye, because infrared light is not registered by the eye, and thus the pupil won't close in order to protect the retina from bright IR light sources. This is the same situation as with UV light, which will cause snow blindness eventually, but in contrast to UV light, IR light contains much less harmful energy due to its longer wavelength.

The only legal restrictions and medical advices we were able to find on the web were concerned with infrared emissions of heat lamps or in the welding process and IEC 825-1 (CENELEC EN60825-1). This suggests that IR light as emitted by IrDA devices will be harmless, since even the peak power emitted by strong IR LEDs (ca. 300mW) is several orders of magnitude below the power emitted by medical IR heat lamps (up to 500W). For these, however, you are supposed to wear protective goggles, so maybe if you are looking straight into 1.000 infrared LEDs flashing at once, you should do so, too. The effect of infrared light is mostly heat, though, and not an alteration or destruction of the biological cell structure, such as caused by UV light. Though in the specs for the HP OmniBook 800 Hewlett-Packard recommends not to look directly into the IR LED.

As stated above, this discussion is only based on guesswork and common sense assumptions about the data found in IR LED and heat lamp specs. If anybody with a better medical knowledge can comment on this, please do so!!!


18. Credits

Thanks to:

Sorry I didn't start to follow the credits when starting the HOWTO, so probably I forgot somebody.


19. Revision History


20. Copyright and Disclaimer

Copyright © 1998, 1999 by Werner Heuser. This document may be distributed under the terms set forth in the LDP license at LDP.

The information in this document is correct to the best of my knowledge, but there's a always a chance I've made some mistakes, so don't follow everything too blindly, especially if it seems wrong. Nothing here should have a detrimental effect on your computer, but just in case I take no responsibility for any damages incurred from the use of the information contained herein.


21. Appendix A - Configuration Script

Configuration script by Ove Ewerlid (please change to new major device numbers, wh):


#!/bin/sh

# You may have problems if kerneld is running!

killall irattach
killall irmanager

sleep 1

rm -f /dev/ircomm 
mknod /dev/ircomm c 60 64

rmmod ircomm_tty
rmmod ircomm
rmmod irtty
rmmod irda

insmod irda
insmod irtty
insmod ircomm
insmod ircomm_tty

irmanager    # executes 'irattach /dev/ttyS1' based on /etc/irda/drivers


# Now start your favorite PPP software on /dev/ircomm

# The 'no activity on link' happens if you move the phone out of IR sight, this is no problem once the phone is back in sight!

# Mar 10 12:31:41 octagon kernel: Linux-2.2 Support for the IrDA (tm) Protocols (Dag Brattli)
# Mar 10 12:31:41 octagon kernel: IrCOMM_common, $Revision: 1.13 $ $Date: 1998/10/13 12:59:05 $ (Takahide Higuchi)
# Mar 10 12:31:41 octagon kernel: IrVTD, $Revision: 1.2 $ $Date: 1998/09/27 08:37:04 $ (Takahide Higuchi)
# Mar 10 12:31:41 octagon irmanager: executing: './drivers start  0'
# Mar 10 12:31:41 octagon irmanager: + 0.1 Fri Jul 25 11:45:26 1997 Dag Brattli
# Mar 10 12:31:41 octagon irattach: Serial connection established.
# Mar 10 12:31:41 octagon kernel: IrDA device irda0 registered.
# Mar 10 12:31:41 octagon irmanager: + 0.1 Fri Jul 25 11:45:26 1997 Dag Brattli
# ...  
# Mar 11 13:13:43 octagon kernel: IrLAP, no activity on link!


22. Appendix B - Serial Infrared Port Sniffers

22.1 Sniffer by Gerd Knorr

This programm is a courtesy by Gerd Knorr. You may use it to sniff the traffic which is going trough your IrDA port for details of the protocol (change the default ttyS1 in the source if necessary):


#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <string.h>
#include <fcntl.h>
#include <termios.h>
#include <ctype.h>
#include <sys/types.h>
#include <sys/time.h>
#include <sys/ioctl.h>

#define BUFSIZE 1024

int
read_and_print(int fd, int sec, int usec)
{
    int             rc,l,i;
    char            buf[BUFSIZE+1];
    fd_set          set;
    struct timeval  tv;
    
    if (sec || usec) {
        FD_ZERO(&set);
        FD_SET(fd,&set);
        tv.tv_sec  = sec;

        tv.tv_usec = usec;
        if (0 == select(fd+1,&set,NULL,NULL,&tv))
            return -1;
    }
    
    switch (rc = read(fd,buf,BUFSIZE)) {
    case 0:
        printf("EOF");
        exit(0);
        break;
    case -1:
        perror("read");
        exit(1);
    default:
        for (l = 0; l < rc; l+= 16) {
            printf("%04x  ",l);
            for (i = l; i < l+16; i++) {
                if (i < rc)
                    printf("%02x ",buf[i]);
                else
                    printf("-- ");
                if ((i%4) == 3)
                    printf(" ");
            }
            for (i = l; i < l+16; i++) {

                if (i < rc)
                    printf("%c",isalnum(buf[i]) ? buf[i] : '.');
            }
            printf("\n");
        }
        break;
    }
    return rc;
}

void
setlines(int fd, int rts, int dtr)
{
    int lines = 0;

    if (rts) lines |= TIOCM_RTS;
    if (dtr) lines |= TIOCM_DTR;
    
    ioctl(fd,TIOCMSET,&lines);
}

int main(int argc, char *argv[])
{
    int                 ser,i;
    struct termios      saved_attributes,tattr;
    struct winsize      win;
    char                buf[16];
    
    if (-1 == (ser = open("/dev/ttyS1",O_RDWR))) {
        perror("open /dev/ttyS1");
        exit(1);
    }
        
    /* Set the terminal mode */
    tcgetattr (ser, &tattr);
    cfmakeraw (&tattr);
    cfsetospeed (&tattr,B9600);
    cfsetispeed (&tattr,B9600);
    tcsetattr (ser, 0, &tattr);
    
    setlines(ser,0,0);
#if 0
    tcsendbreak(ser,0);
#endif

    /* main loop */
    fprintf(stderr,"setup done\n");
    while (-1 != read_and_print(ser,30,0)) {
        usleep(100000);
    }
    
    return 0;
}

22.2 sersniff

Written by Jonathan McDowell sersniff is a simple program to tunnel/sniff between 2 serial ports. The program was written to aid with the decoding of the protocol used by the Nokia 9000i Communicator to talk to the NServer software Nokia provides, which only runs under Windows.


23. Appendix C - User space application for Psion 5 Palmtop Computers: psion.c


/*********************************************************************
 *                
 * Filename:      psion5.c
 * Version:       0.1
 * Description:   User space application for Psion 5 Palmtop Computers
 * Status:        Experimental.
 * Author:        Fons Botman <budely@tref.nl>
 * Created at:    Mon Apr 19 21:51:29 CEST 1999
 * 
 *     Copyright (c) 1999, Fons Botman, All Rights Reserved.
 *      
 *     This program is free software; you can redistribute it and/or 
 *     modify it under the terms of the GNU General Public License as 
 *     published by the Free Software Foundation; either version 2 of 
 *     the License, or (at your option) any later version.
 *  
 *     Neither Fons Botman nor anyone else admit liability nor
 *     provide warranty for any of this software. This material is 
 *     provided "AS-IS" and at no charge.
 *     
 ********************************************************************/

#include <unistd.h>
#include <stdlib.h>
#include <string.h>
#include <fcntl.h>
#include <stdio.h>
#include <errno.h>
#include <assert.h>
#include <signal.h>
#include <time.h>
#include <sys/types.h>
#include <utime.h>

#include <sys/stat.h>
#include <sys/ioctl.h>
#include <netinet/in.h>

#include <sys/socket.h>
#include <linux/types.h>
#include <linux/irda.h>

#ifndef AF_IRDA
#define AF_IRDA 23
#endif /* AF_IRDA */




#define MAX_DEVICES 10

int discover_devices(int fd)
{
        struct irda_device_list *list;
        unsigned char *buf;
        int len;
        int i;
        int daddr = 0;

        len = sizeof(struct irda_device_list) +
                sizeof(struct irda_device_info) * MAX_DEVICES;

        /* FIXME */
        system("echo 150 > /proc/sys/net/irda/slot_timeout");
        
        if (!(buf = malloc(len))) {
                fprintf(stderr, "Could not allocate discovery buffer.\n");
                exit(1);
        }
        list = (struct irda_device_list *) buf;

        /* FIXME: discovery does not return when there are no devices */
        if (getsockopt(fd, SOL_IRLMP, IRLMP_ENUMDEVICES, buf, &len)) {
                perror("getsockopt");
                exit(-1);
        }

        if (len > 0) {
                printf("Discovered:\n");

                for (i=0;i<list->len;i++) {
                        printf("  daddr: %08x", list->dev[i].daddr);
                        printf("  saddr: %08x", list->dev[i].saddr);
                        printf("  name:  %s\n", list->dev[i].info);
                        daddr = list->dev[i].daddr;
                }
        } else {
                printf("No devices discovered.\n");
        }
                    
        return daddr;
}


int irttp_get_mtu(int fd) {
        int mtu;
        int len = sizeof(int);
        /* Check what the IrTTP data size is */
        if (getsockopt(fd, SOL_IRLMP, IRTTP_MAX_SDU_SIZE, 
                       (void *)&mtu, &len)) {
                return -1;
        }
        return mtu;
}


int sendfile(char* filename) {
        int fd;
        struct sockaddr_irda peer;
        int daddr;
        FILE* f;
        int buflen;
        char *buf;
        int rc;
        struct stat s;
        int cnt;
        int t0, tx, t;
        unsigned long long int fdatell;

        fd = socket(AF_IRDA, SOCK_STREAM, 0);
        if (fd < 0) {
                perror("socket");
                if (errno == EINVAL) 
                        fprintf(stderr, "Is IrDA active?, perhaps run irmanager\n");
                exit(-1);
        }

        /* FIXME: We should use a better/any device selection mechanism */
        daddr = discover_devices(fd);
        if (!daddr) {
                fprintf(stderr,"No IRDA device found\n");
                exit(1);
        }

        peer.sir_family = AF_IRDA;
        peer.sir_addr = daddr;
        strcpy(peer.sir_name, "Epoc32:EikonIr:v1.0");

        if (connect(fd, (struct sockaddr *) &peer, 
                    sizeof(struct sockaddr_irda))) {
                perror("connect");
                if (errno == ENETUNREACH)
                        /* P5: System ^L IrDA is active, 
                           but IR-receive not selected */
                        fprintf(stderr, 
                                "No Psion5 or IR-receive is not selected\n");
                exit(-1);
        }
        printf("Connected to %x\n", daddr);

        buflen = irttp_get_mtu(fd);
        printf("mtu = %d\n", buflen);
        if (buflen < 2) {
                perror("irttp_get_mtu");
                exit(1);
        }
        if (!(buf = malloc(buflen))) {
                perror("malloc");
                exit(1);
        }
        /* 
           FIXME : I got strange results when the buffer size was less than 
           the mtu (e.g. 200), the psion did not seem to see the frames were 
           not full length, and stopped after the number of frames based on 
           the full mtu size.
           investigate.
        */

        /* 
           FIXME : psion connects to port 2, but does not get error back
           from us. Linux bug?
        */

        if (!(f = fopen(filename,"rb"))) {
                perror(filename);
                exit(1);
        }

        rc = stat(filename,&s);
        if (rc != 0) {
                perror("stat");
                exit(1);
        }

        /* FIXME map psion mode bits to unix filemodes */

        fdatell = 62168263200000000ULL + 1000000 * 
                ( s.st_mtime & 0x00000000FFFFFFFFULL);
        printf("date: %Ld\n", (unsigned long long) s.st_mtime);
        printf("date: %Ld\n", fdatell);
        sprintf(buf,"FILE %d %d %lu %lu %s", 
                (int) s.st_size,
                32 | (s.st_mode & S_IWUSR ? 0 : 1),
                (unsigned long) ((unsigned long long int) fdatell >> 32),
                (unsigned long) (fdatell & 0x00000000FFFFFFFFULL),
                filename);
        rc = write(fd,buf,strlen(buf));
        if (rc != strlen(buf)) {
                perror("write");
                fprintf(stderr,"rc = %d, strlen=%d\n", 
                        rc, strlen(buf));
                exit(1);
        }
        printf("sent: %s\n", buf);
        rc = read(fd,buf,buflen-1);
        printf("Received (%d) ", rc);
        if (rc < 0) {
                perror("reply error");
                exit(1);
        }
        if (rc == 0) {
                fprintf(stderr, "EOF on reply?\n");
                exit(1);
        }
        if (rc < buflen) {
                buf[rc] = 0;
        }
        /* should be "ACK Y" */
        if (0 != strcmp(buf,"ACK Y")) {
                fprintf(stderr, "Unexpected response: %s\n", buf);
                exit(1);
        }
        printf("%s\n", buf);

        cnt = 0;
        t0 = tx = t = time(NULL);

        while (!ferror(f) && !feof(f)) {
                int wrc;

                rc = fread(buf, 1, buflen, f);
                if (rc == 0) continue;

                wrc = write(fd,buf,rc);
                if (wrc < 0) {
                        perror("write");
                        exit(1);
                }
                if (wrc < rc) {
                        fprintf(stderr, "Problem: only sent %d of %d\n", 
                                wrc, rc);
                        exit(1);
                }

                /* progress indication */
                t = time(NULL);
                cnt += rc;
                if (t - t0 == 0 || cnt == 0 || tx == t)
                        /* avoid division errors */
                        /* only once per second */
                        continue;
                tx = t;
                printf("sent %d/%lu bytes=%4g%% in %d sec," 
                       " %g Kbytes/s, to go %li sec  \r", 
                       cnt, s.st_size, 100.0 * cnt / s.st_size, t - t0,
                       cnt / 1000.0 / (t - t0), 
                       ( s.st_size - cnt ) * (t - t0) / cnt);
                fflush(stdout);
        }
        if (ferror(f)) {
                perror("ferror");
                exit(1);
        }
        if (cnt != s.st_size) {
                printf("Warning: "
                       "file size changed: initial: %lu, actual: %d\n",
                       s.st_size, cnt);
        }
        if (t == t0) t++;       /* white lie for fast transfers */
        printf("\r%79s\r","");  /* Cleanup the progress line */
        printf("Sent %s, %d bytes in %d sec. %g KBytes/sec\n",
               filename, cnt, t - t0, cnt / 1000.0 / (t - t0));

        /* Check for close on the other side */
        rc = read(fd,buf,buflen);
        if (rc > 0) {
                fprintf(stderr, "Strange: the other side responded.\n");
                fprintf(stderr, "rc=%d, data:%s\n", rc, buf);
                exit(1);
        }
        if (rc == 0) {
                fprintf(stderr, "Received end of file.\n");
        }
        if (rc == -1) {
                if (errno == EPERM) {
                        /* Strange error code to get in this case */
                        printf("Other side closed connection, OK\n");
                } else {
                        perror("last read");
                        exit(1);
                }
        }

        close(fd);
        return 0;
}

int handle_client(int cfd) {
        int buflen;
        char* buf;
        int rc;

        /* fields of file transfer header */
        unsigned int fsize;
        unsigned int fmode;
        unsigned int fdate1;
        unsigned int fdate2;
        char* fname;

        unsigned int fdate;
        unsigned long long int fdatell;

        FILE* f;
        int cnt;

        int t0, tx, t;

        buflen = irttp_get_mtu(cfd);
        printf("mtu=%d\n", buflen);
        if (buflen < 2) {
                perror("irttp_get_mtu");
                exit(1);
        }
        if (!(buf = malloc(buflen))) {
                fprintf(stderr, "malloc buf failed\n");
                exit(1);
        }

        /* Wait for the other side to send a header */
        /* 
           Sample headers received:
           DATA 185
           FILE 55175 32 14689800 2691219200 Data
                size mode datehi  datelo     name
        */

        rc = read(cfd, buf, buflen);
        if (rc < 0) {
                perror("1st read");
                exit(1);
        }
        if (rc == 0) {
                perror("1st read 0");
                exit(1);
        }
        assert(rc < buflen);
        buf[rc] = 0;
        printf("%s\n", buf);

        fsize = 0;
        fdate = 0;
        if (0 == strncmp(buf, "FILE ", 5)) {
                cnt = 0; /* to be safe */
                rc = sscanf(buf, "FILE %u %u %u %u %n", 
                            &fsize, &fmode, &fdate1, &fdate2,
                            &cnt);
                if (!(rc == 4 || rc == 5)) {
                                /* grumble */
                        fprintf(stderr, "sscanf rc=%d\n", rc);
                        exit(1);
                }
                assert(cnt < buflen);
                fname = strdup(buf+cnt);
                fdatell = ((unsigned long long int) fdate1 << 32) + fdate2;
                fdate = ( fdatell - 62168263200000000ULL) / 1000000 ;
                
                printf("filename: %s\n", fname);
                printf("filesize: %d\n", fsize);
                printf("Filemode: %d", fmode);
                printf("%s", (fmode &  1 ? ", Readonly" : ""));
                printf("%s", (fmode &  2 ? ", Hidden" : ""));
                printf("%s", (fmode & 32 ? ", Modified" : ""));
                printf("%s", (fmode & ~35 ? ", Unknown" : ""));
                printf("\n");
                printf("fdate1:   %u = 0x%x\n", fdate1, fdate1);
                printf("fdate2:   %u = 0x%x\n", fdate2, fdate2);
                printf("filedate: %Ld\n", fdatell);
                printf("filedate: %d = %s", fdate, 
                       asctime(gmtime((time_t*)&fdate)));

                if (!(f = fopen(fname,"wb"))) {
                        perror(fname);
                        exit(1);
                }
        } else if (0 == strncmp(buf, "DATA ", 5)) {
                cnt = 0; /* to be safe */
                rc = sscanf(buf, "DATA %d", &fsize);
                if (rc != 1) {
                        fprintf(stderr, "sscanf rc=%d\n", rc);
                        exit(1);
                }
                assert(cnt < buflen);
                fname = strdup("/tmp/psion5-data");
                if (!(f = fopen(fname,"wb"))) {
                        perror(fname);
                        exit(1);
                }
        } else {
                fprintf(stderr, "Unknown data type: %s\n", buf);
                                /* exit(1); */
        }

        rc = write(cfd,"ACK Y",5);
        if (rc != 5) {
                perror("1st write");
                fprintf(stderr,"1st write rc = %d\n", rc);
                exit(1);
        }
                        
        cnt = 0;
        t0 = tx = t = time(NULL);
        while (cnt < fsize) {
                int wrc;
                rc = read(cfd,buf,buflen);
                if (rc < 0) {
                        perror("data read");
                                /* EPERM on disconnect ? */
                        exit(1);
                }
                if (rc == 0) {
                        perror("data read 0");
                        exit(1);
                }
                wrc = fwrite(buf,rc,1,f);
                if (wrc != 1) {
                        perror("fwrite");
                        exit(1);
                }
                cnt += rc;

                /* progress indication */
                t = time(NULL);
                if (t - t0 == 0 || cnt == 0 || tx == t)
                        /* avoid division errors */
                        /* only once per second */
                        continue;
                tx = t;
                printf("got %d/%u bytes=%g%% in %d sec,"
                       " %g Kbytes/s, to go %i sec  \r", 
                       cnt, fsize, 100.0 * cnt / fsize, t - t0,
                       cnt / 1000.0 / (t - t0), 
                       ( fsize - cnt ) * (t - t0) / cnt);
                fflush(stdout);
        }
                
        if (cnt != fsize) {
                printf("Warning: "
                       "file size changed: initial: %u, actual: %d\n",
                       fsize, cnt);
        }
        if (t == t0) t++;       /* white lie for fast transfers */
        printf("\r%79s\r","");  /* Cleanup the progress line */
        printf("Received %s, %d bytes in %d sec. %g KBytes/sec\n",
               fname, cnt, t - t0, cnt / 1000.0 / (t - t0));

        rc = fclose(f);
        if (rc != 0) {
                perror("fclose");
                exit(1);
        }
        if (fdate) {
                struct utimbuf utb;
                utb.actime = fdate;
                utb.modtime = fdate;
                rc = utime(fname,&utb);
                if (rc != 0) {
                        perror(fname);
                }
        }
        free(fname);
        close(cfd);
        return 0;
}

int receivefile(int mode)
{
        /* 
           The Psion 5 tries the following connections:
           Epoc32:EikonIr:v1.0  IrDA:TinyTP:LsapSel
           IrDA:IrCOMM          Parameters
           IrLPT                IrDA:IrLMP:LsapSel
           connect on 2

           Warning: discovery reply after 101ms
        */

        int addrlen = sizeof(struct sockaddr_irda);
        /* int oflags; */
        /* int mtu; */
        int fd;
        struct sockaddr_irda peer;
        int cfd;

        /* Create socket */
        fd = socket(AF_IRDA, SOCK_STREAM, 0);
        if (fd < 0) {
                perror("socket");
                exit(-1);
        }

        /* Bind local service */
        peer.sir_family = AF_IRDA;
        strcpy(peer.sir_name, "Epoc32:EikonIr:v1.0");
        peer.sir_lsap_sel = LSAP_ANY;
        
        if (bind(fd, (struct sockaddr*)&peer, sizeof(struct sockaddr_irda))) {
                        perror("bind");
                        return -1;
        }

        if (listen(fd, 2)) {
                perror("listen");
                return -1;
        }

        /* FIXME: allow more simultaneous clients */
        for (;;) {
                cfd = accept(fd, (struct sockaddr *) &peer, &addrlen);
                if (cfd < 0) {
                        perror("accept");
                        return -1;
                }

                if (handle_client(cfd))
                        break;
               
                if (mode == 1)
                        break;
        }

        sleep(1);
        close(fd);
        return 0;
}


int
main(int argc, char* argv[]) {
        char* argv0 = argv[0];

        if (argc <= 1) {
                fprintf(stderr, "Usage: %s [-s file] [-r] [-d]\n", argv0);
                fprintf(stderr, "\t-s file\tSend file to the Psion\n");
                fprintf(stderr, "\t-r\tReceive a file from the Psion\n");
                fprintf(stderr, "\t-b\tReceive multiple files (batch mode)\n");
                exit(1);
        }
        
        /* skip program name */
        argv++; argc--;

        for ( ; argc>0 && argv[0] ; argc-- , argv++) {
                if (0 == strcmp(argv[0],"-s")) {
                        /* FIXME: sending multiple files does not
                           work yet. We need to wait for the user
                           to select receive again on the psion */
                        if (argv[1] && 0 == strcmp(argv[1],"--")) {
                                /* Allow the user to send ANY filename */
                                argv++; argv++;
                                for ( ; argv[1] ; argv++ , argc--) {
                                        sendfile(argv[1]);
                                }
                        } else {
                                /* Send files upto next switch */
                                while (argv[1] && *argv[1] != '-') {
                                        sendfile(argv[1]);
                                        argv++; argc--;
                                }
                        }
                } else if (argv[0] && 0 == strcmp(argv[0],"-r")) {
                        receivefile(1);
                } else if (argv[0] && 0 == strcmp(argv[0],"-b")) 
                        receivefile(0);
                else {
                        fprintf(stderr,"Error: unknown switch %s\n", argv[0]);
                        fprintf(stderr,"Call without args for usage: %s\n", 
                                argv0);
                        exit(1);
                }
        }
        return 0;
}