emwin和rtthread的api函数 rtthread例程

一、串口设备使用示例–中断接收及轮询发送

串口数据接收和发送数据的模式分为 3 种：中断模式、轮询模式、DMA 模式。在使用的时候，这 3 种模式只能选其一，若串口的打开参数 oflags 没有指定使用中断模式或者 DMA 模式，则默认使用轮询模式

示例代码的主要步骤如下所示：

1.首先查找串口设备获取设备句柄。

2.初始化回调函数发送使用的信号量，然后以读写及中断接收方式打开串口设备。

3.设置串口设备的接收回调函数，之后发送字符串，并创建读取数据线程。

4.读取数据线程会尝试读取一个字符数据，如果没有数据则会挂起并等待信号量，当串口设备接收到一个数据时会触发中断并调用接收回调函数，此函数会发送信号量唤醒线程，此时线程会马上读取接收到的数据。

5.此示例代码不局限于特定的 BSP，根据 BSP 注册的串口设备，修改示例代码宏定义 SAMPLE_UART_NAME 对应的串口设备名称即可运行。

运行序列图如下图所示：

二、验证

app_uart2.c

/*
 * Copyright (c) 2006-2020, RT-Thread Development Team
 *
 * SPDX-License-Identifier: Apache-2.0
 *
 * Change Logs:
 * Date           Author       Notes
 * 2020-04-14     David       the first version
 */

#include "app_uart2.h"

#define SAMPLE_UART_NAME       "uart2"

/* 用于接收消息的信号量 */
static struct rt_semaphore rx_sem;
static rt_device_t serial;

/* 接收数据回调函数 */
static rt_err_t uart_input(rt_device_t dev, rt_size_t size)
{
    /* 串口接收到数据后产生中断，调用此回调函数，然后发送接收信号量 */
    rt_sem_release(&rx_sem);

    return RT_EOK;
}


static void serial_thread_entry(void *parameter)
{
    char ch;

    while (1)
    {
        /* 从串口读取一个字节的数据，没有读取到则等待接收信号量 */
        while (rt_device_read(serial, -1, &ch, 1) != 1)
        {
            /* 阻塞等待接收信号量，等到信号量后再次读取数据 */
            rt_sem_take(&rx_sem, RT_WAITING_FOREVER);
        }
        /* 读取到的数据通过串口输出 */
        rt_device_write(serial, 0, &ch, 1);
    }
}

void CreatUart2TestEntry(void)
{
    char str[] = "hello RT-Thread666!\r\n";
    /* 查找系统中的串口设备 */
       serial = rt_device_find(SAMPLE_UART_NAME);
       if (!serial)
       {
           rt_kprintf("find %s failed!\n", SAMPLE_UART_NAME);

       }

       /* 初始化信号量 */
       rt_sem_init(&rx_sem, "rx_sem", 0, RT_IPC_FLAG_FIFO);
       /* 以中断接收及轮询发送模式打开串口设备 */
       rt_device_open(serial, RT_DEVICE_FLAG_INT_RX);
       /* 设置接收回调函数 */
       rt_device_set_rx_indicate(serial, uart_input);
       /* 发送字符串 */
       rt_device_write(serial, 0, str, (sizeof(str) - 1));

       /* 创建 serial 线程 */
       rt_thread_t thread = rt_thread_create("serial", serial_thread_entry, RT_NULL, 1024, 25, 10);
       /* 创建成功则启动线程 */
       if (thread != RT_NULL)
       {
           rt_thread_startup(thread);
       }
       else
       {
           rt_kprintf("Create %s Entry failed!\n", SAMPLE_UART_NAME);
       }

}

app_uart2.h

/*
 * Copyright (c) 2006-2020, RT-Thread Development Team
 *
 * SPDX-License-Identifier: Apache-2.0
 *
 * Change Logs:
 * Date           Author       Notes
 * 2020-04-14     CRJ       the first version
 */
#ifndef APPLICATIONS_APP_UART2_H_
#define APPLICATIONS_APP_UART2_H_

#include <rtthread.h>

extern void CreatUart2TestEntry(void);


#endif /* APPLICATIONS_APP_UART2_H_ */

main.c

/*
 * Copyright (c) 2006-2019, RT-Thread Development Team
 *
 * SPDX-License-Identifier: Apache-2.0
 *
 * Change Logs:
 * Date           Author       Notes
 * 2019-09-09     RT-Thread    first version
 */

#include <rtthread.h>
#include <board.h>
#include <rtdevice.h>
#include "app_uart2.h"

#define DBG_TAG "main"
#define DBG_LVL DBG_LOG
#include <rtdbg.h>


int main(void)
{
    CreatUart2TestEntry();
    return RT_EOK;
}