<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">

<head>
  <title>fhem.pl - Hints for GNU/Linux</title>
  <script type="text/javascript" src="fhemdoc.js"></script>
  <noscript>
    <link rel="stylesheet" type="text/css" href="../www/pgm2/style.css" />
  </noscript>
  <meta http-equiv="Content-type" content="text/html;charset=ISO-8859-1"/>
</head>

<body>
  <div id="menuScrollArea">
    <div id="logo"></div>
    <div id="menu">
      <h3>fhem.pl - Hints for GNU/Linux</h3>
      Version: <b>EN</b>&nbsp;<a href="linux_DE.html">DE</a>
    </div>
  </div>

  <div id="right">


<h2>fhem.pl - Hints for GNU/Linux</h2>

<table border=1><tr><td>
  Note: Depending on the GNU/Linux distribution (Debian, openSuSE, etc.) and
  version of the Linux kernel you may or <i>may not</i> have to do the
  following steps.<br>

  It is worth giving it a try without any modifications <b>first</b>.<br> We
  have convinced the kernel developers to enable all (currently known) ELV
  devices by default. Starting with kernel 2.6.24.2 (e.g. openSUSE 11) the
  changes below are <b>not</b> required. You can check your running kernel
  version using the command:
  <code><br>uname -r<br></code>
</td></tr></table>

<hr>

<p><b><a name="onedevice">One device</a></b><br>
  If you connect one USB device (FHZ1000PC, FHZ1300PC, EM1010PC, WS300, ...) to
  your GNU/Linux server you can use the regular <i>ftdi_sio</i> kernel module.
  However, it may not recognize our device. Therefore you need to get the
  <i>vendor</i> and <i>product</i> codes:
  <code><br>
  # lsusb<br>
  ...<br>
  Bus 002 Device 002: ID <b>0403</b>:<b>e0e8</b> Future Technology Devices International, Ltd <br>
  ...<br>
  </code><br>

  Now you need to edit your <code>/etc/modprobe.conf</code> or
  <code>/etc/modprobe.conf.local</code> file (depending on your distribution).
  Add the following line to it:<br>

  <code><br>
  options ftdi_sio vendor=0x<b>0403</b> product=0x<b>e0e8</b><br>
  </code><br>
  Replace the vendor and product code with the output of the <i>lsusb</i>
  command. The you load the module using:<br>
  <code><br>
  # modprobe ftdi_sio<br>
  </code><br>

<hr>


<p><b><a name="multipledevices">Multiple devices</a></b><br>
If you're using multiple USB devices (FHZ1000PC, FHZ1300PC, EM1010PC, WS300,
...) you cannot use the method above. You need to modify the ftdi_sio kernel
module to make it work. The following example was done with openSuSE 10.1:<br>
You need to have the kernel-source-<i>version</i> RPM of your current kernel
(see output of <code>uname -r</code>) installed.<br>

  <code><br>
  # cd /usr/src/linux<br>
  # make cloneconfig<br>
  # make modules_prepare<br>
  # cp /boot/symvers-2.6.*-default.gz /usr/src/linux<br>
  # mv symvers-2.6.*-default.gz Module.symvers.gz<br>
  # gunzip /usr/src/linux/Module.symvers.gz<br>
  # make modules_prepare<br>
  # cd drivers/usb/serial<br>
  </code>

  For the EM1010PC you (may) need to add the following line:
  <code><br>
  # vi ftdi_sio.h<br>
  ...<br>
  #define FTDI_ELV_WS500_PID 0xE0E9   /* PC-Wetterstation (WS 500) */<br>
  <b>#define FTDI_ELV_EM1010PC_PID 0xE0EF   /* EM 1010 PC */</b><br>
  </code><br>
  Now we need to uncomment some lines to enable all of our devices.
  <code><br>
  # vi ftdi_sio.c<br>
  ...<br>
   { USB_DEVICE(FTDI_VID, FTDI_ELV_WS300PC_PID) }, <br>
   { USB_DEVICE(FTDI_VID, FTDI_ELV_FHZ1300PC_PID) },<br>
   { USB_DEVICE(FTDI_VID, FTDI_ELV_WS500_PID) }, <br>
   { USB_DEVICE(FTDI_VID, FTDI_ELV_EM1010PC_PID) },<br>
  ...<br>
  </code><br>
  Remove the <b>/*</b> and <b>*/</b> of your devices and save the file.
  <br>
  <code>
  # cd /usr/src/linux<br>
  </code>
  Now you have 3 choices:<br>
  <table border=1>
  <tr><td>
  <code>
  # mv Module.symvers Module.symvers.notneeded<br>
  # make M=drivers/usb/serial</code>
  <td>
  ... to build the modules for all of <i>usb serial</i>.<br>
  If you have a less powerful machine like the ARM-Based NSLU2 then it is
  sufficient to only build the required module.
  </td></tr>
  <td><code>
  # make modules</code>
  </td><td>
  ... to build all modules (takes a long time).
  </td></tr>
  <tr><td>
  <code>
  # make driver/usb/serial/ftdi_sio.ko
  </code>
  </td><td>
  ... to build just the <i>ftdi_sio.ko</i> module. However, this does not seem
  to be working always.

  </td></tr>
  </table>
  Once you have the module:<br>
  <code><br>
  # cd /lib/modules/<i>yourKernelVerion</i>/kernel/drivers/usb/serial<br>
  # cp ftdi_sio.ko ftdi_sio.ko_backup<br>
  # cp /usr/src/linux/drivers/usb/serial/ftdi_sio.ko .<br>
  </code><br>
  To activete it you may need to stop applications (like fhem) who
  are using the /dev/ttyUSB device and unload the module and load it again.<br>
  <code><br>
  # rmmod ftdi_so<br>
  # modprobe ftdi_so<br>
  </code><br>
  You should now see multiple ttyUSB devices:
  <code><br>
  # ls -l /dev/ttyUSB*<br>
  crw-rw---- 1 root uucp 188, 0 2007-02-11 23:00 /dev/ttyUSB0<br>
  crw-rw---- 1 root uucp 188, 1 2007-02-11 23:00 /dev/ttyUSB1<br>
  </code><br>
<hr>

<p><b><a name="devicelinks">Device links</a></b><br>
  If you're using multiple USB devices (FHZ, EM, WS...) it might occur that the
  enumeration of the /dev/ttyUSB<i>n</i> numbers get mixed up if one of the
  device is missing or after a reboot.<br> Starting with kernel 2.6 the UDEV
  implements means for using virtual names instead of the bare numbers.<br>
  Edit the file <code>/etc/udev/rules.d/10-udev.rules</code> (create if
  necessary) and insert the following lines: <br>

  If you use udev prior to version 103:<br>
  <code>
  KERNEL=="ttyUSB*", SYSFS{product}=="ELV FHZ 1300 PC", SYMLINK+="elv_fhz1300pc"<br>
  KERNEL=="ttyUSB*", SYSFS{product}=="ELV EM 1010 PC", SYMLINK+="elv_em1010pc"<br>
  </code><br>
  Starting with udev 103 the SYSFS will be replaced by ATTRS:
  <br>
  <code>
  KERNEL=="ttyUSB*", ATTRS{product}=="ELV FHZ 1300 PC", SYMLINK+="elv_fhz1300pc"<br>
  KERNEL=="ttyUSB*", ATTRS{product}=="ELV EM 1010 PC", SYMLINK+="elv_em1010pc"<br>
  </code><br>

  Now you need to reload (rmmod/modprobe) the ftdio_sio kernel module to 
  use the device paths <code><b>/dev/elv_fhz1300pc</b></code> or
  <code><b>/dev/elv_em1010pc</b></code> in your FHEM configuration file.

<hr>
<p><b><a name="log">Perl Device::SerialPort</a></b><br>
  On debian you may install the missing Device::SerialPort package with:
  <pre>
  apt-get install libdevice-serialport-perl
  </pre>

<hr>
<p><b><a name="log">Logfile config</a></b><br>
  For a weekly fhem.log rotation add to /etc/logrotate.conf:<br>
  <pre>
  /var/log/fhem.log {
    missingok
    weekly
    copytruncate
    rotate 5
    compress
  }
  </pre>
  </div>

</body>
</html>