Home | History | Annotate | Line # | Download | only in isa
if_ec.c revision 1.12.2.2
      1  1.12.2.2   nathanw /*	$NetBSD: if_ec.c,v 1.12.2.2 2001/08/24 00:09:45 nathanw Exp $	*/
      2       1.1   thorpej 
      3       1.1   thorpej /*-
      4       1.5   thorpej  * Copyright (c) 1997, 1998 The NetBSD Foundation, Inc.
      5       1.1   thorpej  * All rights reserved.
      6       1.1   thorpej  *
      7       1.1   thorpej  * This code is derived from software contributed to The NetBSD Foundation
      8       1.1   thorpej  * by Jason R. Thorpe of the Numerical Aerospace Simulation Facility,
      9       1.1   thorpej  * NASA Ames Research Center.
     10       1.1   thorpej  *
     11       1.1   thorpej  * Redistribution and use in source and binary forms, with or without
     12       1.1   thorpej  * modification, are permitted provided that the following conditions
     13       1.1   thorpej  * are met:
     14       1.1   thorpej  * 1. Redistributions of source code must retain the above copyright
     15       1.1   thorpej  *    notice, this list of conditions and the following disclaimer.
     16       1.1   thorpej  * 2. Redistributions in binary form must reproduce the above copyright
     17       1.1   thorpej  *    notice, this list of conditions and the following disclaimer in the
     18       1.1   thorpej  *    documentation and/or other materials provided with the distribution.
     19       1.1   thorpej  * 3. All advertising materials mentioning features or use of this software
     20       1.1   thorpej  *    must display the following acknowledgement:
     21       1.1   thorpej  *	This product includes software developed by the NetBSD
     22       1.1   thorpej  *	Foundation, Inc. and its contributors.
     23       1.1   thorpej  * 4. Neither the name of The NetBSD Foundation nor the names of its
     24       1.1   thorpej  *    contributors may be used to endorse or promote products derived
     25       1.1   thorpej  *    from this software without specific prior written permission.
     26       1.1   thorpej  *
     27       1.1   thorpej  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
     28       1.1   thorpej  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
     29       1.1   thorpej  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
     30       1.1   thorpej  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
     31       1.1   thorpej  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
     32       1.1   thorpej  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
     33       1.1   thorpej  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
     34       1.1   thorpej  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
     35       1.1   thorpej  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
     36       1.1   thorpej  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     37       1.1   thorpej  * POSSIBILITY OF SUCH DAMAGE.
     38       1.1   thorpej  */
     39       1.1   thorpej 
     40       1.1   thorpej /*
     41       1.1   thorpej  * Device driver for National Semiconductor DS8390/WD83C690 based ethernet
     42       1.1   thorpej  * adapters.
     43       1.1   thorpej  *
     44       1.1   thorpej  * Copyright (c) 1994, 1995 Charles M. Hannum.  All rights reserved.
     45       1.1   thorpej  *
     46       1.1   thorpej  * Copyright (C) 1993, David Greenman.  This software may be used, modified,
     47       1.1   thorpej  * copied, distributed, and sold, in both source and binary form provided that
     48       1.1   thorpej  * the above copyright and these terms are retained.  Under no circumstances is
     49       1.1   thorpej  * the author responsible for the proper functioning of this software, nor does
     50       1.1   thorpej  * the author assume any responsibility for damages incurred with its use.
     51       1.1   thorpej  */
     52       1.1   thorpej 
     53       1.1   thorpej /*
     54       1.1   thorpej  * Device driver for the 3Com Etherlink II (3c503).
     55       1.1   thorpej  */
     56       1.1   thorpej 
     57       1.1   thorpej #include <sys/param.h>
     58       1.1   thorpej #include <sys/systm.h>
     59       1.1   thorpej #include <sys/device.h>
     60       1.1   thorpej #include <sys/socket.h>
     61       1.1   thorpej #include <sys/mbuf.h>
     62       1.1   thorpej #include <sys/syslog.h>
     63       1.1   thorpej 
     64       1.1   thorpej #include <net/if.h>
     65       1.1   thorpej #include <net/if_dl.h>
     66       1.1   thorpej #include <net/if_types.h>
     67       1.1   thorpej #include <net/if_media.h>
     68       1.1   thorpej 
     69       1.1   thorpej #include <net/if_ether.h>
     70       1.1   thorpej 
     71       1.1   thorpej #include <machine/bus.h>
     72       1.1   thorpej #include <machine/intr.h>
     73       1.1   thorpej 
     74       1.1   thorpej #include <dev/isa/isareg.h>
     75       1.1   thorpej #include <dev/isa/isavar.h>
     76       1.1   thorpej 
     77       1.1   thorpej #include <dev/ic/dp8390reg.h>
     78       1.1   thorpej #include <dev/ic/dp8390var.h>
     79       1.1   thorpej 
     80       1.1   thorpej #include <dev/isa/if_ecreg.h>
     81       1.1   thorpej 
     82       1.1   thorpej struct ec_softc {
     83       1.1   thorpej 	struct dp8390_softc sc_dp8390;
     84       1.1   thorpej 
     85       1.1   thorpej 	bus_space_tag_t sc_asict;	/* space tag for ASIC */
     86       1.1   thorpej 	bus_space_handle_t sc_asich;	/* space handle for ASIC */
     87       1.1   thorpej 
     88       1.1   thorpej 	int sc_16bitp;			/* are we 16 bit? */
     89       1.1   thorpej 
     90       1.1   thorpej 	void *sc_ih;			/* interrupt handle */
     91       1.1   thorpej };
     92       1.1   thorpej 
     93       1.1   thorpej int	ec_probe __P((struct device *, struct cfdata *, void *));
     94       1.1   thorpej void	ec_attach __P((struct device *, struct device *, void *));
     95       1.1   thorpej 
     96       1.1   thorpej struct cfattach ec_ca = {
     97       1.1   thorpej 	sizeof(struct ec_softc), ec_probe, ec_attach
     98       1.1   thorpej };
     99       1.1   thorpej 
    100       1.1   thorpej int	ec_set_media __P((struct ec_softc *, int));
    101       1.1   thorpej 
    102      1.12   thorpej void	ec_media_init __P((struct dp8390_softc *));
    103      1.12   thorpej 
    104       1.1   thorpej int	ec_mediachange __P((struct dp8390_softc *));
    105       1.1   thorpej void	ec_mediastatus __P((struct dp8390_softc *, struct ifmediareq *));
    106       1.1   thorpej 
    107       1.1   thorpej void	ec_init_card __P((struct dp8390_softc *));
    108       1.1   thorpej int	ec_write_mbuf __P((struct dp8390_softc *, struct mbuf *, int));
    109       1.1   thorpej int	ec_ring_copy __P((struct dp8390_softc *, int, caddr_t, u_short));
    110       1.1   thorpej void	ec_read_hdr __P((struct dp8390_softc *, int, struct dp8390_ring *));
    111       1.1   thorpej int	ec_fake_test_mem __P((struct dp8390_softc *));
    112       1.1   thorpej int	ec_test_mem __P((struct dp8390_softc *));
    113       1.1   thorpej 
    114       1.1   thorpej __inline void ec_readmem __P((struct ec_softc *, int, u_int8_t *, int));
    115       1.1   thorpej 
    116       1.1   thorpej static const int ec_iobase[] = {
    117       1.1   thorpej 	0x2e0, 0x2a0, 0x280, 0x250, 0x350, 0x330, 0x310, 0x300,
    118       1.1   thorpej };
    119       1.1   thorpej #define	NEC_IOBASE	(sizeof(ec_iobase) / sizeof(ec_iobase[0]))
    120       1.1   thorpej 
    121       1.1   thorpej static const int ec_membase[] = {
    122       1.1   thorpej 	MADDRUNK, MADDRUNK, MADDRUNK, MADDRUNK, 0xc8000, 0xcc000,
    123       1.1   thorpej 	0xd8000, 0xdc000,
    124       1.1   thorpej };
    125       1.1   thorpej #define	NEC_MEMBASE	(sizeof(ec_membase) / sizeof(ec_membase[0]))
    126       1.1   thorpej 
    127       1.1   thorpej int
    128       1.1   thorpej ec_probe(parent, match, aux)
    129       1.1   thorpej 	struct device *parent;
    130       1.1   thorpej 	struct cfdata *match;
    131       1.1   thorpej 	void *aux;
    132       1.1   thorpej {
    133       1.1   thorpej 	struct isa_attach_args *ia = aux;
    134       1.1   thorpej 	bus_space_tag_t nict, asict, memt;
    135       1.1   thorpej 	bus_space_handle_t nich, asich, memh;
    136       1.1   thorpej 	bus_size_t memsize;
    137       1.1   thorpej 	int nich_valid, asich_valid, memh_valid;
    138       1.1   thorpej 	int i, rv = 0;
    139       1.1   thorpej 	u_int8_t x;
    140       1.1   thorpej 
    141       1.1   thorpej 	nict = asict = ia->ia_iot;
    142       1.1   thorpej 	memt = ia->ia_memt;
    143       1.1   thorpej 
    144       1.1   thorpej 	nich_valid = asich_valid = memh_valid = 0;
    145       1.1   thorpej 
    146       1.1   thorpej 	/*
    147       1.1   thorpej 	 * Hmm, a 16-bit card has 16k of memory, but only an 8k window
    148       1.1   thorpej 	 * to it.
    149       1.1   thorpej 	 */
    150       1.1   thorpej 	memsize = 8192;
    151       1.1   thorpej 
    152       1.1   thorpej 	/* Disallow wildcarded i/o addresses. */
    153       1.1   thorpej 	if (ia->ia_iobase == ISACF_PORT_DEFAULT)
    154       1.1   thorpej 		return (0);
    155       1.1   thorpej 
    156       1.1   thorpej 	/* Disallow wildcarded mem address. */
    157       1.1   thorpej 	if (ia->ia_maddr == ISACF_IOMEM_DEFAULT)
    158       1.1   thorpej 		return (0);
    159       1.1   thorpej 
    160       1.1   thorpej 	/* Validate the i/o base. */
    161       1.1   thorpej 	for (i = 0; i < NEC_IOBASE; i++)
    162       1.1   thorpej 		if (ia->ia_iobase == ec_iobase[i])
    163       1.1   thorpej 			break;
    164       1.1   thorpej 	if (i == NEC_IOBASE)
    165       1.1   thorpej 		return (0);
    166       1.1   thorpej 
    167       1.1   thorpej 	/* Validate the mem base. */
    168       1.1   thorpej 	for (i = 0; i < NEC_MEMBASE; i++) {
    169       1.1   thorpej 		if (ec_membase[i] == MADDRUNK)
    170       1.1   thorpej 			continue;
    171       1.1   thorpej 		if (ia->ia_maddr == ec_membase[i])
    172       1.1   thorpej 			break;
    173       1.1   thorpej 	}
    174       1.1   thorpej 	if (i == NEC_MEMBASE)
    175       1.1   thorpej 		return (0);
    176       1.1   thorpej 
    177       1.1   thorpej 	/* Attempt to map the NIC space. */
    178       1.1   thorpej 	if (bus_space_map(nict, ia->ia_iobase + ELINK2_NIC_OFFSET,
    179       1.1   thorpej 	    ELINK2_NIC_PORTS, 0, &nich))
    180       1.1   thorpej 		goto out;
    181       1.1   thorpej 	nich_valid = 1;
    182       1.1   thorpej 
    183       1.1   thorpej 	/* Attempt to map the ASIC space. */
    184       1.1   thorpej 	if (bus_space_map(asict, ia->ia_iobase + ELINK2_ASIC_OFFSET,
    185       1.1   thorpej 	    ELINK2_ASIC_PORTS, 0, &asich))
    186       1.1   thorpej 		goto out;
    187       1.1   thorpej 	asich_valid = 1;
    188       1.1   thorpej 
    189       1.1   thorpej 	/* Attempt to map the memory space. */
    190       1.1   thorpej 	if (bus_space_map(memt, ia->ia_maddr, memsize, 0, &memh))
    191       1.1   thorpej 		goto out;
    192       1.1   thorpej 	memh_valid = 1;
    193       1.1   thorpej 
    194       1.1   thorpej 	/*
    195       1.1   thorpej 	 * Verify that the kernel configured I/O address matches the
    196       1.1   thorpej 	 * board configured I/O address.
    197       1.1   thorpej 	 *
    198       1.1   thorpej 	 * This is really only useful to see if something that looks like
    199       1.1   thorpej 	 * the board is there; after all, we're already talking to it at
    200       1.1   thorpej 	 * this point.
    201       1.1   thorpej 	 */
    202       1.1   thorpej 	x = bus_space_read_1(asict, asich, ELINK2_BCFR);
    203       1.1   thorpej 	if (x == 0 || (x & (x - 1)) != 0)
    204       1.1   thorpej 		goto out;
    205       1.1   thorpej 	i = ffs(x) - 1;
    206       1.1   thorpej 	if (ia->ia_iobase != ec_iobase[i])
    207       1.1   thorpej 		goto out;
    208       1.1   thorpej 
    209       1.1   thorpej 	/*
    210       1.1   thorpej 	 * ...and for the memory address.  Note we do not support
    211       1.1   thorpej 	 * cards configured with shared memory disabled.
    212       1.1   thorpej 	 */
    213       1.1   thorpej 	x = bus_space_read_1(asict, asich, ELINK2_PCFR);
    214       1.1   thorpej 	if (x == 0 || (x & (x - 1)) != 0)
    215       1.1   thorpej 		goto out;
    216       1.1   thorpej 	i = ffs(x) - 1;
    217       1.1   thorpej 	if (ia->ia_maddr != ec_membase[i])
    218       1.1   thorpej 		goto out;
    219       1.1   thorpej 
    220       1.1   thorpej 	/* So, we say we've found it! */
    221       1.1   thorpej 	ia->ia_iosize = ELINK2_NIC_PORTS;
    222       1.1   thorpej 	ia->ia_msize = memsize;
    223       1.1   thorpej 	rv = 1;
    224       1.1   thorpej 
    225       1.1   thorpej  out:
    226       1.1   thorpej 	if (nich_valid)
    227       1.1   thorpej 		bus_space_unmap(nict, nich, ELINK2_NIC_PORTS);
    228       1.1   thorpej 	if (asich_valid)
    229       1.1   thorpej 		bus_space_unmap(asict, asich, ELINK2_ASIC_PORTS);
    230       1.1   thorpej 	if (memh_valid)
    231       1.1   thorpej 		bus_space_unmap(memt, memh, memsize);
    232       1.1   thorpej 	return (rv);
    233       1.1   thorpej }
    234       1.1   thorpej 
    235       1.1   thorpej void
    236       1.1   thorpej ec_attach(parent, self, aux)
    237       1.1   thorpej 	struct device *parent, *self;
    238       1.1   thorpej 	void *aux;
    239       1.1   thorpej {
    240       1.1   thorpej 	struct ec_softc *esc = (struct ec_softc *)self;
    241       1.1   thorpej 	struct dp8390_softc *sc = &esc->sc_dp8390;
    242       1.1   thorpej 	struct isa_attach_args *ia = aux;
    243       1.1   thorpej 	bus_space_tag_t nict, asict, memt;
    244       1.1   thorpej 	bus_space_handle_t nich, asich, memh;
    245       1.1   thorpej 	bus_size_t memsize;
    246       1.1   thorpej 	u_int8_t tmp;
    247       1.1   thorpej 	int i;
    248       1.1   thorpej 
    249       1.1   thorpej 	printf("\n");
    250       1.1   thorpej 
    251       1.1   thorpej 	nict = asict = ia->ia_iot;
    252       1.1   thorpej 	memt = ia->ia_memt;
    253       1.1   thorpej 
    254       1.1   thorpej 	/*
    255       1.1   thorpej 	 * Hmm, a 16-bit card has 16k of memory, but only an 8k window
    256       1.1   thorpej 	 * to it.
    257       1.1   thorpej 	 */
    258       1.1   thorpej 	memsize = 8192;
    259       1.1   thorpej 
    260       1.1   thorpej 	/* Map the NIC space. */
    261       1.1   thorpej 	if (bus_space_map(nict, ia->ia_iobase + ELINK2_NIC_OFFSET,
    262       1.1   thorpej 	    ELINK2_NIC_PORTS, 0, &nich)) {
    263       1.1   thorpej 		printf("%s: can't map nic i/o space\n",
    264       1.1   thorpej 		    sc->sc_dev.dv_xname);
    265       1.1   thorpej 		return;
    266       1.1   thorpej 	}
    267       1.1   thorpej 
    268       1.1   thorpej 	/* Map the ASIC space. */
    269       1.1   thorpej 	if (bus_space_map(asict, ia->ia_iobase + ELINK2_ASIC_OFFSET,
    270       1.1   thorpej 	    ELINK2_ASIC_PORTS, 0, &asich)) {
    271       1.1   thorpej 		printf("%s: can't map asic i/o space\n",
    272       1.1   thorpej 		    sc->sc_dev.dv_xname);
    273       1.1   thorpej 		return;
    274       1.1   thorpej 	}
    275       1.1   thorpej 
    276       1.1   thorpej 	/* Map the memory space. */
    277       1.1   thorpej 	if (bus_space_map(memt, ia->ia_maddr, memsize, 0, &memh)) {
    278       1.1   thorpej 		printf("%s: can't map shared memory\n",
    279       1.1   thorpej 		    sc->sc_dev.dv_xname);
    280       1.1   thorpej 		return;
    281       1.1   thorpej 	}
    282       1.1   thorpej 
    283       1.1   thorpej 	esc->sc_asict = asict;
    284       1.1   thorpej 	esc->sc_asich = asich;
    285       1.1   thorpej 
    286       1.1   thorpej 	sc->sc_regt = nict;
    287       1.1   thorpej 	sc->sc_regh = nich;
    288       1.1   thorpej 
    289       1.1   thorpej 	sc->sc_buft = memt;
    290       1.1   thorpej 	sc->sc_bufh = memh;
    291       1.1   thorpej 
    292       1.1   thorpej 	/* Interface is always enabled. */
    293       1.1   thorpej 	sc->sc_enabled = 1;
    294       1.1   thorpej 
    295       1.1   thorpej 	/* Registers are linear. */
    296       1.1   thorpej 	for (i = 0; i < 16; i++)
    297       1.1   thorpej 		sc->sc_reg_map[i] = i;
    298       1.1   thorpej 
    299       1.1   thorpej 	/* Now we can use the NIC_{GET,PUT}() macros. */
    300       1.1   thorpej 
    301       1.1   thorpej 	/*
    302       1.1   thorpej 	 * Reset NIC and ASIC.  Enable on-board transeiver throughout
    303       1.1   thorpej 	 * reset sequence since it will lock up if the cable isn't
    304       1.1   thorpej 	 * connected if we don't.
    305       1.1   thorpej 	 */
    306       1.1   thorpej 	bus_space_write_1(asict, asich, ELINK2_CR,
    307       1.1   thorpej 	    ELINK2_CR_RST | ELINK2_CR_XSEL);
    308       1.1   thorpej 
    309       1.1   thorpej 	/* Wait for a while, then un-reset it. */
    310       1.1   thorpej 	delay(50);
    311       1.1   thorpej 
    312       1.1   thorpej 	/*
    313       1.1   thorpej 	 * The 3Com ASIC defaults to rather strange settings for the CR
    314       1.1   thorpej 	 * after a reset.  It's important to set it again after the
    315       1.1   thorpej 	 * following write (this is done when we map the PROM below).
    316       1.1   thorpej 	 */
    317       1.1   thorpej 	bus_space_write_1(asict, asich, ELINK2_CR, ELINK2_CR_XSEL);
    318       1.1   thorpej 
    319       1.1   thorpej 	/* Wait a bit for the NIC to recover from the reset. */
    320       1.1   thorpej 	delay(5000);
    321       1.1   thorpej 
    322       1.1   thorpej 	/*
    323       1.1   thorpej 	 * Get the station address from on-board ROM.
    324       1.1   thorpej 	 *
    325       1.1   thorpej 	 * First, map Ethernet address PROM over the top of where the NIC
    326       1.1   thorpej 	 * registers normally appear.
    327       1.1   thorpej 	 */
    328       1.1   thorpej 	bus_space_write_1(asict, asich, ELINK2_CR,
    329       1.1   thorpej 	    ELINK2_CR_XSEL | ELINK2_CR_EALO);
    330       1.1   thorpej 
    331       1.1   thorpej 	for (i = 0; i < ETHER_ADDR_LEN; i++)
    332       1.1   thorpej 		sc->sc_enaddr[i] = NIC_GET(nict, nich, i);
    333       1.1   thorpej 
    334       1.1   thorpej 	/*
    335       1.1   thorpej 	 * Unmap PROM - select NIC registers.  The proper setting of the
    336  1.12.2.1   nathanw 	 * transceiver is set in later in ec_init_card() via dp8390_init().
    337       1.1   thorpej 	 */
    338       1.1   thorpej 	bus_space_write_1(asict, asich, ELINK2_CR, ELINK2_CR_XSEL);
    339       1.1   thorpej 
    340       1.1   thorpej 	/* Determine if this is an 8-bit or 16-bit board. */
    341       1.1   thorpej 
    342       1.1   thorpej 	/* Select page 0 registers. */
    343       1.1   thorpej 	NIC_PUT(nict, nich, ED_P0_CR, ED_CR_RD2 | ED_CR_PAGE_0 | ED_CR_STP);
    344       1.1   thorpej 
    345       1.1   thorpej 	/*
    346       1.1   thorpej 	 * Attempt to clear WTS.  If it doesn't clear, then this is a
    347       1.1   thorpej 	 * 16-bit board.
    348       1.1   thorpej 	 */
    349       1.1   thorpej 	NIC_PUT(nict, nich, ED_P0_DCR, 0);
    350       1.1   thorpej 
    351       1.1   thorpej 	/* Select page 2 registers. */
    352       1.1   thorpej 	NIC_PUT(nict, nich, ED_P0_CR, ED_CR_RD2 | ED_CR_PAGE_2 | ED_CR_STP);
    353       1.1   thorpej 
    354       1.1   thorpej 	/* The 3c503 forces the WTS bit to a one if this is a 16-bit board. */
    355       1.1   thorpej 	if (NIC_GET(nict, nich, ED_P2_DCR) & ED_DCR_WTS)
    356       1.1   thorpej 		esc->sc_16bitp = 1;
    357       1.1   thorpej 	else
    358       1.1   thorpej 		esc->sc_16bitp = 0;
    359       1.1   thorpej 
    360       1.1   thorpej 	printf("%s: 3Com 3c503 Ethernet (%s-bit)\n",
    361       1.1   thorpej 	    sc->sc_dev.dv_xname, esc->sc_16bitp ? "16" : "8");
    362       1.1   thorpej 
    363       1.1   thorpej 	/* Select page 0 registers. */
    364       1.1   thorpej 	NIC_PUT(nict, nich, ED_P2_CR, ED_CR_RD2 | ED_CR_PAGE_0 | ED_CR_STP);
    365       1.1   thorpej 
    366       1.1   thorpej 	sc->cr_proto = ED_CR_RD2;
    367       1.1   thorpej 
    368       1.1   thorpej 	/*
    369       1.1   thorpej 	 * DCR gets:
    370       1.1   thorpej 	 *
    371       1.1   thorpej 	 *	FIFO threshold to 8, No auto-init Remote DMA,
    372       1.1   thorpej 	 *	byte order=80x86.
    373       1.1   thorpej 	 *
    374       1.1   thorpej 	 * 16-bit cards also get word-wide DMA transfers.
    375       1.1   thorpej 	 */
    376       1.1   thorpej 	sc->dcr_reg = ED_DCR_FT1 | ED_DCR_LS |
    377       1.1   thorpej 	    (esc->sc_16bitp ? ED_DCR_WTS : 0);
    378       1.1   thorpej 
    379       1.1   thorpej 	sc->test_mem = ec_fake_test_mem;
    380       1.1   thorpej 	sc->ring_copy = ec_ring_copy;
    381       1.1   thorpej 	sc->write_mbuf = ec_write_mbuf;
    382       1.1   thorpej 	sc->read_hdr = ec_read_hdr;
    383      1.10   thorpej 	sc->init_card = ec_init_card;
    384       1.1   thorpej 
    385      1.12   thorpej 	sc->sc_media_init = ec_media_init;
    386      1.12   thorpej 
    387       1.1   thorpej 	sc->sc_mediachange = ec_mediachange;
    388       1.1   thorpej 	sc->sc_mediastatus = ec_mediastatus;
    389       1.1   thorpej 
    390       1.1   thorpej 	sc->mem_start = 0;
    391       1.1   thorpej 	sc->mem_size = memsize;
    392       1.1   thorpej 
    393       1.1   thorpej 	/* Do generic parts of attach. */
    394      1.12   thorpej 	if (dp8390_config(sc)) {
    395       1.1   thorpej 		printf("%s: configuration failed\n", sc->sc_dev.dv_xname);
    396       1.1   thorpej 		return;
    397       1.1   thorpej 	}
    398       1.1   thorpej 
    399       1.1   thorpej 	/*
    400       1.1   thorpej 	 * We need to override the way dp8390_config() set up our
    401       1.1   thorpej 	 * shared memory.
    402       1.1   thorpej 	 *
    403       1.1   thorpej 	 * We have an entire 8k window to put the transmit buffers on the
    404       1.1   thorpej 	 * 16-bit boards.  But since the 16bit 3c503's shared memory is only
    405       1.1   thorpej 	 * fast enough to overlap the loading of one full-size packet, trying
    406       1.1   thorpej 	 * to load more than 2 buffers can actually leave the transmitter idle
    407       1.1   thorpej 	 * during the load.  So 2 seems the best value.  (Although a mix of
    408       1.1   thorpej 	 * variable-sized packets might change this assumption.  Nonetheless,
    409       1.1   thorpej 	 * we optimize for linear transfers of same-size packets.)
    410       1.1   thorpej 	 */
    411       1.1   thorpej 	if (esc->sc_16bitp) {
    412       1.1   thorpej 		if (sc->sc_dev.dv_cfdata->cf_flags & DP8390_NO_MULTI_BUFFERING)
    413       1.1   thorpej 			sc->txb_cnt = 1;
    414       1.1   thorpej 		else
    415       1.1   thorpej 			sc->txb_cnt = 2;
    416       1.1   thorpej 
    417       1.1   thorpej 		sc->tx_page_start = ELINK2_TX_PAGE_OFFSET_16BIT;
    418       1.1   thorpej 		sc->rec_page_start = ELINK2_RX_PAGE_OFFSET_16BIT;
    419       1.1   thorpej 		sc->rec_page_stop = (memsize >> ED_PAGE_SHIFT) +
    420       1.1   thorpej 		    sc->rec_page_start;
    421       1.1   thorpej 		sc->mem_ring = sc->mem_start;
    422       1.1   thorpej 	} else {
    423       1.1   thorpej 		sc->txb_cnt = 1;
    424       1.1   thorpej 		sc->tx_page_start = ELINK2_TX_PAGE_OFFSET_8BIT;
    425       1.1   thorpej 		sc->rec_page_start = sc->tx_page_start + ED_TXBUF_SIZE;
    426       1.1   thorpej 		sc->rec_page_stop = (memsize >> ED_PAGE_SHIFT) +
    427       1.1   thorpej 		    sc->tx_page_start;
    428       1.1   thorpej 		sc->mem_ring = sc->mem_start +
    429       1.1   thorpej 		    (ED_TXBUF_SIZE << ED_PAGE_SHIFT);
    430       1.1   thorpej 	}
    431       1.1   thorpej 
    432       1.1   thorpej 	/*
    433       1.1   thorpej 	 * Initialize CA page start/stop registers.  Probably only needed
    434       1.1   thorpej 	 * if doing DMA, but what the Hell.
    435       1.1   thorpej 	 */
    436       1.1   thorpej 	bus_space_write_1(asict, asich, ELINK2_PSTR, sc->rec_page_start);
    437       1.1   thorpej 	bus_space_write_1(asict, asich, ELINK2_PSPR, sc->rec_page_stop);
    438       1.1   thorpej 
    439       1.1   thorpej 	/*
    440       1.1   thorpej 	 * Program the IRQ.
    441       1.1   thorpej 	 */
    442       1.1   thorpej 	switch (ia->ia_irq) {
    443       1.1   thorpej 	case 9:	tmp = ELINK2_IDCFR_IRQ2; break;
    444       1.1   thorpej 	case 3:	tmp = ELINK2_IDCFR_IRQ3; break;
    445       1.1   thorpej 	case 4:	tmp = ELINK2_IDCFR_IRQ4; break;
    446       1.1   thorpej 	case 5:	tmp = ELINK2_IDCFR_IRQ5; break;
    447       1.1   thorpej 		break;
    448       1.1   thorpej 
    449       1.1   thorpej 	case IRQUNK:
    450       1.1   thorpej 		printf("%s: wildcarded IRQ is not allowed\n",
    451       1.1   thorpej 		    sc->sc_dev.dv_xname);
    452       1.1   thorpej 		return;
    453       1.1   thorpej 
    454       1.1   thorpej 	default:
    455       1.1   thorpej 		printf("%s: invalid IRQ %d, must be 3, 4, 5, or 9\n",
    456       1.1   thorpej 		    sc->sc_dev.dv_xname, ia->ia_irq);
    457       1.1   thorpej 		return;
    458       1.1   thorpej 	}
    459       1.1   thorpej 
    460       1.1   thorpej 	bus_space_write_1(asict, asich, ELINK2_IDCFR, tmp);
    461       1.1   thorpej 
    462       1.1   thorpej 	/*
    463       1.1   thorpej 	 * Initialize the GA configuration register.  Set bank and enable
    464       1.1   thorpej 	 * shared memory.
    465       1.1   thorpej 	 */
    466       1.1   thorpej 	bus_space_write_1(asict, asich, ELINK2_GACFR,
    467       1.1   thorpej 	    ELINK2_GACFR_RSEL | ELINK2_GACFR_MBS0);
    468       1.1   thorpej 
    469       1.1   thorpej 	/*
    470       1.1   thorpej 	 * Intialize "Vector Pointer" registers.  These gawd-awful things
    471       1.1   thorpej 	 * are compared to 20 bits of the address on the ISA, and if they
    472       1.1   thorpej 	 * match, the shared memory is disabled.  We se them to 0xffff0...
    473       1.1   thorpej 	 * allegedly the reset vector.
    474       1.1   thorpej 	 */
    475       1.1   thorpej 	bus_space_write_1(asict, asich, ELINK2_VPTR2, 0xff);
    476       1.1   thorpej 	bus_space_write_1(asict, asich, ELINK2_VPTR1, 0xff);
    477       1.1   thorpej 	bus_space_write_1(asict, asich, ELINK2_VPTR0, 0x00);
    478       1.1   thorpej 
    479       1.1   thorpej 	/*
    480       1.1   thorpej 	 * Now run the real memory test.
    481       1.1   thorpej 	 */
    482       1.1   thorpej 	if (ec_test_mem(sc)) {
    483       1.1   thorpej 		printf("%s: memory test failed\n", sc->sc_dev.dv_xname);
    484       1.1   thorpej 		return;
    485       1.1   thorpej 	}
    486       1.1   thorpej 
    487       1.1   thorpej 	/* Establish interrupt handler. */
    488       1.1   thorpej 	esc->sc_ih = isa_intr_establish(ia->ia_ic, ia->ia_irq, IST_EDGE,
    489       1.1   thorpej 	    IPL_NET, dp8390_intr, sc);
    490       1.1   thorpej 	if (esc->sc_ih == NULL)
    491       1.1   thorpej 		printf("%s: can't establish interrupt\n", sc->sc_dev.dv_xname);
    492       1.1   thorpej }
    493       1.1   thorpej 
    494       1.1   thorpej int
    495       1.1   thorpej ec_fake_test_mem(sc)
    496       1.1   thorpej 	struct dp8390_softc *sc;
    497       1.1   thorpej {
    498       1.1   thorpej 
    499       1.1   thorpej 	/*
    500       1.1   thorpej 	 * We have to do this after we initialize the GA, but we
    501       1.1   thorpej 	 * have to do that after calling dp8390_config(), which
    502       1.1   thorpej 	 * wants to test memory.  Put this noop here, and then
    503       1.1   thorpej 	 * actually test memory later.
    504       1.1   thorpej 	 */
    505       1.1   thorpej 	return (0);
    506       1.1   thorpej }
    507       1.1   thorpej 
    508       1.1   thorpej int
    509       1.1   thorpej ec_test_mem(sc)
    510       1.1   thorpej 	struct dp8390_softc *sc;
    511       1.1   thorpej {
    512       1.1   thorpej 	struct ec_softc *esc = (struct ec_softc *)sc;
    513       1.1   thorpej 	bus_space_tag_t memt = sc->sc_buft;
    514       1.1   thorpej 	bus_space_handle_t memh = sc->sc_bufh;
    515       1.1   thorpej 	bus_size_t memsize = sc->mem_size;
    516       1.1   thorpej 	int i;
    517       1.1   thorpej 
    518       1.1   thorpej 	if (esc->sc_16bitp)
    519       1.1   thorpej 		bus_space_set_region_2(memt, memh, 0, 0, memsize >> 1);
    520       1.1   thorpej 	else
    521       1.1   thorpej 		bus_space_set_region_1(memt, memh, 0, 0, memsize);
    522       1.1   thorpej 
    523       1.1   thorpej 	if (esc->sc_16bitp) {
    524       1.1   thorpej 		for (i = 0; i < memsize; i += 2) {
    525       1.1   thorpej 			if (bus_space_read_2(memt, memh, i) != 0)
    526       1.1   thorpej 				goto fail;
    527       1.1   thorpej 		}
    528       1.1   thorpej 	} else {
    529       1.1   thorpej 		for (i = 0; i < memsize; i++) {
    530       1.1   thorpej 			if (bus_space_read_1(memt, memh, i) != 0)
    531       1.1   thorpej 				goto fail;
    532       1.1   thorpej 		}
    533       1.1   thorpej 	}
    534       1.1   thorpej 
    535       1.1   thorpej 	return (0);
    536       1.1   thorpej 
    537       1.1   thorpej  fail:
    538       1.1   thorpej 	printf("%s: failed to clear shared memory at offset 0x%x\n",
    539       1.1   thorpej 	    sc->sc_dev.dv_xname, i);
    540       1.1   thorpej 	return (1);
    541       1.1   thorpej }
    542       1.1   thorpej 
    543       1.7   thorpej /*
    544       1.7   thorpej  * Given a NIC memory source address and a host memory destination address,
    545       1.7   thorpej  * copy 'len' from NIC to host using shared memory.  The 'len' is rounded
    546       1.7   thorpej  * up to a word - ok as long as mbufs are word-sized.
    547       1.7   thorpej  */
    548       1.1   thorpej __inline void
    549       1.1   thorpej ec_readmem(esc, from, to, len)
    550       1.1   thorpej 	struct ec_softc *esc;
    551       1.1   thorpej 	int from;
    552       1.1   thorpej 	u_int8_t *to;
    553       1.1   thorpej 	int len;
    554       1.1   thorpej {
    555       1.1   thorpej 	bus_space_tag_t memt = esc->sc_dp8390.sc_buft;
    556       1.1   thorpej 	bus_space_handle_t memh = esc->sc_dp8390.sc_bufh;
    557       1.1   thorpej 
    558       1.7   thorpej 	if (len & 1)
    559       1.7   thorpej 		++len;
    560       1.7   thorpej 
    561       1.7   thorpej 	if (esc->sc_16bitp)
    562       1.1   thorpej 		bus_space_read_region_2(memt, memh, from, (u_int16_t *)to,
    563       1.1   thorpej 		    len >> 1);
    564       1.7   thorpej 	else
    565       1.1   thorpej 		bus_space_read_region_1(memt, memh, from, to, len);
    566       1.1   thorpej }
    567       1.1   thorpej 
    568       1.1   thorpej int
    569       1.1   thorpej ec_write_mbuf(sc, m, buf)
    570       1.1   thorpej 	struct dp8390_softc *sc;
    571       1.1   thorpej 	struct mbuf *m;
    572       1.1   thorpej 	int buf;
    573       1.1   thorpej {
    574       1.1   thorpej 	struct ec_softc *esc = (struct ec_softc *)sc;
    575       1.1   thorpej 	bus_space_tag_t asict = esc->sc_asict;
    576       1.1   thorpej 	bus_space_handle_t asich = esc->sc_asich;
    577       1.7   thorpej 	bus_space_tag_t memt = esc->sc_dp8390.sc_buft;
    578       1.7   thorpej 	bus_space_handle_t memh = esc->sc_dp8390.sc_bufh;
    579       1.7   thorpej 	u_int8_t *data, savebyte[2];
    580       1.7   thorpej 	int savelen, len, leftover;
    581       1.7   thorpej #ifdef DIAGNOSTIC
    582       1.7   thorpej 	u_int8_t *lim;
    583       1.7   thorpej #endif
    584       1.1   thorpej 
    585       1.1   thorpej 	savelen = m->m_pkthdr.len;
    586       1.1   thorpej 
    587       1.1   thorpej 	/*
    588       1.7   thorpej 	 * 8-bit boards are simple: we're already in the correct
    589       1.7   thorpej 	 * page, and no alignment tricks are necessary.
    590       1.7   thorpej 	 */
    591       1.7   thorpej 	if (esc->sc_16bitp == 0) {
    592       1.7   thorpej 		for (; m != NULL; buf += m->m_len, m = m->m_next)
    593       1.7   thorpej 			bus_space_write_region_1(memt, memh, buf,
    594       1.7   thorpej 			    mtod(m, u_int8_t *), m->m_len);
    595       1.7   thorpej 		return (savelen);
    596       1.7   thorpej 	}
    597       1.7   thorpej 
    598       1.7   thorpej 	/*
    599       1.1   thorpej 	 * If it's a 16-bit board, we have transmit buffers
    600       1.1   thorpej 	 * in a different page; switch to it.
    601       1.1   thorpej 	 */
    602       1.1   thorpej 	if (esc->sc_16bitp)
    603       1.1   thorpej 		bus_space_write_1(asict, asich, ELINK2_GACFR,
    604       1.1   thorpej 		    ELINK2_GACFR_RSEL);
    605       1.1   thorpej 
    606       1.7   thorpej 	/* Start out with no leftover data. */
    607       1.7   thorpej 	leftover = 0;
    608       1.7   thorpej 	savebyte[0] = savebyte[1] = 0;
    609       1.7   thorpej 
    610       1.7   thorpej 	for (; m != NULL; m = m->m_next) {
    611       1.7   thorpej 		len = m->m_len;
    612       1.7   thorpej 		if (len == 0)
    613       1.7   thorpej 			continue;
    614       1.7   thorpej 		data = mtod(m, u_int8_t *);
    615       1.7   thorpej #ifdef DIAGNOSTIC
    616       1.7   thorpej 		lim = data + len;
    617       1.7   thorpej #endif
    618       1.7   thorpej 		while (len > 0) {
    619       1.7   thorpej 			if (leftover) {
    620       1.7   thorpej 				/*
    621       1.7   thorpej 				 * Data left over (from mbuf or realignment).
    622       1.7   thorpej 				 * Buffer the next byte, and write it and
    623       1.7   thorpej 				 * the leftover data out.
    624       1.7   thorpej 				 */
    625       1.7   thorpej 				savebyte[1] = *data++;
    626       1.7   thorpej 				len--;
    627       1.7   thorpej 				bus_space_write_2(memt, memh, buf,
    628       1.7   thorpej 				    *(u_int16_t *)savebyte);
    629       1.7   thorpej 				buf += 2;
    630       1.7   thorpej 				leftover = 0;
    631      1.11  drochner 			} else if (BUS_SPACE_ALIGNED_POINTER(data, u_int16_t)
    632      1.11  drochner 				   == 0) {
    633       1.7   thorpej 				/*
    634       1.7   thorpej 				 * Unaligned data; buffer the next byte.
    635       1.7   thorpej 				 */
    636       1.7   thorpej 				savebyte[0] = *data++;
    637       1.7   thorpej 				len--;
    638       1.7   thorpej 				leftover = 1;
    639       1.7   thorpej 			} else {
    640       1.7   thorpej 				/*
    641       1.7   thorpej 				 * Aligned data; output contiguous words as
    642       1.7   thorpej 				 * much as we can, then buffer the remaining
    643       1.7   thorpej 				 * byte, if any.
    644       1.7   thorpej 				 */
    645       1.7   thorpej 				leftover = len & 1;
    646       1.7   thorpej 				len &= ~1;
    647       1.7   thorpej 				bus_space_write_region_2(memt, memh, buf,
    648       1.7   thorpej 				    (u_int16_t *)data, len >> 1);
    649       1.7   thorpej 				data += len;
    650       1.7   thorpej 				buf += len;
    651       1.7   thorpej 				if (leftover)
    652       1.7   thorpej 					savebyte[0] = *data++;
    653       1.7   thorpej 				len = 0;
    654       1.7   thorpej 			}
    655       1.7   thorpej 		}
    656       1.7   thorpej 		if (len < 0)
    657       1.7   thorpej 			panic("ec_write_mbuf: negative len");
    658       1.7   thorpej #ifdef DIAGNOSTIC
    659       1.7   thorpej 		if (data != lim)
    660       1.7   thorpej 			panic("ec_write_mbuf: data != lim");
    661       1.7   thorpej #endif
    662       1.7   thorpej 	}
    663       1.7   thorpej 	if (leftover) {
    664       1.7   thorpej 		savebyte[1] = 0;
    665       1.7   thorpej 		bus_space_write_2(memt, memh, buf, *(u_int16_t *)savebyte);
    666       1.7   thorpej 	}
    667       1.1   thorpej 
    668       1.1   thorpej 	/*
    669       1.1   thorpej 	 * Switch back to receive page.
    670       1.1   thorpej 	 */
    671       1.1   thorpej 	if (esc->sc_16bitp)
    672       1.1   thorpej 		bus_space_write_1(asict, asich, ELINK2_GACFR,
    673       1.1   thorpej 		    ELINK2_GACFR_RSEL | ELINK2_GACFR_MBS0);
    674       1.1   thorpej 
    675       1.1   thorpej 	return (savelen);
    676       1.1   thorpej }
    677       1.1   thorpej 
    678       1.1   thorpej int
    679       1.1   thorpej ec_ring_copy(sc, src, dst, amount)
    680       1.1   thorpej 	struct dp8390_softc *sc;
    681       1.1   thorpej 	int src;
    682       1.1   thorpej 	caddr_t dst;
    683       1.1   thorpej 	u_short amount;
    684       1.1   thorpej {
    685       1.1   thorpej 	struct ec_softc *esc = (struct ec_softc *)sc;
    686       1.1   thorpej 	u_short tmp_amount;
    687       1.1   thorpej 
    688       1.1   thorpej 	/* Does copy wrap to lower addr in ring buffer? */
    689       1.1   thorpej 	if (src + amount > sc->mem_end) {
    690       1.1   thorpej 		tmp_amount = sc->mem_end - src;
    691       1.1   thorpej 
    692       1.1   thorpej 		/* Copy amount up to end of NIC memory. */
    693       1.1   thorpej 		ec_readmem(esc, src, dst, tmp_amount);
    694       1.1   thorpej 
    695       1.1   thorpej 		amount -= tmp_amount;
    696       1.1   thorpej 		src = sc->mem_ring;
    697       1.1   thorpej 		dst += tmp_amount;
    698       1.1   thorpej 	}
    699       1.1   thorpej 
    700       1.1   thorpej 	ec_readmem(esc, src, dst, amount);
    701       1.1   thorpej 
    702       1.1   thorpej 	return (src + amount);
    703       1.1   thorpej }
    704       1.1   thorpej 
    705       1.1   thorpej void
    706       1.1   thorpej ec_read_hdr(sc, packet_ptr, packet_hdrp)
    707       1.1   thorpej 	struct dp8390_softc *sc;
    708       1.1   thorpej 	int packet_ptr;
    709       1.1   thorpej 	struct dp8390_ring *packet_hdrp;
    710       1.1   thorpej {
    711       1.1   thorpej 	struct ec_softc *esc = (struct ec_softc *)sc;
    712       1.1   thorpej 
    713       1.1   thorpej 	ec_readmem(esc, packet_ptr, (u_int8_t *)packet_hdrp,
    714       1.1   thorpej 	    sizeof(struct dp8390_ring));
    715       1.4   thorpej #if BYTE_ORDER == BIG_ENDIAN
    716       1.4   thorpej 	packet_hdrp->count = bswap16(packet_hdrp->count);
    717       1.4   thorpej #endif
    718      1.12   thorpej }
    719      1.12   thorpej 
    720      1.12   thorpej void
    721      1.12   thorpej ec_media_init(struct dp8390_softc *sc)
    722      1.12   thorpej {
    723      1.12   thorpej 
    724      1.12   thorpej 	ifmedia_init(&sc->sc_media, 0, dp8390_mediachange, dp8390_mediastatus);
    725      1.12   thorpej 	ifmedia_add(&sc->sc_media, IFM_ETHER|IFM_10_2, 0, NULL);
    726      1.12   thorpej 	ifmedia_add(&sc->sc_media, IFM_ETHER|IFM_10_5, 0, NULL);
    727      1.12   thorpej 	ifmedia_set(&sc->sc_media, IFM_ETHER|IFM_10_2);
    728       1.1   thorpej }
    729       1.1   thorpej 
    730       1.1   thorpej int
    731       1.1   thorpej ec_mediachange(sc)
    732       1.1   thorpej 	struct dp8390_softc *sc;
    733       1.1   thorpej {
    734       1.1   thorpej 	struct ec_softc *esc = (struct ec_softc *)sc;
    735       1.1   thorpej 	struct ifmedia *ifm = &sc->sc_media;
    736       1.1   thorpej 
    737       1.1   thorpej 	return (ec_set_media(esc, ifm->ifm_media));
    738       1.1   thorpej }
    739       1.1   thorpej 
    740       1.1   thorpej void
    741       1.1   thorpej ec_mediastatus(sc, ifmr)
    742       1.1   thorpej 	struct dp8390_softc *sc;
    743       1.1   thorpej 	struct ifmediareq *ifmr;
    744       1.1   thorpej {
    745       1.1   thorpej 	struct ifmedia *ifm = &sc->sc_media;
    746       1.1   thorpej 
    747       1.1   thorpej 	/*
    748       1.1   thorpej 	 * The currently selected media is always the active media.
    749       1.1   thorpej 	 */
    750       1.1   thorpej 	ifmr->ifm_active = ifm->ifm_cur->ifm_media;
    751       1.1   thorpej }
    752       1.1   thorpej 
    753       1.1   thorpej void
    754       1.1   thorpej ec_init_card(sc)
    755       1.1   thorpej 	struct dp8390_softc *sc;
    756       1.1   thorpej {
    757       1.1   thorpej 	struct ec_softc *esc = (struct ec_softc *)sc;
    758       1.1   thorpej 	struct ifmedia *ifm = &sc->sc_media;
    759       1.1   thorpej 
    760       1.1   thorpej 	(void) ec_set_media(esc, ifm->ifm_cur->ifm_media);
    761       1.1   thorpej }
    762       1.1   thorpej 
    763       1.1   thorpej int
    764       1.1   thorpej ec_set_media(esc, media)
    765       1.1   thorpej 	struct ec_softc *esc;
    766       1.1   thorpej 	int media;
    767       1.1   thorpej {
    768       1.1   thorpej 	u_int8_t new;
    769       1.1   thorpej 
    770       1.1   thorpej 	if (IFM_TYPE(media) != IFM_ETHER)
    771       1.1   thorpej 		return (EINVAL);
    772       1.1   thorpej 
    773       1.1   thorpej 	switch (IFM_SUBTYPE(media)) {
    774       1.1   thorpej 	case IFM_10_2:
    775       1.1   thorpej 		new = ELINK2_CR_XSEL;
    776       1.1   thorpej 		break;
    777       1.1   thorpej 
    778       1.1   thorpej 	case IFM_10_5:
    779       1.1   thorpej 		new = 0;
    780       1.1   thorpej 		break;
    781       1.1   thorpej 
    782       1.1   thorpej 	default:
    783       1.1   thorpej 		return (EINVAL);
    784       1.1   thorpej 	}
    785       1.1   thorpej 
    786       1.1   thorpej 	bus_space_write_1(esc->sc_asict, esc->sc_asich, ELINK2_CR, new);
    787       1.1   thorpej 	return (0);
    788       1.1   thorpej }
    789