AliOS Things标准输入输出端口对接以及修改方法-CSDN博客

1 标准输入输出端口对接

标准输入输出用于输出系统日志、打印异常信息、软件调试、CLI交互等场景。在具体项目中，只需要对接PUTCHAR_PROTOTYPE和GETCHAR_PROTOTYPE两个函数即可。其具体定义如下：

#if defined (__CC_ARM) && defined(__MICROLIB)
#define PUTCHAR_PROTOTYPE int fputc(int ch, FILE *f)
#define GETCHAR_PROTOTYPE int fgetc(FILE *f)

#elif defined(__ICCARM__)
#define PUTCHAR_PROTOTYPE int fputc(int ch, FILE *f)
#define GETCHAR_PROTOTYPE int fgetc(FILE *f)
#else
/* With GCC/RAISONANCE, small printf (option LD Linker->Libraries->Small printf
   set to 'Yes') calls __io_putchar() */
#define PUTCHAR_PROTOTYPE int __io_putchar(int ch)
#define GETCHAR_PROTOTYPE int __io_getchar(void)
#endif /* defined (__CC_ARM) && defined(__MICROLIB) */

在gcc下，对接代码示例如下：

/**
  * @brief  Retargets the C library printf function to the USART.
  * @param  None
  * @retval None
  */
PUTCHAR_PROTOTYPE
{
    if (ch == '\n') {
        hal_uart_send(&uart_0, (void *)"\r", 1, 30000);
    }
  
    hal_uart_send(&uart_0, &ch, 1, 30000);
  
    return ch;
}

/**
  * @brief  Retargets the C library scanf function to the USART.
  * @param  None
  * @retval None
  */
GETCHAR_PROTOTYPE
{
    uint8_t ch = EOF;
    int32_t ret = -1;
    uint32_t recv_size = 0;
  
    ret = hal_uart_recv_II(&uart_0, &ch, 1, &recv_size, HAL_WAIT_FOREVER);

    if ((ret == 0) && (recv_size == 1)) {
        return ch;
    } else {
        return -1;
    }
}

可以看出输入输出最终调用的是hal_uart_send 和hal_uart_recv_II这两个函数，实现这两个函数即可。在具体芯片上，需要将芯片的串口驱动对接到uart的hal接口，具体方法见https://github.com/alibaba/AliOS-Things/wiki/AliOS-Things-HAL-Porting-Guide.zh 。

标准输入输出串口的逻辑端口号必须为0，也就是其对应的uart_dev_t结构体的port元素必须设置为0。

2 如何从其他物理端口输入输出

标准输入输出串口的逻辑端口号必须为0，并不意味着标准输入输出只能通过固定的端。因为这个0指的是逻辑端口，逻辑端口与物理端口存在一个映射关系。在一个由多个串口的芯片上，可以将port0映射到任意的串口。逻辑端口到物理端口的映射是在hal的对接代码中实现的。
以stm32平台为例，其hal_uart_send函数实现如下：

int32_t hal_uart_send(uart_dev_t *uart, const void *data, uint32_t size, uint32_t timeout)
{
    UART_HandleTypeDef *handle = NULL;
    int32_t ret = -1;

    if ((uart == NULL) || (data == NULL)) {
        return -1;
    }

    switch (uart->port) {
        case PORT_UART0:
            handle = &uart0_handle;
            break;
        case PORT_UART1:
            handle = &uart1_handle;
            break;
        case PORT_UART2:
            handle = &uart2_handle;
            break;
        /* if other uart exist add code here */
        default:
        break;
    }
   
    if (handle != NULL) {
        ret = HAL_UART_Transmit_IT(handle, (uint8_t *)data, size);
    }

    return ret;
}

其中PORT_UART0、PORT_UART1、PORT_UART2的值分别为0，1，2，代表的逻辑端口号，uart0_handle、uart1_handle、uart2_handle分别为物理端口串口0、1、2的设备句柄，上述代码中逻辑端口和物理端口是一一对应的，标准输入输出对应到了物理端口串口0.
如果要将标准输入输出端口对应到物理端口串口1，则只需要按照如下修改代码：

int32_t hal_uart_send(uart_dev_t *uart, const void *data, uint32_t size, uint32_t timeout)
{
    UART_HandleTypeDef *handle = NULL;
    int32_t ret = -1;

    if ((uart == NULL) || (data == NULL)) {
        return -1;
    }

    switch (uart->port) {
        case PORT_UART0:
            handle = &uart1_handle;
            break;
        case PORT_UART1:
            handle = &uart0_handle;
            break;
        case PORT_UART2:
            handle = &uart2_handle;
            break;
        /* if other uart exist add code here */
        default:
        break;
    }
   
    if (handle != NULL) {
        ret = HAL_UART_Transmit_IT(handle, (uint8_t *)data, size);
    }

    return ret;
}

3 注意事项

在多bin的情况下，app和kernel是分开的。标准输入输出是由用户进行初始化，也就是其对应的uart_dev_t结构体是定义在app中的，但是kernel中要进行异常输出和CLI交互等功能，也需要使用到该结构体，kernel无法获取app中的该结构体。由于kernel中只需要进行send和recive操作而不需要初始化，因此kernel中需要进行标准输入输出时，我们重新定义一个uart_dev_t结构体，将port设置为0即可。由于这个结构体不是初始化时app传入的结构体，因此这个结构体中除了port之外其他的成员都是不可用的。具体来说就是针对标准输入输出串口，在数据发送和接收函数中不要使用uart_dev_t结构体中的priv和config元素，因为这两个元素在kernel中是无效的。对于其他串口，还有其他设备，无此限制。