--- Installing the microEnable III/IV Linux driver ---

The Linux driver for microEnable III/IV (from now on called simply "driver") supports all hardware types of both device families.

As of February 2010 (driver version 3.9.12/4.0.1) these are:

-microEnable III
-microEnable III-XXL
-microEnable IV-BASE x1
-microEnable IV-FULL x1
-microEnable IV-FULL x4
-microEnable IV-GigE x4
-microEnable IV-AS1-CL
-microEnable IV-AD1-CL
-microEnable IV-VD1-CL
-microEnable IV-VD4-CL
-microEnable IV-AQ4-GE
-microEnable IV-VQ4-GE

All commands in this documentation may be run as an ordinary user. Those
parts that need root access gain them by calling sudo.

= Building and installing the driver =

The provided Makefile will build the driver for your currently running kernel.
For this to work you need to make sure that you have the kernel sources and
build objects of this kernel available.

You need at least kernel version 2.6.23.

If you are running a distribution kernel make sure the kernel source package
matching your running kernel is installed. These packages is often called
kernel-source or similar. Please see the documentation of your distribution
on details.

A quick check to see if those files are installed:

ls -l /lib/modules/$(uname -r)/{build,source}

This must show two symlinks.

ls -l /lib/modules/$(uname -r)/build/

This must show a directory which at least contains a Makefile and the
subdirectories include and include2.

== Building the module ==

1.) Extract the driver sources and change into that directory
    # cd ..
    # tar xjf menable_linuxdrv_src_YYYY-MM-DD.tar.bz2
    # cd menable_linuxdrv_src_YYYY-MM-DD
2a.) If you only want to build the driver
    # make
2b.) If you want to build the driver and make it autoload on boot
    # sudo make install
3.) If you want to load the driver now:
    # sudo insmod menable.ko

= Device files =

The device nodes for every board found are automatically created by udev if you have installed the runtime package package. Please note that those scripts will grant full access to all members of group "video" to both the device files as well as the PCI address ranges of the microEnable boards. User access to this resources is needed to allow non-root users to use the microEnable framegrabbers. Please make sure that only trusted users belong to group video.
