1<html><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 bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><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 name="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> 2      <code class="email"><<a class="email" href="mailto:alan@lxorguk.ukuu.org.uk">alan@lxorguk.ukuu.org.uk</a>></code><br> 3     </p></div></div></div></div></div><div><p class="copyright">Copyright © 2000 Alan Cox</p></div><div><div class="legalnotice"><a name="idp1116417140"></a><p> 4 This documentation is free software; you can redistribute 5 it and/or modify it under the terms of the GNU General Public 6 License as published by the Free Software Foundation; either 7 version 2 of the License, or (at your option) any later 8 version. 9 </p><p> 10 This program is distributed in the hope that it will be 11 useful, but WITHOUT ANY WARRANTY; without even the implied 12 warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. 13 See the GNU General Public License for more details. 14 </p><p> 15 You should have received a copy of the GNU General Public 16 License along with this program; if not, write to the Free 17 Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, 18 MA 02111-1307 USA 19 </p><p> 20 For more details see the file COPYING in the source 21 distribution of Linux. 22 </p></div></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></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"> — 23 Handle an interrupt from a Z8530 24 </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"> — 25 Open a Z8530 channel for PIO 26 </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"> — 27 Close a PIO Z8530 channel 28 </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"> — 29 Open a Z8530 for DMA I/O 30 </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"> — 31 Close down DMA I/O 32 </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"> — 33 Open a Z8530 for TX driven DMA 34 </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"> — 35 Close down a TX driven DMA channel 36 </span></dt><dt><span class="refentrytitle"><a href="API-z8530-describe.html"><span class="phrase">z8530_describe</span></a></span><span class="refpurpose"> — 37 Uniformly describe a Z8530 port 38 </span></dt><dt><span class="refentrytitle"><a href="API-z8530-init.html"><span class="phrase">z8530_init</span></a></span><span class="refpurpose"> — 39 Initialise a Z8530 device 40 </span></dt><dt><span class="refentrytitle"><a href="API-z8530-shutdown.html"><span class="phrase">z8530_shutdown</span></a></span><span class="refpurpose"> — 41 Shutdown a Z8530 device 42 </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"> — 43 Load channel data 44 </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"> — 45 Discard a packet 46 </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"> — 47 Queue a packet 48 </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"> — 49 Architecture specific interface function 50 </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"> — 51 Architecture specific interface function 52 </span></dt><dt><span class="refentrytitle"><a href="API-read-zsreg.html"><span class="phrase">read_zsreg</span></a></span><span class="refpurpose"> — 53 Read a register from a Z85230 54 </span></dt><dt><span class="refentrytitle"><a href="API-read-zsdata.html"><span class="phrase">read_zsdata</span></a></span><span class="refpurpose"> — 55 Read the data port of a Z8530 channel 56 </span></dt><dt><span class="refentrytitle"><a href="API-write-zsreg.html"><span class="phrase">write_zsreg</span></a></span><span class="refpurpose"> — 57 Write to a Z8530 channel register 58 </span></dt><dt><span class="refentrytitle"><a href="API-write-zsctrl.html"><span class="phrase">write_zsctrl</span></a></span><span class="refpurpose"> — 59 Write to a Z8530 control register 60 </span></dt><dt><span class="refentrytitle"><a href="API-write-zsdata.html"><span class="phrase">write_zsdata</span></a></span><span class="refpurpose"> — 61 Write to a Z8530 control register 62 </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"> — 63 Flush on chip RX FIFO 64 </span></dt><dt><span class="refentrytitle"><a href="API-z8530-rtsdtr.html"><span class="phrase">z8530_rtsdtr</span></a></span><span class="refpurpose"> — 65 Control the outgoing DTS/RTS line 66 </span></dt><dt><span class="refentrytitle"><a href="API-z8530-rx.html"><span class="phrase">z8530_rx</span></a></span><span class="refpurpose"> — 67 Handle a PIO receive event 68 </span></dt><dt><span class="refentrytitle"><a href="API-z8530-tx.html"><span class="phrase">z8530_tx</span></a></span><span class="refpurpose"> — 69 Handle a PIO transmit event 70 </span></dt><dt><span class="refentrytitle"><a href="API-z8530-status.html"><span class="phrase">z8530_status</span></a></span><span class="refpurpose"> — 71 Handle a PIO status exception 72 </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"> — 73 Handle a DMA RX event 74 </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"> — 75 Handle a DMA TX event 76 </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"> — 77 Handle a DMA status exception 78 </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"> — 79 Handle RX events from a stopped chip 80 </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"> — 81 Handle TX events from a stopped chip 82 </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"> — 83 Handle status events from a stopped chip 84 </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"> — 85 Begin packet transmission 86 </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"> — 87 TX complete callback 88 </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"> — 89 Receive completion callback 90 </span></dt><dt><span class="refentrytitle"><a href="API-spans-boundary.html"><span class="phrase">spans_boundary</span></a></span><span class="refpurpose"> — 91 Check a packet can be ISA DMA'd 92 </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> 93