'\" 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 runVxWorks 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, andpcPentium4 BSPs are generic BSPs for generic PC style motherboards.  Forbest results, the board vendor's documentation should be used inconjunction 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 alternativessuch 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 useTrueFFS, install the product and define INCLUDE_TFFS configurationconstant in the BSP config.h file.TrueFFS is set up to use the M-Systems DiskOnChip 2000 and two PCMCIAslots as a drive for use with dosFs.If you wish to reboot from the DiskOnChip device change the definitions forSYS_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 systemcontaining 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 Projector the command line.  Other images are built by the command line..TS Eexpand;c c c cc c c cl l l l.		Image is	Image LoadsImage Name	Description	Compressed	Into=vxWorks_rom.bin	bootable vxWorks	No	High MemoryvxWorks.st_rom.bin	bootable vxWorks.st	Yes	High Memorybootrom.bin	bootrom	Yes	High Memorybootrom_uncmp.bin	bootrom	No	High MemoryvxWorks_romCompress.bin	bootable vxWorks	Yes	High MemoryvxWorks_romResident.bin	bootable vxWorks	No	Low Memory_.TEVxWorks.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 yourproject. The default is to use the floppy disk for rebooting.Making boot disks on the host side involves two steps.  Creatingthe 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 .binextension name, vxWorks_rom.bin, vxWorks.st_rom.bin, bootrom.bin, orbootrom_uncmp.bin based on your application needs.  Keep in mind that LowMemory boot images are limited to approximately 640KB in size.    2. Choose an appropriate boot parameters and define them inDEFAULT_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".CE3. Compile the boot image by running "make image_name" in the BSPdirectory 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. Bootfiles with the .bin extension may be renamed to bootrom.sys. All otherboot images require a conversion tool create bootrom.sys. At this point, these instructions fork into three separate sets ofinstructions 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 inyour Tornado directory tree at $WIND_BASE/host/sun4-solaris2/bin/vxld.binInsert a 1.44MB diskette into the Sun diskette drive, and issue the fdformat command to format the diskette and install the boot block..CSfdformat -U -d -B $WIND_BASE/host/sun4-solaris2/bin/vxld.binFormatting 1.44 MB in /vol/dev/rdiskette0/no_name#0Press return to start formatting floppy.....................................................................fdformat: using "vxld.bin" for MS-DOS boot loader.CEEject and re-insert the diskette. On many systems the eject command isrequired..CS> eject/vol/dev/rdiskette0/no_name can now be manually ejected> volcheck.CECopy the bootrom image to the diskette. Use cp for bin images orobjcopypentium 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".CSC:\Tornado\target\config\pcPentium\> format a: /v /qInsert new disk for drive A:and press ENTER when ready...The type of the file system is FAT.Verifying 1.44MFormat 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-4ACBFormat another (Y/N)? nC:\Tornado\target\config\pcPentium> mkboot a: bootrom.binVxSys 1.6 (c) Wind River 1993-2002Boot sector installed OK.        1 file(s) copied.System transferred.  Checking a:BOOTROM.SYS is contiguouschkdsk a:bootrom.sysThe type of the file system is FAT.Volume Serial Number is D4CF-F52BWindows 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..CEmkboot.bat writes the boot sector containing the boot loader onto the floppy disk.  Then mkboot copies the boot file to the floppy disk andchecks 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: formatuse .\host\x86-win32\bin\vxsys  to create a boot sector use copy for boot images with a .bin extensionuse objcopypentium for all other boot imagesFor example:.CSC:\Tornado\target\config\pcPentium\> format a: /v /qInsert new disk for drive A:and press ENTER when ready...The type of the file system is FAT.QuickFormatting 1.44MFormat 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-1143QuickFormat another (Y/N)? nC:\Tornado\host\x86-win32\bin> vxsys a:VxSys 1.6 (c) Wind River 1993-2002Boot sector installed OK..CENow copy the boot image to the floppy. For .bin images use copy.CSC:\Tornado\target\config\pcPentium> copy bootrom.bin a:bootrom.sys.CEFor all other images use objcopypentium .CSC:\Tornado\host\x86-win32\bin\objcopypentium -O binary --gap-fill=0bootrom a:bootrom.sys.CENow verify that the file is contiguous. Non contiguous images will notboot..CSc:\Tornado\target\config\pcPentium> chkdsk a:bootrom.sysThe type of the file system is FAT.Volume Serial Number is DC31-1143CHKDSK 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.