Changes ======= 3.5p1: Initial release of linux package. 3.5p2: run_pcbase did not export LD_LIBRARY_PATH. This caused the software to not load on systems that do not have 32 bit libusb and libftdi installed. 3.5p3: Updated to livecam 4.4 3.5p4: Updated to Livecam 4.6 and modem driver version 1.5 3.6p1: Updated to livecam 4.7, pcbase 3.6, and driver version 1.6 3.6p2: Updated to livecam 4.8. 3.6p4: Updated driver to version 1.7 3.6p6: Updated driver to version 1.8 3.6p7: Updated driver to version 2.0 3.6p8: Updated livecam to version 4.9 3.6p9: Updated driver to version 2.1 3.7p1: Updated to PCBase 3.7 3.7p2: Updated to LiveCam 5.1 3.8p1: Updated to PCBase 3.8 3.9p2: Updated to PCBase 3.9 3.9p4: Updated to livecam 5.3 and driver version 2.4 System Requirements =================== 192 MB RAM USB port x86 processor (needs multilib distribution for x86-64) Wine 1.x 400 MHz CPU 2.6 kernel The driver for the Orion PCBase runs in user mode and was developed under Slamd64 12.x. It is meant to be distribution independant and should only require udev rules. The ftd2xx library is compiled for wine 1.0.1 and should be binary compatible with newer versions. Installation Instructions ========================= Install wine ------------ Go to http://www.winehq.org to get a copy of wine. The stable releases are recommended, but the development releases should also work. If a binary package is not available for your system, download the source, unpack it, and read the included documentation. Generally, installing wine should be like this: tar jxvf wine-1.0.tar.bz2 cd wine-1.0 ./configure make depend make install To uninstall: make uninstall If you would still like a package for wine and are unable to find one, try CheckInstall at "http://www.asic-linux.com.mx/~izto/checkinstall/". Configure udev -------------- All udev related files are in the udev directory. Some distributions have problems allowing unprivileged users to access USB devices. For a possible fix, see udev-usb.rules. Follow the steps below and if they don't work, then have a look at udev-usb.rules 1. Copy 100-orion_pcbase.rules to the udev rules directory. This is typically "/etc/udev/rules.d/". 2. Copy bec_orion.sh to the udev script directory, typically "/lib/udev". 3. Try lsusb -v as a regular user. If it does not work, look at udev-usb.rules for a possible solution. Install the software -------------------- 1. Copy pcbase_bin to a directory of your choice. A few good examples are /usr, /usr/local, and /opt. 2. Make a link in your $PATH to "$YOUR_PREFIX/pcbase_bin/run_pcbase", where $YOUR_PREFIX is something like what is above, such as /opt. For example, assuming it is installed in /opt and the link is in /usr/bin: ln -s /opt/pcbase_bin/run_pcbase /usr/bin. 3. Under X11, open a terminal and type run_pcbase. Toubleshooting -------------- The following is a list of known problems that may need fixed to run the pcbase properly. 1. Old kernel. Some old kernels are reported to have trouble with libusb. The 2.6.2x series should work as well as the 2.6.16.x series. 2. Old pthreads library. You need NPTL for wine to work. If it even still compiles without it, it will complain when ran. If you see something like what is below, then you have a really old distribution without NPTL. wine: glibc >= 2.3 without NPTL or TLS is not a supported combination. It will most likely crash. Please upgrade to a glibc with NPTL support. 3. udev misconfigured. If you have tried updating the rules, you may have to restart udev or reboot your computer to get udev to update all of the device nodes. 4. Buggy window manager. If the window jumps around, it is because your window manager has a bug, such as not implementing window gravity correctly. One possible solution is to run winecfg and uncheck "Allow the window manager to decorate the windows". Currently, the only known window manager with this problem on Linux is Fluxbox. 5. Problems minimizing and restoring window. Try wine version 1.0.1.