libs/rt-thread
libs
/
rt-thread
4
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
rt-thread/bsp/allwinner/libraries/sunxi-hal/hal/source/spi/common_spi.h

319 lines
17 KiB
C
Raw Normal View History

sync branch rt-smart. (#6641) * Synchronize the code of the rt mart branch to the master branch. * TTY device * Add lwP code from rt-smart * Add vnode in DFS, but DFS will be re-write for rt-smart * There are three libcpu for rt-smart: * arm/cortex-a, arm/aarch64 * riscv64 Co-authored-by: Rbb666 <zhangbingru@rt-thread.com> Co-authored-by: zhkag <zhkag@foxmail.com>
2022-12-03 12:07:44 +08:00
/*
* Copyright (c) 2019-2025 Allwinner Technology Co., Ltd. ALL rights reserved.
*
* Allwinner is a trademark of Allwinner Technology Co.,Ltd., registered in
* the the People's Republic of China and other countries.
* All Allwinner Technology Co.,Ltd. trademarks are used with permission.
*
* DISCLAIMER
* THIRD PARTY LICENCES MAY BE REQUIRED TO IMPLEMENT THE SOLUTION/PRODUCT.
* IF YOU NEED TO INTEGRATE THIRD PARTY’S TECHNOLOGY (SONY, DTS, DOLBY, AVS OR MPEGLA, ETC.)
* IN ALLWINNERS’SDK OR PRODUCTS, YOU SHALL BE SOLELY RESPONSIBLE TO OBTAIN
* ALL APPROPRIATELY REQUIRED THIRD PARTY LICENCES.
* ALLWINNER SHALL HAVE NO WARRANTY, INDEMNITY OR OTHER OBLIGATIONS WITH RESPECT TO MATTERS
* COVERED UNDER ANY REQUIRED THIRD PARTY LICENSE.
* YOU ARE SOLELY RESPONSIBLE FOR YOUR USAGE OF THIRD PARTY’S TECHNOLOGY.
*
*
* THIS SOFTWARE IS PROVIDED BY ALLWINNER"AS IS" AND TO THE MAXIMUM EXTENT
* PERMITTED BY LAW, ALLWINNER EXPRESSLY DISCLAIMS ALL WARRANTIES OF ANY KIND,
* WHETHER EXPRESS, IMPLIED OR STATUTORY, INCLUDING WITHOUT LIMITATION REGARDING
* THE TITLE, NON-INFRINGEMENT, ACCURACY, CONDITION, COMPLETENESS, PERFORMANCE
* OR MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
* IN NO EVENT SHALL ALLWINNER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
* LOSS OF USE, DATA, OR PROFITS, OR BUSINESS INTERRUPTION)
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
* STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
* OF THE POSSIBILITY OF SUCH DAMAGE.
*/
#ifndef __COMMON_SPI_I_H__
#define __COMMON_SPI_I_H__
#ifdef __cplusplus
extern "C" {
#endif
#define SUNXI_SPI_REG_SIZE 0x1000 /* controler reg sized */
#define HEXADECIMAL (0x10)
#define REG_INTERVAL (0x04)
#define REG_CL (0x0c)
#define SPI_FIFO_DEPTH (128)
#define MAX_FIFU 64
#define BULK_DATA_BOUNDARY 64 /* can modify to adapt the application */
#define SPI_MAX_FREQUENCY 100000000 /* spi controller just support 100Mhz */
#define SPI_HIGH_FREQUENCY 60000000 /* sample mode threshold frequency */
#define SPI_LOW_FREQUENCY 24000000 /* sample mode threshold frequency */
#define SPI_MOD_CLK 50000000 /* sample mode frequency */
/* SPI Registers offsets from peripheral base address */
#define SPI_VER_REG (0x00) /* version number register */
#define SPI_GC_REG (0x04) /* global control register */
#define SPI_TC_REG (0x08) /* transfer control register */
#define SPI_INT_CTL_REG (0x10) /* interrupt control register */
#define SPI_INT_STA_REG (0x14) /* interrupt status register */
#define SPI_FIFO_CTL_REG (0x18) /* fifo control register */
#define SPI_FIFO_STA_REG (0x1C) /* fifo status register */
#define SPI_WAIT_CNT_REG (0x20) /* wait clock counter register */
#define SPI_CLK_CTL_REG \
(0x24) /* clock rate control register. better not to use it */
#define SPI_BURST_CNT_REG (0x30) /* burst counter register */
#define SPI_TRANSMIT_CNT_REG (0x34) /* transmit counter register */
#define SPI_BCC_REG (0x38) /* burst control counter register */
#define SPI_DMA_CTL_REG (0x88) /* DMA control register, only for 1639 */
#define SPI_TXDATA_REG (0x200) /* tx data register */
#define SPI_RXDATA_REG (0x300) /* rx data register */
/* SPI Global Control Register Bit Fields & Masks,default value:0x0000_0080 */
#define SPI_GC_EN \
(0x1 \
<< 0) /* SPI module enable control 1:enable; 0:disable; default:0 */
#define SPI_GC_MODE \
(0x1 << 1) /* SPI function mode select 1:master; 0:slave; default:0 */
#define SPI_GC_TP_EN \
(0x1 << 7) /* SPI transmit stop enable 1:stop transmit data when \
RXFIFO is full; 0:ignore RXFIFO status; default:1 */
#define SPI_GC_SRST \
(0x1 << 31) /* soft reset, write 1 will clear SPI control, auto \
clear to 0 */
/* SPI Transfer Control Register Bit Fields & Masks,default value:0x0000_0087 */
#define SPI_TC_PHA \
(0x1 << 0) /* SPI Clock/Data phase control,0: phase0,1: \
phase1;default:1 */
#define SPI_TC_POL \
(0x1 << 1) /* SPI Clock polarity control,0:low level idle,1:high \
level idle;default:1 */
#define SPI_TC_SPOL \
(0x1 << 2) /* SPI Chip select signal polarity control,default: 1,low \
effective like this:~~|_____~~ */
#define SPI_TC_SSCTL \
(0x1 \
<< 3) /* SPI chip select control,default 0:SPI_SSx remains asserted \
between SPI bursts,1:negate SPI_SSx between SPI bursts */
#define SPI_TC_SS_MASK \
(0x3 << 4) /* SPI chip \
select:00-SPI_SS0;01-SPI_SS1;10-SPI_SS2;11-SPI_SS3*/
#define SPI_TC_SS_OWNER \
(0x1 << 6) /* SS output mode select default is 0:automatic output \
SS;1:manual output SS */
#define SPI_TC_SS_LEVEL \
(0x1 << 7) /* defautl is 1:set SS to high;0:set SS to low */
#define SPI_TC_DHB \
(0x1 \
<< 8) /* Discard Hash Burst,default 0:receiving all spi burst in BC \
period 1:discard unused,fectch WTC bursts */
#define SPI_TC_DDB \
(0x1 << 9) /* Dummy burst Type,default 0: dummy spi burst is \
zero;1:dummy spi burst is one */
#define SPI_TC_RPSM \
(0x1 << 10) /* select mode for high speed write,0:normal write \
mode,1:rapids write mode,default 0 */
#define SPI_TC_SDM \
(0x1 << 13) /* master sample data mode, 1: normal sample \
mode;0:delay sample mode. */
#define SPI_TC_SDC \
(0x1 << 11) /* master sample data control, 1: delay--high speed \
operation;0:no delay. */
#define SPI_TC_FBS \
(0x1 << 12) /* LSB/MSB transfer first select 0:MSB,1:LSB,default \
0:MSB first */
#define SPI_TC_XCH \
(0x1 \
<< 31) /* Exchange burst default 0:idle,1:start exchange;when BC is \
zero,this bit cleared by SPI controller*/
#define SPI_TC_SS_BIT_POS (4)
/* SPI Interrupt Control Register Bit Fields & Masks,default value:0x0000_0000
*/
#define SPI_INTEN_RX_RDY \
(0x1 << 0) /* rxFIFO Ready Interrupt Enable,---used for immediately \
received,0:disable;1:enable */
#define SPI_INTEN_RX_EMP \
(0x1 << 1) /* rxFIFO Empty Interrupt Enable ---used for IRQ received \
*/
#define SPI_INTEN_RX_FULL \
(0x1 << 2) /* rxFIFO Full Interrupt Enable ---seldom used */
#define SPI_INTEN_TX_ERQ \
(0x1 << 4) /* txFIFO Empty Request Interrupt Enable ---seldom used */
#define SPI_INTEN_TX_EMP \
(0x1 << 5) /* txFIFO Empty Interrupt Enable ---used for IRQ tx */
#define SPI_INTEN_TX_FULL \
(0x1 << 6) /* txFIFO Full Interrupt Enable ---seldom used */
#define SPI_INTEN_RX_OVF \
(0x1 \
<< 8) /* rxFIFO Overflow Interrupt Enable ---used for error detect */
#define SPI_INTEN_RX_UDR \
(0x1 \
<< 9) /* rxFIFO Underrun Interrupt Enable ---used for error detect */
#define SPI_INTEN_TX_OVF \
(0x1 << 10) /* txFIFO Overflow Interrupt Enable ---used for error \
detect */
#define SPI_INTEN_TX_UDR \
(0x1 << 11) /* txFIFO Underrun Interrupt Enable ---not happened */
#define SPI_INTEN_TC \
(0x1 << 12) /* Transfer Completed Interrupt Enable ---used */
#define SPI_INTEN_SSI \
(0x1 << 13) /* SSI interrupt Enable,chip select from valid state to \
invalid state,for slave used only */
#define SPI_INTEN_ERR \
(SPI_INTEN_TX_OVF | SPI_INTEN_RX_UDR | \
SPI_INTEN_RX_OVF) /* NO txFIFO underrun */
#define SPI_INTEN_MASK (0x77 | (0x3f << 8))
/* SPI Interrupt Status Register Bit Fields & Masks,default value:0x0000_0022 */
#define SPI_INT_STA_RX_RDY \
(0x1 << 0) /* rxFIFO ready, 0:RX_WL < RX_TRIG_LEVEL,1:RX_WL >= \
RX_TRIG_LEVEL */
#define SPI_INT_STA_RX_EMP \
(0x1 << 1) /* rxFIFO empty, this bit is set when rxFIFO is empty */
#define SPI_INT_STA_RX_FULL \
(0x1 << 2) /* rxFIFO full, this bit is set when rxFIFO is full */
#define SPI_INT_STA_TX_RDY \
(0x1 << 4) /* txFIFO ready, 0:TX_WL > TX_TRIG_LEVEL,1:TX_WL <= \
TX_TRIG_LEVEL */
#define SPI_INT_STA_TX_EMP \
(0x1 << 5) /* txFIFO empty, this bit is set when txFIFO is empty */
#define SPI_INT_STA_TX_FULL \
(0x1 << 6) /* txFIFO full, this bit is set when txFIFO is full */
#define SPI_INT_STA_RX_OVF \
(0x1 << 8) /* rxFIFO overflow, when set rxFIFO has overflowed */
#define SPI_INT_STA_RX_UDR \
(0x1 << 9) /* rxFIFO underrun, when set rxFIFO has underrun */
#define SPI_INT_STA_TX_OVF \
(0x1 << 10) /* txFIFO overflow, when set txFIFO has overflowed */
#define SPI_INT_STA_TX_UDR \
(0x1 << 11) /* fxFIFO underrun, when set txFIFO has underrun */
#define SPI_INT_STA_TC (0x1 << 12) /* Transfer Completed */
#define SPI_INT_STA_SSI \
(0x1 << 13) /* SS invalid interrupt, when set SS has changed from \
valid to invalid */
#define SPI_INT_STA_ERR \
(SPI_INT_STA_TX_OVF | SPI_INT_STA_RX_UDR | \
SPI_INT_STA_RX_OVF) /* NO txFIFO underrun */
#define SPI_INT_STA_MASK (0x77 | (0x3f << 8))
/* SPI FIFO Control Register Bit Fields & Masks,default value:0x0040_0001 */
#define SPI_FIFO_CTL_RX_LEVEL \
(0xFF << 0) /* rxFIFO reday request trigger level,default 0x1 */
#define SPI_FIFO_CTL_RX_DRQEN \
(0x1 << 8) /* rxFIFO DMA request enable,1:enable,0:disable */
#define SPI_FIFO_CTL_RX_TESTEN \
(0x1 << 14) /* rxFIFO test mode enable,1:enable,0:disable */
#define SPI_FIFO_CTL_RX_RST \
(0x1 << 15) /* rxFIFO reset, write 1, auto clear to 0 */
#define SPI_FIFO_CTL_TX_LEVEL \
(0xFF << 16) /* txFIFO empty request trigger level,default 0x40 */
#define SPI_FIFO_CTL_TX_DRQEN \
(0x1 << 24) /* txFIFO DMA request enable,1:enable,0:disable */
#define SPI_FIFO_CTL_TX_TESTEN \
(0x1 << 30) /* txFIFO test mode enable,1:enable,0:disable */
#define SPI_FIFO_CTL_TX_RST \
(0x1 << 31) /* txFIFO reset, write 1, auto clear to 0 */
#define SPI_FIFO_CTL_DRQEN_MASK (SPI_FIFO_CTL_TX_DRQEN | SPI_FIFO_CTL_RX_DRQEN)
/* SPI FIFO Status Register Bit Fields & Masks,default value:0x0000_0000 */
#define SPI_FIFO_STA_RX_CNT \
(0xFF << 0) /* rxFIFO counter,how many bytes in rxFIFO */
#define SPI_FIFO_STA_RB_CNT \
(0x7 << 12) /* rxFIFO read buffer counter,how many bytes in rxFIFO \
read buffer */
#define SPI_FIFO_STA_RB_WR (0x1 << 15) /* rxFIFO read buffer write enable */
#define SPI_FIFO_STA_TX_CNT \
(0xFF << 16) /* txFIFO counter,how many bytes in txFIFO */
#define SPI_FIFO_STA_TB_CNT \
(0x7 << 28) /* txFIFO write buffer counter,how many bytes in txFIFO \
write buffer */
#define SPI_FIFO_STA_TB_WR (0x1 << 31) /* txFIFO write buffer write enable */
#define SPI_RXCNT_BIT_POS (0)
#define SPI_TXCNT_BIT_POS (16)
/* SPI Wait Clock Register Bit Fields & Masks,default value:0x0000_0000 */
#define SPI_WAIT_WCC_MASK \
(0xFFFF << 0) /* used only in master mode: Wait Between Transactions \
*/
#define SPI_WAIT_SWC_MASK \
(0xF << 16) /* used only in master mode: Wait before start dual data \
transfer in dual SPI mode */
/* SPI Clock Control Register Bit Fields & Masks,default:0x0000_0002 */
#define SPI_CLK_CTL_CDR2 \
(0xFF << 0) /* Clock Divide Rate 2,master mode only : SPI_CLK = \
AHB_CLK/(2*(n+1)) */
#define SPI_CLK_CTL_CDR1 \
(0xF << 8) /* Clock Divide Rate 1,master mode only : SPI_CLK = \
AHB_CLK/2^n */
#define SPI_CLK_CTL_DRS \
(0x1 << 12) /* Divide rate select,default,0:rate 1;1:rate 2 */
#define SPI_CLK_SCOPE (SPI_CLK_CTL_CDR2 + 1)
/* SPI Master Burst Counter Register Bit Fields & Masks,default:0x0000_0000 */
/* master mode: when SMC = 1,BC specifies total burst number, Max length is
* 16Mbytes */
#define SPI_BC_CNT_MASK \
(0xFFFFFF << 0) /* Total Burst Counter, tx length + rx length ,SMC=1 \
*/
/* SPI Master Transmit Counter reigster default:0x0000_0000 */
#define SPI_TC_CNT_MASK \
(0xFFFFFF \
<< 0) /* Write Transmit Counter, tx length, NOT rx length!!! */
/* SPI Master Burst Control Counter reigster Bit Fields &
* Masks,default:0x0000_0000 */
#define SPI_BCC_STC_MASK \
(0xFFFFFF << 0) /* master single mode transmit counter */
#define SPI_BCC_DBC_MASK (0xF << 24) /* master dummy burst counter */
#define SPI_BCC_DUAL_MODE (0x1 << 28) /* master dual mode RX enable */
#define SPI_BCC_QUAD_MODE (0x1 << 29) /* master quad mode RX enable */
#define SPI_PHA_ACTIVE_ (0x01)
#define SPI_POL_ACTIVE_ (0x02)
#define SPI_MODE_0_ACTIVE_ (0 | 0)
#define SPI_MODE_1_ACTIVE_ (0 | SPI_PHA_ACTIVE_)
#define SPI_MODE_2_ACTIVE_ (SPI_POL_ACTIVE_ | 0)
#define SPI_MODE_3_ACTIVE_ (SPI_POL_ACTIVE_ | SPI_PHA_ACTIVE_)
#define SPI_CS_HIGH_ACTIVE_ (0x04)
#define SPI_LSB_FIRST_ACTIVE_ (0x08)
#define SPI_DUMMY_ONE_ACTIVE_ (0x10)
#define SPI_RECEIVE_ALL_ACTIVE_ (0x20)
#define SUNXI_SPI_DRQ_RX(ch) (DRQSRC_SPI0_RX + ch)
#define SUNXI_SPI_DRQ_TX(ch) (DRQDST_SPI0_TX + ch)
#define SPIM_BUSY (1)
#define SPIM_IDLE (0)
#define spim_set_idle(master_port) \
do { \
g_spi_master_status[master_port] = SPIM_IDLE; \
} while (0)
#define SPI_MASTER_MB_LSB_FIRST (0x1UL << 3)
#define SPI_MASTER_MB_MSB_FIRST (0x0UL << 3)
#define SPI_MASTER_CPOL_0 (0x0UL << 4)
#define SPI_MASTER_CPOL_1 (0x1UL << 4)
#define SPI_MASTER_CPHA_0 (0x0UL << 5)
#define SPI_MASTER_CPHA_1 (0x1UL << 5)
#define SPI_MASTER_INT_DISABLE (0x0UL << 9)
#define SPI_MASTER_INT_ENABLE (0x1UL << 9)
#define SPI_MASTER_HALF_DUPLEX (0x0UL << 10)
#define SPI_MASTER_FULL_DUPLEX (0x1UL << 10)
#define SPI_MASTER_SLAVE_SEL_0 (0x0UL << 29)
#define SPI_MASTER_SLAVE_SEL_1 (0x1UL << 29)
#ifdef __cplusplus
}
#endif
#endif /* __COMMON_SPI_I_H__ */