===================================================================== = Linux Driver for GPIB = = API-GPIB(LNX) Ver1.33 = = CONTEC Co.,Ltd. = ===================================================================== Contents ======= Introduction About the Product Restrictions Note How to install Installed files How to uninstall Sample programs Version up history Introduction ============ Thank you for purchasing this product. The following description is a supplementary explanation for API-GPIB(LNX). Please refer to Online Help(apitool.htm) for how to use API-GPIB(LNX). Product introduction =========== - API-GPIB(LNX) supplies the set of functions for controlling our GPIB board by the driver and the shared library in module. - Setup and use the device to be used by using the setup program (config) and setup files. - Setup program generates the setting file and driver start script file required for shifting to executing environment and stop script file. Restrictions ============ This product supports the following versions of Linux. Distribution Kernel version -------------------------- ------------------ RedHat Linux 7.1 2.4.2 7.2 2.4.7 7.3 2.4.18 8.0 2.4.18 9.0 2.4.20 Professional Workstation 2.4.21 Enterprise Linux WS Ver.4 2.6.9-5.EL TurboLinux 7.0 2.4.5 8.0 2.4.18 10.0 Server 2.6.8-1 Please understand that the behavior-verifications on the other than above versions have not be done. And, SMP is not supported. The device of Cardbus becomes the correspondence a kernel 2.4. (In OS of Turbo Linux 7.0, since the version of pcmcia-cs is old, it cannot operate) Note ========== To install and setup the driver, it is required to startup with root authority. How to install ================== The driver is provided in a compressed file. You can use the following command in shell to copy/extract it. If you want to change the library install path to a location, such as /usr/local/lib, you should find the Makefile and change the install path in advance. Numerical values except "." of the driver version enter the part of following "***". # cd # mount /dev/cdrom /mnt/cdrom # cp /mnt/cdrom/linux/gpib/cgpib***u.tgz ./ # tar xvfz cgpib***u.tgz ................ # cd contec/cgpib # make ................ # make install ................ # cd config # ./config ..... Setup the following ......... # ./contec_gpib_start.sh Start and stop the driver by executing contec_gpib_start.sh and contec_gpib_stop.sh. If you want to start driver when the system started, please add the processing contents of start script to /etc/rc.d/rc.local. Installed files ============================ - The compressed file of the product installs files in the hierarchical directory structure as follows. //contec/cgpib cgpib_uninstall.sh ........... Shell script for uninstall Makefile ..................... Make file for install readme.txt ................... README file /config config ................... Setup program contec_gpib.conf ......... Setup file: created by executing config, It is copied to /proc as the start script contec_gpib_start.sh ..... Driver start script contec_gpib_stop.sh ...... Driver stop script cgpib.o .................. Driver for the version of the started OS /2.4.2-2 cgetres.o ............ Driver for config to get the resources(RedHat Linux 7.1) /2.4.5-3 ................. /Same as 2.4.2-2(Turbo Linux 7.0) /2.4.7-10 ................ /Same as 2.4.2-2(RedHat Linux 7.2) /2.4.18-1 ................ /Same as 2.4.2-2(Turbo Linux 8.0) /2.4.18-3 ................ /Same as 2.4.2-2(RedHat Linux 7.3) /2.4.18-14 ............... /Same as 2.4.2-2(RedHat Linux 8.0) /2.4.20-8 ................ /Same as 2.4.2-2(RedHat Linux 9.0) /2.4.21-4.EL ............. /Same as 2.4.2-2(RedHat Linux PW) /2.6.9-5.EL cgetres.ko ............ Driver for config to get the resources(RedHat Linux Enterprise Linux WS Ver.4) /2.6.8-1 ............. /Same as 2.6.9-5.EL(Turbo Linux 10.0 Server) /module Makefile ................. Make file for compiling and installing /2.4.2-2 cgpib.o .............. Compiled driver(RedHat Linux 7.1) /2.4.5-3 ................. /Same as 2.4.2-2(Turbo Linux 7.0) /2.4.7-10 ................ /Same as 2.4.2-2(RedHat Linux 7.2) /2.4.18-1 ................ /Same as 2.4.2-2(Turbo Linux 8.0) /2.4.18-3 ................ /Same as 2.4.2-2(RedHat Linux 7.3) /2.4.18-14 ............... /Same as 2.4.2-2(RedHat Linux 8.0) /2.4.20-8 ................ /Same as 2.4.2-2(RedHat Linux 9.0) /2.4.21-4.EL ............. /Same as 2.4.2-2(RedHat Linux PW) /2.6.9-5.EL cgpib.ko .............. Compiled driver(edHat Linux Enterprise Linux WS Ver.4) /2.6.8-1 ................. /Same as 2.6.9-5.EL(Turbo Linux 10.0 Server) /library Makefile ................. Make file for installing libcgpib.so.1.0 .......... Shared library /samples /console ................. gcc sample directory /help apitool.htm .............. html help files - The following files are copied to system by executing make install. /usr/lib/libcgpib.so .......... Shared library /usr/lib/libcgpib.so.1.0 ...... Shared library - The following files are created in system by performing the start script of driver. /dev/cgpibXXX (XXX is digital) ....File node of driver /proc/contec_gpib.conf .........The copy of the setup file How to uninstall ====================== Perform the shell script for uninstallation to uninstall this product. # cd contec # ./cgpib_uninstall.sh ................... # For details, please refer to cgpib_uninstall.sh script Sample programs ==================== The sample programs are contained in the following directory by language. //contec/cgpib/samples The explanation of directory /inc Include the function define file in C/C++. When you create the program in C/C++, incule this file. And, don't edit this file. /console Sample program source code in C language and Makefile. - The history of version-up =========================== Ver1.32->Ver1.33 --------------------------------------------- - Be supported at Turbo Linux 10.0 Server in the device of CardBus. - Be supported at Red Hat Linux Enterprise Linux WS Ver.4 in the device of CardBus. Ver1.30->Ver1.32 (API-PAC(W32) Ver.Oct.2007) --------------------------------------------- - Be supported at Turbo Linux 10.0 Server. - Be supported at Red Hat Linux Enterprise Linux WS Ver.4 New Device: - GP-IB(PC)L Ver1.11->Ver1.30 (API-PAC(W32) Ver.Apr.2006) --------------------------------------------- New Device: - GPIB-F-LPE - GPIB-FL-LPE Ver1.10->Ver1.11 (API-PAC(W32) Ver.Aug.2005) --------------------------------------------- Fault correction: - Fault correction for which mistake of the model of the board. Ver1.01->Ver1.10 (API-PAC(W32) Ver.Apr.2005) --------------------------------------------- New Device: - GP-IB(LPCI)FL - GP-IB(CB)FL Fault correction: - Fault correction which status is not turned off by 2H parameter of the GpibGetStatus function. Specification change: - The TimeOut time of the transmission of the command in the GpibEnableRemote function is changed to a fixed value. Ver1.00->Ver1.01 (API-PAC(W32) Ver.Jan.2005) --------------------------------------------- Fault correction: - Fault correction which does not output the SPD command when a timeout occurs into a serial poll. - Fault correction which was performing lead reset for SRQI with 12H parameter of a GpibGetStatus function. Functional addition: - The functional addition which changes handshake timing. - The function in which weight can be set up between the GPIB command and data is added. - A GpibGetErrorString function and a GpibFindListener function addition. Ver1.00 (API-PAC(W32) Ver.Oct.2004) --------------------------------------------- - First release