1.\" $NetBSD: tpctl.8,v 1.5 2012/04/08 22:00:41 wiz Exp $ 2.\" 3.\" Copyright (c) 2002 The NetBSD Foundation, Inc. 4.\" All rights reserved. 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: 9.\" 1. Redistributions of source code must retain the above copyright 10.\" notice, this list of conditions and the following disclaimer. 11.\" 2. Redistributions in binary form must reproduce the above copyright 12.\" notice, this list of conditions and the following disclaimer in the 13.\" documentation and/or other materials provided with the distribution. 14.\" 15.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 16.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 17.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 18.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 19.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 20.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 21.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 22.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 23.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 24.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 25.\" POSSIBILITY OF SUCH DAMAGE. 26.\" 27.Dd August 25, 2002 28.Dt TPCTL 8 29.Os 30.Sh NAME 31.Nm tpctl 32.Nd touch panel calibration utility 33.Sh SYNOPSIS 34.Nm 35.Op Fl hnuv 36.Op Fl D Ar dispdevname 37.Op Fl d Ar devname 38.Op Fl f Ar filename 39.Sh DESCRIPTION 40.Nm 41is a touch panel calibration utility. 42.Nm 43calibrates a touch panel and saves and restores the calibration parameters 44into/from a parameter database file. 45.Pp 46Available command-line flags are: 47.Bl -tag -width dispdevnameXXXX -compact 48.It Fl D Ar dispdevname 49Specify display device name. 50.It Fl d Ar devname 51Specify touch panel device name. 52.It Fl f Ar filename 53Specify alternate parameter database file name. 54.It Fl h 55Print brief description. 56.It Fl n 57Do not change the parameter database file. 58.It Fl u 59Force calibration. 60Without this flag, 61.Nm 62won't do calibration if the database file already contains parameters 63for the touch panel. 64.It Fl v 65Verbose mode. 66.El 67.Pp 68You calibrate the touch panel the first time you run 69.Nm . 70If you see a cross cursor on the screen, you should tap the center of 71the cursor to calibrate the touch panel, or you can abort the 72calibration with the 73.Sq ESC 74key. 75Five cursors will appear on the screen in turn. 76Once calibration is done, 77.Nm 78saves the calibration parameters into the database file and uses the saved 79parameters to calibrate the touch panel. 80.Pp 81You can run 82.Nm 83automatically with 84.Pa /etc/rc.d/tpctl . 85.Sh FILES 86.Bl -tag -width /etc/tpctl.dat -compact 87.It Pa /etc/tpctl.dat 88The default calibration parameter database file. 89The 90.Fl f 91flag may be used to specify an alternate database file name. 92.Nm 93will create an empty database file if it doesn't exist. 94.It Pa /dev/ttyE0 95The default display device, which is used to display the cursor during 96calibration. 97The 98.Fl D 99flag may be used to specify an alternate display device name. 100The display device must provide the 101.Sq hpcfb 102interface as defined in 103.Pa /usr/include/dev/hpc/hpcfbio.h . 104.It Pa /dev/wsmux0 105The default touch panel device. 106The 107.Fl d 108flag may be used to specify an alternate touch panel device name. 109.El 110.Sh SEE ALSO 111.Xr rc.conf 5 112.Sh BUGS 113.Nm 114isn't available on all ports because it requires a display device which 115provides the 116.Sq hpcfb 117interface. 118