xref: /freebsd/sys/dev/qcom_qup/qcom_spi_reg.h (revision f126890ac5386406dadf7c4cfa9566cbb56537c5)
1 /*-
2  * SPDX-License-Identifier: BSD-2-Clause
3  *
4  * Copyright (c) 2021 Adrian Chadd <adrian@FreeBSD.org>
5  *
6  * Redistribution and use in source and binary forms, with or without
7  * modification, are permitted provided that the following conditions
8  * are met:
9  * 1. Redistributions of source code must retain the above copyright
10  *    notice, this list of conditions and the following disclaimer.
11  * 2. Redistributions in binary form must reproduce the above copyright
12  *    notice, this list of conditions and the following disclaimer in the
13  *    documentation and/or other materials provided with the distribution.
14  *
15  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
16  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
19  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
21  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
25  * SUCH DAMAGE.
26  */
27 
28 #ifndef	__QCOM_SPI_REG_H__
29 #define	__QCOM_SPI_REG_H__
30 
31 #define	SPI_CONFIG			0x0300
32 #define		SPI_CONFIG_HS_MODE	(1U << 10)
33 #define		SPI_CONFIG_INPUT_FIRST	(1U << 9)
34 #define		SPI_CONFIG_LOOPBACK	(1U << 8)
35 
36 #define	SPI_IO_CONTROL			0x0304
37 #define		SPI_IO_C_FORCE_CS		(1U << 11)
38 #define		SPI_IO_C_CLK_IDLE_HIGH		(1U << 10)
39 #define		SPI_IO_C_MX_CS_MODE		(1U << 8)
40 #define		SPI_IO_C_CS_N_POLARITY_0	(1U << 4)
41 #define		SPI_IO_C_CS_SELECT(x)		(((x) & 3) << 2)
42 #define		SPI_IO_C_CS_SELECT_MASK		0x000c
43 #define		SPI_IO_C_TRISTATE_CS		(1U << 1)
44 #define		SPI_IO_C_NO_TRI_STATE		(1U << 0)
45 
46 #define	SPI_ERROR_FLAGS			0x0308
47 #define	SPI_ERROR_FLAGS_EN		0x030c
48 #define		SPI_ERROR_CLK_OVER_RUN		(1U << 1)
49 #define		SPI_ERROR_CLK_UNDER_RUN		(1U << 0)
50 
51 /*
52  * Strictly this isn't true; some controllers have
53  * less CS lines exposed via GPIO/pinmux.
54  */
55 #define	SPI_NUM_CHIPSELECTS		4
56 
57 /*
58  * The maximum single SPI transaction done in any mode.
59  * Ie, if you have a PIO/DMA transaction larger than
60  * this then it must be split up into SPI_MAX_XFER
61  * sub-transactions in the transfer loop.
62  */
63 #define	SPI_MAX_XFER			(65536 - 64)
64 
65 /*
66  * Any frequency at or above 26MHz is considered "high"
67  * and will have some different parameters configured.
68  */
69 #define	SPI_HS_MIN_RATE			26000000
70 
71 #define	SPI_MAX_RATE			50000000
72 
73 #endif	/* __QCOM_SPI_REG_H__ */
74 
75