1）实验平台：正点原子APM32E103最小系统板
2）平台购买地址：https://detail.tmall.com/item.htm?id=609294757420
3）全套实验源码+手册+视频下载地址： http://www.openedv.com/docs/boards/xiaoxitongban
USMART调试组件是正点原子开发的一款灵巧的串口调试交互组件，其功能类似Linux的Shell，支持通过串口调用程序中的任意函数，对调试代码有很大的帮助。通过本章的学习，读者将学习到USMART调试组件的使用。
本章分为如下几个小节：
26.1 硬件设计
26.2 程序设计
26.3 下载验证
26.1硬件设计
26.1.1 例程功能
/**
* @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进行显示。