tc(4) [netbsd man page]

TC(4)							   BSD Kernel Interfaces Manual 						     TC(4)

NAME

     tc -- TURBOchannel expansion bus driver

SYNOPSIS

   alpha
     tc* at tcasic?

   pmax
     tc* at mainbus0

DESCRIPTION

     The tc driver provides machine-independent support for the DEC TURBOchannel expansion bus found on all DEC 5000-series machines with MIPS and
     DEC 3000-series with Alpha processors.

     Your system may support additional TURBOchannel devices.  Drivers for TURBOchannel devices not listed here are machine-dependent.	Consult
     your system's intro(4) for additional information.

HARDWARE

     NetBSD includes machine-independent TURBOchannel drivers, sorted by device type and driver name:

   SCSI interfaces
	   asc	      PMAZ-A single-channel SCSI adapter

	   tcds       PMAZ-DS, PMAZ-FS, PMAZB-AA and PMAZC-AA dual-channel SCSI adapters

   Network interfaces
	   fta	      PMAF-F DEFTA FDDI controller

	   le	      LANCE Ethernet interface

   Frame buffers
	   cfb	      PMAG-B CX colour unaccelerated 2-D framebuffer

	   mfb	      PMAG-A MX monochrome framebuffer

	   px	      PMAG-C PX accelerated graphics boards

	   pxg	      PMAG-D, PMAG-E and PMAG-F PXG accelerated graphics boards

	   sfb	      PMAGB-BA HX colour unaccelerated 2-D framebuffer

	   tfb	      PMAG-J TX 24-bit colour unaccelerated 2-D framebuffer

   Miscellaneous
	   ioasic     baseboard IO control ASIC for DEC TURBOchannel systems

SEE ALSO

     asc(4), cfb(4), fta(4), intro(4), ioasic(4), le(4), mfb(4), px(4), pxg(4), sfb(4), tcds(4), tfb(4)

HISTORY

     The tc driver first appeared in NetBSD 1.1.

BUGS

     The tc driver makes poor use of interrupt priority on the 5000/1xx series systems.

BSD
								September 12, 2001							       BSD

TC(9)							   BSD Kernel Developer's Manual						     TC(9)

NAME

     TC, tc_intr_establish, tc_intr_disestablish, tc_intr_evcnt.  tc_mb, tc_wmb, tc_syncbus, tc_badaddr, TC_DENSE_TO_SPARSE, TC_PHYS_TO_UNCACHED
     -- TURBOchannel bus

SYNOPSIS

     #include <sys/bus.h>
     #include <dev/tc/tcvar.h>
     #include <dev/tc/tcdevs.h>

     void
     tc_intr_establish(struct device *dev, void *cookie, int level, int (*handler)(void *), void *arg);

     void
     tc_intr_disestablish(struct device *dev, void *cookie);

     const struct evcnt *
     tc_intr_evcnt(struct device *dev, void *cookie);

     void
     tc_mb();

     void
     tc_wmb();

     void
     tc_syncbus();

     int
     tc_badaddr(tc_addr_t tcaddr);

     tc_addr_t
     TC_DENSE_TO_SPARSE(tc_addr_t addr);

     tc_addr_t
     TC_PHYS_TO_UNCACHED(tc_addr_t addr);

DESCRIPTION

     The TC device provides support for the DEC TURBOchannel bus found on all DEC TURBOchannel machines with MIPS (DECstation 5000 series, exclud-
     ing the 5000/200) and Alpha (3000-series) systems.  TURBOchannel is a 32-bit wide synchronous DMA-capable bus, running at 25 MHz on higher-
     end machines and at 12.5 MHz on lower-end machines.

DATA TYPES

     Drivers for devices attached to the TURBOchannel bus will make use of the following data types:

     struct tc_attach_args
	      A structure use to inform the driver of TURBOchannel bus properties.  It contains the following members:

		      bus_space_tag_t ta_memt;
		      bus_dma_tag_t   ta_dmat;
		      char	      ta_modname[TC_ROM_LLEN+1];
		      u_int	      ta_slot;
		      tc_offset_t     ta_offset;
		      tc_addr_t       ta_addr;
		      void	      *ta_cookie;
		      u_int	      ta_busspeed;

	      The ta_busspeed member specifies the TURBOchannel bus speed and is useful for time-related functions.  Values values are
	      TC_SPEED_12_5_MHZ for the 12.5 MHz bus and TC_SPEED_25_MHZ for the 50 MHz bus.

FUNCTIONS

     tc_intr_establish(dev, cookie, level, handler, arg)
	      Establish an interrupt handler with device dev for the interrupt described completely by cookie, the value passed to the driver in
	      the ta_cookie member of the tc_attach_args structure.  The priority of the interrupt is specified by level.  When the interrupt
	      occurs the function handler is called with argument arg.

     tc_intr_disestablish(dev, cookie)
	      Dis-establish the interrupt handler with device dev for the interrupt described completely cookie.

     tc_intr_evcnt(dev, cookie)
	      Do interrupt event counting with device dev for the event described completely by cookie.

     tc_mb()  A read/write memory barrier.  Any CPU-to-memory reads/writes before the barrier must complete before any CPU-to-memory reads/writes
	      after it.

     tc_wmb()
	      A write memory barrier.  Any CPU-to-memory writes before the barrier must complete before any CPU-to-memory writes after it.

     tc_syncbus()
	      Synchronise writes on the TURBOchannel bus by ensuring CPU writes are propagated across the TURBOchannel bus.

     tc_badaddr(tcaddr)
	      Returns non-zero if the given address tcaddr is invalid.

     TC_DENSE_TO_SPARSE(addr)
	      Convert the given physical address addr in TURBOchannel dense space to the corresponding address in TURBOchannel sparse space.

     TC_PHYS_TO_UNCACHED(addr)
	      Convert the given system memory physical address addr to the physical address of the corresponding region that is not cached.

AUTOCONFIGURATION

     The TURBOchannel bus is a direct-connection bus.  During autoconfiguration, the parent specifies the name of the found TURBOchannel module
     into the ta_modname member of the tc_attach_args structure.  Drivers should match on this name.

DMA SUPPORT

     The TURBOchannel bus supports 32-bit, bidirectional DMA transfers.  Support is provided by the standard bus_dma(9) interface.

CODE REFERENCES

     The TURBOchannel subsystem itself is implemented within the file sys/dev/tc/tc_subr.c.  Machine-dependent portions can be found in
     sys/arch/<arch>/tc/tcbus.c.

SEE ALSO

     tc(4), autoconf(9), bus_dma(9), bus_space(9), driver(9)

BSD
								  October 7, 2001							       BSD