【STM32F407】第9章 RL-TCPnet V7.X调试方法(Event Recorder和串口两种)

时间:2022-07-24
本文章向大家介绍【STM32F407】第9章 RL-TCPnet V7.X调试方法(Event Recorder和串口两种),主要内容包括其使用实例、应用技巧、基本知识点总结和需要注意事项,具有一定的参考价值,需要的朋友可以参考一下。

最新教程下载:http://www.armbbs.cn/forum.php?mod=viewthread&tid=95243

第9章   RL-TCPnet调试方法(Event Recorder和串口两种)

本章节为大家讲解RL-TCPnet的调试方法,RL-TCPnet的调试功能可以通过串口打印和Event Recoder实时监控运行状态。而且RL-TCPnet的调试设置比较简单,因为官方已经为我们做好了调试版本的库,直接添加到工程,并使能相应的宏配置就可以使用了。

9.1 初学者重要提示

9.2 RL-TCPnet支持的调试版本

9.3 RL-TCPnet调试方法设置(串口打印)

9.4 RL-TCPnet调试方法设置(Event Recorder)

9.5 实验例程说明

9.6 总结

9.1   初学者重要提示

  1.   本章节讲解的内容相对比较简单,主要是配置Net_Debug.c文件即可。由于Net_Debug.c文件中可以使能的选项较多,实际测试中使能太多的话,会打印出非常多的信息,完全看不过来,所以实际测试的时候最好需要调试哪些功能,就开启哪些选项。
  2.   本章节使用的例子是由前面移植章节配套的例子简单修改而来。另外,对于本章节配套的例子,大家仅需要知道如何使能调试功能即可,具体代码实现的功能会在后面章节逐渐讲解。
  3.   如果不熟悉Event Recorder的使用,务必看下V5用户手册的第8章。http://www.armbbs.cn/forum.php?mod=viewthread&tid=93255

9.2   RL-TCPnet支持的调试版本

KEIL官方提供的库有如下几个版本:

  •   IPv4 Debug和IPv4/IPv6 Debug

这两个版本用于Event Recoder的调试。

  •   IPv4 Debug STDIO和IPv4/IPv6 Debug STDIO

这两个版本用于串口调试。

  •   IPv4 Release和IPv4/IPv6 Release

这两个是正式发布版本。

9.3   RL-TCPnet调试方法设置(串口打印)

下面分步进行说明RL-TCPnet的串口调试方法。

9.3.1      第1步,添加串口调试版本的RL-TCPnet库

选择库文件IPv4/IPv6 Debug STDIO

9.3.2      第2步,设置使用User模式的IO输出

设置后,用户就可以设置串口输出数据。

9.3.3      第3步,使用串口重定向函数stdout_putchar

RL-TCPnet的调试功能就是通过调用函数printf实现打印功能,所以需要我们做一个串口重定向,也就是修改函数stdout_putchar(特别注意,如果程序里面有fputc函数的重定向,请注释掉)。只不过这里稍有区别,对于换行符 n 要特殊处理下,将其修改成回车符 r 。否则打印出来的消息会错行,比较混乱。

int stdout_putchar (int ch)
{
#if 0  /* 将需要printf的字符通过串口中断FIFO发送出去,printf函数会立即返回 */
    comSendChar(COM1, ch);
    
    return ch;
#else    /* 采用阻塞方式发送每个字符,等待数据发送完毕 */
    /* 使用了RL-TCPnet网络协议栈,这里特别调整下 */
    if (ch == 'n')  
    {
        /* 写一个字节到USART1 */
        USART1->TDR = 'r';

        /* 等待发送结束 */
        while((USART1->ISR & USART_ISR_TC) == 0){}
    }
    
    /* 写一个字节到USART1 */
    USART1->TDR = ch;
    
    /* 等待发送结束 */
    while((USART1->ISR & USART_ISR_TC) == 0){}
    
    return ch;
#endif    
}
int stdout_putchar (int ch)
{
#if 0  /* 将需要printf的字符通过串口中断FIFO发送出去,printf函数会立即返回 */
    comSendChar(COM1, ch);
    
    return ch;
#else    /* 采用阻塞方式发送每个字符,等待数据发送完毕 */
    /* 使用了RL-TCPnet网络协议栈,这里特别调整下 */
    if (ch == 'n')  
    {
        /* 写一个字节到USART1 */
        USART1->TDR = 'r';

        /* 等待发送结束 */
        while((USART1->ISR & USART_ISR_TC) == 0){}
    }
    
    /* 写一个字节到USART1 */
    USART1->TDR = ch;
    
    /* 等待发送结束 */
    while((USART1->ISR & USART_ISR_TC) == 0){}
    
    return ch;
#endif    
}

9.3.4      第4步,调试级别配置

(重要说明,RL-TCPnet的调试是通过串口打印出来的)

RL-TCPnet的调试功能是通过配置文件Net_Debug.c实现。在MDK工程中打开文件Net_Debug.c,可以看到下图所示的工程配置向导:

  • Print Time Stamp

勾选了此选项的话,打印消息时,前面会附带时间信息。

  • 其它所有的选项

默认情况下,所有的调试选项都是关闭的,每个选项有三个调试级别可选择,这里我们以Memory Management为例,点击下拉列表,可以看到里面有Off,Errors only和Full debug三个调试级别可供选择,每个调试选项里面都是这三个级别。

Off:表示关闭此选项的调试功能。

Errors only:表示仅在此选项出错时,将其错误打印出来。

Full debug:表示此选项的全功能调试。

9.3.5      第5步,实际效果

下面开启如下几个选项的全功能调试(Application Debug Definitions的所有选项都是关闭的,没有开启):

实际应用时,要调试哪方面功能的时候,打开哪些选项,否则打印出来的信息非常多,显示效果如下:

9.4   RL-TCPnet调试方法设置(Event Recorder)

下面分步说明RL-TCPnet的Event Recorder调试方法。关于JLINK,STLINK,CMSIS-DAP使用Event Recorder的注意事项在V5开发板用户手册的8章节有详细说明:

http://www.armbbs.cn/forum.php?mod=viewthread&tid=93255

9.4.1      第1步,添加Event Recorder调试版本的RL-TCPnet库

选择库文件IPv4/IPv6 Debug。

9.4.2      第2步,设置使用Event Recorder模式的IO输出

使能bsp.h文件里面的宏定义,0表示禁止Event Recorder,1表示使能。

这个宏定义控制的是bsp.c文件里面的Event Recorder的初始化。

#if Enable_EventRecorder == 1  
    /* 初始化EventRecorder并开启 */
    EventRecorderInitialize(EventRecordAll, 1U);
    EventRecorderStart();
#endif

设置完毕后,配置STDOUT使用Event Recorder。

9.4.3      第3步,调试级别配置

(重要说明,RL-TCPnet的调试是通过串口打印出来的)

RL-TCPnet的调试功能是通过配置文件Net_Debug.c实现。在MDK工程中打开文件Net_Debug.c,可以看到下图所示的工程配置向导:

  • Print Time Stamp

勾选了此选项的话,打印消息时,前面会附带时间信息。

  • 其它所有的选项

默认情况下,所有的调试选项都是关闭的,每个选项有三个调试级别可选择,这里我们以Memory Management为例,点击下拉列表,可以看到里面有Off,Errors only和Full debug三个调试级别可供选择,每个调试选项里面都是这三个级别。

Off:表示关闭此选项的调试功能。

Errors only:表示仅在此选项出错时,将其错误打印出来。

Full debug:表示此选项的全功能调试。

9.4.4      第4步,实际效果

打开RL-TCPnet的调试组件:

效果如下:

Event Recorder组件:

效果如下:

9.5   实验例程说明

本章节仅仅是教会大家调试方法,具体实验内容还不做讲解,仅需学会调试功能的开启方法即可。

本章节配套了如下几个例子:

具体网络工程的测试看第7章的7.14小节或者第8章的8.14章节均可。

9.6   总结

本章节为大家讲解这么多,建议实际操作演练下,实践出真知。