Kernel mode driver compilation – Agilent Technologies DP211 User Manual
Page 22
User Manual: Family of 8-bit Digitizers
Page 22 of 66
acqrsPCI.o.2.4.21-4.EL
for Red Hat Enterprise Linux version 3
acqrsPCI.ko.2.6.8-3-686
for Debian 3.1 'sarge'
acqrsPCI.ko.2.6.8-24-smp
for Suse 9.2
acqrsPCI.ko.2.6.9-11.EL
for Scientific Linux 4.4
acqrsPCI.ko.2.6.18-4-686
for Debian 4.0 'etch'
To install the driver and the load script to the system, you have to get super user privileges and execute the driver
install script by typing,
cd AcqirisLinux
./drv-install add
You can check that the driver is loaded properly with lsmod or dmesg. The drv-install script has the following
additional functionality:
drv-install rem to remove the driver and load script
drv-install res
to restart the driver
If you intend to use an Averager, an Analyzer, or a 12-Bit Digitizer you must install the Firmware .bit files. You can
either copy them from the Firmware directory of the CD-ROM or download them from our WEB site. They should
be placed in the Firmware subdirectory of AcqirisLinux. In the case of the CD-ROM, this can be done by continuing
the above command sequence with the following:
cp /mnt/CDRom/Firmware/*.bit Firmware/
2.3.1. Kernel Mode Driver Compilation
For some special kernels, for example SMP, the kernel mode driver will have to be recompiled on the target system.
All files needed to compile a new kernel mode driver are in AcqirisLinux/linuxdriverpci for Kernel 2.4 or in
AcqirisLinux/linux2.6driverpci for Kernel 2.6
The makefile can be used for compilation under a standard compatible distribution. To compile the driver, the kernel
header files need to be installed. Furthermore, depending on the Linux distribution, the kernel source files may need
to be installed. The makefile will try to guess where they are located. If it fails, see instructions inside the makefile
itself to specify manually where these kernel header files are located.
To compile a new kernel under linux-2.4, issue the following commands:
cd linuxdriverpci
make clean to remove all *.o files in AcqirisLinux/linuxdriverpci.
make to generate a new kernel mode driver acqrsPCI.o and also copy it to the directory
AcqirisLinux/lib/modules where the install script (drv_install) can access it.
drv_install rem to remove the previous installed kernel mode driver.
drv_install add to install the new driver.
To compile a new kernel under linux-2.6, issue the following commands:
cd linux2.6driverpci
make clean all to generate a new kernel mode driver acqrsPCI.ko from scratch.
make install to copy the kernel module where it should reside.
Note that this version of the loadable kernel module had been tested on Linux kernel versions up to 2.6.18. However,
starting with kernel 2.6.17, a few kernel functions relating to the device classes are no longer available to proprietary
modules. Thus automatic creation of the /dev/acqrsPCI node has to be done manually in the /etc/rc.local file.
For Debian users, in order to compile the kernel module on a system, a few packages that match the current kernel-
image must be installed. For instance, on a Debian 3.1 sarge system 686 the required packages are:
kernel-image-2.6-686
kernel-image-2.6.8-3-686
kernel-headers-2.6-686
kernel-headers-2.6.8-3
kernel-headers-2.6.8-3-686
kernel-kbuild-2.6-3