DM6437中的PSP库介绍

 

TMS320DM6437芯片中，TI公司并不提供的CSL(Chip Support Library)进行编程操作，而是改用PSP(Proeessor Support Package)。PSP是一种针对目标芯片进行硬件操作而在上层提供的复杂任务控制软件包，例如外设I/O传输等。每个PSP对应一个设备，如DM6437拥有自己的PSP。在DSP/BIOS中PSP的基本功能是对所有外设进行设置，这些驱动以库的形式被提供，能够被链接到应用程序中。PSP驱动由多层构成。

1、DDA层（Device Driver Adapter）

DDA层是操作系统的驱动接口。它执行IOM调用到适当的、低层的（DDC）功能调用。它的唯一目的就是解析操作系统的功能性内核驱动。

2、DDC层（Device driver core）

DDC层是驱动的心脏。DDC层处理处理核心的驱动特性，与设备相关和操作系统相关的操作则调用其它的功能层。因此，改变DDC层是唯一的步骤来改变或加强驱动器性能。

3、LLC层（Low Level Controller）

LLC层通过芯片支持库（CSL）与外设直接交互。但是LLC层并不包含在所有PSP驱动中，一些驱动器直接在DDC层中执行LLC层的功能。

4、PAL OS

为操作系统服务的平台抽象层（PALOS）允许DDC层使用基本的操作系统功能，例如旗标处理和中断设置等。通过使用PALOS功能替代直接调用DSP/BIOS模块，DDC层可以从操作系统中提取出来。PALOS是一个单独的库，要包括PSP的安装，可以被多个驱动使用。

 

 

DSP视频驱动中FVID函数的用法 

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

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

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

参数定义：

String name            /* handle to an instance of the device */

Int mode               /* pointer to buffer allocated by driver */

Int *status            /* pointer to size of buffer pointed to by */

Ptr optArgs            /* */

FVID_Attrs *attrs      /* */

其中:

name是设备实例的句柄,是一个字符串mode 是选择的模式,只有两个值:IOM_INPUT 设置采集模式,IOM_OUTPUT设置显示模式。

status是由下层mini driver返回的状态值。

attrs 是指向FVID_Attrs结构的指针:

FVID_Attrs的定义如下:

typedef struct FVID_Attrs {

                          Uns timeout;

                          } FVID_Attrs;

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

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

数字的timeout值会让这些APIs阻塞一段指定的时间(以系统时钟). 0值会让APIs不阻塞,他们会立刻返回,这种情况下,应用程序会检查返回的status值来保证调用已经成功完成.

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

FVID_create的返回值:

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

实列：

/* Initialize the attributes */

FVID_ATTRS dispAttrs = FVID_ATTRS;

/* Create an instance to a video display device */ chan-

Handle = FVID_create(“\display< XMLNAMESPACE PREFIX ="ST1" />0”, IOM_INPUT, NULL, NULL,&dispAttrs);

FVID_control()作用是:发送一个控制命令给下层的mini_driver

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

参数定义:

　　　FVID_Handle fvidChan    /* handle to an instance of the device */

      Int cmd                 /* control command */

      Ptr args                /* 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的工作正常进行。

　　　　Args　是要传递的命令(参数或者结构体)的指针。

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

实例：

/* abort all pending video driver I/O jobs */

FVID_control(fvidChan, IOM_ABORT, NULL);

FVID-alloc()作用：申请获得驱动程序缓存单元。

语法：status = FVID_alloc (fvidChan, bufp);

参数定义：

       FVID_Handle fvidChan /* handle to an instance of the device */

       Ptr bufp /* pointer to buffer allocated by driver */

       Return Value Int status /* returns IOM_COMPLETED if successful */

参数说明：

       fvidChan 是FVID_create()创建的指向通道的句柄。

       bufp 是输出参数，指向所申请的驱动缓存空间的指针。

       返回值：如果调用成功,FVID_alloc()返回IOM_COMPLETED，如果有错误产生,这个调用会返回一个负值。

       备注：这个函数只能是在外设已经加载和初始化之后才能调用。其中的句柄应该由FVID_create()函数提供。

       实例：

/* allocate a buffer from the device */

status = FVID_alloc(chanHandle, dispBuf);

FVID_exchange()作用：交换应用程序和驱动程序缓存空间，实际作用相当于FVID_free()和FVID_alloc()函数的组合。

语法： status = FVID_exchange (fvidChan, bufp);

参数定义：

      FVID_Handle fvidChan /* handle to an instance of the device */

      Ptr bufp /* pointer to buffer exchanged by driver */

      LgUns *pSize /* pointer to size of buffer pointed to by bufp */

参数说明：

      fvidChan 是FVID_create()创建的指向通道的句柄。

      bufp 是输入输出参数，刚开始指向的是应用程序需要交换的缓存空间，交换后，指向与驱动程序进行缓存空间交换后的内存空间。

      pSize 是指向bufp内存大小的指针。

返回值：如果调用成功,FVID_exchange()返回IOM_COMPLETED，如果有错误产生,这个调用会返回一个负值。

      备注：这个函数只能是在外设已经加载和初始化之后才能调用。其中的句柄应该由FVID_create()函数提供。

实例：

/* allocate a buffer from the device */

status = FVID_exchange(chanHandle, dispBuf);

FVID_free()作用：释放返回应用程序申请的缓存给驱动程序

语法： status = FVID_free (fvidChan, bufp);

参数定义：

       FVID_Handle fvidChan /* handle to an instance of the device */

       Ptr bufp /* pointer to buffer to be relinquished to driver */

       LgUns *pSize /* pointer to size of buffer pointed to by bufp */

参数说明：

      fvidChan 是FVID_create()创建的指向通道的句柄。

      bufp 是输入参数，指向的是应用程序需要释放返回的缓存空间。

      pSize 是指向bufp内存大小的指针。

返回值：如果调用成功,FVID_free()返回IOM_COMPLETED，如果有错误产生,这个调用会返回一个负值。

备注：这个函数只能是在外设已经加载和初始化之后才能调用。其中的句柄应该由FVID_create()函数提供。

实例：

Example /* free a buffer back to the device */

status = FVID_free(chanHandle, dispBuf);

FVID_delete()作用： 申请关闭一个FVID channel 对象。

语法： status = FVID_delete (fvidChan);

参数定义：

       FVID_Handle fvidChan /* handle to an instance of the device */

参说说明：

       fvidChan 是FVID_create()创建的指向通道的句柄。

返回值：如果调用成功,FVID_delete()返回IOM_COMPLETED，如果有错误产生,这个调用会返回一个负值。

备注：这个函数只能是在外设已经加载和初始化之后才能调用。其中的句柄应该由FVID_create()函数提供。

实例：

Example /* allocate a buffer from the device */

status = FVID_delete(chanHandle）

关于FVID的queue和deque  
VPFE,VPBE的driver维护了两个队列一个叫READY,一个叫FREE。queue操作就是将一个缓冲区放入READY队列中，然后等待driver去填充它（这是由硬件自动完成的），在driver填充完后，若是READY里还有空闲的缓冲（这就决定了必须要分配有两个以上的缓冲），则driver将这个填充满的缓冲放到FREE队列中，而dequeue操作则是从FREE队列中获得已经填充好了的缓冲给应用程序。VPFE的dequeue是从driver获得一个捕捉到的帧，VPBE的queue则是将一个帧交由driver去显示。