Eagle Technology Data Acquisition Linux Library
Brought to you by:
janzwiegers,
johan-radical
EDR Enhanced Library by Eagle Technology, South Africa Written by Jan Zwiegers 1. History --------------- The original Eagle DRiver (EDR) was written in the very early 1990's to support Data Acquisition (DAQ) hardware for programmers. These consisted of DOS C / Pascal libraries and later Windows 3.11 VXD drivers. Mainly these cards were ISA based and very simple to address. Later it was extended to Windows 98 & NT. With the dawn of newer PC periperal buses, like PCI, EDR was replaced with EDR Enhanced and a new much simpler API specification was formed. Later this API was ported to Linux and this API was also release under a opensource license. 2. Introduction --------------- The EDR Enhanced API and Library is a software package for Eagle Technology's Data Acquisition hardware. The API provide a software interface and hardware abstractuion layer for a variety of buses and different interfaces. The API is easy to learn and example programs are also provided. Please visit the Eagle Technology Data Acquistion Website http://www.eagledaq.com for more information or email us eagle@eagle.co.za. 3. Source Layout ---------------- -apps All applications related to the library. These include calibration software and other utilities. -doc Documentation and manuals -edrelib The EDR Enhanced API -etc Configuration files that should go into the same directory on hard disk. This is setup file for the API, udev and init.d startup scripts. -examples Examples for various programming and scripting languages -images Official EDR Enhanced logos -include Programming includes files mainly for C/C++ and very important for EDR Enhanced driver modules. This is required to build driver modules. -java Suppor for Java via JNI -drivers All hardware drivers -vs2005 Project files for Visual Studio 2005 to build the API for Win32/Windows. This EDR Enhanced Cross Platform API still lacks a lot of functionality compared to the Windows version, so this cannot replace it yet. 4. Installation Instructions ---------------------------- 4.1 Download and install your kernel header files or kernel source.This can be obtained from http://www.kernel.org and FTP via ftp.kernel.org. A good resource of things to do with your kernel can be found here: http://www.linuxheadquarters.com/howto/tuning/kernelsources.shtml. Or follow the instruction below. 1.1 Howto install the kernel source on Fedora Core or Red Hat. # yum install kernel-devel # tar xjf kernel-source-$(uname -r).tar.bz2 1.2 Howto install the kernel source on Ubuntu Hardy(8.04) and later # sudo apt-get source linux-image-$(uname -r) # tar xjf /usr/src/linux-source-$(uname -r).tar.bz2 1.3 Howto install the kernel source on Debian # apt-get install linux-source-$(uname -r) # tar xjf /usr/src/linux-source-$(uname -r).tar.bz2 4.2 Extract the edrelib-x.y.z.tar.gz to a temporary directory, i.e. /usr/src # cd /usr/src # tar xzf edrelib-x.y.z.tar.gz 4.3 Copy all driver files to the edredaq directory. # cd edrelib-x.y.z/drivers # cp -R * /usr/src/linux-x.y.x/drivers/edredaq/. 4.4 EDR Enhanced Header Files are required to build in the drivers Make sure to install or copy the include files found in edrelib-x.y.z/include to /usr/includes/edre. The easiest to do this is to install the API shared object. See the EDR Enhanced Library installation file or simply do the following: # cd usr/src/edrelib-x.y.z # ./configure --prefix=/usr # make # make install 4.5 Build all the drivers and install # cd /usr/src/linux-x.y.x/drivers/edredaq # make clean # make # make install 4.6 Rebuild the kernel module dependancy table. # depmod -a 4.7 Install UDEV script. This is needed to detect plug and play event and to build the necessary files nodes under /dev/edredaq. The EDR Enhance library needs to be able to open a file handle directly to the hardware device driver. # cp /usr/src/edrelib-x.y.x/etc/udev/z-edredaq.rules /etc/udev/. 4.8 Reboot. It's not always needed, but because of problems with earlier versions of UDEV it's safer to reboot. The new device driver modules will then be loaded properly and UDEV will also load the new EDR Enhanced rules set. 4.9 Testing the installation is easy. Goto /usr/src/edrelib-x.y.z/apps/lsedre. Build it and install it. # cd /usr/src/edrelib-x.y.z/apps/lsedre # make # make install And then to list all installed EDR Enhanced compatible hardware simply type 'lsedre'. # lsedre # Index: 0 Bus: PCI Type: 71 Serial#: 1000002005 - PCI766A16 16 Ch DAC Board 4.10 For applications see edrelib/apps and examples see edrelib/examples. 4.11 Help via email. Please contact Jan Zwiegers <jan@eagle.co.za> if you need any help or information. Visit our website www.eagledaq.com for a complete catalog of our product range. A Disclaimer and copyright This document is provided as is and information provided is not warranted to be correct; use it at own own risk.