.. _uart_echo-index:

UART_ECHO
==================

总览
----------------

本示例主要介绍通过UART0将收到的数据回传给发送方的过程(注意cli将不能使用)。

准备及使用步骤
----------------
- 使用步骤：
 - 插入将板子的USB电源线，USB电源线默认连接UART0；
 - 编译 ``customer_app/periperal/demo_uart`` 工程并下载工程，编译命令： ``genromap <chip name>``，<chip name>可选择 ``BL602`` , ``BL702``；
 - 打开一个串口终端窗口（波特率为2000000，用于接收和发送uart消息）；
 - 串口终端输入 ``demo_hosal_uart_echo`` ，表示启动 UART_ECHO的demo；
 - 此时通过UART0输入任意字符，例如 "123122233333333333" ，能够回显，表示说明演示成功。

.. figure:: imgs/image1.png
   :alt: 
   
应用实例
----------------

- 通过 ``HOSAL_UART_DEV_DECL`` 接口定义一个uart_dev的uart设备，并初始化uart_id, tx_pin, rx_pin以及波特率为2000000。

::

    /**
     *  Define a UART device,
     *  TX pin : 16
     *  RX pin : 7
     *  baud : 2000000
     */
    HOSAL_UART_DEV_DECL(uart_dev, uart_id, 16, 7, 2000000);

- 通过 ``hosal_uart_init`` 接口初始化硬件uart_dev设备。

::

    /* Uart init device */
    hosal_uart_init(&uart_dev);

- 通过 ``hosal_uart_send`` 接口以及 ``hosal_uart_receive`` 接口来收发UART数据。

::

    while (1) {
        /* Uart receive poll */
        ret = hosal_uart_receive(&uart_dev, data, sizeof(data));
        if (ret > 0) {
            /* Uart send poll */
            hosal_uart_send(&uart_dev, data, ret);
        }
    }