target.nr

鼎鼎大名的WRS提供的VxWorks下pcPentium BSP开发包

'\" t
.so wrs.an
.\" pc/target.nr - PC386/486/Pentium/PentiumPro target-specific documentation
.\"
.\" Copyright 1984-1999 Wind River Systems, Inc.
.\"
.\" modification history
.\" --------------------
.\" 02b,12mar99,cn   added el3c90xEnd driver comment.
.\" 02a,11mar99,sbs  added ne2000End driver comment.
.\" 01z,11mar99,sbs  added ultraEnd driver comment.
.\" 01y,24feb99,hdn  added comment for Pentium/PentiumPro's data cache mode.
.\" 01x,01feb99,jkf  added 3com and AMD SENS support comment.
.\" 01w,26jan99,jkf  added INCLUDE_ADD_BOOTMEM information. (SPR#21338)
.\" 01v,04jun98,hdn  added PentiumPro's APIC support
.\" 01u,12may98,hdn  added Pentium/PentiumPro support
.\" 01t,01may98,yp   added TrueFFS support
.\" 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/PENTIUM/PENTIUMPRO"

.SH "INTRODUCTION"
This manual entry provides board-specific information 
necessary to run VxWorks for the pc386, pc486, pcPentium and
pcPentiumpro 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, pc486, pcPentium and pcPentiumpro 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 "TrueFFS support"
This BSP supports the optional product TrueFFS for Tornado. To use TrueFFS
install the product, add sysTffs.o to MACH_EXTRA in the Makefile and define
INCLUDE_TFFS or INCLUDE_PCMCIA in config.h.

Defining INCLUDE_PCMCIA assumes that TrueFFS support is needed.

TrueFFS is set up to use the M-Systems DiskOnChip 2000 and two PCMCIA
slots as a drive for use with dosFs.

If you wish to reboot from the DiskOnChip device change the finition for
SYS_WARM_TYPE in config.h from SYS_WARM_FD to SYS_WARM_TFFS.

.SS "BOOT ROMS"
The PC-AT 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. 

For TrueFFS disks that appear as a hard disk using BIOS extentions 
the boot utility is "mkbootTffs".

The usage of the three 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                   */
    )

STATUS mkbootTffs
    (
    int drive,       /* drive number: (0 - TFFS_MAX_DRIVES - 1) */
    int removable,   /* removable or not: (TRUE - FALSE)      */
    char *in         /* name of file to read: "bootrom_uncmp" */
    )
.CE
All 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
Example 3: Creating a bootable TrueFFS disk using mkbootTffs:

The TrueFFS disk is drive 0 (or c:), that is a non removable drive.
The image file name is `bootrom_uncmp':
.CS
    -> mkbootTffs 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."

The config.h macro INCLUDE_ADD_BOOTMEM is used to memAddToPool some upper 
memory to a x86 low memory rom image.  VxWorks low memory rom images 
run within a memory range from 0x8000 to 0xa0000.  This restricts the 
size of the bootrom kernels memory pool available to drivers.  This 
macro is used to make upper memory (above 1MB) available to drivers
for the bootrom image only. It is defined in config.h and used in 
sysLib.c, sysHwInit2().   It should be un-defined for x86 systems with 
memory less than 4MB.  The default value is 0x00200000 (2MB).  This 
value may be increased, but beware that the added pool does not 
overlap with the downloaded vxWorks image.  If there is an overlap, 
then loading the vxWorks runtime image will corrupt the added 
memory pool.
 
To calculate the safe amount:
 
.CS
 (RAM_LOW_ADRS + vxWorks image size) < (memTopPhys + ADDED_BOOTMEM_SIZE)
.CE
 
Where: RAM_LOW_ADRS == 0x00108000 and memTopPhys is from sysLib.c.


.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
loApicTimer.c	Intel PentiumPro's Local APIC Timer driver
i8259Intr.c	Intel 8259 PIC
loApicIntr.c	Intel PentiumPro's Local APIC
ioApicIntr.c	Intel PentiumPro's IO APIC
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
fei82557End.o   EtherExpress PRO100B END/SENS driver
ln97xEnd.o      AMD Am79C97X PCnet-FAST PCI END/SENS driver
elt3c509End.o   3COM 3C509 END/SENS driver
el3c90xEnd.o    3COM 3C90x END/SENS driver
ultraEnd.o      SMC Elite Ultra END driver
if_ene.o	Novell/Eagle 2000 END 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"
A device driver for the  AHA-2940 PCI SCSI Adapter card is provided. This card
houses the AIC-7880 Adaptec SCSI Host Adapter. The macros, INCLUDE_SCSI 
and INCLUDE_SCSI2, must be defined in config.h in order to configure SCSI-2. 
This is a PCI card and INCLUDE_PCI must also be defined in config.h.

The SCSI-2 driver for x86 requires the AHA-2940 PCI SCSI Adapter card. The 
user is expected to follow instructions on the "Adaptec 7800 Family Manager 
Set User's Guide" regarding installation procedures.