target.nr

vxworks bsp for pc pentium3 开发环境为tornado2.2 for pentium。

'\" t
.so wrs.an
.\" pc/target.nr - Pentium/2/3/4 target-specific documentation
.\"
.\" Copyright 1984-2002 Wind River Systems, Inc.
.\"
.\" modification history
.\" --------------------
.\" 01a,18jul02,tfr  Minor doc fixes
.\" 01a,12jul02,pai  add commentary on changes to the default BSP memory map
.\" 02p,28jun02,hdn  added bootrom images built by Project (spr 71289)
.\" 02o,18jun02,hdn  added a description of the new reboot mechanism
.\" 02n,14jun02,hdn  updated the "Enhanced MMU" section
.\" 02m,20may02,rhe  Update build instructions to use .bin files
.\" 02l,07may02,pai  Removed documentation on deprecated and / or unsupported
.\"                  VxWorks and bootrom images.
.\" 02k,28apr02,hdn  added comment for newly supported PIC modes (spr 76411)
.\" 02j,24apr02,pai  Removed comments on USR_ENTRY as a result of the fix for
.\"                  (SPR 73382).
.\" 02i,09apr02,pai  Reworked ATA configuration and documentation (SPR#
.\"                  73848).  Updated aic7880Lib configuration documentation.
.\" 02h,01apr02,jkf  Added _WRS_BSP_DEBUG_NULL_ACCESS to generate exception
.\"                  for code accesses to lower page of memory, null ptr.
.\" 02g,26mar02,pai  Added comments on PIT1_FOR_AUX configuration (SPR 73396).
.\"                  Updated comments in section on TrueFFS support
.\"                  (SPR 74103).
.\" 02f,01feb01,dmh  make bootrom instructions clearer
.\" 02e,03dec01,hdn  updated APIC, Pentium4 stuff. added Upgrading... section
.\" 02d,11oct01,pai  updated for Veloce.
.\" 02c,27aug01,dgp  change manual pages to reference entries per SPR 23698
.\" 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 guidelines 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 bootrom image.
.\" 01a,12jan93,hdn  written.
.\"
.\" NOTE
.\" EXOS
.\"
.TH "pcPentium/2/3/4" T "PC 386/486 and Pentium/2/3/4" "Rev: 26 Oct 01" "TORNADO REFERENCE: VXWORKS"

.SH "NAME"
.aX "PC Pentium/2/3/4"

.SH "INTRODUCTION"
This reference entry provides board-specific information necessary to run
VxWorks for the pcPentium, pcPentium2, pcPentium3, and pcPentium4 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, pcPentium2, pcPentium3, and
pcPentium4 BSPs are generic BSPs for generic PC style motherboards.  For
best results, the board vendor's documentation should be used in
conjunction with this document.

.SS "BOOT PROCESS"

When a standard PC-AT computer is powered on, the system BIOS code 
loads and executes the bootstrap loader. The bootstrap loader is 
written in 8088 16-bit assembly language. The BIOS obtains the 
bootstrap loader from the boot sector, which may be in one of 
several locations: a diskette, a hard disk, or some other alternatives
such as a ROMCARD or TFFS card.  When the BIOS finds the bootstrap loader, 
it transfers execution to it.  The bootstrap loader finds the bootrom.sys 
file, loads it into memory, and transfers execution to romInit.

.SS "TrueFFS support"
This BSP supports the optional product TrueFFS for Tornado.  To use
TrueFFS, install the product and define INCLUDE_TFFS configuration
constant in the BSP config.h file.

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 definitions for
SYS_WARM_TYPE in config.h from SYS_WARM_FD to SYS_WARM_TFFS.

.SS "BOOT ROMS"
The PC-AT generic boards typically 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.  Note, that the Project builds vxWorks_romCompress.bin 
and vxWorks_romResident.bin.  VxWorks_rom.bin can be built by either Project
or the command line.  Other images are built by the command line.

.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.bin	bootable vxWorks	No	High Memory
vxWorks.st_rom.bin	bootable vxWorks.st	Yes	High Memory
bootrom.bin	bootrom	Yes	High Memory
bootrom_uncmp.bin	bootrom	No	High Memory
vxWorks_romCompress.bin	bootable vxWorks	Yes	High Memory
vxWorks_romResident.bin	bootable vxWorks	No	Low 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. 

Note to avoid rebooting issues, adjust the SYS_WARM_TYPE parameter 
appropriately in workspace and propagate the change to your
project. The default is to use the floppy disk for rebooting.

Making boot disks on the host side involves two steps.  Creating
the bootrom image file and preparing the boot disk.

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

.SH "Creating a bootrom image"

1. Begin by choosing one of the 6 supported boot image types with a .bin
extension name, vxWorks_rom.bin, vxWorks.st_rom.bin, bootrom.bin, or
bootrom_uncmp.bin based on your application needs.  Keep in mind that Low
Memory boot images are limited to approximately 640KB in size.    

2. Choose an appropriate boot parameters and define them in
DEFAULT_BOOT_LINE via Tornado or directly in config.h.  
Some examples values for DEFAULT_BOOT_LINE are...

.CS
"fei(0,0)host:/path/name/vxWorks h=90.0.0.3 e=90.0.0.50 u=bob"

"fd=0,0(0,0)host:/fd0/vxWorks e=90.0.0.50 u=jane o=fei"

"ata=0,0(0,0)host:/ata0disk0/vxWorks e=90.0.0.50 u=steve o=fei"

"ata=0,1(0,0)host:/ata0disk1/vxWorks.st"
.CE

3. Compile the boot image by running "make image_name" in the BSP
directory or see 
.I "Tornado User's Guide" 
for instructions on how to compile a bootable image from the Tornado IDE.

Preparing a Boot Disk/Diskette.

4. The boot loader searches the floppy disk for the file bootrom.sys. Boot
files with the .bin extension may be renamed to bootrom.sys. All other
boot images require a conversion tool create bootrom.sys. 

At this point, these instructions fork into three separate sets of
instructions that apply to Solaris, Windows and vxWorks itself.

.SS "Creating bootable diskettes from Solaris"

Use /usr/bin/fdformat that comes with Solaris. 
It requires a bootstrap loader file called vxld.bin located in
your Tornado directory tree at $WIND_BASE/host/sun4-solaris2/bin/vxld.bin

Insert a 1.44MB diskette into the Sun diskette drive, and issue the 
fdformat command to format the diskette and install the boot block.

.CS
fdformat -U -d -B $WIND_BASE/host/sun4-solaris2/bin/vxld.bin
Formatting 1.44 MB in /vol/dev/rdiskette0/no_name#0
Press return to start formatting floppy.
....................................................................
fdformat: using "vxld.bin" for MS-DOS boot loader
.CE

Eject and re-insert the diskette. On many systems the eject command is
required.

.CS
> eject
/vol/dev/rdiskette0/no_name can now be manually ejected
> volcheck
.CE

Copy the bootrom image to the diskette. Use cp for bin images or
objcopypentium for all other images.

.CS
> cp bootrom.bin /floppy/floppy0/bootrom.sys
...
> objcopypentium -O binary bootrom /floppy/floppy0/bootrom.sys
.CE


.SS "Creating bootable diskettes from Windows"

.CS

C:\Tornado\target\config\pcPentium\> format a: /v /q
Insert new disk for drive A:
and press ENTER when ready...
The type of the file system is FAT.
Verifying 1.44M
Format complete.
Volume label (11 characters, ENTER for none)?

  1457664 bytes total disk space.
  1457664 bytes available on disk.

      512 bytes in each allocation unit.
     2847 allocation units available on disk.

Volume Serial Number is 307A-4ACB

Format another (Y/N)? n


C:\Tornado\target\config\pcPentium> mkboot a: bootrom.bin
VxSys 1.6 (c) Wind River 1993-2002
Boot sector installed OK.
        1 file(s) copied.
System transferred.  Checking a:BOOTROM.SYS is contiguous
chkdsk a:bootrom.sys
The type of the file system is FAT.
Volume Serial Number is D4CF-F52B
Windows is verifying files and folders...
File and folder verification is complete.
Windows has checked the file system and found no problem.

    1,457,664 bytes total disk space.
      271,360 bytes in 1 files.
    1,186,304 bytes available on disk.

          512 bytes in each allocation unit.
        2,847 total allocation units on disk.
        2,317 allocation units available on disk.
All specified file(s) are contiguous.

.CE

mkboot.bat writes the boot sector containing the boot loader onto the 
floppy disk.  Then mkboot copies the boot file to the floppy disk and
checks to ensure the boot file is contiguous.  The user must pay attention 
to the output and ensure the boot file is reported as contiguous.  The boot 
loader will not properly handle a non-contiguous boot files.   

An alternative to mkboot.bat is to manually invoke: 

format

use .\host\x86-win32\bin\vxsys  to create a boot sector 

use copy for boot images with a .bin extension

use objcopypentium for all other boot images

For example:

.CS
C:\Tornado\target\config\pcPentium\> format a: /v /q
Insert new disk for drive A:
and press ENTER when ready...
The type of the file system is FAT.
QuickFormatting 1.44M
Format complete.
Volume label (11 characters, ENTER for none)?

  1457664 bytes total disk space.
  1457664 bytes available on disk.

      512 bytes in each allocation unit.
     2847 allocation units available on disk.

Volume Serial Number is DC31-1143

QuickFormat another (Y/N)? n

C:\Tornado\host\x86-win32\bin> vxsys a:
VxSys 1.6 (c) Wind River 1993-2002
Boot sector installed OK.

.CE
Now copy the boot image to the floppy. For .bin images use copy
.CS
C:\Tornado\target\config\pcPentium> copy bootrom.bin a:bootrom.sys

.CE
For all other images use objcopypentium 
.CS
C:\Tornado\host\x86-win32\bin\objcopypentium -O binary --gap-fill=0
bootrom a:bootrom.sys

.CE
Now verify that the file is contiguous. Non contiguous images will not
boot.
.CS
c:\Tornado\target\config\pcPentium> chkdsk a:bootrom.sys
The type of the file system is FAT.
Volume Serial Number is DC31-1143
CHKDSK is verifying files and directories...
File and directory verification completed.

  1457664 bytes total disk space.
   493056 bytes in 1 user files.
   964608 bytes available on disk.

      512 bytes in each allocation unit.
     2847 total allocation units on disk.
     1884 allocation units available on disk.
All specified file(s) are contiguous.