VxWorks6.6 pcPentium BSP 使用说明（三）：设备驱动

        本文主要介绍了pcPentium BSP中包含的驱动程序。包含了官方提供的所有驱动程序，除了aic7888Lib――现在已用得很少的一个AIC-7888 SCSI控制器的驱动介绍。建议重点阅读ataDrv和ataShow部分，其他部分可以略看。

 

BSP通过VxBus的驱动合集和老的非VxBus驱动来支持设备。 此版本中，VxBus是默认配置，非VxBus驱动程序支持已被删除。

VxBus驱动遵循VxWorks 6.2中引进的总线模型。 在此模型中，VxBus提供大部分功能，这在以前是需要放入BSP文件sysDev.c中的（例如sysFei82557End.c） 对于PCI设备，除了确保在sysPhysMemDesc[]中有足够的DUMMY_MMU_ENTRY定义行，BSP的其他支持是不需要的。 对于位于处理器总线的设备，BSP的支持通常仅限于进入hwconf.c的条目表。

该BSP中的非VxBus驱动包括主板的板载芯片和独立的适配卡的驱动。 对于主板和适配器卡使用请参考供应商的说明文档。 板载芯片的官方文档也可能是必要的文件。

请注意，对于所有的ISA驱动程序，I/O基地址，内存地址和中断级别必须与config.h或pc.h中的一致 。

下面的表格中的驱动以.C的源代码的最终形式交付。其他驱动都只有目标文件的形式交付。

i8237Dma.c	8237 DMA驱动程序
pcConsole.c	控制台驱动程序
i8042Kbd.c	英特尔键盘控制器
i8048Kbd.c	英特尔键盘控制器
m6845Vga.c	摩托罗拉M6845 VGA控制器
nec765Fd.c	nec765软盘控制器
ataDrv.c	IDE / ATA的硬盘控制器
ataShow.c	IDE / ATA的硬盘控制器显示例程
aic7880Lib.o	AHA-2940 PCI SCSI适配器卡
vxbI8253Timer.o	英特尔8253定时器驱动程序
vxbLoApicTimer.o	英特尔Pentium/2/3/4 APIC / xAPIC定时器库
vxbIntelTimestamp.o	英特尔时间戳驱动程序
vxbMc146818Rtc.o	MC146818 RTC的驱动程序
i8259Intr.c	英特尔8259PIC
loApicIntr.c	英特尔Pentium/2/3/4本地APIC / xAPIC驱动
loApicIntrShow.c	英特尔Pentium/2/3/4本地APIC / xAPIC显示驱动程序
ioApicIntr.c	英特尔IO APIC的/ xAPIC驱动
ioApicIntrShow.c	英特尔IO APIC/xAPIC显示驱动程序
nullNvRam.c	无效的NVRAM库
nullVme.c	VME总线空库
pcmciaLib.c	PCMCIA驱动
pcmciaShow.c	PCMCIA驱动显示程序
elt3c509End.o	3COM的3C509 END驱动程序
ultraEnd.o	SMC Elite Ultra驱动程序
dec21x40End.o	DEC 21x4x PCI END驱动程序
ne2000End.o	Novell/Eagle 2000 END驱动
lptDrv.c	并行端口驱动程序

下面是关于每个驱动程序的一些简要说明。 欲了解更多详情请参考VxWorks Reference Manual

ns16550

用于串口。

此驱动程序不支持E7520芯片。 详细请参阅第一节第3部分“创建一个BootROM镜像”。

i8237Dma

为ISA DMA控制器驱动。 该驱动用在nec765Fd.c，这是一个很好的可用的范例。

pcConsole，i8042Kbd和i8048Kbd

板载英特尔8042和8048键盘控制器。为了使用该控制器config.h中的INCLUDE_PC_CONSOLE必须使能。 宏PC_KBD_TYPE在config.h必须和PC_PS2_101_KBD在i8042Kbd.c中，PC_XT_83_KBD在i8048Kbd.c中一样，被定义。

m6845Vga

摩托罗拉M6845VGA控制器驱动。 要使用此控制器，定义config.h中INCLUDE_PC_CONSOLE使能。

nec765Fd

nec765软盘控制器驱动。 要使用这个驱动程序，必须使能INCLUDE_FD指令在config.h中。

ataDrv和ataShow

IDE/ATA硬盘控制器驱动。 要使用该驱动程序，必须启用config.h中的INCLUDE_ATA指令。 请注意，老的INCLUDE_IDE指令被INCLUDE_ATA取代而且vxsys（）被替换为mkbootFd（）和mkbootAta（）。

默认情况下，通过设置INCLUDE_ATAVxWorks设置一个ATA硬盘设备在ATA主控制器(ATA控制器0）和一个设备在ATA控制器1。 如果一个系统有两个以上的控制器或每个控制器超过一个驱动器，则配置config.h 的参数，而且sysLib.c中的ataResources表也必须进行修改以支持更多的驱动器和控制器。

例如，假设系统的ATA控制器0有两个物理驱动器。 修改config.h中ATA0_NUM_DRIVES的定义的默认值1为2：

/* config.h */ ... ...#define ATA0_NUM_DRIVES (2)...
请注意，BSP的config.h和sysLib.c预先确定ATA配置参数的值而ataResources表记录至多允许两个控制器。 这样一个受限的配置不是每一个目标系统的代表。

考虑到在一个系统上，可能有一个硬盘挂载在主控制器，一个CD-ROM设备在从控制器，一个PCMCIA设备在第三个控制器上。 默认的ataResources表必须修改以使ataDrv可以初始化并使用系统所有的控制器。 特别地，应该定义附加的配置参数，在ataResources表中采用如下类似的方式来初始化第三个控制器。

 

...ATA_RESOURCE ataResources[ATA_MAX_CTRLS] =    {
    /* ATA controller zero resources */    {    /* ATA 0 initializers ... */
    },/* ATA controller one resources */    {    /* ATA 1 initializers ... */
    },    /* ATA controller two resources */    {        /*  PCCARD_RESOURCE */
        {         ATA2_VCC,           /* 3-5 volts Vcc */
        ATA2_VPP,           /* 5-12 volts Vpp */            {
            ATA2_IO_START0, /* start I/O address 0 */
            ATA2_IO_START1  /* start I/O address 1 */            }, 
            {            ATA2_IO_STOP0,  /* end I/0 address 0 */
            ATA2_IO_STOP1   /* end I/0 address 1 */            },
        ATA2_EXTRA_WAITS,   /* extra wait states 0-2 */
        ATA2_MEM_START,     /* start host mem address */
        ATA2_MEM_STOP,      /* stop host mem address */
        ATA2_MEM_WAITS,     /* mem extra wait states 0-2 */
        ATA2_MEM_OFFSET,    /* mem offset of card address */
        ATA2_MEM_LENGTH     /* length of memory */        },
    ATA2_CTRL_TYPE,         /* IDE_LOCAL or ATA_PCMCIA */
    ATA2_NUM_DRIVES,        /* number of drives on controller */
    INT_NUM_ATA2,           /* interrupt number of controller */
    ATA2_INT_LVL,           /* interrupt level of controller */
    ATA2_CONFIG,            /* device configuration settings */
    ATA2_SEM_TIMEOUT,       /* semaphore timeout for controller */
    ATA2_WDG_TIMEOUT,       /* watchdog timeout for controller */
    ATA2_SOCKET_TWIN,       /* socket number for twin card */
    ATA2_POWER_DOWN         /* power down mode for this controller */    }    };
 ...  

 

该表的初始值包含定义在BSP文件config.h中。

ataResources表的大小和ataDrv支持的ATA控制器数量，由$WIND_BASE/target/h/drv/hdisk/ataDrv.h文件中的ATA_MAX_CTRLS定义。 默认ATA_MAX_CTRLS的值设置为2的情况下ataDrv将支持最多2个控制器。 当ataResources表被修改为指定两个以上的控制器，如上面的例子中ATA_MAX_CTRLS被重新定义$WIND_BASE/target/src/drv/hdisk/ataDrv.c文件应在重新生成vxWorks镜像前被重新编译以使用新的配置。

vxbI8253Timer

这个库包含一个用于操作Intel定时器8253及其兼容定时器芯片的的板级独立接口。

默认情况下在hwconf.c中只有计数器0被配置。 如果使用其他定时器，i8253DevResources []需要做如下修改。

 

struct hcfResource i8253DevResources[] = {    { "regBase", HCF_RES_INT, {(void *)PIT_BASE_ADR} },

    { "clkFreq", HCF_RES_INT, {(void *)PIT_CLOCK} },
    { "intr0", HCF_RES_INT, {(void *)INUM_TO_IVEC (INT_NUM_IRQ0)}},
    { "intr0Level", HCF_RES_INT, {(void *)PIT0_INT_LVL}},
    { "intr1", HCF_RES_INT, ....................................},
    { "intr1Level", HCF_RES_INT, ...............................},
    { "intr2", HCF_RES_INT, ....................................},
    { "intr2Level", HCF_RES_INT, ...............................},
    { "clkRateMin", HCF_RES_INT, {(void *)SYS_CLK_RATE_MIN} },
    { "clkRateMax", HCF_RES_INT, {(void *)SYS_CLK_RATE_MAX} },
    { "regInterval",HCF_RES_INT, {(void *)PIT_REG_ADDR_INTERVAL} }
};

作为为什么考虑一个8253兼容设备如何整合到系统如此重要的一个例子，考虑这些设备在消费者那通常是如何应用的。 The 8253的兼容芯片通常包含三个定时器。 通常情况下，所有三个定时器通过一个14.31818 MHz的板载晶振除以12，以产生1.19318 MHz的时钟频输入给定时器。 桌面系统下每个通道的定时器输出往往如如下方式连接：

 8253  +---------------+  | Timer 2 |  from bit 0 | output+------> to speaker circuitry  of port 61h ----+->gate |  | |  1.19318 MHz ----+->clk 2 |  | |  +---------------+  | Timer 1 |  +5 V | output+------> DRAM refresh  (logic 1)--+----+->gate |  | | |  1.19318 MHz ----+->clk 1 |  | | |  | +---------------+  | | Timer 0 |  | | output+------> to IRQ0 (timer interrupt)  +----+->gate |  | |  1.19318 MHz ----+->clk 0 |  | |  +---------------+ 

正如图所示，定时器通道2的输出直连接到扬声器。 定时器2的输出没有连接到8259 PIC（Programable Interrupt Control可编程中断控制器）或其他中断控制器。

从定时器通道1的输出提供给DRAM刷新。 因此，该定时器一旦被编程分配给系统DRAM就不可以被操作。

因为上面例子中定时器通道0被连接到中断控制器，而不是作为系统的关键功能时间基准（如DRAM的刷新），所以定时器0是作为系统可编程的辅助时钟的好的候选。

上面的例子只是8253兼容定时器设备整合到系统的一种可能的方式。 有些系统板可能将所有的定时器输出通道都连接到了中断控制器。 不是每个系统都会将定时器输出通道连接到DRAM刷新或扬声器。 再次强调，我们建议用户查阅目标系统的说明文档以了解具体系统的定义需求。

-

这些宏SYS_CLK_RATE_MIN，SYS_CLK_RATE_MAX，AUX_CLK_RATE_MIN,和AUX_CLK_RATE_MAX必须被定义以提供给sys[Aux]ClkRateSet()校验参数。

-

宏PIT_CLOCK也必须定义为i8253的时钟频率。

vxbMc146818Rtc

这是实时时钟驱动程序（基于摩托罗拉MC146818）。

vxbIntelTimestamp

这是英特尔芯片组时间戳驱动;在使用时间戳功能，必须定义config.h中的宏INCLUDE_TIMESTAMP。

vxbLoApicTimer

这个库包含操作英特尔P6(PentiumPro, II, and III)和P7(Pentium4)系列处理器本地APIC/xAPIC 定时器的规则并提供板级独立的接口。

-

宏APIC_TIMER_CLOCK_HZ也必须定义为指示本地APIC/xAPIC定时器的时钟频率。

i8259Intr

Intel 8259A可编程中断控制器（PIC）驱动。

loApicIntr

英特尔P6(PentiumPro, II, and III)和P7(Pentium4)系列处理器本地APIC/xAPIC驱动程序。此驱动程序即用于Virtual Wire Mode（定义在config.h中的VIRTUAL_WIRE_MODE））也用于Symmetric IO Mode（定义在config.h中的SYMMETRIC_IO_MODE）。 loApicInit（）初始化本地APIC/xAPIC，扫描规范指定的特定内存区域以确定基地址。 它使用BSP中定义的LOAPIC_BASE和IOAPIC_BASE如果不能在MP配置表中找到地址。 扫描内存区域由pc.h中的两对宏BIOS_ROM_START和BIOS_ROM_END，EBDA_START}和EBDA_END定义。

ioApicIntr

英特尔P6(PentiumPro, II, and III)和P7(Pentium4)系列处理器本地APIC/xAPIC驱动程序。此驱动程序用于Symmetric IO模式（定义在config.h中的SYMMETRIC_IO_MODE）。ioApicInit初始化IO APIC/xAPIC存储在redTable[]中的信息。redTable[]有三个部分――lsw、vectorNo和mask。 第一个部分，lsw，存储IO APIC/xAPIC重定向表的低位字符（least significant word）。 这包括触发模式，中断输入引脚的极性，目标模式和交付模式。 第二个部分，vectorNo，是重定向表的vectorNo。 第三部分，mask，应该为0被ioApicIntLock（）和ioApicIntUnlock（）用来保存中断掩码的状态。

nullNvRam

这个库包含了对断电缺乏断电非易失性存储芯片（NvRAM）的系统提供虚拟NvRAM的操作指令。

对于没有NvRAM的系统，宏NV_RAM_SIZE应定义为NONE。

nullVme

这个库包含板卡不包括在任何常用总线指令的空指令。

pcmciaLib和pcmciaShow

PCMCIA驱动。为了使用PCMCIA卡config.h的INCLUDE_PCMCIA指令必须启用。 该驱动目前支持三张卡。 要使用ATA PC卡，使能INCLUDE_ATA；要使用SRAM PC卡，使能INCLUDE_SRAM；要使用3Com Etherlink III PC卡，使能INCLUDE_ELT。默认情况下，当INCLUDE_PCMCIA使能时所有的这三种卡都能够支持。

USB支持

该BSP提供USB 1.1和2.0的支持。