===================================================================== = IO-LIB(LNX)u Ver2.90 = = = = 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 IO-LIB(LNX)u is described as follows. You must read it because some contents are not described in help. About the Product =================== - IO-LIB(LNX)u supplies the set of functions for controlling our board by the driver and the shared library in module. - The basic functionality of input, output and notifying interrupt is provided. - Start the driver by the driver start script. - When interrupt is being used, inherent interrupt processing of using board is written to the source code of the user interrupt processing. - You can free extend and vary the function to add source code. Restrictions ============ - Object of product specification : Supported Linux version Distribution Kernel version ---------------------- -------------- RedHat Linux Enterprise Linux 6.7 2.6.32-573.el6.i686 Enterprise Linux 6.7 2.6.32-573.el6.x86_64 Enterprise Linux 7.2 3.10.0-327.el7.x86_64 Enterprise Linux 8.0 4.18.0-80.el8.x86_64 Enterprise Linux 8.4 4.18.0-305.el8.x86_64 Enterprise Linux 8.6 4.18.0-372.9.1.el8.x86_64 Enterprise Linux 9.0 5.14.0-70.13.1.el9_0.x86_64 - Not covered by product specifications : Operation check only. Distribution Kernel version ---------------------- -------------- Ubuntu 18.04.1 LTS 4.15.0-29-generic (x86_64) 18.04.3 LTS 5.0.0-23-generic (x86_64) 20.04 LTS 5.4.0-26-generic (x86_64) 20.04.2 LTS 5.8.0-43-generic (x86_64) 22.04 LTS 5.15.0-25-generic (x86_64) 22.04.2 LTS 5.19.0-32-generic (x86_64) Please understand that the behavior-verifications on the other than above versions have not be done. Note ========== Legal Information for using the source code of the driver Use of the source code constitutes acceptance of the terms shown below. -Copyright 2002 CONTEC Co.,LTD. ALL RIGHTS RESERVED. -The source code is only for controlling our hardware, you can change the source code to create the new driver, and the created driver can be redistributed. -When you integrate the created driver into the product and open the source code, you should specifically disclose this legal information regardless of the source code being changed or not. -The change of the source code is as for you. and we can not reply to the questions about the source code, please refer to the book. -We don't take responsibility for the damage caused by modifying the source code and redistributing, or for the requests from third party. To install and setup the driver, it is required to startup with root authority. How to install ================== This driver is provide 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/iolib/iolibXXXu.tgz ./ # tar xvfz iolibXXXu.tgz ................ # cd contec/iolib # make ................ # make install ................ # ./addmod.sh Start and stop the driver by executing addmod.sh and delmod.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/iolib Makefile ..................... Make file for install readme_u.txt ................. README file addmod.sh .................... Driver start script delmod.sh .................... Driver stop script iolib_uninstall.sh ........... Uninstall script /module Makefile ................. Make file for compiling and installing iolib_module.c ........... Driver source iolib_module.h ........... Driver header file iolib_user_irq.c ......... Source of user interrupt processing /library Makefile ................. Make file for compiling and installing iolib_lib.c .............. Shared library source iolib_lib.h .............. Shared library header file iolib_ctrl.h ............. Common header file of shared library and device driver libiolib.so.1.2 .......... Shared library /samples console/ ................. Console sample directory /help_u/ ..................... English edition help index.htm ................. html help file data/ ..................... Help data - The following files are copied to system by executing make install. /usr/lib/libiolib.so ........... Shared library /usr/lib/libiolib.so.1.2 ....... Shared library - The following files are created in system by performing the start script of driver. /dev/iolib ..................... File node of driver How to uninstall ====================== Perform the shell script for uninstallation to uninstall this product. # cd contec/iolib # ./iolib_uninstall.sh ................... # For details, please refer to iolib_uninstall.sh script. Sample Programs ==================== The following directory include the sample programs. //contec/iolib/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 IO-LIB(LNX)u ===================================== Ver2.80 -> Ver2.90 (Web Release) -------------------------------- - New corresponded distribution - Red Hat Enterprise Linux 8.6 (x86_64) - Red Hat Enterprise Linux 8.4 (x86_64) - Add confirmation distribution - Ubuntu 22.04.2 LTS (x86_64) Ver2.70 -> Ver2.80 (Web Release) -------------------------------- - New corresponded distribution - Red Hat Enterprise Linux 9.0 (x86_64) - Add confirmation distribution - Ubuntu 22.04 LTS (x86_64) Ver2.60 -> Ver2.70 (Web Release) -------------------------------- - Tested on the following distributions. Ubuntu 20.04.2 LTS (x86_64) Ver2.50 -> Ver2.60 (Web Release) -------------------------------- - Tested on the following distributions. Ubuntu 20.04 LTS (x86_64) Ver2.40 -> Ver2.50 (Web Release) -------------------------------- - New corresponded distribution RedHat Enterprise Linux 8.0 - Tested on the following distributions. Ubuntu 18.04.1 LTS (x86_64) Ubuntu 18.04.3 LTS (x86_64) -------------------------------- Ver2.30 -> Ver2.40 (Web Release) -------------------------------- - Corresponded to a new distribution. Red Hat Enterprise Linux 6.7 - 64bit support was introduced in the following distributions Red Hat Enterprise Linux 6.7 Red Hat Enterprise Linux 7.2 - The support on the following distributions was terminated RedHat Linux 6.2 RedHat Linux 7.0 RedHat Linux 7.1 RedHat Linux 7.2 RedHat Linux 7.3 RedHat Linux 8.0 RedHat Linux 9 Red Hat Professional Workstation Red Hat Enterprise Linux 4 Red Hat Enterprise Linux 5 Red Hat Enterprise Linux 6 TurboLinux 6.0 TurboLinux 7.0 TurboLinux 8 TurboLinux 10 Server TurboLinux 11 Server TurboLinux 11 Server SP1 Ver2.10 -> Ver2.30 -------------------------------- - Corresponded to a new distribution. RedHat Enterprise Linux 6 2.6.32-71.el6.i686 Turbo Linux 11 server SP1 2.6.23-10 RedHat Enterprise Linux server 5.7(x64) 2.6.18-274 RedHat Enterprise Linux 6.2(x64) 2.6.32-220.e16.x86_64 Turbo Linux 11 server(x64) 2.6.23-10.x86_64 Ver2.00 -> Ver2.10 (Web Release) -------------------------------- - Corresponded to a new distribution. (Include it for SMP. ) Red Hat Enterprise Linux 5 Turbo Linux 11 server Ver2.00 -> Ver2.01 -------------------------------- - Trouble not to be able to be likely to do IO normally with the card bus device is corrected. Ver.1.40 -> Ver.2.00 (Var.Jun.2005) -------------------------------- - It corresponds to kernel 2.6.xx - It corresponds to Red Hat Enterprise Linux 4. - It corresponds to Turbo Linux 10 server. Ver.1.30 -> Ver.1.40 (Var.Apr.2005) -------------------------------- - It corresponds to Red Hat Professional Workstation. Ver.1.21 -> Ver.1.30 (Web Release) -------------------------------- - It corresponds to Red Hat Linux 8.0 Red Hat Linux 9. Ver.1.0->Ver.1.21(Var.Dec.2002) ----------------------------- - Open source code - Support interrupt by callback - Add the get error string function