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

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进行显示。