/*
 * Copyright (c) 1997, by Sun Microsytems, Inc.
 * All rights reserved.
 */

	ident	"@(#)README	1.5	97/09/25 SMI"

DRIVER NAME:
	pio -- sample programmed I/O driver

ARCHITECTURES:
	This sample code is written for hypothetical hardware and will
	not run on any platform.

DESCRIPTION OF DRIVER:
	This sample code is written for hypothetical hardware and will not 
	run on any platform.  The code can be compiled for x86 or SPARC,
	and demonstrates how a driver can be written independent of the
	particular processor.

	The fictional device accepts one character at a time and
	generates an interrupt when it is ready for another.  The
	device implements two register sets, the first an 8-bit CSR 
	register and the second an 8-bit data register.

	The sample driver is not intended to be efficient or bulletproof;
	it is intended to show how to write a simple DDI/DKI-compliant
	driver.

CAVEATS AND CONSTRAINTS:
	This sample code is written for hypothetical hardware and will not 
	run on any platform.

DISCLAIMER:
	This driver is meant to illustrate the functionality of the 
	DDI/DKI. It is meant to be a skeleton that can be used as a basis
	for a real-world driver. This driver will not actually run. 

COMPILING/LOADING:
	Use the Makefile in the pio directory to compile the driver.
	The Makefile determines the architecture (x86 or sparc) of the 
	build machine and sets a preprocessor variable (i386 or sparc)
	accordingly. The object files are placed in an appropriate
	architecture-specific subdirectory of the pio directory.
