target.txt

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

pc386/486(T)       TORNADO REFERENCE: VXWORKS        pc386/486(T)



NAME
     PC 386/486


INTRODUCTION
     This manual entry provides board-specific information neces-
     sary  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.


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:

                                           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
     ____________________________________________________________
     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  initial-
     ized.

     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.












Rev: 25 Mar 98             PC 386/486                           1






pc386/486(T)       TORNADO REFERENCE: VXWORKS        pc386/486(T)



     The usage of the two VxWorks boot utilities is as follows:

     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                   */
         )

     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':

         -> mkbootFd 0, 0, "bootrom_uncmp"

     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':

         -> mkbootAta 0, 0, "bootrom_uncmp"

     These boards do not have non-volatile RAM; thus, boot param-
     eters  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 VxWorks
     Programmer's Guide, Appendix D: Intel i386/i486.

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


Jumpers
     Refer to the board vendor's documentation.




Rev: 25 Mar 98             PC 386/486                           2






pc386/486(T)       TORNADO REFERENCE: VXWORKS        pc386/486(T)



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


Supported Features
     Supported features are discussed below in the "Devices" sec-
     tion under the "HARDWARE DETAILS" heading.


Unsupported Features
     This BSP does not support ISA PnP. Such devices can be  sup-
     ported  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 manufac-
     turer, should be used to set the device parameters.


Feature Interactions
     Refer to the board vendor's documentation.


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


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 documen-
     tation 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.

i8250Sio.c     Intel UART tty driver







Rev: 25 Mar 98             PC 386/486                           3






pc386/486(T)       TORNADO REFERENCE: VXWORKS        pc386/486(T)



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

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


     i8250Sio
          Intel 8250 Universal Asynchronous Receiver  Transmitter
          (UART) tty driver.  Used for the serial ports

     i8237Dma
          Driver for the ISA DMA controller.   This  is  used  in
          nec765Fd.c,  which  also  serves  as a good application
          example.

     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.

     m6845Vga
          Driver for the Motorola M6845 VGA controller.   To  use
          this controller, define INCLUDE_PC_CONSOLE in config.h.

     nec765Fd:
          Driver for the nec765 floppy disk controller.   To  use
          this  driver,  the INCLUDE_FD directive must be enabled
          in config.h.



Rev: 25 Mar 98             PC 386/486                           4






pc386/486(T)       TORNADO REFERENCE: VXWORKS        pc386/486(T)



     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().

     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.

          For information regarding installing the  AHA-2940  see
          the "Adaptec 7800 Family Manager Set User's Guide".

     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.

          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.

          The macro PIT_CLOCK must also be  defined  to  indicate
          the clock frequency of the i8253.

          The system clock is the programmable  interrupt  timer.
          The auxiliary clock is the real time clock.

          This driver includes a timestamp driver;  to  use  this
          feature, the macro INCLUDE_TIMESTAMP must be defined in
          config.h.

     i8259Pic
          Driver for the Intel 8259A Programmable Interrupt  Con-
          troller (PIC).

     nullNvRam
          This library contains dummy non-volatile RAM  manipula-
          tion  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.

     nullVme
          This library contains null routines for boards which do



Rev: 25 Mar 98             PC 386/486                           5






pc386/486(T)       TORNADO REFERENCE: VXWORKS        pc386/486(T)



          not include any common bus routines.

     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.

     if_ultra
          Driver for the SMC Elite16 (Western Digital 8013WC) and
          SMC  Elite  16  Ultra network cards.  To use these con-
          trollers the INCLUDE_ULTRA directive must be enabled in
          config.h.  The following jumper configurations are sup-
          ported:

             SMC Elite 16                     SMC Elite16 Ultra
   Jumper   Setting                    Jumper   Setting
   ________________________________    ________________________________
     W1      SOFT (I/O addr 0x240)       W1      SOFT (I/O addr 0x240)
     W2      NONE/SOFT                   -       NO ROM
     -       NO ROM

          IRQ levels 2,3,5,7,10,11,15 are supported.

     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.

     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 configura-
          tion for this card to work with vxWorks.

     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.

     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 config-
          ured.   The  I/O  base address and interrupt level must



Rev: 25 Mar 98             PC 386/486                           6






pc386/486(T)       TORNADO REFERENCE: VXWORKS        pc386/486(T)



          match those in config.h.

     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.


Memory Maps
 ___________________________________________________________________
 |   Start Address     |           Size            |      Use       |
 |_____________________|___________________________|________________|
 |LOCAL_MEM_LOCAL_ADRS | 0xa0000                   | lower memory   |
 |_____________________|___________________________|________________|
 |0xa0000              | 0x60000                   | video ram, etc |
 |_____________________|___________________________|________________|
 |0x100000             | LOCAL_MEM_SIZE - 0x100000 | upper memory   |
 |_____________________|___________________________|________________|


Shared Memory
     Not applicable to this BSP


Interrupts
     All ISA interrupts are external to the CPU  and  are  routed
     through  the  ISA  interrupt  prioritization hardware.  This
     hardware is comprised of two 82C59 PICs.  There are  16  ISA
     interrupts  and interrupt priority levels numbered 0 through
     15. The mapping between interrupt numbers and priority  lev-
     els is not necessarily one to one.  The motherboard hardware
     determines the mapping of interrupt request lines  (IRQ)  to
     priority  levels. The hardware should adhere to the standard
     ISA assignments:


















Rev: 25 Mar 98             PC 386/486                           7