xref: /freebsd/sys/dev/sdhci/sdhci_xenon.h (revision 59c8e88e72633afbc47a4ace0d2170d00d51f7dc)
1 /*-
2  * Copyright (c) 2018 Rubicon Communications, LLC (Netgate)
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  *
14  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
15  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
16  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
17  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
18  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
19  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
20  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
21  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
22  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
23  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
24  */
25 
26 /*
27  * Marvel Xenon SDHCI driver defines.
28  */
29 
30 #ifndef	_SDHCI_XENON_H_
31 #define	_SDHCI_XENON_H_
32 
33 #define	XENON_LOWEST_SDCLK_FREQ			100000
34 #define	XENON_MMC_MAX_CLK			400000000
35 
36 #define	XENON_SYS_OP_CTRL			0x0108
37 #define	 XENON_AUTO_CLKGATE_DISABLE		(1 << 20)
38 #define	 XENON_SDCLK_IDLEOFF_ENABLE_SHIFT	8
39 
40 #define	XENON_SYS_EXT_OP_CTRL			0x010C
41 #define	 XENON_MASK_CMD_CONFLICT_ERR		(1 << 8)
42 
43 #define	XENON_SLOT_EMMC_CTRL			0x0130
44 #define	 XENON_ENABLE_DATA_STROBE		(1 << 24)
45 #define	 XENON_ENABLE_RESP_STROBE		(1 << 25)
46 
47 /* Custom HS200 / HS400 Mode Select values in SDHCI_HOST_CONTROL2 register. */
48 #define	XENON_CTRL2_MMC_HS200			0x5
49 #define	XENON_CTRL2_MMC_HS400			0x6
50 
51 /* eMMC PHY */
52 #define	XENON_EMMC_PHY_REG_BASE			0x170
53 
54 #define	XENON_EMMC_PHY_TIMING_ADJUST		XENON_EMMC_PHY_REG_BASE
55 #define	 XENON_SAMPL_INV_QSP_PHASE_SELECT	(1 << 18)
56 #define	 XENON_TIMING_ADJUST_SDIO_MODE		(1 << 28)
57 #define	 XENON_TIMING_ADJUST_SLOW_MODE		(1 << 29)
58 #define	 XENON_PHY_INITIALIZATION		(1U << 31)
59 #define	 XENON_WAIT_CYCLE_BEFORE_USING_MASK	0xF
60 #define	 XENON_WAIT_CYCLE_BEFORE_USING_SHIFT	12
61 #define	 XENON_FC_SYNC_EN_DURATION_MASK		0xF
62 #define	 XENON_FC_SYNC_EN_DURATION_SHIFT	8
63 #define	 XENON_FC_SYNC_RST_EN_DURATION_MASK	0xF
64 #define	 XENON_FC_SYNC_RST_EN_DURATION_SHIFT	4
65 #define	 XENON_FC_SYNC_RST_DURATION_MASK	0xF
66 #define	 XENON_FC_SYNC_RST_DURATION_SHIFT	0
67 
68 #define	XENON_EMMC_PHY_FUNC_CONTROL		(XENON_EMMC_PHY_REG_BASE + 0x4)
69 #define	 XENON_DQ_ASYNC_MODE			(1 << 4)
70 #define	 XENON_CMD_DDR_MODE			(1 << 16)
71 #define	 XENON_DQ_DDR_MODE_SHIFT		8
72 #define	 XENON_DQ_DDR_MODE_MASK			0xFF
73 #define	 XENON_ASYNC_DDRMODE_MASK		(1 << 23)
74 #define	 XENON_ASYNC_DDRMODE_SHIFT		23
75 
76 #define	XENON_EMMC_PHY_PAD_CONTROL		(XENON_EMMC_PHY_REG_BASE + 0x8)
77 #define	 XENON_FC_DQ_RECEN			(1 << 24)
78 #define	 XENON_FC_CMD_RECEN			(1 << 25)
79 #define	 XENON_FC_QSP_RECEN			(1 << 26)
80 #define	 XENON_FC_QSN_RECEN			(1 << 27)
81 #define	 XENON_OEN_QSN				(1 << 28)
82 #define	 XENON_FC_ALL_CMOS_RECEIVER		0xF000
83 
84 #define	XENON_EMMC_PHY_PAD_CONTROL1		(XENON_EMMC_PHY_REG_BASE + 0xC)
85 #define	 XENON_EMMC_FC_CMD_PD			(1 << 8)
86 #define	 XENON_EMMC_FC_QSP_PD			(1 << 9)
87 #define	 XENON_EMMC_FC_CMD_PU			(1 << 24)
88 #define	 XENON_EMMC_FC_QSP_PU			(1 << 25)
89 #define	 XENON_EMMC_FC_DQ_PD			0xFF
90 #define	 XENON_EMMC_FC_DQ_PU			(0xFF << 16)
91 
92 #define	XENON_EMMC_PHY_PAD_CONTROL2		(XENON_EMMC_PHY_REG_BASE + 0x10)
93 #define	 XENON_ZNR_MASK				0x1F
94 #define	 XENON_ZNR_SHIFT			8
95 #define	 XENON_ZPR_MASK				0x1F
96 #define	 XENON_ZNR_DEF_VALUE			0xF
97 #define	 XENON_ZPR_DEF_VALUE			0xF
98 
99 #define	XENON_EMMC_PHY_LOGIC_TIMING_ADJUST	(XENON_EMMC_PHY_REG_BASE + 0x18)
100 #define	 XENON_LOGIC_TIMING_VALUE		0x00AA8977
101 
102 DECLARE_CLASS(sdhci_xenon_driver);
103 
104 struct sdhci_xenon_softc {
105 	device_t	dev;		/* Controller device */
106 	int		slot_id;	/* Controller ID */
107 
108 	struct resource	*mem_res;	/* Memory resource */
109 	struct resource *irq_res;	/* IRQ resource */
110 	void		*intrhand;	/* Interrupt handle */
111 
112 	struct sdhci_slot *slot;	/* SDHCI internal data */
113 
114 	uint8_t		znr;		/* PHY ZNR */
115 	uint8_t		zpr;		/* PHY ZPR */
116 	bool		slow_mode;	/* PHY slow mode */
117 	bool		wp_inverted;
118 	bool		skip_regulators; /* Don't switch regulators */
119 
120 	regulator_t	vmmc_supply;
121 	regulator_t	vqmmc_supply;
122 
123 #ifdef FDT
124 	struct sdhci_fdt_gpio *gpio;	/* GPIO pins for CD detection. */
125 #endif
126 };
127 
128 device_attach_t sdhci_xenon_attach;
129 device_detach_t sdhci_xenon_detach;
130 
131 #endif	/* _SDHCI_XENON_H_ */
132