RDK中的Vps_printf()与Vps_rprintf()

=======================================================================================================

转载请注明原文地址：http://blog.csdn.net/crushonme/article/details/16105261

=======================================================================================================

       最近在TI的e2e以及相关QQ群众讨论时很多同学在做DSP算法或者在使用中断时SYS/BIOS被异常挂起，最终分析下来的原因是因为在中断上下文中使用了Vps_printf()或者是在禁止中断后恢复中断前的期间内使用了Vps_printf()，即hwi_disable()和hwi_restore()的上下文中使用。

       在TI提供的RDK（包括DVRRDK和IPNCRDK）中Ducati-M3和DSP中运行的实时操作系统为SYS/BIOS，在SYS/BIOS中输出到串口的打印API为System_printf()。提供的能输出到linux串口的API即为Vps_printf()和Vps_rprintf()。

       下面我们来分析下Vps_printf()和Vps_rprintf的源代码和相关限制。

       首先我们来看下两个API的实现代码：

int Vps_printf(char *format, ...){    int retVal;    va_list vaArgPtr;    char *buf = NULL;    UInt32 cookie;    cookie = Hwi_disable();    buf = &gRemoteDebug_serverObj.printBuf[0];    va_start(vaArgPtr, format);    vsnprintf(buf, REMOTE_DEBUG_SERVER_PRINT_BUF_LEN, format, vaArgPtr);    va_end(vaArgPtr);    retVal = RemoteDebug_serverPutString(gRemoteDebug_serverObj.coreId, buf);    Hwi_restore(cookie);    if (BIOS_getThreadType() == BIOS_ThreadType_Task)    {        /* Printf should be called only from Task context as it does pend.         * Calling from other context will cause exception         */        System_printf(buf);    }    return (retVal);}

int Vps_rprintf(char *format, ...){    int retVal;    va_list vaArgPtr;    char *buf = NULL;    UInt32 cookie;    cookie = Hwi_disable();    buf = &gRemoteDebug_serverObj.printBuf[0];    va_start(vaArgPtr, format);    vsnprintf(buf, REMOTE_DEBUG_SERVER_PRINT_BUF_LEN, format, vaArgPtr);    va_end(vaArgPtr);    retVal = RemoteDebug_serverPutString(gRemoteDebug_serverObj.coreId, buf);    Hwi_restore(cookie);    return (retVal);}

       由上面两端代码可以很明显的看出Vps_printf()和Vps_rprintf()的前半部分都是讲输出到共享内存中供A8侧打印线程输出，唯一的区别就是Vps_printf()会判断当前thread类型是否是Task，如果是Task则调用SYS/BIOS下的System_printf()，将数据输出到对应处理器的串口或者是Circular Buffer中。

       在Vps_printf()中有下列注释：

        /* Printf should be called only from Task context as it does pend.         * Calling from other context will cause exception         */

即表示Vps_printf()只能被用于Task任务类型的thread，在其他类型的thread中会导致异常情况。（thread未翻译成线程，因为这里的thread和我们通常理解的线程有差异）

      此外，需要注意的是在Vps_printf()和Vps_rprintf()的实现中均需要屏蔽硬件中断，因此不能用于硬件中断类型的thread。下面有个童鞋使用的错误的例子：

注：

1、在SYS/BIOS下线程可以分为以下几类，如下图所示：

2、SYS/BIOS下的System_printf()可以配制成两种模式，一种是输出到串口，另一种是将内容输出到SYS/BIOS下配置的静态circular buffer中。System_printf()的静态circular buffer配置及输出方式配置如下图所示：

相关文档：

1、SYS/BIOS wiki：http://processors.wiki.ti.com/index.php?title=Category:SYSBIOS

2、SYS/BIOS API： http://software-dl.ti.com/dsps/dsps_public_sw/sdo_sb/targetcontent/sysbios/6_21_01_16/exports/docs/docs/cdoc/ti/sysbios/BIOS.html#.Thread.Type

3、e2e问答：http://e2e.ti.com/support/development_tools/code_composer_studio/f/81/t/43747.aspx

http://e2e.ti.com/support/embedded/bios/f/355/t/224754.aspx