VxWorks 6.9 BSP开发指南

概述

本文主要是记录《VxWorks BSP Developer's Guide 6.9》和《VxBus Device Driver Developer's Guide 6.9》的部分章节内容，重点关注VxWorks 6.9的BSP移植和驱动开发。

BSP概述

本章主要介绍VxWorks启动过程中调用的BSP相关函数，BSP移植的主要工作就是实现这些函数。

函数	文件	描述
romInit()	romInit.s	初始化CPU和内存
sysHwInit()	sysLib.c	硬件外设初始化
sysHwInit0()	sysLib.c	在sysHwInit()之前完成特定硬件外设初始化，该函数只在部分BSP中需要
sysHwInit1()	sysLib.c	只有64bit需要，初始化所有硬件外设和虚拟内存
sysHwInit2()	sysLib.c	准备VxWorks应用运行所需的硬件外设

BSP所需的源文件包括：


Required BSP Files:
    installDir/vxworks-6.x/target/config/bspname/bspname.h
    installDir/vxworks-6.x/target/config/bspname/config.h
    installDir/vxworks-6.x/target/config/bspname/Makefile
    installDir/vxworks-6.x/target/config/bspname/README
    installDir/vxworks-6.x/target/config/bspname/romInit.s
    installDir/vxworks-6.x/target/config/bspname/sysALib.s
    installDir/vxworks-6.x/target/config/bspname/sysLib.c
    installDir/vxworks-6.x/target/config/bspname/target.ref

Optional BSP Files:
    installDir/vxworks-6.x/target/config/bspname/sysSerial.c
    installDir/vxworks-6.x/target/config/bspname/configNet.h
    installDir/vxworks-6.x/target/config/bspname/sysEnd.c

VxBus Device Driver Directories:
    installDir/vxworks-6.x/target/src/hwif/busCtlr
    installDir/vxworks-6.x/target/src/hwif/console
    installDir/vxworks-6.x/target/src/hwif/cpu
    installDir/vxworks-6.x/target/src/hwif/demo
    installDir/vxworks-6.x/target/src/hwif/dmaCtlr
    installDir/vxworks-6.x/target/src/hwif/end
    installDir/vxworks-6.x/target/src/hwif/end2
    installDir/vxworks-6.x/target/src/hwif/fw
    installDir/vxworks-6.x/target/src/hwif/h
    installDir/vxworks-6.x/target/src/hwif/hEnd
    installDir/vxworks-6.x/target/src/hwif/i2c
    installDir/vxworks-6.x/target/src/hwif/intCtlr
    installDir/vxworks-6.x/target/src/hwif/mf
    installDir/vxworks-6.x/target/src/hwif/mii
    installDir/vxworks-6.x/target/src/hwif/nvram
    installDir/vxworks-6.x/target/src/hwif/resource
    installDir/vxworks-6.x/target/src/hwif/sio
    installDir/vxworks-6.x/target/src/hwif/spi
    installDir/vxworks-6.x/target/src/hwif/storage
    installDir/vxworks-6.x/target/src/hwif/timer
    installDir/vxworks-6.x/target/src/hwif/usb
    installDir/vxworks-6.x/target/src/hwif/util
    installDir/vxworks-6.x/target/src/hwif/vxbus

VxWorks Configuration Directories:
    installDir/vxworks-6.x/target/config/all
    installDir/vxworks-6.x/target/src/config
    installDir/vxworks-6.x/target/config/comps
    installDir/vxworks-6.x/target/config/comps/src
    installDir/vxworks-6.x/target/config/comps/vxWorks

重要源文件说明：

prjParams.h	VxWorks组件化配置和裁剪，自动生成开关宏（COMPONENTS INCLUDED）和宏参数（PARAMETERS）文件。prjParams.h通常被config.h包含，prjComps.h被target/config/comps/src/configAll.h包含。
prjComps.h
configAll.h	被config.h包含
configNet.h	增强型网络驱动配置文件
config_pre.h
config.h
sysALib.s
sysLib.c
linkSyms.c
prjConfig.c	包含config.h，是VxWorks应用程序的入口，因为prjConfig.c的usrRoot()函数调用了usrAppInit()。创建工程或者重新编译VxWorks系统镜像工程时自动生成，用来初始化VxWorks系统各个组件，每次重新编译工程时会重置。
usrConfig.c	编译bootrom文件时使用，功能与prjConfig.c类似。
vxBus.c
usrAppInit.c

VxWorks Image启动流程


sysInit : sysALib.s
    禁用中断，初始化栈，跳转到usrInit()

usrInit() : prjConfig.c
    sysStart(startType)  /* 清零BSS段，配置异常向量表基地址等 */
    sysHwInit0();
    intVecBaseSet ((FUNCPTR *) VEC_BASE_ADRS);
    excShowInit();
    usrBootHwInit()
    cacheLibInit()
    excShowInit()
    excVecInit()
    sysHwInit()          /* 外设驱动初始化 */
    usrCacheEnable()
    objInfoInit()
    objLibInit()
    vxMemProbeInit()
    classListLibInit()
    semLibInit()
    classLibInit()
    kernelBaseInit()
    taskCreateHookInit()
    sysDebugModeInit()
    usrKernelInit()

sysHwInit() : sysLib.c
    hardWareInterFaceInit()

usrKernelInit() : usrKernel.c
    调用taskLibInit()初始化task库，计算内存池结束地址memPoolEndAdrs，最后调用kernelInit()

kernelInit() : kernelLib.c
    初始化并启动内核，从内存池顶部创建根堆栈和TCB，最后创建tRootTask任务用于执行usrRoot()初始化

usrRoot() : prjConfig.c
    初始化内存、系统时钟、I/O系统，标准输入输出，异常处理，添加用户应用程序。

usrAppInit() : usrAppInit.c
    用户代码入口。

VxWorks 6.9 BSP开发指南

VxWorks设备驱动

VxWorks设备驱动有VxBus-enabled和legacy(pre-VxBus)两种实现方式。VxBus形式的设备驱动天然支持SMP(symmetric multiprocessing)。

VxBus驱动框架为VxWorks内核和硬件外设定义了一组标准的驱动接口。

VxBus设备驱动有三个要素：设备、驱动和实例。

应用程序通过vxbDevMethodGet()函数去查询每一个实例。

开发流程

重要结构体：


struct hcfResource
    {
    char *  name;
    UINT32  type;
    union
        {
        char *  string;
        UINT32  integer;
        void *  addr;
        ULONG   longval;
        } u;
    };

struct hcfDevice
    {
    char *      devName;
    int         devUnit;
    int         busType;
    int         busIndex;
    int         count;
    const struct hcfResource * pResource;
    };

1、实现vxbDevRegInfo设备描述块结构体实例，并通过vxbDevRegister(structure vxbDevRegInfo *pDevInfo)注册驱动程序；

VxWorks系统启动时，通过sysHwInit() -> hardWareInterFaceInit() -> hardWareInterFaceBusInit()调用vxbDevRegister()注册驱动程序。


struct vxbDevRegInfo
{
    struct vxbDevRegInfo * pNext;
    UINT32  devID;
    UINT32  busID;
    UINT32  vxbVersion;
    char    drvName[MAX_DRV_NAME_LEN+1];
    struct drvBusFuncs * pDrvBusFuncs;
    struct vxbDeviceMethod * pMethods;
    BOOL (*devProbe) ( struct vxbDev * pDevInfo);
    struct vxbParams * pParamDefaults;
};

pNext用于总线级联，如果没有级联，则置为NULL。

drvName表示设备名称，同时实现设备与驱动的匹配，只有与hcfDeviceList中的设备名称一致，才能匹配上。

pMethods用于提供总线的各种方法，但是通常只提供该总线特有的方法，因为通用方法如open, read等，一般都通过I/O层的系统调用，它们需要单独注册。

devProbe用于检测当前是否存在该类型的设备，如果不需要探测，则置为NULL。

pDrvBusFuncs提供了设备初始化需要的接口：


struct drvBusFuncs
{
    void (*devInstanceInit) (struct vxbDev *);
    void (*devInstanceInit2) (struct vxbDev *);
    void (*devInstanceConnect) (struct vxbDev *);
};

devInstanceInit在VxWorks内核初始化前被调用，devInstanceInit2在VxWorks内核初始化之后内调用，一般设备初始化都通过devInstanceInit2实现。

devInstanceConnect用于设备连接，通常可以不使用，如果它依赖于其他设备，则可以把启动代码放在这里。

2、在hcfDeviceList中添加设备；

hcfDeviceList[]数组管理VxBus驱动框架的所有设备，每个成员描述符的最后一个成员变量pResource用于配置设备特性信息，如串口波特率等。可以通过devResourceGet()函数获取。

3、VxWorks系统启动时，会实例化hcfDeviceList中的设备；

实例化的过程是VxWorks系统遍历hcfDeviceList[]数组，如果hcfDevice->devName与vxbDevRegInfo->drvName与匹配，则调用指向的驱动的初始化函数，如devInstanceInit。

AN EMBEDDED GROUP

AN EMBEDDED GROUP