<?xml version="1.0" encoding="ANSI_X3.4-1968" standalone="no"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968" /><title>Z8530 Programming Guide</title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1" /><link rel="home" href="index.html" title="Z8530 Programming Guide" /><link rel="next" href="intro.html" title="Chapter 1. Introduction" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Z8530 Programming Guide</th></tr><tr><td width="20%" align="left"> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="intro.html">Next</a></td></tr></table><hr /></div><div class="book"><div class="titlepage"><div><div><h1 class="title"><a id="Z85230Guide"></a>Z8530 Programming Guide</h1></div><div><div class="authorgroup"><div class="author"><h3 class="author"><span class="firstname">Alan</span> <span class="surname">Cox</span></h3><div class="affiliation"><div class="address"><p><br />       <code class="email"><<a class="email" href="mailto:alan@lxorguk.ukuu.org.uk">alan@lxorguk.ukuu.org.uk</a>></code><br />      </p></div></div></div></div></div><div><p class="copyright">Copyright © 2000 Alan Cox</p></div><div><div class="legalnotice"><a id="idm140438219946304"></a><p> This documentation is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. </p><p> This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. </p><p> You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA </p><p> For more details see the file COPYING in the source distribution of Linux. </p></div></div></div><hr /></div><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="chapter"><a href="intro.html">1. Introduction</a></span></dt><dt><span class="chapter"><a href="Driver_Modes.html">2. Driver Modes</a></span></dt><dt><span class="chapter"><a href="Using_the_Z85230_driver.html">3. Using the Z85230 driver</a></span></dt><dt><span class="chapter"><a href="Attaching_Network_Interfaces.html">4. Attaching Network Interfaces</a></span></dt><dt><span class="chapter"><a href="Configuring_And_Activating_The_Port.html">5. Configuring And Activating The Port</a></span></dt><dt><span class="chapter"><a href="Network_Layer_Functions.html">6. Network Layer Functions</a></span></dt><dt><span class="chapter"><a href="Porting_The_Z8530_Driver.html">7. Porting The Z8530 Driver</a></span></dt><dt><span class="chapter"><a href="bugs.html">8. Known Bugs And Assumptions</a></span></dt><dt><span class="chapter"><a href="pubfunctions.html">9. Public Functions Provided</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="API-z8530-interrupt.html"><span class="phrase">z8530_interrupt</span></a></span><span class="refpurpose"> — Handle an interrupt from a Z8530 </span></dt><dt><span class="refentrytitle"><a href="API-z8530-sync-open.html"><span class="phrase">z8530_sync_open</span></a></span><span class="refpurpose"> — Open a Z8530 channel for PIO </span></dt><dt><span class="refentrytitle"><a href="API-z8530-sync-close.html"><span class="phrase">z8530_sync_close</span></a></span><span class="refpurpose"> — Close a PIO Z8530 channel </span></dt><dt><span class="refentrytitle"><a href="API-z8530-sync-dma-open.html"><span class="phrase">z8530_sync_dma_open</span></a></span><span class="refpurpose"> — Open a Z8530 for DMA I/O </span></dt><dt><span class="refentrytitle"><a href="API-z8530-sync-dma-close.html"><span class="phrase">z8530_sync_dma_close</span></a></span><span class="refpurpose"> — Close down DMA I/O </span></dt><dt><span class="refentrytitle"><a href="API-z8530-sync-txdma-open.html"><span class="phrase">z8530_sync_txdma_open</span></a></span><span class="refpurpose"> — Open a Z8530 for TX driven DMA </span></dt><dt><span class="refentrytitle"><a href="API-z8530-sync-txdma-close.html"><span class="phrase">z8530_sync_txdma_close</span></a></span><span class="refpurpose"> — Close down a TX driven DMA channel </span></dt><dt><span class="refentrytitle"><a href="API-z8530-describe.html"><span class="phrase">z8530_describe</span></a></span><span class="refpurpose"> — Uniformly describe a Z8530 port </span></dt><dt><span class="refentrytitle"><a href="API-z8530-init.html"><span class="phrase">z8530_init</span></a></span><span class="refpurpose"> — Initialise a Z8530 device </span></dt><dt><span class="refentrytitle"><a href="API-z8530-shutdown.html"><span class="phrase">z8530_shutdown</span></a></span><span class="refpurpose"> — Shutdown a Z8530 device </span></dt><dt><span class="refentrytitle"><a href="API-z8530-channel-load.html"><span class="phrase">z8530_channel_load</span></a></span><span class="refpurpose"> — Load channel data </span></dt><dt><span class="refentrytitle"><a href="API-z8530-null-rx.html"><span class="phrase">z8530_null_rx</span></a></span><span class="refpurpose"> — Discard a packet </span></dt><dt><span class="refentrytitle"><a href="API-z8530-queue-xmit.html"><span class="phrase">z8530_queue_xmit</span></a></span><span class="refpurpose"> — Queue a packet </span></dt></dl></dd><dt><span class="chapter"><a href="intfunctions.html">10. Internal Functions</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="API-z8530-read-port.html"><span class="phrase">z8530_read_port</span></a></span><span class="refpurpose"> — Architecture specific interface function </span></dt><dt><span class="refentrytitle"><a href="API-z8530-write-port.html"><span class="phrase">z8530_write_port</span></a></span><span class="refpurpose"> — Architecture specific interface function </span></dt><dt><span class="refentrytitle"><a href="API-read-zsreg.html"><span class="phrase">read_zsreg</span></a></span><span class="refpurpose"> — Read a register from a Z85230 </span></dt><dt><span class="refentrytitle"><a href="API-read-zsdata.html"><span class="phrase">read_zsdata</span></a></span><span class="refpurpose"> — Read the data port of a Z8530 channel </span></dt><dt><span class="refentrytitle"><a href="API-write-zsreg.html"><span class="phrase">write_zsreg</span></a></span><span class="refpurpose"> — Write to a Z8530 channel register </span></dt><dt><span class="refentrytitle"><a href="API-write-zsctrl.html"><span class="phrase">write_zsctrl</span></a></span><span class="refpurpose"> — Write to a Z8530 control register </span></dt><dt><span class="refentrytitle"><a href="API-write-zsdata.html"><span class="phrase">write_zsdata</span></a></span><span class="refpurpose"> — Write to a Z8530 control register </span></dt><dt><span class="refentrytitle"><a href="API-z8530-flush-fifo.html"><span class="phrase">z8530_flush_fifo</span></a></span><span class="refpurpose"> — Flush on chip RX FIFO </span></dt><dt><span class="refentrytitle"><a href="API-z8530-rtsdtr.html"><span class="phrase">z8530_rtsdtr</span></a></span><span class="refpurpose"> — Control the outgoing DTS/RTS line </span></dt><dt><span class="refentrytitle"><a href="API-z8530-rx.html"><span class="phrase">z8530_rx</span></a></span><span class="refpurpose"> — Handle a PIO receive event </span></dt><dt><span class="refentrytitle"><a href="API-z8530-tx.html"><span class="phrase">z8530_tx</span></a></span><span class="refpurpose"> — Handle a PIO transmit event </span></dt><dt><span class="refentrytitle"><a href="API-z8530-status.html"><span class="phrase">z8530_status</span></a></span><span class="refpurpose"> — Handle a PIO status exception </span></dt><dt><span class="refentrytitle"><a href="API-z8530-dma-rx.html"><span class="phrase">z8530_dma_rx</span></a></span><span class="refpurpose"> — Handle a DMA RX event </span></dt><dt><span class="refentrytitle"><a href="API-z8530-dma-tx.html"><span class="phrase">z8530_dma_tx</span></a></span><span class="refpurpose"> — Handle a DMA TX event </span></dt><dt><span class="refentrytitle"><a href="API-z8530-dma-status.html"><span class="phrase">z8530_dma_status</span></a></span><span class="refpurpose"> — Handle a DMA status exception </span></dt><dt><span class="refentrytitle"><a href="API-z8530-rx-clear.html"><span class="phrase">z8530_rx_clear</span></a></span><span class="refpurpose"> — Handle RX events from a stopped chip </span></dt><dt><span class="refentrytitle"><a href="API-z8530-tx-clear.html"><span class="phrase">z8530_tx_clear</span></a></span><span class="refpurpose"> — Handle TX events from a stopped chip </span></dt><dt><span class="refentrytitle"><a href="API-z8530-status-clear.html"><span class="phrase">z8530_status_clear</span></a></span><span class="refpurpose"> — Handle status events from a stopped chip </span></dt><dt><span class="refentrytitle"><a href="API-z8530-tx-begin.html"><span class="phrase">z8530_tx_begin</span></a></span><span class="refpurpose"> — Begin packet transmission </span></dt><dt><span class="refentrytitle"><a href="API-z8530-tx-done.html"><span class="phrase">z8530_tx_done</span></a></span><span class="refpurpose"> — TX complete callback </span></dt><dt><span class="refentrytitle"><a href="API-z8530-rx-done.html"><span class="phrase">z8530_rx_done</span></a></span><span class="refpurpose"> — Receive completion callback </span></dt><dt><span class="refentrytitle"><a href="API-spans-boundary.html"><span class="phrase">spans_boundary</span></a></span><span class="refpurpose"> — Check a packet can be ISA DMA'd </span></dt></dl></dd></dl></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="intro.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"> </td><td width="20%" align="center"> </td><td width="40%" align="right" valign="top"> Chapter 1. Introduction</td></tr></table></div></body></html>