mirror of
https://github.com/drasko/open-ameba.git
synced 2024-11-28 17:20:32 +00:00
258 lines
8.2 KiB
C
258 lines
8.2 KiB
C
|
/*
|
||
|
|
* Routines to access hardware
|
||
|
|
*
|
||
|
|
* Copyright (c) 2013 Realtek Semiconductor Corp.
|
||
|
|
*
|
||
|
|
* This module is a confidential and proprietary property of RealTek and
|
||
|
|
* possession or use of this module requires written permission of RealTek.
|
||
|
|
*/
|
||
|
|
|
||
|
|
#ifndef _HAL_UART_H_
|
||
|
|
#define _HAL_UART_H_
|
||
|
|
|
||
|
|
#include "rtl8195a_uart.h"
|
||
|
|
|
||
|
|
/**
|
||
|
|
* RUART Configurations
|
||
|
|
*/
|
||
|
|
#define UART_WAIT_FOREVER 0xffffffff
|
||
|
|
|
||
|
|
#define UART_DMA_MBLK_NUM 16 // maximum block number for each DMA transfer, it must <= 16
|
||
|
|
#define UART_DMA_BLOCK_SIZE 4092 // the block size of multiple block DMA, it cann0t over 4095
|
||
|
|
|
||
|
|
typedef struct _HAL_UART_DMA_MULTIBLK_ {
|
||
|
|
volatile GDMA_CH_LLI_ELE GdmaChLli[UART_DMA_MBLK_NUM];
|
||
|
|
struct GDMA_CH_LLI Lli[UART_DMA_MBLK_NUM];
|
||
|
|
struct BLOCK_SIZE_LIST BlockSizeList[UART_DMA_MBLK_NUM];
|
||
|
|
}UART_DMA_MULTIBLK, *PUART_DMA_MULTIBLK;
|
||
|
|
|
||
|
|
typedef struct _UART_DMA_CONFIG_ {
|
||
|
|
u8 TxDmaEnable;
|
||
|
|
u8 RxDmaEnable;
|
||
|
|
u8 TxDmaBurstSize;
|
||
|
|
u8 RxDmaBurstSize;
|
||
|
|
VOID *pHalGdmaOp;
|
||
|
|
VOID *pTxHalGdmaAdapter;
|
||
|
|
VOID *pRxHalGdmaAdapter;
|
||
|
|
IRQ_HANDLE TxGdmaIrqHandle;
|
||
|
|
IRQ_HANDLE RxGdmaIrqHandle;
|
||
|
|
#if defined(E_CUT_ROM_DOMAIN) || (!defined(CONFIG_RELEASE_BUILD_LIBRARIES))
|
||
|
|
UART_DMA_MULTIBLK *pTxDmaBlkList; // point to multi-block list
|
||
|
|
UART_DMA_MULTIBLK *pRxDmaBlkList; // point to multi-block list
|
||
|
|
u8 TxDmaMBChnl; // is using DMA multiple block channel
|
||
|
|
u8 RxDmaMBChnl; // is using DMA multiple block channel
|
||
|
|
#endif
|
||
|
|
}UART_DMA_CONFIG, *PUART_DMA_CONFIG;
|
||
|
|
|
||
|
|
typedef struct _HAL_RUART_ADAPTER_ {
|
||
|
|
u32 BaudRate;
|
||
|
|
u32 FlowControl;
|
||
|
|
u32 FifoControl;
|
||
|
|
u32 Interrupts;
|
||
|
|
u32 TxCount; // how many byte to TX
|
||
|
|
u32 RxCount; // how many bytes to RX
|
||
|
|
u8 *pTxBuf;
|
||
|
|
u8 *pRxBuf;
|
||
|
|
HAL_UART_State State; // UART state
|
||
|
|
u8 Status; // Transfer Status
|
||
|
|
u8 Locked; // is UART locked for operation
|
||
|
|
u8 UartIndex;
|
||
|
|
u8 WordLen; // word length select: 0 -> 7 bits, 1 -> 8 bits
|
||
|
|
u8 StopBit; // word length select: 0 -> 1 stop bit, 1 -> 2 stop bit
|
||
|
|
u8 Parity; // parity check enable
|
||
|
|
u8 ParityType; // parity check type
|
||
|
|
u8 StickParity;
|
||
|
|
u8 ModemStatus; // the modem status
|
||
|
|
u8 DmaEnable;
|
||
|
|
u8 TestCaseNumber;
|
||
|
|
u8 PinmuxSelect;
|
||
|
|
BOOL PullMode;
|
||
|
|
IRQ_HANDLE IrqHandle;
|
||
|
|
PUART_DMA_CONFIG DmaConfig;
|
||
|
|
VOID (*ModemStatusInd)(VOID *pAdapter); // modem status indication interrupt handler
|
||
|
|
VOID (*TxTDCallback)(VOID *pAdapter); // User Tx Done callback function
|
||
|
|
VOID (*RxDRCallback)(VOID *pAdapter); // User Rx Data ready callback function
|
||
|
|
VOID (*TxCompCallback)(VOID *para); // User Tx complete callback function
|
||
|
|
VOID (*RxCompCallback)(VOID *para); // User Rx complete callback function
|
||
|
|
VOID *TxTDCbPara; // the pointer agrument for TxTDCallback
|
||
|
|
VOID *RxDRCbPara; // the pointer agrument for RxDRCallback
|
||
|
|
VOID *TxCompCbPara; // the pointer argument for TxCompCbPara
|
||
|
|
VOID *RxCompCbPara; // the pointer argument for RxCompCallback
|
||
|
|
VOID (*EnterCritical)(void);
|
||
|
|
VOID (*ExitCritical)(void);
|
||
|
|
|
||
|
|
#if defined(E_CUT_ROM_DOMAIN) || (!defined(CONFIG_RELEASE_BUILD_LIBRARIES))
|
||
|
|
//1 New member only can be added below: members above must be fixed for ROM code
|
||
|
|
u32 *pDefaultBaudRateTbl; // point to the table of pre-defined baud rate
|
||
|
|
u8 *pDefaultOvsrRTbl; // point to the table of OVSR for pre-defined baud rate
|
||
|
|
u16 *pDefaultDivTbl; // point to the table of DIV for pre-defined baud rate
|
||
|
|
u8 *pDefOvsrAdjBitTbl_10; // point to the table of OVSR-Adj bits for 10 bits
|
||
|
|
u8 *pDefOvsrAdjBitTbl_9; // point to the table of OVSR-Adj bits for 9 bits
|
||
|
|
u8 *pDefOvsrAdjBitTbl_8; // point to the table of OVSR-Adj bits for 8 bits
|
||
|
|
u16 *pDefOvsrAdjTbl_10; // point to the table of OVSR-Adj for pre-defined baud rate
|
||
|
|
u16 *pDefOvsrAdjTbl_9; // point to the table of OVSR-Adj for pre-defined baud rate
|
||
|
|
u16 *pDefOvsrAdjTbl_8; // point to the table of OVSR-Adj for pre-defined baud rate
|
||
|
|
PUART_DMA_MULTIBLK pTxDMAMBlk; // point to the Link List Table of the DMA Multiple Block
|
||
|
|
PUART_DMA_MULTIBLK pRxDMAMBlk; // point to the Link List Table of the DMA Multiple Block
|
||
|
|
u32 BaudRateUsing; // Current using Baud-Rate
|
||
|
|
u8 WordLenUsing; // Current using Word Length
|
||
|
|
u8 ParityUsing; // Current using Parity check
|
||
|
|
u8 RTSCtrl; // Software RTS Control
|
||
|
|
|
||
|
|
#if 0//CONFIG_CHIP_E_CUT
|
||
|
|
u8 TxState;
|
||
|
|
u8 RxState;
|
||
|
|
u32 TxInitSize; // how many byte to TX at atart
|
||
|
|
u32 RxInitSize; // how many bytes to RX at start
|
||
|
|
|
||
|
|
VOID (*RuartEnterCritical)(VOID *para); // enter critical: disable UART interrupt
|
||
|
|
VOID (*RuartExitCritical)(VOID *para); // exit critical: re-enable UART interrupt
|
||
|
|
VOID (*TaskYield)(VOID *para); // User Task Yield: do a context switch while waitting
|
||
|
|
VOID *TaskYieldPara; // the agrument (pointer) for TaskYield
|
||
|
|
#endif // #if CONFIG_CHIP_E_CUT
|
||
|
|
#endif
|
||
|
|
}HAL_RUART_ADAPTER, *PHAL_RUART_ADAPTER;
|
||
|
|
|
||
|
|
typedef struct _HAL_RUART_OP_ {
|
||
|
|
VOID (*HalRuartAdapterLoadDef)(VOID *pAdp, u8 UartIdx); // Load UART adapter default setting
|
||
|
|
VOID (*HalRuartTxGdmaLoadDef)(VOID *pAdp, VOID *pCfg); // Load TX GDMA default setting
|
||
|
|
VOID (*HalRuartRxGdmaLoadDef)(VOID *pAdp, VOID *pCfg); // Load RX GDMA default setting
|
||
|
|
HAL_Status (*HalRuartResetRxFifo)(VOID *Data);
|
||
|
|
HAL_Status (*HalRuartInit)(VOID *Data);
|
||
|
|
VOID (*HalRuartDeInit)(VOID *Data);
|
||
|
|
HAL_Status (*HalRuartPutC)(VOID *Data, u8 TxData);
|
||
|
|
u32 (*HalRuartSend)(VOID *Data, u8 *pTxData, u32 Length, u32 Timeout);
|
||
|
|
HAL_Status (*HalRuartIntSend)(VOID *Data, u8 *pTxData, u32 Length);
|
||
|
|
HAL_Status (*HalRuartDmaSend)(VOID *Data, u8 *pTxData, u32 Length);
|
||
|
|
HAL_Status (*HalRuartStopSend)(VOID *Data);
|
||
|
|
HAL_Status (*HalRuartGetC)(VOID *Data, u8 *pRxByte);
|
||
|
|
u32 (*HalRuartRecv)(VOID *Data, u8 *pRxData, u32 Length, u32 Timeout);
|
||
|
|
HAL_Status (*HalRuartIntRecv)(VOID *Data, u8 *pRxData, u32 Length);
|
||
|
|
HAL_Status (*HalRuartDmaRecv)(VOID *Data, u8 *pRxData, u32 Length);
|
||
|
|
HAL_Status (*HalRuartStopRecv)(VOID *Data);
|
||
|
|
u8 (*HalRuartGetIMR)(VOID *Data);
|
||
|
|
VOID (*HalRuartSetIMR)(VOID *Data);
|
||
|
|
u32 (*HalRuartGetDebugValue)(VOID *Data, u32 DbgSel);
|
||
|
|
VOID (*HalRuartDmaInit)(VOID *Data);
|
||
|
|
VOID (*HalRuartRTSCtrl)(VOID *Data, BOOLEAN RtsCtrl);
|
||
|
|
VOID (*HalRuartRegIrq)(VOID *Data);
|
||
|
|
VOID (*HalRuartIntEnable)(VOID *Data);
|
||
|
|
VOID (*HalRuartIntDisable)(VOID *Data);
|
||
|
|
}HAL_RUART_OP, *PHAL_RUART_OP;
|
||
|
|
|
||
|
|
typedef struct _RUART_DATA_ {
|
||
|
|
PHAL_RUART_ADAPTER pHalRuartAdapter;
|
||
|
|
BOOL PullMode;
|
||
|
|
u8 BinaryData;
|
||
|
|
u8 SendBuffer;
|
||
|
|
u8 RecvBuffer;
|
||
|
|
}RUART_DATA, *PRUART_DATA;
|
||
|
|
|
||
|
|
typedef struct _RUART_ADAPTER_ {
|
||
|
|
PHAL_RUART_OP pHalRuartOp;
|
||
|
|
PHAL_RUART_ADAPTER pHalRuartAdapter;
|
||
|
|
PUART_DMA_CONFIG pHalRuartDmaCfg;
|
||
|
|
}RUART_ADAPTER, *PRUART_ADAPTER;
|
||
|
|
|
||
|
|
extern VOID
|
||
|
|
HalRuartOpInit(
|
||
|
|
IN VOID *Data
|
||
|
|
);
|
||
|
|
|
||
|
|
extern HAL_Status
|
||
|
|
HalRuartTxGdmaInit(
|
||
|
|
PHAL_RUART_ADAPTER pHalRuartAdapter,
|
||
|
|
PUART_DMA_CONFIG pUartGdmaConfig,
|
||
|
|
u8 IsMultiBlk
|
||
|
|
);
|
||
|
|
|
||
|
|
extern VOID
|
||
|
|
HalRuartTxGdmaDeInit(
|
||
|
|
PUART_DMA_CONFIG pUartGdmaConfig
|
||
|
|
);
|
||
|
|
|
||
|
|
extern HAL_Status
|
||
|
|
HalRuartRxGdmaInit(
|
||
|
|
PHAL_RUART_ADAPTER pHalRuartAdapter,
|
||
|
|
PUART_DMA_CONFIG pUartGdmaConfig,
|
||
|
|
u8 IsMultiBlk
|
||
|
|
);
|
||
|
|
|
||
|
|
extern VOID
|
||
|
|
HalRuartRxGdmaDeInit(
|
||
|
|
PUART_DMA_CONFIG pUartGdmaConfig
|
||
|
|
);
|
||
|
|
|
||
|
|
extern HAL_Status
|
||
|
|
HalRuartResetTxFifo(
|
||
|
|
VOID *Data
|
||
|
|
);
|
||
|
|
|
||
|
|
extern HAL_Status HalRuartResetTRxFifo(IN VOID *Data);
|
||
|
|
|
||
|
|
extern HAL_Status
|
||
|
|
HalRuartResetRxFifo(
|
||
|
|
IN VOID *Data
|
||
|
|
);
|
||
|
|
|
||
|
|
extern HAL_Status
|
||
|
|
HalRuartSetBaudRate(
|
||
|
|
IN VOID *Data
|
||
|
|
);
|
||
|
|
|
||
|
|
extern HAL_Status
|
||
|
|
HalRuartInit(
|
||
|
|
IN VOID *Data
|
||
|
|
);
|
||
|
|
|
||
|
|
extern VOID
|
||
|
|
HalRuartDeInit(
|
||
|
|
IN VOID *Data
|
||
|
|
);
|
||
|
|
|
||
|
|
extern HAL_Status
|
||
|
|
HalRuartDisable(
|
||
|
|
IN VOID *Data
|
||
|
|
);
|
||
|
|
|
||
|
|
extern HAL_Status
|
||
|
|
HalRuartEnable(
|
||
|
|
IN VOID *Data
|
||
|
|
);
|
||
|
|
|
||
|
|
HAL_Status
|
||
|
|
HalRuartFlowCtrl(
|
||
|
|
IN VOID *Data
|
||
|
|
);
|
||
|
|
|
||
|
|
VOID
|
||
|
|
HalRuartEnterCritical(
|
||
|
|
IN VOID *Data
|
||
|
|
);
|
||
|
|
|
||
|
|
VOID
|
||
|
|
HalRuartExitCritical(
|
||
|
|
IN VOID *Data
|
||
|
|
);
|
||
|
|
|
||
|
|
HAL_Status
|
||
|
|
HalRuartDmaSend(
|
||
|
|
IN VOID *Data,
|
||
|
|
IN u8 *pTxBuf,
|
||
|
|
IN u32 Length
|
||
|
|
);
|
||
|
|
|
||
|
|
HAL_Status
|
||
|
|
HalRuartDmaRecv(
|
||
|
|
IN VOID *Data,
|
||
|
|
IN u8 *pRxBuf,
|
||
|
|
IN u32 Length
|
||
|
|
);
|
||
|
|
|
||
|
|
extern const HAL_RUART_OP _HalRuartOp;
|
||
|
|
extern HAL_Status RuartLock (PHAL_RUART_ADAPTER pHalRuartAdapter);
|
||
|
|
extern VOID RuartUnLock (PHAL_RUART_ADAPTER pHalRuartAdapter);
|
||
|
|
|
||
|
|
#endif
|
||
|
|
|