【正点原子STM32连载】第二十六章 USMART调试实验 摘自【正点原子】APM32E103最小系统板使用指南

发布时间:2024年01月06日

1)实验平台:正点原子APM32E103最小系统板
2)平台购买地址:https://detail.tmall.com/item.htm?id=609294757420
3)全套实验源码+手册+视频下载地址: http://www.openedv.com/docs/boards/xiaoxitongban

第二十六章 USMART调试实验

USMART调试组件是正点原子开发的一款灵巧的串口调试交互组件,其功能类似Linux的Shell,支持通过串口调用程序中的任意函数,对调试代码有很大的帮助。通过本章的学习,读者将学习到USMART调试组件的使用。
本章分为如下几个小节:
26.1 硬件设计
26.2 程序设计
26.3 下载验证

26.1硬件设计
26.1.1 例程功能

  1. 通过USMART调用程序中的函数,实现对LCD、LED和延时操作
  2. LED0闪烁,指示程序正在运行
    26.1.2 硬件资源
  3. LED
    LED0 - PB5
  4. USART1(PA9、PA10连接至板载USB转串口芯片上)
  5. 定时器4
  6. 正点原子 2.8/3.5/4.3/7/10寸TFTLCD模块(仅限MCU屏,16位8080并口驱动)
    26.1.3 原理图
    本章实验使用的USMART组件为应用软件,因此没有对应的连接原理图。
    26.2 程序设计
    26.2.1 USMART组件
    使用USMART组件需要先进行相应的移植操作,USMART组件的移植也非常简单,只需要实现usmart_port.c文件中的5个函数即可完成移植。
    第一个函数为usmart_get_input_string(),该函数用于USMART获取串口输入的数据流,该函数的实现,如下所示:
/**
 * @brief     获取输入数据流(字符串)
 * @note      USMART通过解析该函数返回的字符串以获取函数名及参数等信息
 * @param     无
 * @retval
 * @arg       0,  没有接收到数据
 * @arg       其他,数据流首地址(不能是0)
 */
char *usmart_get_input_string(void)
{
    uint8_t len;
    char *pbuf = 0;

    if (g_usart_rx_sta & 0x8000)        /* 串口接收完成 */
    {
        len = g_usart_rx_sta & 0x3fff;  /* 得到此次接收到的数据长度 */
        g_usart_rx_buf[len] = '\0';     /* 在末尾加入结束符 */
        pbuf = (char*)g_usart_rx_buf;
        g_usart_rx_sta = 0;             /* 开启下一次接收 */
    }

    return pbuf;
}

从上面的代码中可以看出,该函数就是从SYSTEM文件夹USART驱动中获取USART1输入的数据。
剩余的四个函数,在宏USMART_ENTIMX_SCAN开启后才需要定义,该宏用于使能runtime统计等功能。
第二个函数为usmart_timx_reset_time(),该函数用于复位runtime,该函数的实现,如下所示:

/**
 * @brief       复位runtime
 * @note        需要根据所移植到的MCU的定时器参数进行修改
 * @param       无
 * @retval      无
 */
void usmart_timx_reset_time(void)
{
    TMR_ClearIntFlag(USMART_TIMX, TMR_INT_UPDATE);  /* 清除中断标志位 */
    TMR_ConfigAutoreload(USMART_TIMX, 0xFFFF);      /* 将重装载值设置到最大 */
    TMR_ConfigCounter(USMART_TIMX, 0);              /* 清空定时器的CNT */
    usmart_dev.runtime = 0;
}

该函数复位了runtime功能和用于runtime功能的相关TMR。
第三个函数为usmart_timx_get_time(),用于runtime功能获取时间,该函数的实现,如下所示:

/**
 * @brief       获得runtime时间
 * @note        需要根据所移植到的MCU的定时器参数进行修改
 * @param       无
 * @retval      执行时间,单位:0.1ms,最大延时时间为定时器CNT值的2倍*0.1ms
 */
uint32_t usmart_timx_get_time(void)
{
/* 在运行期间,产生了定时器溢出 */
    if (TMR_ReadIntFlag(USMART_TIMX, TMR_INT_UPDATE) == SET)
    {
        usmart_dev.runtime += 0XFFFF;
    }
    usmart_dev.runtime += TMR_ReadCounter(USMART_TIMX);
    return usmart_dev.runtime;                                 /* 返回计数值 */
}

应为该函数能够处理一次定时器的溢出情况,因此能获取到的时间上限为定时器计数最大值的两倍。
第四个函数为usmart_timx_init(),用于初始化用于runtime功能的定时器,该函数的实现,如下所示:

/**
 * @brief       定时器初始化函数
 * @param       arr:自动重装载值
 *              psc:定时器分频系数
 * @retval      无
 */ 
void usmart_timx_init(uint16_t arr, uint16_t psc)
{
    TMR_BaseConfig_T tmr_init_struct;
    
    USMART_TIMX_CLK_ENABLE();
    
    tmr_init_struct.countMode = TMR_COUNTER_MODE_UP;    /* 向上计数器 */
    tmr_init_struct.clockDivision = TMR_CLOCK_DIV_1;
    tmr_init_struct.period = arr;                       /* 自动装载值 */
    tmr_init_struct.division = psc;                     /* 分频系数 */
    TMR_ConfigTimeBase(USMART_TIMX, &tmr_init_struct);
    NVIC_EnableIRQRequest(USMART_TIMX_IRQn, 3, 0);
    
    TMR_EnableInterrupt(USMART_TIMX, TMR_INT_UPDATE);
    TMR_Enable(USMART_TIMX);
}

可以看到,该函数初始化了一个用于runtime功能的定时器,同时使能了该定时器的更新中断。
第五个函数就是用于runtime功能的定时器的中断服务函数,该函数的实现,如下所示:

/**
 * @brief       USMART定时器中断服务函数
 * @param       无
 * @retval      无
 */
void USMART_TIMX_IRQHandler(void)
{
    if (TMR_ReadIntFlag(USMART_TIMX, TMR_INT_UPDATE) == SET)/* 溢出中断 */
    {
        usmart_dev.scan();                                  /* 执行usmart扫描 */
        TMR_ConfigCounter(USMART_TIMX, 0);                  /* 清空定时器的CNT */
        TMR_ConfigAutoreload(USMART_TIMX, 100);             /* 恢复原来的设置 */
    }
    
    TMR_ClearIntFlag(USMART_TIMX, TMR_INT_UPDATE);          /* 清除中断标志位 */
}

以上就是移植USMART组件时需要实现的五个函数,至此USMART组件的移植也就基本完成了,接下来便可在usart_config.c文件中的usmart_nametab数组中添加需要调试的函数。
26.2.2 实验应用代码
本实验的应用代码,如下所示:

/**
 * @brief       LED状态设置
 * @param       无
 * @retval      无
 */
void led_set(uint8_t sta)
{
    LED1(sta);
}

/**
 * @brief       测试函数参数调用
 * @param       无
 * @retval      无
 */
void test_fun(void (*ledset)(uint8_t), uint8_t sta)
{
    ledset(sta);
}

int main(void)
{
    NVIC_ConfigPriorityGroup(NVIC_PRIORITY_GROUP_4);  /* 设置中断优先级分组为组4 */
    sys_apm32_clock_init(15);                         /* 配置系统时钟 */
    delay_init(120);                                  /* 初始化延时功能 */
    usart_init(115200);                               /* 初始化串口 */
    usmart_dev.init(120);                             /* 初始化USMART */
    led_init();                                       /* 初始化LED */
    lcd_init();                                       /* 初始化LCD */
    
    lcd_show_string(30, 50, 200, 16, 16, "APM32", RED);
    lcd_show_string(30, 70, 200, 16, 16, "USMART TEST", RED);
    lcd_show_string(30, 90, 200, 16, 16, "ATOM@ALIENTEK", RED);
    
    while (1)
    {
        LED0_TOGGLE();
        delay_ms(500);
    }
}

从上面的代码中可以看出,main()函数中初始化了USMART组件,并且另外定义了两个函数,分别为:函数led_set()和函数test_fun(),这两个函数都被添加到了usmart_config.c文件的usmart_nametab数组中,用于测试USMART组件,同时也添加了LCD操作和延时等函数,读者也可以添加自行编写的函数进行测试和调试。
26.3 下载验证
在完成编译和烧录操作后,便可通过串口调试助手“体验”USMART组件,例如通过串口调试助手发送“led_set(0)\r\n”或“led_set(1)\r\n”,即可看到板载的LED1亮起或熄灭,也可使用同样的方式调用LCD的操作函数操作LCD进行显示。

文章来源:https://blog.csdn.net/weixin_55796564/article/details/135428357
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。