FVID

FVID模块为DSP/BIOS程序提供API函数，以实现帧图像的获取和显示。FVID模块提供的设备驱动API函数不同于其他的设备驱动，因为它掌握数据缓冲区的所有权，应用程序按需求来分配缓冲区。对于大多数的DSP/BIOS设备驱动，最初都是由应用程序来控制数据缓冲区，并传递这些缓冲区的地址到设备驱动以实现数据的输入输出。FVID模块和视频捕获显示驱动与此不同，是山设备驱动来直接控制数据缓冲区，这是因为视频采集/显示系统通常需要有较大的、复杂的缓冲区，而且对数据读取速度的要求要远高于对缓冲区分配的灵活性和机动性的要求。设备驱动根据FVID通道的配置参数计算缓冲区的大小并分配缓冲区，而且至少要为每个FVID通道分配3个缓冲区，以确保视频图像的捕获和显示的连续性。

Fvid对gio的封装：
从fvid.h中我们可以清晰的看出fvid即为gio的一种扩展封装。
#define FVID_alloc(gioChan, bufp)
GIO_submit(gioChan, FVID_ALLOC, bufp, NULL, NULL)；

Fvid的属性结构：
typedef struct FVID_Attrs {
Uns timeout;
} FVID_Attrs;
Fvid的属性，指定fvid函数（即相当于gio相关函数）等待时间。若函数不能立即返回将会导致进程被挂起。如果指定为非0, FVID_alloc, FVID_free and FVID_exchange 只能在 DSP/BIOStask (TSK)使用。因swi和hwi不可能因此挂起。

Fvid信息：
typedef struct FVID_Frame {
QUE_Elem queElement; /* for queuing */
union {
FVID_Iframe iFrm; /* y/c frame buffer */
FVID_Pframe pFrm; /* y/c frame buffer */
FVID_RawIFrame riFrm; /* raw frame buffer */
FVID_RawPFrame rpFrm; /* raw frame buffer */
} frame;
} FVID_Frame;
typedef struct FVID_Iframe{
Char* y1;
Char* cb1;
Char* cr1;
Char* y2;
Char* cb2;
Char* cr2;
}FVID_Iframe;

/* progressive frame */
typedef struct FVID_Pframe {
Char* y;
Char* cb;
Char* cr;
} FVID_Pframe;
typedef struct FVID_RawIFrame{
Char* buf1;
Char* buf2;
} FVID_RawIFrame;
typedef struct FVID_RawPFrame{
Char* buf;
} FVID_RawPFrame;
QUE_Elem为该gio使用的队列，第二个成员为一指向缓冲区的指针。为联合体，即实例化结构对象第二个成员为指向该种联合体成员之一。该程序为iframe。

FVID_create()

     FVID_create()函数的作用：分配并初始化FVID通道对象;

语法:fvidChan = FVID_create (name, mode,*status, optArgs, *attrs);

Parameters

Stringname                 /* handle to an instance of the device */
Intmode                    /* pointer to buffer allocated by driver */
Int*status                 /* pointer to size of buffer pointed to by */
PtroptArgs                 /* */
FVID_Attrs*attrs            /* */

其中:name是设备实例的句柄,是一个字符串

mode是选择的模式,只有两个值:IOM_INPUT 设置采集模式,IOM_OUTPUT设置显示模式.

status是The status argument is an out parameterthat this function fills with a pointer to
the status that was returned by the mini-driver.

attrs是指向FVID_Attrs结构的指针:
FVID_Attrs的定义如下:typedef struct FVID_Attrs {
                                                       Uns timeout;
                                                      } FVID_Attrs;

timeout成员用来指定旗语同步,它的值可以是:

1.   SYS_FOREVER:会让FVID_alloc,FVID_free and FVID_exchange的调用不确定的等待到这个调用完成.

2.   数字的timeout值会让这些APIs阻塞一段指定的时间(以系统时钟).

3.   0值会让APIs不阻塞,他们会立刻返回,这种情况下,应用程序会检查返回的status值来保证调用已经成功
完成.

备注:FVID_alloc, FVID_free and FVID_exchange 的调用只能在 DSP/BIOS task (TSK).

·        FVID_create的返回值:

如果通道成功的打开了,那么FVID_create返回一个指向通道的句柄.这个句柄可以用来让后来的模块调用这个通道.

Example/* Initialize the attributes */
FVID_ATTRS dispAttrs = FVID_ATTRS;
/* Create an instance to a video display device */ chan-
Handle = FVID_create(“\display0”,IOM_INPUT, NULL, NULL,
&dispAttrs);

FVID_control

FVID_control作用：发送一个控制命令到mini_driver

语法: status = FVID_control (fvidChan, cmd, args);

参数: FVID_HandlefvidChan            /*handle to an instance of the device */
             Intcmd                        /* control command */
             Ptrargs                       /* pointer to control command arguments */
             Return Value Int status /* returns IOM_COMPLETED if successful */

参数说明:fvidChan 是FVID_create()创建的指向通道的句柄.
                cmd有两个值:IOM_ABORT----作用是中止所以的未定的I/O工作
                            IOM_FLUSH----作用是所以采集口的工作被丢弃,所以显示I/O的工作正常进行.

The args argument is a pointer to the argument orstructure of arguments that
are specific to the command being passed.

返回值:如果调用成功,FVID_control返回IOM_COMPLETED .如果有错误产生,这个调用会返回一个负值.

Example:
/* abort all pending video driver I/O jobs */
FVID_control(fvidChan, IOM_ABORT, NULL);