/*
 * Copyright 2021 MindMotion Microelectronics Co., Ltd.
 * All rights reserved.
 *
 * SPDX-License-Identifier: BSD-3-Clause
 */

#ifndef __HAL_LPUART_H__
#define __HAL_LPUART_H__

#include "hal_common.h"

/*!
 * @addtogroup LPUART
 * @{
 */

/*!
 * @addtogroup LPUART_STATUS
 * @{
 */
#define LPUART_STATUS_RX_FULL   LPU_LPUSTA_RXF_MASK   /*!< Status flag when LPUART receiving buffer is full. */
#define LPUART_STATUS_TX_EMPTY  LPU_LPUSTA_TXE_MASK   /*!< Status flag when LPUART transmiter buffer is empty. */
#define LPUART_STATUS_TX_DONE   LPU_LPUSTA_TC_MASK    /*!< Status flag when LPUART transmiter shifter is empty after the transfer is done. */
/*!
 * @}
 */

/*!
 * @addtogroup LPUART_INT
 * @{
 */
#define LPUART_INT_RX_FULL      (1u << 0u)  /*!< Interrupt enable when LPUART receiving buffer is full. */
#define LPUART_INT_TX_EMPTY     (1u << 1u)  /*!< Interrupt enable when LPUART transmiter buffer is empty. */
#define LPUART_INT_TX_DONE      (1u << 3u)  /*!< Interrupt enable when LPUART transmiter is done. */
/*!
 * @}
 */

/*!
 * @addtogroup LPUART_DMA
 * @{
 */
#define LPUART_DMA_TX     LPU_LPUEN_DMAT_MASK   /*!< Enable LPUART DMA tx only. */
#define LPUART_DMA_RX     LPU_LPUEN_DMAR_MASK   /*!< Enable LPUART DMA rx only. */
#define LPUART_DMA_TXRX  (LPU_LPUEN_DMAT_MASK | LPU_LPUEN_DMAR_MASK)  /*!< Enable LPUART DMA tx and rx. */
/*!
 * @}
 */

/*!
 * @brief LPUART clock source select.
 */
typedef enum
{
    LPUART_ClockSource_LSE = 0u,  /*!< Clock soucre is LSE. */
} LPUART_ClockSource_Type;

/*!
 * @brief LPUART use LSE as clock source's baudrate type.
 */
typedef enum
{
    LPUART_Baudrate_9600 = 0x000,  /*!< Baudrate is 9600 when clock source is LSE. */
    LPUART_Baudrate_4800 = 0x001,  /*!< Baudrate is 4800 when clock source is LSE. */
    LPUART_Baudrate_2400 = 0x010,  /*!< Baudrate is 2400 when clock source is LSE. */
    LPUART_Baudrate_1200 = 0x011,  /*!< Baudrate is 1200 when clock source is LSE. */
    LPUART_Baudrate_600  = 0x100,  /*!< Baudrate is 600 when clock source is LSE. */
    LPUART_Baudrate_300  = 0x101,  /*!< Baudrate is 300 when clock source is LSE. */
} LPUART_Baudrate_Type;

/*!
 * @brief LPUART word length type.
 */
typedef enum
{
    LPUART_WordLength_8 = 0u,  /*!< Word length 8 bits. */
    LPUART_WordLength_7 = 1u,  /*!< Word length 7 bits. */
} LPUART_WordLength_Type;

/*!
 * @brief LPUART stop bits type.
 */
typedef enum
{
    LPUART_StopBits_1 = 0u,  /* stop bit is 1 bit */
    LPUART_StopBits_2 = 1u,  /* stop bit is 2 bit */
} LPUART_StopBits_Type;

/*!
 * @brief LPUART parity type.
 */
typedef enum
{
    LPUART_Parity_None = 0u, /*!< No parity. */
    LPUART_Parity_Even = 1u, /*!< Even parity. */
    LPUART_Parity_Odd  = 2u, /*!< Odd parity. */
} LPUART_Parity_Type;

/*!
 * @brief This type of structure instance is used to keep the settings when calling the @ref LPUART_Init() to initialize the LPUART module.
 */
typedef struct
{
    LPUART_ClockSource_Type   ClockSource;  /*!< LPUART clock source. */
    LPUART_Baudrate_Type      BaudRate;     /*!< Specify the LPUART LSE specific baud rate. */
    LPUART_WordLength_Type    WordLength;   /*!< Specify the number of data bits transmitted or received in a frame. */
    LPUART_StopBits_Type      StopBits;     /*!< Specify the number of stop bits transmitted. */
    LPUART_Parity_Type        Parity;       /*!< Specify the parity mode. */
} LPUART_Init_Type;

/*!
 * @brief Initialize the LPUART module.
 *
 * @param LPUARTx LPUART instance.
 * @param init  Pointer to the initialization structure. See to @ref LPUART_Init_Type.
 * @return None.
 */
void LPUART_Init(LPU_Type * LPUARTx, LPUART_Init_Type * init);

/*!
 * @brief Enable the LPUART tx module.
 *
 * The LPUART Tx module should be enabled before sending data.
 *
 * @param LPUARTx LPUART instance.
 * @param enable 'true' to enable the module, 'false' to disable the module.
 * @return None.
 */
void LPUART_EnableTx(LPU_Type * LPUARTx, bool enable);

/*!
 * @brief Enable the LPUART rx module.
 *
 * The LPUART module should be enabled before receiving data.
 *
 * @param LPUARTx LPUART instance.
 * @param enable 'true' to enable the module, 'false' to disable the module.
 * @return None.
 */
void LPUART_EnableRx(LPU_Type * LPUARTx, bool enable);

/*!
 * @brief Get the current status flags of the LPUART module.
 *
 * @param LPUARTx LPUART instance.
 * @return Status flags. See to @ref LPUART_STATUS.
 */
uint32_t LPUART_GetStatus(LPU_Type * LPUARTx);

/*!
 * @brief Put the data into transmiter buffer of the LPUART module.
 *
 * @param LPUARTx LPUART instance.
 * @param value Data value to be send through the transmiter.
 * @return None.
 */
void LPUART_PutData(LPU_Type * LPUARTx, uint8_t value);

/*!
 * @brief Get the data from receiver buffer of the LPUART module.
 *
 * @param LPUARTx LPUART instance.
 * @return The data value received from the receiver.
 */
uint8_t LPUART_GetData(LPU_Type * LPUARTx);

/*!
 * @brief Enable interrupts of the LPUART module.
 *
 * @param LPUARTx LPUART instance.
 * @param interrupts Interrupt code masks. See to @ref LPUART_INT.
 * @param enable 'true' to enable the indicated interrupts, 'false' to disable the indicated interrupts.
 * @return None.
 */
void LPUART_EnableInterrupts(LPU_Type * LPUARTx, uint32_t interrupts, bool enable);

/*!
 * @brief Get the interrupts status flags of the LPUART module.
 *
 * @param LPUARTx LPUART instance.
 * @return Interrupt status flags. See to @ref LPUART_INT.
 */
uint32_t LPUART_GetInterruptStatus(LPU_Type * LPUARTx);

/*!
 * @brief Read the current enabled interrupts the LPUART module.
 *
 * @param LPUARTx LPUART instance.
 * @return The mask codes enabled interrupts. See to @ref LPUART_INT
 */
uint32_t LPUART_GetEnabledInterrupts(LPU_Type * LPUARTx);

/*!
 * @brief Clear the interrupts status flags of the LPUART module.
 *
 * @param LPUARTx LPUART instance.
 * @param interrupts The mask codes of the indicated interrupt flags to be cleared.
 * @return Interrupt status flags. See to @ref LPUART_INT.
 */
void LPUART_ClearInterruptStatus(LPU_Type * LPUARTx, uint32_t interrupts);

/*!
 * @brief Enable the DMA trigger from the LPUART module.
 *
 * The DMA trigger events are the same as the interrupts.
 *
 * @param LPUARTx LPUART instance.
 * @param dma DMA xfer direction.
 * @param enable 'true' to enable the DMA trigger, 'false' to disable the DMA trigger.
 * @return None.
 */
void LPUART_EnableDMA(LPU_Type * LPUARTx, uint32_t dma, bool enable);

/*!
 * @brief Get the hardware Tx data buffer's address the LPUART module.
 *
 * The return value of the address is most used with DMA module.
 *
 * @param LPUARTx LPUART instance.
 * @return The value of the address for LPUART module's hardware Tx data buffer.
 */
uint32_t   LPUART_GetTxDataRegAddr(LPU_Type * LPUARTx);

/*!
 * @brief Get the hardware Rx data buffer's address the LPUART module.
 *
 * The return value of the address is most used with DMA module.
 *
 * @param LPUARTx LPUART instance.
 * @return The value of the address for LPUART module's hardware Rx data buffer.
 */
uint32_t   LPUART_GetRxDataRegAddr(LPU_Type * LPUARTx);

/*!
 *@}
 */

#endif /* __HAL_UART_H__ */