2 .\" Copyright (c) 2012 Robert N. M. Watson
3 .\" All rights reserved.
5 .\" This software was developed by SRI International and the University of
6 .\" Cambridge Computer Laboratory under DARPA/AFRL contract (FA8750-10-C-0237)
7 .\" ("CTSRD"), as part of the DARPA CRASH research programme.
9 .\" Redistribution and use in source and binary forms, with or without
10 .\" modification, are permitted provided that the following conditions
12 .\" 1. Redistributions of source code must retain the above copyright
13 .\" notice, this list of conditions and the following disclaimer.
14 .\" 2. Redistributions in binary form must reproduce the above copyright
15 .\" notice, this list of conditions and the following disclaimer in the
16 .\" documentation and/or other materials provided with the distribution.
18 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
19 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
22 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
37 .Nd driver for the Terasic/Cambridge Multi-Touch LCD device
39 .Cd "device terasic_mtl"
42 .Pa /boot/device.hints :
43 .Cd hint.terasic_mtl.0.at="nexus0"
44 .Cd hint.terasic_mtl.0.reg_maddr=0x70400000
45 .Cd hint.terasic_mtl.0.reg_msize=0x1000
46 .Cd hint.terasic_mtl.0.pixel_maddr=0x70000000
47 .Cd hint.terasic_mtl.0.pixel_msize=0x177000
48 .Cd hint.terasic_mtl.0.text_maddr=0x70177000
49 .Cd hint.terasic_mtl.0.text_msize=0x2000
53 device driver provides support for the Terasic Multi-Touch LCD combined as
54 controlled by a University of Cambridge's IP Core.
55 Three device nodes are instantiated, representing various services supported
57 .Bl -tag -width terasic_pixelX
59 Memory-mapped register interface, including touch screen input.
61 Memory-mapped pixel-oriented frame buffer.
63 Memory-mapped text-oriented frame buffer.
67 devices are also attached to the
69 framework, which implements a VT-compatible terminal connected to the
73 device nodes may be added to
79 Register, text, and pixel devices may be accessed using
83 system calls, and also memory mapped using
98 device driver first appeared in
103 device driver and this manual page were
104 developed by SRI International and the University of Cambridge Computer
105 Laboratory under DARPA/AFRL contract
108 as part of the DARPA CRASH research programme.
109 This device driver was written by
110 .An Robert N. M. Watson .
115 attachment does not support the hardware cursor feature.
117 A more structured interface to control registers using the
119 system call, would sometimes be preferable to memory mapping.
120 For touch screen input, it would be highly desirable to offer a streaming
121 interface whose events can be managed using
123 and related system calls, with the kernel performing polling rather than the
124 userspace application.
129 bus attachment, which is appropriate for system-on-chip busses such as
131 If the IP core is configured off of another bus type, then additional bus
132 attachments will be required.