1 /* SPDX-License-Identifier: GPL-2.0-or-later */
2 /*
3  *  include/linux/mmc/sdio.h
4  *
5  *  Copyright 2006-2007 Pierre Ossman
6  */
7 
8 #ifndef LINUX_MMC_SDIO_H
9 #define LINUX_MMC_SDIO_H
10 
11 /* SDIO commands                         type  argument     response */
12 #define SD_IO_SEND_OP_COND          5 /* bcr  [23:0] OCR         R4  */
13 #define SD_IO_RW_DIRECT            52 /* ac   [31:0] See below   R5  */
14 #define SD_IO_RW_EXTENDED          53 /* adtc [31:0] See below   R5  */
15 
16 /*
17  * SD_IO_RW_DIRECT argument format:
18  *
19  *      [31] R/W flag
20  *      [30:28] Function number
21  *      [27] RAW flag
22  *      [25:9] Register address
23  *      [7:0] Data
24  */
25 
26 /*
27  * SD_IO_RW_EXTENDED argument format:
28  *
29  *      [31] R/W flag
30  *      [30:28] Function number
31  *      [27] Block mode
32  *      [26] Increment address
33  *      [25:9] Register address
34  *      [8:0] Byte/block count
35  */
36 
37 #define R4_18V_PRESENT (1<<24)
38 #define R4_MEMORY_PRESENT (1 << 27)
39 
40 /*
41   SDIO status in R5
42   Type
43 	e : error bit
44 	s : status bit
45 	r : detected and set for the actual command response
46 	x : detected and set during command execution. the host must poll
47             the card by sending status command in order to read these bits.
48   Clear condition
49 	a : according to the card state
50 	b : always related to the previous command. Reception of
51             a valid command will clear it (with a delay of one command)
52 	c : clear by read
53  */
54 
55 #define R5_COM_CRC_ERROR	(1 << 15)	/* er, b */
56 #define R5_ILLEGAL_COMMAND	(1 << 14)	/* er, b */
57 #define R5_ERROR		(1 << 11)	/* erx, c */
58 #define R5_FUNCTION_NUMBER	(1 << 9)	/* er, c */
59 #define R5_OUT_OF_RANGE		(1 << 8)	/* er, c */
60 #define R5_STATUS(x)		(x & 0xCB00)
61 #define R5_IO_CURRENT_STATE(x)	((x & 0x3000) >> 12) /* s, b */
62 
63 /*
64  * Card Common Control Registers (CCCR)
65  */
66 
67 #define SDIO_CCCR_CCCR		0x00
68 
69 #define  SDIO_CCCR_REV_1_00	0	/* CCCR/FBR Version 1.00 */
70 #define  SDIO_CCCR_REV_1_10	1	/* CCCR/FBR Version 1.10 */
71 #define  SDIO_CCCR_REV_1_20	2	/* CCCR/FBR Version 1.20 */
72 #define  SDIO_CCCR_REV_3_00	3	/* CCCR/FBR Version 3.00 */
73 
74 #define  SDIO_SDIO_REV_1_00	0	/* SDIO Spec Version 1.00 */
75 #define  SDIO_SDIO_REV_1_10	1	/* SDIO Spec Version 1.10 */
76 #define  SDIO_SDIO_REV_1_20	2	/* SDIO Spec Version 1.20 */
77 #define  SDIO_SDIO_REV_2_00	3	/* SDIO Spec Version 2.00 */
78 #define  SDIO_SDIO_REV_3_00	4	/* SDIO Spec Version 3.00 */
79 
80 #define SDIO_CCCR_SD		0x01
81 
82 #define  SDIO_SD_REV_1_01	0	/* SD Physical Spec Version 1.01 */
83 #define  SDIO_SD_REV_1_10	1	/* SD Physical Spec Version 1.10 */
84 #define  SDIO_SD_REV_2_00	2	/* SD Physical Spec Version 2.00 */
85 #define  SDIO_SD_REV_3_00	3	/* SD Physical Spec Version 3.00 */
86 
87 #define SDIO_CCCR_IOEx		0x02
88 #define SDIO_CCCR_IORx		0x03
89 
90 #define SDIO_CCCR_IENx		0x04	/* Function/Master Interrupt Enable */
91 #define SDIO_CCCR_INTx		0x05	/* Function Interrupt Pending */
92 
93 #define SDIO_CCCR_ABORT		0x06	/* function abort/card reset */
94 
95 #define SDIO_CCCR_IF		0x07	/* bus interface controls */
96 
97 #define  SDIO_BUS_WIDTH_MASK	0x03	/* data bus width setting */
98 #define  SDIO_BUS_WIDTH_1BIT	0x00
99 #define  SDIO_BUS_WIDTH_RESERVED 0x01
100 #define  SDIO_BUS_WIDTH_4BIT	0x02
101 #define  SDIO_BUS_ECSI		0x20	/* Enable continuous SPI interrupt */
102 #define  SDIO_BUS_SCSI		0x40	/* Support continuous SPI interrupt */
103 
104 #define  SDIO_BUS_ASYNC_INT	0x20
105 
106 #define  SDIO_BUS_CD_DISABLE     0x80	/* disable pull-up on DAT3 (pin 1) */
107 
108 #define SDIO_CCCR_CAPS		0x08
109 
110 #define  SDIO_CCCR_CAP_SDC	0x01	/* can do CMD52 while data transfer */
111 #define  SDIO_CCCR_CAP_SMB	0x02	/* can do multi-block xfers (CMD53) */
112 #define  SDIO_CCCR_CAP_SRW	0x04	/* supports read-wait protocol */
113 #define  SDIO_CCCR_CAP_SBS	0x08	/* supports suspend/resume */
114 #define  SDIO_CCCR_CAP_S4MI	0x10	/* interrupt during 4-bit CMD53 */
115 #define  SDIO_CCCR_CAP_E4MI	0x20	/* enable ints during 4-bit CMD53 */
116 #define  SDIO_CCCR_CAP_LSC	0x40	/* low speed card */
117 #define  SDIO_CCCR_CAP_4BLS	0x80	/* 4 bit low speed card */
118 
119 #define SDIO_CCCR_CIS		0x09	/* common CIS pointer (3 bytes) */
120 
121 /* Following 4 regs are valid only if SBS is set */
122 #define SDIO_CCCR_SUSPEND	0x0c
123 #define SDIO_CCCR_SELx		0x0d
124 #define SDIO_CCCR_EXECx		0x0e
125 #define SDIO_CCCR_READYx	0x0f
126 
127 #define SDIO_CCCR_BLKSIZE	0x10
128 
129 #define SDIO_CCCR_POWER		0x12
130 
131 #define  SDIO_POWER_SMPC	0x01	/* Supports Master Power Control */
132 #define  SDIO_POWER_EMPC	0x02	/* Enable Master Power Control */
133 
134 #define SDIO_CCCR_SPEED		0x13
135 
136 #define  SDIO_SPEED_SHS		0x01	/* Supports High-Speed mode */
137 #define  SDIO_SPEED_BSS_SHIFT	1
138 #define  SDIO_SPEED_BSS_MASK	(7<<SDIO_SPEED_BSS_SHIFT)
139 #define  SDIO_SPEED_SDR12	(0<<SDIO_SPEED_BSS_SHIFT)
140 #define  SDIO_SPEED_SDR25	(1<<SDIO_SPEED_BSS_SHIFT)
141 #define  SDIO_SPEED_SDR50	(2<<SDIO_SPEED_BSS_SHIFT)
142 #define  SDIO_SPEED_SDR104	(3<<SDIO_SPEED_BSS_SHIFT)
143 #define  SDIO_SPEED_DDR50	(4<<SDIO_SPEED_BSS_SHIFT)
144 #define  SDIO_SPEED_EHS		SDIO_SPEED_SDR25	/* Enable High-Speed */
145 
146 #define SDIO_CCCR_UHS		0x14
147 #define  SDIO_UHS_SDR50		0x01
148 #define  SDIO_UHS_SDR104	0x02
149 #define  SDIO_UHS_DDR50		0x04
150 
151 #define SDIO_CCCR_DRIVE_STRENGTH 0x15
152 #define  SDIO_SDTx_MASK		0x07
153 #define  SDIO_DRIVE_SDTA	(1<<0)
154 #define  SDIO_DRIVE_SDTC	(1<<1)
155 #define  SDIO_DRIVE_SDTD	(1<<2)
156 #define  SDIO_DRIVE_DTSx_MASK	0x03
157 #define  SDIO_DRIVE_DTSx_SHIFT	4
158 #define  SDIO_DTSx_SET_TYPE_B	(0 << SDIO_DRIVE_DTSx_SHIFT)
159 #define  SDIO_DTSx_SET_TYPE_A	(1 << SDIO_DRIVE_DTSx_SHIFT)
160 #define  SDIO_DTSx_SET_TYPE_C	(2 << SDIO_DRIVE_DTSx_SHIFT)
161 #define  SDIO_DTSx_SET_TYPE_D	(3 << SDIO_DRIVE_DTSx_SHIFT)
162 
163 #define SDIO_CCCR_INTERRUPT_EXT	0x16
164 #define SDIO_INTERRUPT_EXT_SAI	(1 << 0)
165 #define SDIO_INTERRUPT_EXT_EAI	(1 << 1)
166 
167 /*
168  * Function Basic Registers (FBR)
169  */
170 
171 #define SDIO_FBR_BASE(f)	((f) * 0x100) /* base of function f's FBRs */
172 
173 #define SDIO_FBR_STD_IF		0x00
174 
175 #define  SDIO_FBR_SUPPORTS_CSA	0x40	/* supports Code Storage Area */
176 #define  SDIO_FBR_ENABLE_CSA	0x80	/* enable Code Storage Area */
177 
178 #define SDIO_FBR_STD_IF_EXT	0x01
179 
180 #define SDIO_FBR_POWER		0x02
181 
182 #define  SDIO_FBR_POWER_SPS	0x01	/* Supports Power Selection */
183 #define  SDIO_FBR_POWER_EPS	0x02	/* Enable (low) Power Selection */
184 
185 #define SDIO_FBR_CIS		0x09	/* CIS pointer (3 bytes) */
186 
187 
188 #define SDIO_FBR_CSA		0x0C	/* CSA pointer (3 bytes) */
189 
190 #define SDIO_FBR_CSA_DATA	0x0F
191 
192 #define SDIO_FBR_BLKSIZE	0x10	/* block size (2 bytes) */
193 
194 #endif /* LINUX_MMC_SDIO_H */
195