/****************************************************************************

Copyright(c) 2019 by Aerospace C.Power (Chongqing) Microelectronics. ALL RIGHTS RESERVED.

This Information is proprietary to Aerospace C.Power (Chongqing) Microelectronics and MAY NOT
be copied by any method or incorporated into another program without
the express written consent of Aerospace C.Power. This Information or any portion
thereof remains the property of Aerospace C.Power. The Information contained herein
is believed to be accurate and Aerospace C.Power assumes no responsibility or
liability for its use in any way and conveys no license or title under
any patent or copyright and makes no representation or warranty that this
Information is free from patent or copyright infringement.

****************************************************************************/

#ifndef _APP_UART_H_
#define _APP_UART_H_

#include "app_flash.h"
#include "app_types.h"
#include "app_common.h"

/* the buffer size for uart receive frame */
#define UART_RCV_BUF_LEN            (1024)
/* cache uart recv buffer */
#define UART_BUF_MAX_LEN            (800)
/* uart recv data timeout, clearn. unit is ms */
#define UART_RECV_TIMEOUT           (1000)

typedef struct _uart_handle_buffer {
    /* buffer handle */
    uint16_t    handle;
    /* buffer length */
    uint16_t    buff_len;
    /* run time */
    uint32_t    boot_tm;
    /* temp buffer */
    uint8_t     *buff_tmp;
} uart_handle_buffer;

/**
 * @brief app_uart_is_valid() - check uart param is valid.
 *
 * @param [in] baudrate: baud rate.
 * @param [in] data_bits: data bits:5,6,7,8.
 * @param [in] stop_bits: stop bits:1,1.5,2.
 * @param [in] parity: parity,NONE:0, ODD:1,EVEN:2.
 * @param [in] thresholdvalue: threshold value,20-1000.
 *
 * @return true: succeeded;
 * @return false: failed;
 */
uint8_t app_uart_is_valid(uint32_t baudrate, uint8_t data_bits,
    uint8_t stop_bits, uint8_t parity, uint32_t thresholdvalue);

/**
 * @brief app_uart_tx() - send data to uart.
 *
 * @param [in] hdl: uart handle.
 * @param [in] data: data will be send uart.
 * @param [in] data_length: data length.
 *
 * @return 0: succeeded;
 * @return others: failed;
 */
uint16_t app_uart_tx(iot_uart_h hdl, uint8_t *data, uint16_t data_length);

/**
 * @brief app_uart_buf_clear() - clearn buffer.
 *
 * @param None.
 *
 * @return None.
 */
void app_uart_buf_clear(void);

/**
 * @brief app_get_uart_buf_info() - get golbal uart info.
 *
 * @param None.
 *
 * @return uart info, point to g_uart_buffer;
 */
uart_handle_buffer *app_get_uart_buf_info(void);

/**
 * @brief app_uart_reassign_pin() - set uart port tx/rx pin before iot_uart_open.
 *
 * @param [in] port: open port, see IOT_UART_PORTXXX,as IOT_UART_PORT0.
 * @param [in] rx_pin: define uart rx pin.
 * @param [in] tx_pin: define uart tx pin.
 *
 * @return 0: succeeded;
 * @return others: failed;
 */
uint8_t app_uart_reassign_pin(uint8_t port, uint8_t rx_pin, uint8_t tx_pin);

/**
 * @brief app_uart_init() - uart init.
 *
 * @param [out] uart_handle: open uart, return handle.
 *
 * @return 0: succeeded;
 * @return others: failed;
 */
uint16_t app_uart_init(iot_uart_h *uart_handle);

#endif  /* _APP_UART_H_ */