xref: /titanic_51/usr/src/uts/common/io/ecpp.conf (revision dcd3dacad308865c548b11e858fbdec783ec2a72)
17c478bd9Sstevel@tonic-gate#
27c478bd9Sstevel@tonic-gate# CDDL HEADER START
37c478bd9Sstevel@tonic-gate#
47c478bd9Sstevel@tonic-gate# The contents of this file are subject to the terms of the
5*dcd3dacaSszhou# Common Development and Distribution License (the "License").
6*dcd3dacaSszhou# You may not use this file except in compliance with the License.
77c478bd9Sstevel@tonic-gate#
87c478bd9Sstevel@tonic-gate# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
97c478bd9Sstevel@tonic-gate# or http://www.opensolaris.org/os/licensing.
107c478bd9Sstevel@tonic-gate# See the License for the specific language governing permissions
117c478bd9Sstevel@tonic-gate# and limitations under the License.
127c478bd9Sstevel@tonic-gate#
137c478bd9Sstevel@tonic-gate# When distributing Covered Code, include this CDDL HEADER in each
147c478bd9Sstevel@tonic-gate# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
157c478bd9Sstevel@tonic-gate# If applicable, add the following below this CDDL HEADER, with the
167c478bd9Sstevel@tonic-gate# fields enclosed by brackets "[]" replaced with your own identifying
177c478bd9Sstevel@tonic-gate# information: Portions Copyright [yyyy] [name of copyright owner]
187c478bd9Sstevel@tonic-gate#
197c478bd9Sstevel@tonic-gate# CDDL HEADER END
207c478bd9Sstevel@tonic-gate#
217c478bd9Sstevel@tonic-gate#
22*dcd3dacaSszhou# Copyright 2006 Sun Microsystems, Inc.  All rights reserved.
23*dcd3dacaSszhou# Use is subject to license terms.
247c478bd9Sstevel@tonic-gate#
257c478bd9Sstevel@tonic-gate#
267c478bd9Sstevel@tonic-gate#ident	"%Z%%M%	%I%	%E% SMI"
277c478bd9Sstevel@tonic-gate
287c478bd9Sstevel@tonic-gate# When fast-centronics is set to "true", handshaking between the
297c478bd9Sstevel@tonic-gate# driver and the peripheral is conducted by hardware. For some
307c478bd9Sstevel@tonic-gate# Centronics devices the hardware handshaking is too fast for the
317c478bd9Sstevel@tonic-gate# peripheral.  To slow down the handshaking, fast-centronics must
327c478bd9Sstevel@tonic-gate# be set to "false". By default fast-centronics is set to "false".
337c478bd9Sstevel@tonic-gate
347c478bd9Sstevel@tonic-gatefast-centronics="false";
357c478bd9Sstevel@tonic-gate
367c478bd9Sstevel@tonic-gate
377c478bd9Sstevel@tonic-gate# When fast-1284-compatible is set to "true", IEEE 1284 compliant
387c478bd9Sstevel@tonic-gate# devices operating in Compatibility mode will have the parallel port
397c478bd9Sstevel@tonic-gate# handshaking controlled by the hardware.  When it is set to "false"
407c478bd9Sstevel@tonic-gate# handshaking is PIO controlled by the driver.  By default
417c478bd9Sstevel@tonic-gate# fast-1284-compatible is set "true".
427c478bd9Sstevel@tonic-gate
437c478bd9Sstevel@tonic-gatefast-1284-compatible="true";
447c478bd9Sstevel@tonic-gate
457c478bd9Sstevel@tonic-gate
467c478bd9Sstevel@tonic-gate# Some Centronics devices require the Init signal to be toggled upon
477c478bd9Sstevel@tonic-gate# power-up.  The application should do this directly with ioctl(2) interface
487c478bd9Sstevel@tonic-gate# as specified in ecpp(7d). As an alternative to using the API, the driver
497c478bd9Sstevel@tonic-gate# may be configured to toggle the nInit signal upon every time the device
507c478bd9Sstevel@tonic-gate# is opened. If centronics-init-seq is set to "true" the Init signal
517c478bd9Sstevel@tonic-gate# will be toggled when the device is opened.  The default is "false".
527c478bd9Sstevel@tonic-gate
537c478bd9Sstevel@tonic-gatecentronics-init-seq="false";
547c478bd9Sstevel@tonic-gate
557c478bd9Sstevel@tonic-gate
567c478bd9Sstevel@tonic-gate# When the ecpp driver detects a Centronics device is in an error state,
577c478bd9Sstevel@tonic-gate# ecpp will re-examine the device every centronics-retry milliseconds.
587c478bd9Sstevel@tonic-gate# The default is 750 milliseconds.
597c478bd9Sstevel@tonic-gate
607c478bd9Sstevel@tonic-gatecentronics-retry=750;
617c478bd9Sstevel@tonic-gate
627c478bd9Sstevel@tonic-gate
637c478bd9Sstevel@tonic-gate# Some Centronics printers continue to assert BUSY after the ACK pulse.
647c478bd9Sstevel@tonic-gate# The driver waits for centronics-wait-for-busy microseconds for a
657c478bd9Sstevel@tonic-gate# desertion of BUSY before it queues the current data transfer.
667c478bd9Sstevel@tonic-gate# The default is 5000 microseconds (5ms).
677c478bd9Sstevel@tonic-gate
687c478bd9Sstevel@tonic-gatecentronics-wait-for-busy=5000;
697c478bd9Sstevel@tonic-gate
707c478bd9Sstevel@tonic-gate
717c478bd9Sstevel@tonic-gate# Devices that are not using fast handshaking may adjust the data setup
727c478bd9Sstevel@tonic-gate# time and the strobe pulse width. The Centronics specification states that
737c478bd9Sstevel@tonic-gate# each must be at least 1 microsecond.  The default values are set to
747c478bd9Sstevel@tonic-gate# 2 microseconds to ensure reliable transfers.
757c478bd9Sstevel@tonic-gate
767c478bd9Sstevel@tonic-gatecentronics-data-setup-time=2;
777c478bd9Sstevel@tonic-gatecentronics-strobe-pulse-width=2;
787c478bd9Sstevel@tonic-gate
797c478bd9Sstevel@tonic-gate# The ecpp driver waits ecpp-transfer-timeout seconds before it aborts
807c478bd9Sstevel@tonic-gate# the current transfer and put the untransferred data back on the queue.
817c478bd9Sstevel@tonic-gate# The default value for ecpp-transfer-timeout is 90 seconds.
827c478bd9Sstevel@tonic-gate
837c478bd9Sstevel@tonic-gateecpp-transfer-timeout=90;
84*dcd3dacaSszhou
85*dcd3dacaSszhou# The following note applies to x86 platforms only
86*dcd3dacaSszhou# If a system has a standard parallel port, but not enumerated
87*dcd3dacaSszhou# in the device tree, you may gain access to the port by uncommenting
88*dcd3dacaSszhou# the following lines and run "update_drv ecpp".
89*dcd3dacaSszhou#
90*dcd3dacaSszhou# name="lp" parent="/isa" interrupts=7 reg=1,0x378,0x8;
91