xref: /onnv-gate/usr/src/uts/common/io/ecpp.conf (revision 1756:ba6fb540c8cd)
10Sstevel@tonic-gate#
20Sstevel@tonic-gate# CDDL HEADER START
30Sstevel@tonic-gate#
40Sstevel@tonic-gate# The contents of this file are subject to the terms of the
5*1756Sszhou# Common Development and Distribution License (the "License").
6*1756Sszhou# You may not use this file except in compliance with the License.
70Sstevel@tonic-gate#
80Sstevel@tonic-gate# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
90Sstevel@tonic-gate# or http://www.opensolaris.org/os/licensing.
100Sstevel@tonic-gate# See the License for the specific language governing permissions
110Sstevel@tonic-gate# and limitations under the License.
120Sstevel@tonic-gate#
130Sstevel@tonic-gate# When distributing Covered Code, include this CDDL HEADER in each
140Sstevel@tonic-gate# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
150Sstevel@tonic-gate# If applicable, add the following below this CDDL HEADER, with the
160Sstevel@tonic-gate# fields enclosed by brackets "[]" replaced with your own identifying
170Sstevel@tonic-gate# information: Portions Copyright [yyyy] [name of copyright owner]
180Sstevel@tonic-gate#
190Sstevel@tonic-gate# CDDL HEADER END
200Sstevel@tonic-gate#
210Sstevel@tonic-gate#
22*1756Sszhou# Copyright 2006 Sun Microsystems, Inc.  All rights reserved.
23*1756Sszhou# Use is subject to license terms.
240Sstevel@tonic-gate#
250Sstevel@tonic-gate#
260Sstevel@tonic-gate#ident	"%Z%%M%	%I%	%E% SMI"
270Sstevel@tonic-gate
280Sstevel@tonic-gate# When fast-centronics is set to "true", handshaking between the
290Sstevel@tonic-gate# driver and the peripheral is conducted by hardware. For some
300Sstevel@tonic-gate# Centronics devices the hardware handshaking is too fast for the
310Sstevel@tonic-gate# peripheral.  To slow down the handshaking, fast-centronics must
320Sstevel@tonic-gate# be set to "false". By default fast-centronics is set to "false".
330Sstevel@tonic-gate
340Sstevel@tonic-gatefast-centronics="false";
350Sstevel@tonic-gate
360Sstevel@tonic-gate
370Sstevel@tonic-gate# When fast-1284-compatible is set to "true", IEEE 1284 compliant
380Sstevel@tonic-gate# devices operating in Compatibility mode will have the parallel port
390Sstevel@tonic-gate# handshaking controlled by the hardware.  When it is set to "false"
400Sstevel@tonic-gate# handshaking is PIO controlled by the driver.  By default
410Sstevel@tonic-gate# fast-1284-compatible is set "true".
420Sstevel@tonic-gate
430Sstevel@tonic-gatefast-1284-compatible="true";
440Sstevel@tonic-gate
450Sstevel@tonic-gate
460Sstevel@tonic-gate# Some Centronics devices require the Init signal to be toggled upon
470Sstevel@tonic-gate# power-up.  The application should do this directly with ioctl(2) interface
480Sstevel@tonic-gate# as specified in ecpp(7d). As an alternative to using the API, the driver
490Sstevel@tonic-gate# may be configured to toggle the nInit signal upon every time the device
500Sstevel@tonic-gate# is opened. If centronics-init-seq is set to "true" the Init signal
510Sstevel@tonic-gate# will be toggled when the device is opened.  The default is "false".
520Sstevel@tonic-gate
530Sstevel@tonic-gatecentronics-init-seq="false";
540Sstevel@tonic-gate
550Sstevel@tonic-gate
560Sstevel@tonic-gate# When the ecpp driver detects a Centronics device is in an error state,
570Sstevel@tonic-gate# ecpp will re-examine the device every centronics-retry milliseconds.
580Sstevel@tonic-gate# The default is 750 milliseconds.
590Sstevel@tonic-gate
600Sstevel@tonic-gatecentronics-retry=750;
610Sstevel@tonic-gate
620Sstevel@tonic-gate
630Sstevel@tonic-gate# Some Centronics printers continue to assert BUSY after the ACK pulse.
640Sstevel@tonic-gate# The driver waits for centronics-wait-for-busy microseconds for a
650Sstevel@tonic-gate# desertion of BUSY before it queues the current data transfer.
660Sstevel@tonic-gate# The default is 5000 microseconds (5ms).
670Sstevel@tonic-gate
680Sstevel@tonic-gatecentronics-wait-for-busy=5000;
690Sstevel@tonic-gate
700Sstevel@tonic-gate
710Sstevel@tonic-gate# Devices that are not using fast handshaking may adjust the data setup
720Sstevel@tonic-gate# time and the strobe pulse width. The Centronics specification states that
730Sstevel@tonic-gate# each must be at least 1 microsecond.  The default values are set to
740Sstevel@tonic-gate# 2 microseconds to ensure reliable transfers.
750Sstevel@tonic-gate
760Sstevel@tonic-gatecentronics-data-setup-time=2;
770Sstevel@tonic-gatecentronics-strobe-pulse-width=2;
780Sstevel@tonic-gate
790Sstevel@tonic-gate# The ecpp driver waits ecpp-transfer-timeout seconds before it aborts
800Sstevel@tonic-gate# the current transfer and put the untransferred data back on the queue.
810Sstevel@tonic-gate# The default value for ecpp-transfer-timeout is 90 seconds.
820Sstevel@tonic-gate
830Sstevel@tonic-gateecpp-transfer-timeout=90;
84*1756Sszhou
85*1756Sszhou# The following note applies to x86 platforms only
86*1756Sszhou# If a system has a standard parallel port, but not enumerated
87*1756Sszhou# in the device tree, you may gain access to the port by uncommenting
88*1756Sszhou# the following lines and run "update_drv ecpp".
89*1756Sszhou#
90*1756Sszhou# name="lp" parent="/isa" interrupts=7 reg=1,0x378,0x8;
91