README

   1 BCU 1 driver for Linux 2.6
   2 --------------------------
   3
   4 Supported Linux versions: 2.6.14 - 2.6.31
   5 Supported Hardware: Any PC with 16550A compatible serial ports (only tested on i386 Linux)
   6
   7 This is a driver to handle the low level protocol (PEI16)
   8 to communicate with a KNX/EIB BCU 1 (or a BCU 2 configured to use PEI16).
   9
  10 It can be used to send/receive EMI 1 messages.
  11 eibd (part of the BCU SDK, http://www.auto.tuwien.ac.at/~mkoegler/index.php/bcusdk)
  12 provides a high level interface on top of it. Several
  13 existing applications also use this driver directly.
  14
  15 bcu1driver 0.2.6.5.1 is the last version, which supports kernels between
  16 2.6.10 and 2.6.13
  17
  18 Usage:
  19 ------
  20
  21 Ensure that the build files of the current kernel are available at
  22 the default location:
  23 ls -l /lib/modules/`uname -r`/build/
  24
  25 Fedore Core ships them as part of the kernel image, SuSE in the
  26 kernel source packages.
  27
  28 Extract the driver and run
  29 make
  30
  31 Load the driver (as root):
  32 insmod eib-common.ko
  33 insmod eib-8250.ko
  34 insmod eib-pei16.ko
  35
  36 If you are using udev, /dev/eib0 to /dev/eib4 are created automatically.
  37 To grant access to all users, copy eib.rules to the udev rule directory.
  38
  39 If you are not using udev, do the following as root:
  40 mknod /dev/eib0 c `grep "eib" /proc/devices |cut -d' ' -f1` 0
  41 mknod /dev/eib1 c `grep "eib" /proc/devices |cut -d' ' -f1` 1
  42 mknod /dev/eib2 c `grep "eib" /proc/devices |cut -d' ' -f1` 2
  43 mknod /dev/eib3 c `grep "eib" /proc/devices |cut -d' ' -f1` 3
  44
  45 Each device corresponds to a serial port (e.g., /dev/ttyS0 to /dev/eib0).
  46 To use a port, the serial driver must be detached (as root):
  47 setserial /dev/ttyS0 uart none
  48
  49 To start eibd on it, use:
  50 eibd -u bcu1:/dev/eib0
  51
  52 To use different settings (I/O port, IRQ, UART base frequency), echo the new values
  53 to /sys/bus/platform/devices/eib/eib[0-4]/(base|irq|port).
  54 Make sure that you use the correct notation (eg. hex for the port). Read the file
  55 after the change to verify.
  56
  57 The settings become effective at the next open of the device.
  58
  59 Ports:
  60 ------
  61 If you are not using a 8250 compatible UART, you must port eib-8250.c
  62 to your UART. There is an (untested) port to the PXA CPU in eib-pxa.c.
  63
  64 ----------------------------------------------------------------------
  65
  66 Questions should be directed to the mailing list:
  67 http://lists.sourceforge.net/lists/listinfo/bcusdk-list
  68 List archive:
  69 http://sourceforge.net/mailarchive/forum.php?forum_id=47098
  70
  71 Martin Koegler
  72 mkoegler@auto.tuwien.ac.at