1. Uart介绍

1.1 串口资源介绍

EASY EAI Nano-TB开发板的串口资源被划分为两类。一类是已被特定功能所占用的【不可用串口】，另外一个类可由用户自由使用的【可用串口】。

【不可直接使用的串口】分布情况如下所示。

串口号	设备节点	描述
串口0	/dev/ttyFIQ0	调试串口占用，不作为普通串口使用
串口1	无	串口所关联的引脚，已被复用成其他功能
串口3~5	无	串口所关联的引脚，已被复用成其他功能

硬件分布情况如下所示。

【可用串口】分布情况如下所示。

串口号	设备节点	描述
串口2	/dev/ttyS2	TTL电平。
串口6	/dev/ttyS6	TTL电平。
串口7	/dev/ttyS7	TTL电平。

硬件分布情况如下所示。

1.2 硬件接线

常规接线，设备与设备进行通信：

本单例测试接线，利用跳线帽把Rxd引脚与Txd引脚短接，进行自发自收。

2. 快速上手

2.1 开发环境准备

如果您初次阅读此文档，请阅读《入门指南/开发环境准备/Easy-Eai编译环境准备与更新》，并按照其相关的操作，进行编译环境的部署。

在PC端Ubuntu系统中执行run脚本，进入EASY-EAI编译环境，具体如下所示。

cd ~/develop_environment
./run.sh

2.2 源码下载以及例程编译

首先，在虚拟机后台终端，执行以下命令，创建外设单例源码管理目录：

cd /opt
mkdir -p EASY-EAI-Nano-TB/demo

首先，到【百度网盘】上下载相关的单例程序：

链接：https://pan.baidu.com/s/1Br608Hiff2Xs65PzWO_qWQ?pwd=1234

提取码：1234

比如把单例程序下载到：此电脑\D:\BaiduNetdisk (无规定，用户可自主选择)，如下图所示。

再将下载好的单例复制进入虚拟机的文件系统，过程如下图所示。

最后，进入到对应的例程目录执行编译操作，具体命令如下所示：

cd EASY-EAI-Nano-TB/demo/06_UART
./build.sh

注：

* 由于依赖库部署在板卡上，因此交叉编译过程中必须保持/mnt挂载。

编译成功后，会生成2个叫可执行程序在Release目录，并会自动部署到开发板的/userdata/目录中。它们分别是发送端demo：test-Send，接收端demo：test-Recv。

2.3 例程运行

通过串口调试或ssh调试，进入板卡后台，定位到例程部署的位置，如下所示：

cd /userdata

先执行下方命令以【后台运行】【接收端】demo，如下所示。

sudo ./test-Recv /dev/ttyS2 &

执行效果如下所示，此时接收端会等待发送端发来数据。

再执行下方命令以运行【发送端】demo，如下所示。

sudo ./test-Send /dev/ttyS2

3. C语言使用案例

串口的C语言使用案例，接收端代码地址为06_UART/test-uart/Recv.c，供用户编码参考。以下代码展示了对串口接收端操作流程：

int main(int argc, char **argv)
{
    if(2 != argc){
        printf("Usage:\n");
        printf("    sudo %s %s\n", argv[0], "/dev/ttyS<2/6/7>");
        return -1;
    }

    int fd = UART_Open(argv[1]);
    if(fd < 0){
        printf("\033[33m【Open ERROR!】%s\n", DEBUG_COLOR_TAIL);
        return -1;
    }
    
    if(false == UART_Set(fd, 115200, 0, 8, 1, 'N')){
        printf("\033[33m【Init ERROR!】%s\n", DEBUG_COLOR_TAIL);
        return -1;
    }
    
    const char *strReceiver = "I am uart Receiver";
    printf("\033[36m【Init OK \"%s\"】%s\n", strReceiver, DEBUG_COLOR_TAIL);

    char recvBuf[128]={0};
    while(1){
        if(UART_Recv(fd, recvBuf, sizeof(recvBuf)) <= 0){
            continue;
        }else{
            printf("\033[36m【Recv Msg from Sender】:%s",   DEBUG_COLOR_TAIL);
            printf("    %s\n", recvBuf);
            break;
        }
    }
    UART_Close(fd);
    
    printf("\033[42m【Recv date OK. BYE BYE!】%s\n", DEBUG_COLOR_TAIL);
    
	return 0;
}

发送端代码地址为06_UART/test-uart/Send.c，供用户编码参考。以下代码展示了对串口发送端操作流程：

int main(int argc, char **argv)
{
    if(2 != argc){
        printf("Usage:\n");
        printf("    sudo %s %s\n", argv[0], "/dev/ttyS<2/6/7>");
        return -1;
    }

    int fd = UART_Open(argv[1]);
    if(fd < 0){
        printf("\033[33m【Open ERROR!】%s\n", DEBUG_COLOR_TAIL);
        return -1;
    }
    
    if(false == UART_Set(fd, 115200, 0, 8, 1, 'N')){
        printf("\033[33m【Init ERROR!】%s\n", DEBUG_COLOR_TAIL);
        return -1;
    }
    
    char *strSender = "I am uart Sender";
    printf("\033[36m【Init OK \"%s\"】%s\n", strSender, DEBUG_COLOR_TAIL);
    
    int len = UART_Send(fd, strSender, strlen(strSender));
    if(len <= 0){
        printf("\033[41m【Send data ERROR!】%s\n", DEBUG_COLOR_TAIL);
        return -1;
    }
    UART_Close(fd);
    
    printf("\033[42m【Send date OK. BYE BYE!】%s\n", DEBUG_COLOR_TAIL);
    
	return 0;
}

其中UART_Open()，UART_Set()，UART_Send()，UART_Recv()是对系统调用的易用化封装。具体实现于06_UART/commonApi/uart.c