FVID驱动及函数用法

/szzh _ 515/blog/static/29076175200941811218667 /TI公司发布了DSP/BIOS设备驱动程序包(DDK )，以开发DSP的外围驱动程序，定义了标准设备驱动程序的型号，并提供了一系列API接口。外围设备驱动程序分为两层：类驱动程序(class driver )。 类驱动程序用于为应用程序提供接口。 该程序的一些部分与该设备无关，主要功能保留该设备的数据缓冲区，提供API接口以调用该应用层程序，以及调节应用外围设备的操作同步和块，其继而与小驱动层连接类驱动程序与硬件无关，只要选择了外围设备驱动程序型号，类驱动程序就已经确定，不需要进行太多更改。微型驱动器(mini driver )。 小型驱动程序与设备相关，因此设计小型驱动程序是外围设备驱动程序开发的重点。 虽然小驱动程序和类驱动程序层的接口格式是统一的，但对基本硬件的操作因硬件平台而异。 微型驱动器接收类驱动器层发出的IOM_Packet命令包，并确定对底层硬件执行的操作。外围设备的驱动程序型号可分为三种类型：PIP/PIO型。 在基于数据管道的I/O模型中，每个管道都有自己的缓冲区。 将数据写入缓冲区或从缓冲区中检索数据时，notifyReader ()和notifyWriter ()函数将启动并同步数据。SIO/DIO型号。 基于流的I/O模型单个流是单向的、输入或输出，并且可以使用SIO/DIO模型或异步方案来操作I/O，从而同时执行数据读取和写入处理。 GIO模型。 通用I/O模型灵活，无适应层，直接操作小驱动器，主要设计新的设备驱动模型。比较PIO、SIO和GIOPIO支持更基本的通信，适用于相对简单的外围设备驱动程序设计。 例如在TI公司的6X11DSK板上实现的音频采集和播放一般基于PIO模型。 SIO模型具有良好的缓冲分配回收机制，适合描述FVID驱动模型TI公司最初设计的GIO模型的缺陷主要在于数据缓冲区管理问题，应用程序无法在获取设备驱动程序缓冲区进行数据处理后将缓冲区返回设备驱动程序。 因此，TI公司在推出DM642这种主要用于视频处理的DSP芯片的同时，改进了GIO模型，提出了专门用于视频设备的FVID模型。FVID模型建立在GIO模型上，用FVID_alloc ()、FVID_exchange ()和FVID_free ()函数封装GIO模型的GIO_submit ()函数，解决了GIO模型驱动程序无法收集缓冲区的问题。另外，FVID模型特别设计了FVID_frame结构。 该结构包括经常使用的影像信号的信息，例如行数、列数、YUV结构、场频率等，适于描述影像数据的帧，影像的情况下设计的FVID模型主要为DM64X系统设计。微驱动函数的具体实现如下： mdBindDev ()函数。 当应用程序建立设备接口(如FVID_create ()函数)时，将调用该接口，固定设备并完成外部设备的初始化。 相应的是mdUBindDev ()函数，mdUBindDev ()函数会禁用设备并禁用设备。 mdCreateChan ()函数。 使用此函数为应用程序和驱动程序建立通信通道，并请求每个通道缓冲区。 TI公司发表的FVID模型中，每个通道分配3个缓冲器，按顺序与外部设备交换数据，每个缓冲器对应1帧的视频数据。 mdCreateChan ()对应于md_DeleteChan ()函数，删除设备通道并释放缓冲资源。 mdSubmitChan ()函数。 负责管理缓冲区，分别接受来自应用程序的FVID_ALLOC ()、FVID_EXCHANGE ()和FVID_FREE ()这三个命令并进行处理。 FVID_ALLOC命令用于获取驱动程序缓冲区，应用程序从三个缓冲区中提取最新的视频数据，处理其中的数据，仅剩下的缓冲区用于接收从外部设备输入的数据。 FVID_EXCHANGE ()用驱动程序的最新数据缓存替换已使用的缓存，应用程序处理一帧的数据，将该一帧的数据返回驱动程序，读取新的一帧的数据并进行处理。 FVID_FREE ()将已使用的高速缓存返回驱动程序，应用程序将已处理的数据帧返回驱动程序，并且不再向驱动程序请求新的数据帧。 mdControlChan ()函数。 用于操作外部视频设备，完成视频数据的收集和输出。 应用程序通过FVID_Control ()函数将命令传递给GIO_Control ()，将GIO_Control ()函数传递给mdControlChan ()函数，并将命令分发到最后指定的设备。FVID函数：1.FVID_create ()的角色是指配和初始化FVID通道对象语法： fvidchan=fvid _ create (名称，模式，*状态，optArgs，*attrs )参数定义：字符串名称/* handletoaninstanceofthedevice * /int模式/* pointertobufferallocatedbydriver * /int * status/* pointertosizeofbufferpointedtoby * /Ptr optArgs /* */FVID_Attrs *attrs /* */其中：name是设备实例的句柄，字符串mode是选定模式，只有：IOM_INPUT的值设置为检索模式，IOM_OUTPUT的值设置为显示模式。status是从底层mini驱动程序返回的状态值。attrs是指向FVID_Attrs结构的指针：FVID_Attrs的定义为：typedef struct FVID_Attrs Uns timeout； FVID_Attrs；timeout成员用于指定旗语同步。 值为：SYS_FOREVER:不可靠地等待FVID_alloc、fvid_free和fvid_exchange调用，直到该调用完成.数字的timeout值阻止APIs在指定的时间(系统时钟)。 0的值可以防止APIs阻止并立即返回。 在这种情况下，应用程序会检查返回的status值，以确保调用成功完成备注：FVID_alloc、FVID_free和FVID_exchange的调用仅为DSP/BIOS任务(tsk )。FVID_create的返回值：如果通道成功打开，则FVID_create返回通道的句柄。 后面的模块可以使用此句柄调用通道实际列：/* Initialize the attributes */FVID_ATTRS dispAttrs=FVID_ATTRS；/* createaninstancetoavideodisplaydevice */chan -Handle=FVID_create(“display0”，IOM_INPUT，NULL，NULL，dispAttrs )；2.FVID_control ()用以将控制命令发送至较低层的mini_driver语法： status=fvid _ control (fvidchan，cmd，args )参数定义：fvid _ handlefvidchan/* handletoaninstanceofthedevice * /int cmd/*控制命令* /ptr args/* pointertocontrolcommandarguments * /return value int status/* return siom _ completeifsuccessful * /参数说明：fvidChan是由FVID_create ()创建的通道的句柄。cmd有两个值：IOM_ABORT-。IOM_FLUSH-功能因收集口的动作被废弃，所以I/O的动作正常进行。Args是指向要传递的命令(参数或结构)的指针。如果返回值：调用成功，则FVID_control返回IOM_COMPLETED。 如果发生错误，调用将返回负值。实例：/* abortspendingvideodriveri/ob作业* /FVID_control(fvidChan，IOM_ABORT，NULL )3.FVID-alloc ()角色：申请获取驱动程序高速缓存单元。语法： status=FVID_alloc (fvidChan，bufp )参数定义：fvid _ handlefvidchan/* handletoaninstanceofthedevice * /ptrb ufp/* pointertobufferallocatedbydriver * /return value int status/* return siom _ completeifsuccessful * /参数说明：fvidChan是由FVID_create ()创建的通道的句柄。bufp是输出参数，是指向所申请驱动器缓存空间的指针。返回值： FVID_alloc ()在调用成功时返回IOM_COMPLETED，在出现错误时返回负值。注意：只有在加载和初始化外围设备后，才能调用此函数。 此处的句柄必须由FVID_create ()函数指定。实例：/* allocateabufferfromthedevice * /status=FVID_alloc(chanHandle，dispBuf )4.FVID_exchange ()角色：交换应用程序和驱动程序高速缓存区域，并且相当于FVID_free ()和FVID_alloc ()函数的组合。语法： status=FVID_exchange (fvidChan，bufp )参数定义：fvid _ handlefvidchan/* handletoaninstanceofthedevice * /ptrb ufp/* pointertobufferexchangbydriver * /LG uns * psize/* pointertosizeofbufferpointedtobybufp * /参数说明：fvidChan是由FVID_create ()创建的通道的句柄。bufp是输入输出参数，指的是最初应用程序需要交换的高速缓存区域，交换后指的是驱动程序和高速缓存区域交换后的存储区域。pSize是指向bufp内存大小的指针。返回值： FVID_exchange ()在调用成功时返回IOM_COMPLETED，在出现错误时返回负值。注意：只有在加载和初始化外围设备后，才能调用此函数。 此处的句柄必须由FVID_create ()函数指定。实例：/* allocateabufferfromthedevice * /status=fvid _ exchange (chan handle，dispBuf )4.FVID_free ()角色：将应用程序请求返回的缓存释放给驱动程序语法： status=FVID_free (fvidChan，bufp )参数定义：fvid _ handlefvidchan/* handletoaninstanceofthedevice * /ptrb ufp/* pointertobuffertoberelinqistedtodriver * /LG uns * psize/* pointertosizeofbufferpointedtobybufp * /参数说明：fvidChan是由FVID_create ()创建的通道的句柄。bufp是一个输入参数，表示应用程序必须释放其返回的缓存空间。pSize是指向bufp内存大小的指针。返回值： FVID_free ()在调用成功时返回IOM_COMPLETED，如果出现错误，则返回负值。注意：只有在加载和初始化外围设备后，才能调用此函数。 此处的句柄必须由FVID_create ()函数指定。实例：example/* freeabufferbacktothedevice * /status=FVID_free(chanHandle，dispBuf )5.FVID_delete ()角色：申请关闭FVID channel对象。语法： status=FVID_delete (fvidChan )参数定义：fvid _ han