target.nr

VxWorks 5.4嵌入式操作系统, Tornado II开发平台BSP包的移植

'\" t
.so wrs.an
.\" pc/target.nr - PC386/486 target-specific documentation
.\"
.\" Copyright 1984-1998 Wind River Systems, Inc.
.\"
.\" modification history
.\" --------------------
.\" 01s,23mar98,ms-  rewritten to conform with guidlines in BSP developers kit
.\" 01r,12mar98,sbs  changed info on use of SCSI-2 driver.
.\" 01q,20nov97,map  mention no support for ISA PnP. [SPR# 9877]
.\" 01p,10jul97,dds  added info on use of the SCSI-2 driver for the AHA 2940
.\"                  PCI SCSI Adapter card.
.\" 01o,25feb97,mas  added info on use of mkboot/mkbootFd and reboot device
.\"		     selection using sysWarmType as well as info on the mapping
.\"		     of IRQ numbers to IRQ levels (SPR 7850).
.\" 01n,22nov96,dat  doc cleanup, added EtherExpress PRO100B support.
.\" 01m,01nov96,hdn  added support for PCMCIA.
.\" 01l,09sep96,hdn  added support for compression.
.\" 01k,26jul96,hdn  added support for ATA and SMC91c9x driver.
.\" 01j,19jun96,wlf  doc: cleanup.
.\" 01i,23oct95,jdi  doc: updated for Tornado
.\" 01h,28sep95,hdn  cleaned up.
.\" 01g,03aug95,myz  upgraded to 5.3 
.\" 01f,06jun94,hdn  added changes by Roland for 5.1.1 FCS.
.\" 01e,13may94,hdn  updated to 5.1.1 FCS.
.\" 01d,01dec93,hdn  cleaned up.
.\" 01c,09nov93,vin  upgraded to 5.1
.\" 01b,26mar93,hdn  added a description about boot rom image.
.\" 01a,12jan93,hdn  written.
.\"
.\" NOTE
.\" EXOS
.\"
.TH "pc386/486" T "PC 386/486" "Rev: 25 Mar 98" "TORNADO REFERENCE: VXWORKS"

.SH "NAME"
.aX "PC 386/486"

.SH "INTRODUCTION"
This manual entry provides board-specific information 
necessary to run VxWorks for the pc386 and pc486 BSPs. 
Before using a board with VxWorks, verify that the board 
runs in the factory configuration by using vendor-supplied 
ROMs and jumper settings and checking the RS-232 connection.

Please note that the pc386 and pc486 BSPs are generic BSPs
for generic PC-AT style motherboards. For best results, the 
board vendor's documentation should be used in conjunction 
with this document.

.SS "BOOT ROMS"
The PC386 and PC486 generic boards use a boot diskette instead of boot ROMs. 
The boot diskette includes the boot sector (sector 0) and a DOS file system
containing a boot ROM image named `bootrom.sys'.
The boot ROM image could be one of following:

.TS E
expand;
c	c	c	c
c	c	c	c
l	l	l	l.
		Image is	Image Loads
Image Name	Description	Compressed	Into
=
vxWorks_rom	bootable vxWorks	No	High Memory
vxWorks_rom_low	bootable vxWorks	No	Low Memory
vxWorks.st_rom	bootable vxWorks.st	Yes	High Memory
bootrom	bootrom	Yes	Low Memory
bootrom_uncmp	bootrom	No	Low Memory
bootrom_high	bootrom	Yes	High Memory
_
.TE
VxWorks.st is a fully linked stand alone image which 
includes a target based shell, symbol table, and network 
interface. Note that the network interface is not initialized.

The boot ROM image must be copied into the floppy disk (a:) or 
the IDE disk (c:) using the DOS boot utility "mkboot.bat" or the 
VxWorks boot utilities "mkbootFd" for floppy disks or 
"mkbootAta" for hard disks.

The usage of the two VxWorks boot utilities is as follows:
.ne 15
.CS
STATUS mkbootFd
    (
    int drive,    /* destination drive number: (0 - 3)  */
    int fdType,   /* type of floppy disk: (0 - 1)       */
    char *in      /* source file name                   */
    )

STATUS mkbootAta 
    (
    int ctrl,     /* dest. controller number: (0 - 1)   */
    int drive,    /* dest. drive number: (0 - 1)        */
    char *in      /* source file name                   */
    )
.CE
Both routines return OK on success and ERROR if there is an error while
copying the image from the source onto the disk.

EXAMPLES:

Example 1: Creating a boot floppy disk using mkbootFd:

The floppy disk is in drive 0 (or a:), the diskette is of type 0,
and the image file name is `bootrom_uncmp':
.CS
    -> mkbootFd 0, 0, "bootrom_uncmp"
.CE
Example 2: Creating a bootable hard disk using mkbootFd:

The hard disk is on ATA controller 0 and is drive number 0
(or c:). The image file name is `bootrom_uncmp':
.CS
    -> mkbootAta 0, 0, "bootrom_uncmp"
.CE
These boards do not have non-volatile RAM; thus, boot parameters are not
preserved whenever the system is powered off.  However, static boot
parameters can be set in the boot disk by setting the boot parameter line
DEFAULT_BOOT_LINE in config.h.

For information on the use of the DOS utility "mkboot.bat" and how to boot VxWorks,
please refer to the
.I "VxWorks Programmer's Guide, Appendix D: Intel i386/i486."

To load VxWorks, and for more information, follow the instructions in the
.I "Tornado User's Guide: Getting Started."

.SS "Jumpers"
Refer to the board vendor's documentation.

.SH "FEATURES"
Since this is a generic BSP for generic PC-AT style motherboards,
your board may or may not have all of these features, and your
board may have some features not discussed here.
Your board vendor's documentation should be used in conjunction 
with this section.

.SS "Supported Features"
Supported features are discussed below in the "Devices" section
under the "HARDWARE DETAILS" heading.

.SS "Unsupported Features"

This BSP does not support ISA PnP. Such devices can be supported if
PnP is disabled and the device parameters (IO address, Memory address,
IRQ, DMA channel etc) are set to match those in the
BSP driver configuration. If
the device uses soft-configuration instead of jumpers, an appropriate
utility program, usually available from the device manufacturer,
should be used to set the device parameters.

.SS "Feature Interactions"
Refer to the board vendor's documentation.

.SH "HARDWARE DETAILS"
This section documents the details of the device drivers and board
hardware elements.

.SS "Devices"
Drivers included with this BSP are for both on-board chips
and for separate adaptor cards that can be used with the
motherboard.
Refer to the vendor's documentation for both the motherboard and
any adaptor cards used. Vendor documentation for on-board
chips may be necessary also.

Note that for all ISA drivers, the I/O base address,
memory address, and interrupt level must match those in config.h
or pc.h.

In the table below, drivers ending in the .c extension are
delivered in source form; the other drivers are delivered
in object form only.
    
.TS
center;
l l.
i8250Sio.c	Intel UART tty driver
i8237Dma.c	8237 DMA driver
pcConsole.c	console driver
i8042Kbd.c	Intel keyboard controller
i8048Kbd.c	Intel keyboard controller
m6845Vga.c	Motorola M6845 VGA controller
nec765Fd.o	nec765 floppy disk controller
ataDrv.o	IDE/ATA hard disk controller
ataShow.o	IDE/ATA hard disk controller show routines
aic7880Lib.o	AHA-2940 PCI SCSI Adapter card
i8253Timer.c	Intel 8253 timer driver
i8259Pic.c	Intel 8259 PIC
nullNvRam.c	null NVRAM library
nullVme.c	null VMEbus library
pcmciaLib.o	PCMCIA driver
pcmciaShow.o	PCMCIA driver show routine
if_ultra.o	SMC Elite16 network interface driver
if_eex.o	Intel EtherExpress16 network interface driver
if_elt.o	3Com EtherLinkIII network interface driver
if_ene.o	Novell/Eagle 2000 network interface driver
if_esmc.o	Ampro Ethernet2(SMC 91c9x chip) network interface driver
if_fei.o	EtherExpress PRO100B network interface driver
.TE

Below are some brief notes on each driver.
For more details refer to the
entry for each driver in the Libraries section of the 
.I "VxWorks Reference Manual"

.IP "i8250Sio"
Intel 8250 Universal Asynchronous 
Receiver Transmitter (UART) tty driver.
Used for the serial ports
.IP "i8237Dma"
Driver for the ISA DMA controller.
This is used in nec765Fd.c, which also
serves as a good application example.
.IP "pcConsole, i8042Kbd and i8048Kbd"
Driver for the on-board Intel 8042 and 8048 keyboard controllers
To use these controllers
the INCLUDE_PC_CONSOLE directive must be enabled in config.h.  
The macro
PC_KBD_TYPE should be defined in config.h as PC_PS2_101_KBD to include
i8042Kbd.c, and as PC_XT_83_KBD to include i8048Kbd.c.
.IP "m6845Vga"
Driver for the Motorola M6845 VGA controller.
To use this controller, define INCLUDE_PC_CONSOLE in config.h.
.IP "nec765Fd:
Driver for the nec765 floppy disk controller.
To use this driver, the INCLUDE_FD directive must be enabled in
config.h.
.IP "ataDrv and ataShow"
Driver for the IDE/ATA hard disk controller.  
To use this driver, the INCLUDE_ATA directive must be enabled in config.h. 
Note that the old INCLUDE_IDE directive is replaced by INCLUDE_ATA,
and that vxsys() is replaced by mkbootFd() and mkbootAta().
.IP "aic7880Lib"
Driver for the AHA-2940 PCI SCSI Adapter card. This card
uses the AIC-7880 Adaptec SCSI Host Adapter. 
To use this driver, the 
INCLUDE_AIC_7880, INCLUDE_SCSI, INCLUDE_SCSI2, and INCLUDE_PCI 
directives must be enabled in config.h. 
.IP
For information regarding installing the AHA-2940
see the "Adaptec 7800 Family Manager Set User's Guide".
.IP "i8253Timer"
This library contains routines to manipulate the timer functions on the
Intel 8253 chip with a board-independent interface.  This library handles
both the system clock and the auxiliary clock functions.
.IP
The macros SYS_CLK_RATE_MIN, SYS_CLK_RATE_MAX, AUX_CLK_RATE_MIN, and
AUX_CLK_RATE_MAX must be defined to provide parameter checking for the
sys[Aux]ClkRateSet() routines.
.IP
The macro PIT_CLOCK must also be defined to indicate the clock frequency
of the i8253.
.IP
The system clock is the programmable interrupt timer.
The auxiliary clock is the real time clock.
.IP
This driver includes a timestamp driver; to use this
feature, the macro INCLUDE_TIMESTAMP must be defined in config.h.
.IP "i8259Pic"
Driver for the Intel 8259A Programmable Interrupt Controller (PIC).
.IP "nullNvRam"
This library contains dummy non-volatile RAM manipulation routines for targets
lacking non-volatile RAM.  Read and write routines that return ERROR
are included.

The macro NV_RAM_SIZE should be defined as NONE for targets lacking
non-volatile RAM.
.IP "nullVme"
This library contains null routines for boards which do not include any
common bus routines.
.IP "pcmciaLib and pcmciaShow"
Drivers for PCMCIA. In order to use any PCMCIA card 
the INCLUDE_PCMCIA directive
must be enabled in config.h. These drivers currently
support three cards. To use an ATA PC card, enable
INCLUDE_ATA; to use an SRAM PC card, enable INCLUDE_SRAM;
to use a 3COM Etherlink III PC card, enable INCLUDE_ELT.
By default, all three cards are enabled when INCLUDE_PCMCIA is enabled.
.IP "if_ultra"
Driver for the SMC Elite16 (Western Digital 8013WC) 
and SMC Elite 16 Ultra network cards.
To use these controllers the INCLUDE_ULTRA 
directive must be enabled in config.h.  
The following jumper configurations
are supported:

.ne 10
.TS
center;
cf3 s cf3 s
lf3 lf3 lf3 lf3
c s c s
a a4 a a .
SMC Elite 16	SMC Elite16 Ultra
.sp .25
Jumper	Setting	Jumper	Setting
\_	\_
W1	SOFT (I/O addr 0x240)	W1	SOFT (I/O addr 0x240)
W2	NONE/SOFT	-	NO ROM
-	NO ROM
.TE

IRQ levels 2,3,5,7,10,11,15 are supported.
.IP "if_eex"
Driver for the Intel EtherExpress16 network card.  
To use this board the INCLUDE_EEX 
directive must be enabled in config.h.  
This board is soft-configured with no jumpers.
.IP "if_elt"
Driver for the 3Com EtherLinkIII network card.
To use this board the INCLUDE_ELT
directive must be enabled in config.h.  
This board is 
soft-configured with no jumpers.
PnP must be disabled in the soft configuration for this card
to work with vxWorks.
.IP "if_ene"
Driver for several compatible versions of the 
Novell/Eagle 2000.
To use one of these board the INCLUDE_ENE
directive must be enabled in config.h.  
The I/O base address, 
memory address, and interrupt level must match those in config.h.
.IP "if_esmc"
Driver for the
Ampro Ethernet2(SMC 91c9x chip) network card.
To use this board the INCLUDE_ESMC
directive must be enabled in config.h.  
This board is soft configured.
The I/O base address and interrupt level must match those in config.h.
.IP "if_fei"
Generic driver for the
Intel 82557 Ethernet network interface chip.
An example of a board using this chip is 
the EtherExpress PRO100B. 
To use this driver the INCLUDE_FEI
directive must be enabled in config.h.
If defined FEI_10MB indicates
the unit should operate at ethernet speed of 10 megabits per second.

.SS "Memory Maps"
.TS
center allbox;
c c c
l l l.
Start Address	Size	Use
LOCAL_MEM_LOCAL_ADRS	0xa0000	lower memory