===================================================================== = Linux Driver for Counter Input = = API-CNT(LNX)u Ver1.20 = = CONTEC Co.,Ltd. = ===================================================================== Index ======= Introduction About the Product Restrictions Note How to install Installed files How to uninstall Sample programs Version up history Introduction =========== The explanation of API-CNT(LNX)u is described as follows. You must read it because some contents are not described in help. About the Product =========== - API-CNT(LNX)u supplies the set of functions for controlling our counter board by the driver and the shared library in module. - The basic functionality of setting mode, getting count value, Count-Match interrupt and Timer interrupt is provided. - Setup and use the device to be used by using the setup program (config) and setup files. - Setup program outputs the setting files, which are easy, migrate to the executing environment, start script and stop script. - The source code of user interrupt processing which can execute with the driver is supplied. 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 2.4.20 Professional Workstation 2.4.21 TurboLinux 7.0 2.4.5 8 2.4.18 Please understand that the behavior-verifications on the other than above versions have not be done. And, SMP is not supported. Note ========== To install and setup the driver, it is required to startup with root authority. How to install ================== This driver is providing 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. (NOTE. XXX is version) # cd # mount /dev/cdrom /mnt/cdrom # cp /mnt/cdrom/linux/cnt/ccntXXXu.tgz ./ # tar xvfz ccntXXXu.tgz ................ # cd contec/ccnt # make ................ # make install ................ # cd config # ./config ..... Setup the following ......... # ./contec_cnt_start.sh Start and stop the driver by executing contec_cnt_start.sh and contec_cnt_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 //contec/ccnt ccnt_uninstall.sh ............ Shell script for uninstall Makefile ..................... Make file for install readme.txt ................... README file /config config ................... Setup program contec_cnt.conf .......... Setting file: created by executing config, It is copied to /proc as the start script contec_cnt_start.sh ...... Driver start script contec_cnt_stop.sh ....... Driver stop script ccnt.o ................... Driver for the version of the started OS /2.4.2-2 cgetres.o ............ Driver config use to retrieve the resource /2.4.5-3 ................. /Same as 2.4.2-2 /2.4.7-10 ................ /Same as 2.4.2-2 /2.4.18-1 ................ /Same as 2.4.2-2 /2.4.18-3 ................ /Same as 2.4.2-2 /2.4.18-14 ............... /Same as 2.4.2-2 /2.4.20-8 ................ /Same as 2.4.2-2 /2.4.21-4.EL ............. /Same as 2.4.2-2 /module Makefile ................. Make file for compiling and installing Ccnt_user_irq.c .......... Source of user interrupt processing /2.4.2-2 ccnt_raw.o ............ Compiled driver object(except user interrupt processing routine) ccnt.o ................ Compiled driver /2.4.5-3 .................. /Same as 2.4.2-2 /2.4.7-10 ................. /Same as 2.4.2-2 /2.4.18-1 ................. /Same as 2.4.2-2 /2.4.18-3 ................. /Same as 2.4.2-2 /2.4.18-14 ............... /Same as 2.4.2-2 /2.4.20-8 ................ /Same as 2.4.2-2 /2.4.21-4.EL ............. /Same as 2.4.2-2 /library Makefile .................. Make file for installing libccnt.so.1.0 ............ Shared library /samples/ console/ .................. Console sample directory /help/ cnthelp.htm ................ html help files data/ ...................... Help data - The following files are copied to system by executing make install. /usr/lib/libccnt.so ............ Shared library /usr/lib/libccn.so.1.0 ......... Shared library - The following files are created in system by performing the start script of driver. /dev/ccntXXX (XXX is digital) .. File node of driver /proc/contec_cnt.conf .......... The copy of the setup file How to uninstall ====================== Perform the shell script for uninstallation to uninstall this product. # cd contec # ./ccnt_uninstall.sh ................... # For details, please refer to ccnt_uninstall.sh script. Sample programs ==================== The following directories include the sample programs in each language. //contec/ccnt/samples The explanation of directory /inc Include the function define file in C/C++. When you create the program in C/C++, include this file. And, don't edit this file. /console Sample program source code in C language and Makefile. Version up history API-CNT(LNX)u ========================================= Ver.1.10 -> Ver.1.20 (Ver Apr.2005) -------------------------------- - Addition of the board which can be used An additional board CNT24-4(PCI)H, CNT24-4D(PCI)H - It corresponds to Red Hat Professional Workstation. - Trouble from which the interrupt of Timer might not be notified is corrected. - When the load is put on CPU when the interrupt function is used, trouble that might cause the kernel panic is corrected. Ver.1.01 -> Ver.1.10 (Web Release) -------------------------------- - It corresponds to Red Hat Linux 8.0 Red Hat Linux 9. Ver.1.00 -> Ver.1.01 (Ver. Dec.2002) -------------------------------- - It corrects that the rate of CPU use had become 100% at the time of interruption use. - Modify Help Ver1.00 (Ver.Dec.2002) -------------------------------- - First release