/**
 *!
 * \file        b_hal_uart.h
 * \version     v0.0.1
 * \date        2020/03/25
 * \author      Bean(notrynohigh@outlook.com)
 *******************************************************************************
 * @attention
 *
 * Copyright (c) 2020 Bean
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in all
 * copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SUARTL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 * SOFTWARE.
 *******************************************************************************
 */
#ifndef __B_HAL_UART_H__
#define __B_HAL_UART_H__

#ifdef __cplusplus
extern "C" {
#endif

/*Includes ----------------------------------------------*/
#include <stdint.h>

#include "hal/inc/b_hal_dma.h"
#include "hal/inc/b_hal_it.h"
#include "utils/inc/b_util_list.h"

/**
 * \addtogroup B_HAL
 * \{
 */

/**
 * \addtogroup UART
 * \{
 */

/**
 * \defgroup UART_Exported_TypesDefinitions
 * \{
 */

typedef enum
{
    B_HAL_UART_1,
    B_HAL_UART_2,
    B_HAL_UART_3,
    B_HAL_UART_4,
    B_HAL_UART_5,
    B_HAL_UART_6,
    B_HAL_UART_7,
    B_HAL_UART_8,
    B_HAL_LPUART_1,
    B_HAL_LPUART_2,
    B_HAL_LPUART_3,
    B_HAL_LPUART_4,
    B_HAL_UART_NUMBER
} bHalUartNumber_t;

typedef int (*bHalUartIdleCallback_t)(uint8_t *pbuf, uint16_t len, void *user_data);

typedef struct
{
    bHalUartNumber_t       uart;
    bHalDmaChlNumber_t     chl;
    bHalIt_t               it;
    uint8_t               *pbuf;
    uint32_t               len;
    uint16_t               idle_ms;
    bHalUartIdleCallback_t callback;
    void                  *user_data;
    volatile uint32_t      index;
    volatile uint32_t      l_index;
    volatile uint32_t      l_tick;
    struct list_head       list;
} bHalUartIdleAttr_t;

/**
 * \}
 */

/**
 * \defgroup UART_Exported_Definitions
 * \{
 */
/// 创建 attr
#define bHAL_UART_CREATE_ATTR(name, buf_len, ms, cb, ud) \
    static uint8_t            bBuf##name[buf_len];       \
    static bHalUartIdleAttr_t name = {                   \
        .pbuf      = bBuf##name,                         \
        .len       = buf_len,                            \
        .idle_ms   = ms,                                 \
        .callback  = cb,                                 \
        .user_data = ud,                                 \
        .index     = 0,                                  \
        .l_index   = 0,                                  \
        .l_tick    = 0,                                  \
        .chl       = B_HAL_DMA_CHL_INVALID,              \
    }

/// 对已有的attr进行初始化
#define bHAL_UART_INIT_ATTR(pattr, buf, buf_len, ms, cb, ud) \
    do                                                       \
    {                                                        \
        (pattr)->pbuf      = buf;                            \
        (pattr)->len       = buf_len;                        \
        (pattr)->idle_ms   = ms;                             \
        (pattr)->callback  = cb;                             \
        (pattr)->user_data = ud;                             \
        (pattr)->index     = 0;                              \
        (pattr)->l_index   = 0;                              \
        (pattr)->l_tick    = 0;                              \
        (pattr)->chl       = B_HAL_DMA_CHL_INVALID;          \
    } while (0)

/**
 * \}
 */

/**
 * \defgroup UART_Exported_Functions
 * \{
 */

int bMcuUartSend(bHalUartNumber_t uart, const uint8_t *pbuf, uint16_t len);
int bMcuUartReceiveDma(bHalUartNumber_t uart, bHalDmaConfig_t *pconf);
//---------------------------------------------------------------------------------------
//---------------------------------------------------------------------------------------
int bHalUartSend(bHalUartNumber_t uart, const uint8_t *pbuf, uint16_t len);

/// attr 通过 bHAL_UART_CREATE_ATTR 创建后传入。
/// 或者已有attr变量，通过 bHAL_UART_INIT_ATTR 初始化后传入。
int bHalUartReceive(bHalUartNumber_t uart, bHalUartIdleAttr_t *attr);
#define bHalUartReceiveIdle bHalUartReceive  // 兼容以往版本命名

int bHalUartReceiveDma(bHalUartNumber_t uart, bHalUartIdleAttr_t *attr, bHalDmaChlNumber_t chl);

/**
 * \}
 */

/**
 * \}
 */

/**
 * \}
 */

#ifdef __cplusplus
}
#endif

#endif

/************************ Copyright (c) 2020 Bean *****END OF FILE****/