HaaS100串口UART使用介绍

布满荆棘的人生 2022-09-05 04:28 210阅读 0赞

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0hhYVNUZWNo_size_16_color_FFFFFF_t_70][]

# 1. HaaS100串口UART硬件说明 #

HaaS100上有3个物理串口(UART)。

**1) UART 0**

UART 0是调试串口，已用USB转UART芯片转为USB口，可通过Micro USB线与电脑连接，用于串口打印及shell命令输入。同时，可以通过板子上硬件电阻切换成RS232。

UART 0调试串口在板子上的位置如下图红框所示：

![35661c0a8d83b13c7dcebbf42d686da9.png][]

UART 0作为调试口时，使用Micro USB数据线连接串口即可。

UART 0作为RS232使用时，在板子上的位置如下图所示：

![92eb7ce1f59fe8643b9d5f6d5cdd3d34.png][]

RS232由于与调试串口共用UART 0，使用时，需要修改板子上的硬件，把UART 0切换成RS232，修改方法如下：

![ba27abe5d4492da0977b7f1fd076ea67.png][]

如上图，将图示中红框中的2个焊点短接，UART0切换成RS232接口，此时USB口无法使用。

**2）UART 1**

UART 1扩展成RS485接口，如下图红框所示：

![2b4f8af3b2cd123c60d23e57012571ae.png][]

上图中标准的A、B、G表示RS485协议中的A、B和GND。

**2）UART 2 （HaaS100常用）**

UART 2为TTL，在42PIN排针上，具体位置如下图所示：

![75459f72693ccafeb9a18bd0754e46ae.png][]

# 2. 接口说明 #

UART接口在头文件include/aos/hal/uart.h中，主要接口如下表：

<table> 
 <tbody> 
 <tr> 
 <td> 接口 </td> 
 <td> 说明 </td> 
 </tr> 
 <tr> 
 <td> hal_uart_init </td> 
 <td> UART初始化，接口中设置UART的端口号、波特率、数据位宽等 </td> 
 </tr> 
 <tr> 
 <td> hal_uart_send </td> 
 <td> 通过指定UART发送数据接口 </td> 
 </tr> 
 <tr> 
 <td> hal_uart_send_poll </td> 
 <td> 该接口HaaS100上未实现 </td> 
 </tr> 
 <tr> 
 <td> hal_uart_recv </td> 
 <td> 该接口HaaS100上未实现 </td> 
 </tr> 
 <tr> 
 <td> hal_uart_recv_poll </td> 
 <td> 该接口HaaS100上未实现 </td> 
 </tr> 
 <tr> 
 <td> hal_uart_recv_II </td> 
 <td> 通过指定UART接收指定长度的串口数据 </td> 
 </tr> 
 <tr> 
 <td> hal_uart_finalize </td> 
 <td> 串口去初始化接口。 </td> 
 </tr> 
 </tbody> 
</table>

具体接口使用说明，可以参考AliOS Things接口帮助文档 [https://help.aliyun.com/document\_detail/161062.html?spm=a2c4g.11186623.6.574.64c67c26w3auXW][https_help.aliyun.com_document_detail_161062.html_spm_a2c4g.11186623.6.574.64c67c26w3auXW]

# 3. 使用案例 #

下面以UART 2使用方式为例，介绍一下UART口的使用方法。

**1）实现功能**

通过UART 2连接电脑，电脑上的串口工具输入一个字符串，按回车后，HaaS100通过UART2往电脑发送"recv="加相同的字符串。

**2）硬件连接**

UART 2为TTL接口，需要通过一个TTL转USB的转接设备连接。如下图所示：

![6261431b6839b658f3dd8e33da1c52bb.png][]

**3）软件代码**

*  串口初始化：

uart_dev_t uart_ttl = {0};
    
    void uart_test_init()
    {
        uart_ttl.port = 2;  /*ttl use uart 2*/
        uart_ttl.config.baud_rate = 115200;
        uart_ttl.config.data_width = DATA_WIDTH_8BIT;
        uart_ttl.config.flow_control = FLOW_CONTROL_DISABLED;
        uart_ttl.config.mode = MODE_TX_RX;
        uart_ttl.config.parity = NO_PARITY;
        uart_ttl.config.stop_bits = STOP_BITS_1;
        
        hal_uart_init(&uart_ttl);
    }

*  数据收送

void uart_test()
    {
        int ret       = 0;
        int recv_size = 0;
        int index     = 5;
        char buf[128] = {0};
    
        buf[0] = 'r';
        buf[1] = 'e';
        buf[2] = 'c';
        buf[3] = 'v';
        buf[4] = '=';
        while (1) {
            ret = -1;
            recv_size = 0;
            ret = hal_uart_recv_II(&uart_ttl, &buf[index], 1, &recv_size, 2000);
            if ((ret == 0) && (recv_size == 1)) {
                if (buf[index] == '\n') {
                    hal_uart_send(&uart_ttl, buf, index + 1, AOS_WAIT_FOREVER);
                    index = 5;
                    aos_msleep(10);
                    continue;
                }
                index ++;
                if(index >= 128) {
                    hal_uart_send(&uart_ttl, buf, index, AOS_WAIT_FOREVER);
                    index = 5;
                }
            }
            aos_msleep(10);
        }
    }

**4）测试方法**

第一步：

在solutions/helloworld\_demo/helloworld.c中，增加头文件\#include "aos/hal/uart.h"，增加上面串口初始化及传输数据收发的代码。

请参考下面文档下载代码、编译及烧录

[HaaS100快速开始][HaaS100]

代码详见：

/*
 * Copyright (C) 2015-2021 Alibaba Group Holding Limited
 */
 
 #include <stdio.h>
 #include <stdlib.h>
 #include <aos/errno.h>
 #include <aos/kernel.h>
 #include "aos/init.h"
 #include "board.h"
 #include <k_api.h>
 #include "aos/hal/uart.h"
 
 uart_dev_t uart_ttl = {0};
 
 void uart_test_init()
 {
 uart_ttl.port = 2; /*ttl use uart 2*/
 uart_ttl.config.baud_rate = 115200;
 uart_ttl.config.data_width = DATA_WIDTH_8BIT;
 uart_ttl.config.flow_control = FLOW_CONTROL_DISABLED;
 uart_ttl.config.mode = MODE_TX_RX;
 uart_ttl.config.parity = NO_PARITY;
 uart_ttl.config.stop_bits = STOP_BITS_1;
 
 hal_uart_init(&uart_ttl);
 }
 
 void uart_test()
 {
 int ret = 0;
 int recv_size = 0;
 int index = 5;
 char buf[128] = {0};
 
 buf[0] = 'r';
 buf[1] = 'e';
 buf[2] = 'c';
 buf[3] = 'v';
 buf[4] = '=';
 while (1) {
 ret = -1;
 recv_size = 0;
 ret = hal_uart_recv_II(&uart_ttl, &buf[index], 1, &recv_size, 2000);
 if ((ret == 0) && (recv_size == 1)) {
 if (buf[index] == '\n') {
 hal_uart_send(&uart_ttl, buf, index + 1, AOS_WAIT_FOREVER);
 index = 5;
 aos_msleep(10);
 continue;
 }
 index ++;
 if(index >= 128) {
 hal_uart_send(&uart_ttl, buf, index, AOS_WAIT_FOREVER);
 index = 5;
 }
 }
 aos_msleep(10);
 }
 }
 
 int application_start(int argc, char *argv[])
 {
 int count = 0;
 
 printf("uart test entry here!\r\n");
 
 uart_test_init();
 uart_test();
 }

第二步：

将编译出来的版本烧录到HaaS100中，按照硬件连接章节图示连接HaaS100和电脑。在电脑上，使用串口工具打开UART2对应的串口，输入字符串后，按回车。串口会打印出recv=加输入的字符串。如下图：

![1655732e991a26dbf5fb520afd5c0d73.png][]

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0hhYVNUZWNo_size_16_color_FFFFFF_t_70]: /images/20220829/d751e01472494ee69216eb6b09c15090.png
[35661c0a8d83b13c7dcebbf42d686da9.png]: /images/20220829/5d120996a03e4d3d93cae877e638d34d.png
[92eb7ce1f59fe8643b9d5f6d5cdd3d34.png]: /images/20220829/b316ffc2ebe24a7b942c8e87d31c51b1.png
[ba27abe5d4492da0977b7f1fd076ea67.png]: /images/20220829/b26ae45e19bc4f5eb0cb0674ef13b494.png
[2b4f8af3b2cd123c60d23e57012571ae.png]: /images/20220829/3afe650dc8134f29b6b15ebb7f290d20.png
[75459f72693ccafeb9a18bd0754e46ae.png]: /images/20220829/6bf4afc54e3844cda1e52c2b42386db3.png
[https_help.aliyun.com_document_detail_161062.html_spm_a2c4g.11186623.6.574.64c67c26w3auXW]: https://help.aliyun.com/document_detail/161062.html?spm=a2c4g.11186623.6.574.64c67c26w3auXW
[6261431b6839b658f3dd8e33da1c52bb.png]: /images/20220829/eaae09933fe3484091a12017e434461b.png
[HaaS100]: https://blog.csdn.net/HaaSTech/article/details/116153629?ops_request_misc=&request_id=&biz_id=102&utm_term=haas100%20%E5%BF%AB%E9%80%9F%E5%85%A5%E9%97%A8&utm_medium=distribute.pc_search_result.none-task-blog-2~all~sobaiduweb~default-2-.pc_search_all_es&spm=1018.2226.3001.4187
[1655732e991a26dbf5fb520afd5c0d73.png]: /images/20220829/93836d7722cc4b418a98a0229955539b.png