MATRIX Vision Framegrabber Drivers for LINUX ============================================= 2002-2008 MATRIX VISION GmbH Version: Feb. 2008 The following framegrabbers are supported: Grabber Directory ====================================================== mvCAM3, mvCAM4, mvGAMMA, mvTITAN series titan mvDELTA, mvSIGMA slc pcIMAGE-SC sc pcIMAGE-SDIG sdig pcIMAGE-SG, pcIMAGE-SRGB sgsrgb Unpack the archive from the appropriate subdirectory using "tar" on your Linux system. Do not use a Windows computer. Windows cannot generate the correct Linux permission bits. Each archive contains all the necessary libraries for your framegrabber and the sources for the kernel modules. These kernel modules must be compiled to match the distribution and kernel version you are using. The libraries should work with all recent versions of the glibc. If you have an older distribution (e.g. SuSE 6.x) please contact Matrix Vision. We *may* still be able to compile compatible libraries for it. **************************************************************** ** After unpacking the archive please.... ** ** READ THE README FILE BEFORE INSTALLING ** **************************************************************** Quickstart. ========================================= The kernel modules supplied here should work with with all 2.6.x kernel versions to date (2.6.23.14). We no longer test with 2.4.x kernels but the kernel modules may well still work with 2.4.x. As of February 2008 you may also use mvTITAN/mvGAMMA cards (but only these) on a system running a 64 bit kernel but only with 32 bit libraries and applications. We use current SuSE and Ubuntu versions to test but they should work correctly with other distributions e.g. RedHat and Linux Mandrake. Special instructions for Red Hat 9.0 and Fedora are to be found below. It may be necessary to do something similar for other Red Hat/Fedora versions. Installation 1. Remove all old MATRIX Vision libraries and kernel modules from your system, making backups as appropriate. 2. Unpack the driver using (example for mvTITAN, file dist_titan-030804.tgz): tar -xvzf dist_titan-030804.tgz A new subdirectory will be created called titan-030804. 3. Make the kernel modules and test programs using (example for mvTITAN): cd titan-030804 ./configure make 64 bit Systems (mvTITAN / mvGAMMA only): On a 64 bit system you should be able to build and install a 64 bit kernel and use it with 32 bit applications. N.B. The libraries supplied by MATRIX VISION here are 32 bit libraries. There are no 64 bit versions available! To build the example applications on a 64 bit system you will need 32 bit versions of the X-libraries and SDL libraries. On some systems (e.g. Gentoo) these will be installed to /lib32 or /usr/lib32 whilst /lib and /usr/lib are symbolic links to /lib64 and /usr/lib64 respectively. On other systems (e.g. SuSE 10.x, Fedora) you may find that /lib and /usr/lib contain 32 bit libraries. You will need to find out this information before calling the configure script and then use it like this (replace the paths with the correct locations for the 32 bit libraries on your 64 bit system) e.g. for Gentoo: ./configure --x-libraries=/usr/lib32 --libdir/usr/lib32 See ....../driver/README and for full details. Your kernel configuration (usually in /lib/modules/`uname -r`/.config) must be up-to-date and must match the kernel that is currently running. If not, run at least make menuconfig whilst in the kernel source directory or just make your own kernel ;-) 4. Install the kernel modules and libraries using: make install 5. Change the kernel boot parameters to reserve memory for DMA buffer by adding a "mem=..." parameter to the lilo or grub configuration (see README for details). Reinstall the bootloader and reboot the machine. 6. Load the correct kernel module using (example for mvTITAN): bin/mvload titan 7. Make sure you have a valid INI-file for your framegrabber, camera etc. in the subdirectory ....driver/linuxtest. See the examples in the directory ....driver/linuxtest/examples. 8. Test using test programs in ....../driver/linuxtest. See ....../driver/linuxtest/README for more details. Special instructions for Red Hat 9.0 and Fedora =============================================== 1. Install kernel development packages. 2. cd to kernel source directory (cd /usr/src/linux-2.4) Edit Makefile to remove the text "custom" from EXTRAVERSION e.g. old: EXTRAVERSION = -8custom new: EXTRAVERSION = -8 3. Copy the correct configuration for your running kernel into this directory. The kernel configuration is usually to be found in "/boot/config-....". Just copy this file to /usr/src/linux-2.4 and rename it to ".config" . Now make kernel dependencies like this: make dep 4. Copy MATRIX VISION tarball to computer and unpack. 5. cd to the new directory (cd dist_titan-....) and call the configure script like this... ./configure ... and observe output looking for problems. The scripts will try their best to figure out how Red Hat have mangled the kernel sources this time.... ;-) 6. Compile and install the kernel modules (and make the test programs) using: make install Now continue with "5." above. -- MATRIX VISION Linux Team