================================================================================ = Touch Panel Utility Sample for Linux = = TPBK(LNX) = = = = Ver. 2.05 = = CONTEC Co.,Ltd. = ================================================================================ ◆ Contents =============== Introduction About the Products Note Restrictions Install/uninstall File Structure Version up history ◆ Introduction ==================== The explanation of TPBK(LNX) is described as follows. You must read it because some contents are not described in help. This Readme file describes the simple operation sample program for using the touch panel function installed in our product in the Linux environment. Please use this sample program as a reference when developing your application. This sample utility and API are implemented in c language. Tpmouce uses uinput mechanism. ◆ Overview =============== TPBK (LNX) is a sample of touch panel utility that works with our IPC series.   This file contains the configuration of the utility and an overview of the utility. TPBK (LNX) includes a touch panel utility and an API library for using commands. For details, please refer to the explanation file under each directory. The following contents are described together with the confirmation information in the conventional version. Therefore, please note that we have not reconfirmed all combinations of this ver and all the listed models and the listed distributions (and versions). In addition, we do not guarantee the operation in combination with all the listed models and each distribution(version). * The contents below are as of the release. It may not match the support status of each distribution. * For operation confirmation information for individual models, see the contents of the operation confirmation document for each model.   We have confirmed the operation with the following products and Linux OS. products ------------------ - PT-956S Series - PT-M1xSA-210 Series - PT-M07WA-310/PT-F10SA-320/PT-F12SA-320 Series Distribution Kernel version ---------------------- ------------------ Ubuntu Ubuntu 20.04 LTS 5.13.0-30-generic(x86_64)(hwe) 5.15.0-67-generic(x86_64)(hwe) Ubuntu 22.04 LTS 5.15.0-25-generic(x86_64) 6.2.0-26-generic(x86_64)(hwe) CentOS CentOS 7.9-2009 3.10.0-1160.el7.x86_64 Red Hat Enterprise Linux(RHEL) RHEL 7.9 3.10.0-1160.el7.x86_64 RHEL 8.3 4.18.0-240.el8.x86_64 RHEL 8.9 4.18.0-513.5.1.el8_9.x86_64 RHEL 8.10 4.18.0-553.el8_10.x86_64 RHEL 9.0 5.14.0-70.13.1.el9_0.x86_64 RHEL 9.3 5.14.0-362.8.1.el9_3.x86_64 RHEL 9.4 5.14.0-427.13.1.el9_4.x86_64 MIRACLE LINUX(ML) ML 8.4 4.18.0-305.el8.x86_64 ML 8.6 4.18.0-372.9.1.el8.x86_64 ML 8.8 4.18.0-477.10.1.el8_8.x86_64 ML 9.0 5.14.0-70.13.1.el9_0.x86_64 ML 9.2 5.14.0-284.11.1.el9_2.x86_64 dependencies ------------ - gcc - GNU make - systemd etc. * When using the sample programs (Tpcal, TPGUI), the following development packages and dependent packages are required for each target Linux distribution. - Ubuntu libgtk-3-dev - RHEL, CentOS, ML gtk3-devel ◆ Note ========== ■ When using the program source and library included in this software package, please check the contents of the attached EULA, and agree to the terms of use before using. ■ In using this sample - Depending on your usage environment, you may need to edit program sources, scripts, etc. Please check the contents of the document before installing. Please use this sample with the understanding that it is intended to be used as a reference when developing applications by customers. - This sample program includes an X11-dependent application. When using the sample application, the usability may differ between X11 and XWayland. Also, please note that it may not work properly depending on the operating environment. When using touch input, operability may be affected depending on the specifications of various applications. - In Tpmouse, touch input is performed using device emulation through the uinput module. Please make sure the uinput module is enabled in your kernel. - It does not support screen rotation or multi-screen environments. - The installation destination configuration etc. may differ between binary package version and source version installation. If used together, unintended problems may occur. ◆ Restrictions ==================== ■ It is necessary to execute this utility sample program with root authority. ■ When using this utility or API, it may be necessary to appropriately reassign the touch input area to the screen depending on the execution environment, such as when connecting an external display or rotating the screen. In the X11 environment, it may be possible to reassign using the xinput command. Other operating specifications may differ depending on the execution environment. Depending on the usage environment and method of use, there may be restrictions based on the specifications. ◆ install/uninstall ==================== This sample program is provided as a compressed file. Place the compressed file in any location and execute the command like [tar xvf xxx.tar.gz] to extract it. [src package] - install Move to the extraction destination directory # cd ./TPBK(LNX)_VX.XX Install libraries, utilities, etc. all at once. # make install_all - uninstall Move to the extraction destination directory $ cd ./TPBK(LNX)_VX.XX Uninstalls libraries, utilities, etc. all at once. (When using make install_all) $ make uninstall_all After uninstalling, execute a command like [ rm -R [extract_dir] ] from the shell to delete the extraction destination directory as appropriate. * If you have changed the installation destination, the uninstall process may not be performed properly, so please check the contents in advance. Also, when uninstalling, do not use a version different from the one used at the time of installation. It may not be processed normally. [rpm package] The included RPM package may be used in RHEL and RHEL compatible environments such as ML. Below is an example using the dnf command. - install # cd ./(TPBKLNX_Top_Directory)/rpm/elX/ package install # dnf install \ ./tpbklnx.X.X-X.elX..rpm \ ./tpbklnx-devel-X.X-X.elX..rpm tpmouse execution (start tpctl service or system reboot) # systemctl restart tpctl - uninstall package uninstall # dnf remove tpbklnx tpbklnx-devel [deb package] May be available in compatible environments such as Ubuntu. The following is an execution example using the apt command. - install # cd ./(TPBKLNX_Top_Directory)/debs// package install # apt install \ ./tpbklnx_X.XX-XubuntuX_.deb \ ./tpbklnx-dev_X.XX-XubuntuX_.deb - uninstall package uninstall # apt purge tpbklnx tpbklnx-dev [note] To enable touch input, you may need to change the Port setting ("/dev/ttyS[0-9]") in tpmouse.config (tpmouse configuration file). The installation location of the configuration file differs depending on what was specified during installation or when installing from a binary package. Please check the Makefile and binary package installation destination information accordingly. ◆ File Structure ====================== The compressed file of this utility has the following configuration. The touch panel utility is provided below Tp_Utils, and the touch panel API library is provided below Tp_API. For details, please refer to the explanation file under each directory. ./TPBK(LNX)_VX.XX/ ReadMe_j.txt ... TPBK (LNX) overview commentary file (Ja) ReadMe_e.txt ... TPBK (LNX) overview commentary file (En) EULA_JP.txt ... End-User License Agreement (Ja) EULA_EN.txt ... End-User License Agreement (En) Makefile ... Makefile for batch processing (make | make install | make uninstall | make install_all | make uninstall_all | make install_gutil | make uninstall_gutil | make sample | make clean) /Tp_API ... Touch panel API /Tp_Utils ... Touch panel utility sample /Tp_GUIUtil ... GUI utility sample rpm/ ... rpm packages el8/x86_64/ ... for el8 - x86_64 el9/x86_64/ ... for el9 - x86_64 [rpm packages] tpbklnx ........... tpbk package(utility, service, library(TpAPI)) tpbklnx-devel ..... for development sub-package(library header, etc.) * about rpm file name --[.]...rpm pkg_name : package name pkg_ver : package version pkg_rel : package release (rpm package) extra_ver : extra version info dist : elX(_X) arch : x86_64 deb/ ... deb packages focal/x86_64/ ... for 20.04(.X) LTS (Focal Fossa) x86_64 jammy/x86_64/ ... for 22.04(.X) LTS (Jammy Jellyfish) x86_64 [deb packages] tpbklnx ........... tpbk package(utility, service, library(TpAPI)) tpbklnx-dev ....... for development sub-package(library header, etc.) * about deb file name _[-revision]_.rpm pkg_name : package name pkg_ver : package version revision : debian revision arch : amd64 ◆ Version up history ========================= Ver. 2.05 (May 2024) ------------------------------ - Update of target model information. - added support products : PT-M07WA-310/PT-F10SA-320/PT-F12SA-320 Series Ver. 2.04 (Jan. 2024) ------------------------------ - Update GUI application - Updated from GTK+2 to GTK+3 - Update of Xorg dependencies - Some specification changes due to implementation updates - Updated contents such as operation confirmation information, etc. - Added binary packages - rpm packages - el8 - el9 - deb packages - Ubuntu 20.04 LTS (Focal Fossa) - Ubuntu 22.04 LTS (Jammy Jellyfish) - Removed content for upstart and sysvinit Ver. 2.03 (Sep. 2022) ------------------------------ - Update of target model information, etc. - Changed the input method for virtual input devices from mouse LR button input to touch input by default. - Partial revision of EULA Ver. 2.02 (Sep. 2019) ------------------------------ - Tpmouse changed from Xtest-library to uinput-device - Tpmouse enhancement - TpAPI enhancement(for Tpmouse enhancement) - Tpcal enhancement - Add sample GUI utility(tpctl_utill) Ver. 2.01 (Nov. 2017) ------------------------------ - Tpmouse、Tpcal correspond to screen rotation - Add API(TpAPI) - Modified Tpmouse for corresponding to TpAPI - Modified Tpmouse for corresponding to Right/left mouse click mode Ver. 2.00 (Jul. 2017) ------------------------------ - Corresponding to Ubuntu, CentOS, RHEL - Corresponding to PT-956S Series - Remove corresponding to freeBSD - Remove RAS utility ----- ===== 1.xx ===== ----- Ver. 1.00 (Apl. 2003) ------------------------------ - First Release <<------------------------------------------------------------------------------ Linux® is the registered trademark of Linus Torvalds in the U.S. and other countries. Ubuntu is a trademark or registered trademark of Canonical Ltd. CentOS, Red Hat, and Red Hat Enterprise Linux are registered trademarks of Red Hat, Inc. in the United States and other countries. MIRACLE LINUX and ミラクル・リナックス are registered trademarks of Cybertrust Japan Co., Ltd. Other brand, product names and service names are trademarks of their respective holder. ------------------------------------------------------------------------------>>