'\" t .\" Title: z8530_init .\" Author: .\" Generator: DocBook XSL Stylesheets v1.79.1 .\" Date: January 2017 .\" Manual: Public Functions Provided .\" Source: Kernel Hackers Manual 4.8.15 .\" Language: English .\" .TH "Z8530_INIT" "9" "January 2017" "Kernel Hackers Manual 4\&.8\&." "Public Functions Provided" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" z8530_init \- Initialise a Z8530 device .SH "SYNOPSIS" .HP \w'int\ z8530_init('u .BI "int z8530_init(struct\ z8530_dev\ *\ " "dev" ");" .SH "ARGUMENTS" .PP \fIdev\fR .RS 4 Z8530 device to initialise\&. .RE .SH "DESCRIPTION" .PP Configure up a Z8530/Z85C30 or Z85230 chip\&. We check the device is present, identify the type and then program it to hopefully keep quite and behave\&. This matters a lot, a Z8530 in the wrong state will sometimes get into stupid modes generating 10Khz interrupt streams and the like\&. .PP We set the interrupt handler up to discard any events, in case we get them during reset or setp\&. .PP Return 0 for success, or a negative value indicating the problem in errno form\&. .SH "AUTHOR" .PP \fBAlan Cox\fR <\&alan@lxorguk.ukuu.org.uk\&> .RS 4 Author. .RE .SH "COPYRIGHT" .br