1 /*
2  * Copyright (C) 2007-2008 Freescale Semiconductor, Inc.
3  *		Dave Liu <daveliu@freescale.com>
4  *
5  * This program is free software; you can redistribute it and/or
6  * modify it under the terms of the GNU General Public License as
7  * published by the Free Software Foundation; either version 2 of
8  * the License, or (at your option) any later version.
9  *
10  * This program is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13  * GNU General Public License for more details.
14  *
15  * You should have received a copy of the GNU General Public License
16  * along with this program; if not, write to the Free Software
17  * Foundation, Inc., 59 Temple Place, Suite 330, Boston,
18  * MA 02111-1307 USA
19  */
20 
21 #ifndef __FSL_SATA_H__
22 #define __FSL_SATA_H__
23 
24 #define SATA_HC_MAX_NUM		4 /* Max host controller numbers */
25 #define SATA_HC_MAX_CMD		16 /* Max command queue depth per host controller */
26 #define SATA_HC_MAX_PORT	16 /* Max port number per host controller */
27 
28 /*
29 * SATA Host Controller Registers
30 */
31 typedef struct fsl_sata_reg {
32 	/* SATA command registers */
33 	u32 cqr;		/* Command queue register */
34 	u8 res1[0x4];
35 	u32 car;		/* Command active register */
36 	u8 res2[0x4];
37 	u32 ccr;		/* Command completed register */
38 	u8 res3[0x4];
39 	u32 cer;		/* Command error register */
40 	u8 res4[0x4];
41 	u32 der;		/* Device error register */
42 	u32 chba;		/* Command header base address */
43 	u32 hstatus;		/* Host status register */
44 	u32 hcontrol;		/* Host control register */
45 	u32 cqpmp;		/* Port number queue register */
46 	u32 sig;		/* Signature register */
47 	u32 icc;		/* Interrupt coalescing control register */
48 	u8 res5[0xc4];
49 
50 	/* SATA supperset registers */
51 	u32 sstatus;		/* SATA interface status register */
52 	u32 serror;		/* SATA interface error register */
53 	u32 scontrol;		/* SATA interface control register */
54 	u32 snotification;	/* SATA interface notification register */
55 	u8 res6[0x30];
56 
57 	/* SATA control status registers */
58 	u32 transcfg;		/* Transport layer configuration */
59 	u32 transstatus;	/* Transport layer status */
60 	u32 linkcfg;		/* Link layer configuration */
61 	u32 linkcfg1;		/* Link layer configuration1 */
62 	u32 linkcfg2;		/* Link layer configuration2 */
63 	u32 linkstatus;		/* Link layer status */
64 	u32 linkstatus1;	/* Link layer status1 */
65 	u32 phyctrlcfg;		/* PHY control configuration */
66 	u8 res7[0x2b0];
67 
68 	/* SATA system control registers */
69 	u32 syspr;		/* System priority register - big endian */
70 	u8 res8[0xbec];
71 } __attribute__ ((packed)) fsl_sata_reg_t;
72 
73 /* HStatus register
74 */
75 #define HSTATUS_ONOFF			0x80000000 /* Online/offline status */
76 #define HSTATUS_FORCE_OFFLINE		0x40000000 /* In process going offline */
77 #define HSTATUS_BIST_ERR		0x20000000
78 
79 /* Fatal error */
80 #define HSTATUS_MASTER_ERR		0x00004000
81 #define HSTATUS_DATA_UNDERRUN		0x00002000
82 #define HSTATUS_DATA_OVERRUN		0x00001000
83 #define HSTATUS_CRC_ERR_TX		0x00000800
84 #define HSTATUS_CRC_ERR_RX		0x00000400
85 #define HSTATUS_FIFO_OVERFLOW_TX	0x00000200
86 #define HSTATUS_FIFO_OVERFLOW_RX	0x00000100
87 #define HSTATUS_FATAL_ERR_ALL		(HSTATUS_MASTER_ERR | \
88 					HSTATUS_DATA_UNDERRUN | \
89 					HSTATUS_DATA_OVERRUN | \
90 					HSTATUS_CRC_ERR_TX | \
91 					HSTATUS_CRC_ERR_RX | \
92 					HSTATUS_FIFO_OVERFLOW_TX | \
93 					HSTATUS_FIFO_OVERFLOW_RX)
94 /* Interrupt status */
95 #define HSTATUS_FATAL_ERR		0x00000020
96 #define HSTATUS_PHY_RDY			0x00000010
97 #define HSTATUS_SIGNATURE		0x00000008
98 #define HSTATUS_SNOTIFY			0x00000004
99 #define HSTATUS_DEVICE_ERR		0x00000002
100 #define HSTATUS_CMD_COMPLETE		0x00000001
101 
102 /* HControl register
103 */
104 #define HCONTROL_ONOFF			0x80000000 /* Online or offline request */
105 #define HCONTROL_FORCE_OFFLINE		0x40000000 /* Force offline request */
106 #define HCONTROL_HDR_SNOOP		0x00000400 /* Command header snoop */
107 #define HCONTROL_PMP_ATTACHED		0x00000200 /* Port multiplier attached */
108 
109 /* Interrupt enable */
110 #define HCONTROL_FATAL_ERR		0x00000020
111 #define HCONTROL_PHY_RDY		0x00000010
112 #define HCONTROL_SIGNATURE		0x00000008
113 #define HCONTROL_SNOTIFY		0x00000004
114 #define HCONTROL_DEVICE_ERR		0x00000002
115 #define HCONTROL_CMD_COMPLETE		0x00000001
116 
117 #define HCONTROL_INT_EN_ALL		(HCONTROL_FATAL_ERR | \
118 					HCONTROL_PHY_RDY | \
119 					HCONTROL_SIGNATURE | \
120 					HCONTROL_SNOTIFY | \
121 					HCONTROL_DEVICE_ERR | \
122 					HCONTROL_CMD_COMPLETE)
123 
124 /* SStatus register
125 */
126 #define SSTATUS_IPM_MASK		0x00000780
127 #define SSTATUS_IPM_NOPRESENT		0x00000000
128 #define SSTATUS_IPM_ACTIVE		0x00000080
129 #define SSTATUS_IPM_PATIAL		0x00000100
130 #define SSTATUS_IPM_SLUMBER		0x00000300
131 
132 #define SSTATUS_SPD_MASK		0x000000f0
133 #define SSTATUS_SPD_GEN1		0x00000010
134 #define SSTATUS_SPD_GEN2		0x00000020
135 
136 #define SSTATUS_DET_MASK		0x0000000f
137 #define SSTATUS_DET_NODEVICE		0x00000000
138 #define SSTATUS_DET_DISCONNECT		0x00000001
139 #define SSTATUS_DET_CONNECT		0x00000003
140 #define SSTATUS_DET_PHY_OFFLINE		0x00000004
141 
142 /* SControl register
143 */
144 #define SCONTROL_SPM_MASK		0x0000f000
145 #define SCONTROL_SPM_GO_PARTIAL		0x00001000
146 #define SCONTROL_SPM_GO_SLUMBER		0x00002000
147 #define SCONTROL_SPM_GO_ACTIVE		0x00004000
148 
149 #define SCONTROL_IPM_MASK		0x00000f00
150 #define SCONTROL_IPM_NO_RESTRICT	0x00000000
151 #define SCONTROL_IPM_PARTIAL		0x00000100
152 #define SCONTROL_IPM_SLUMBER		0x00000200
153 #define SCONTROL_IPM_PART_SLUM		0x00000300
154 
155 #define SCONTROL_SPD_MASK		0x000000f0
156 #define SCONTROL_SPD_NO_RESTRICT	0x00000000
157 #define SCONTROL_SPD_GEN1		0x00000010
158 #define SCONTROL_SPD_GEN2		0x00000020
159 
160 #define SCONTROL_DET_MASK		0x0000000f
161 #define SCONTROL_DET_HRESET		0x00000001
162 #define SCONTROL_DET_DISABLE		0x00000004
163 
164 /* TransCfg register
165 */
166 #define TRANSCFG_DFIS_SIZE_SHIFT	16
167 #define TRANSCFG_RX_WATER_MARK_MASK	0x0000001f
168 
169 /* PhyCtrlCfg register
170 */
171 #define PHYCTRLCFG_FPRFTI_MASK		0x00000018
172 #define PHYCTRLCFG_LOOPBACK_MASK	0x0000000e
173 
174 /*
175 * Command Header Entry
176 */
177 typedef struct cmd_hdr_entry {
178 	u32 cda;		/* Command Descriptor Address, 4 bytes aligned */
179 	u32 prde_fis_len;	/* Number of PRD entries and FIS length */
180 	u32 ttl;		/* Total transfer length */
181 	u32 attribute;		/* the attribute of command */
182 } __attribute__ ((packed)) cmd_hdr_entry_t;
183 
184 #define SATA_HC_CMD_HDR_ENTRY_SIZE	sizeof(struct cmd_hdr_entry)
185 
186 /* cda
187 */
188 #define CMD_HDR_CDA_ALIGN	4
189 
190 /* prde_fis_len
191 */
192 #define CMD_HDR_PRD_ENTRY_SHIFT	16
193 #define CMD_HDR_PRD_ENTRY_MASK	0x003f0000
194 #define CMD_HDR_FIS_LEN_SHIFT	2
195 
196 /* attribute
197 */
198 #define CMD_HDR_ATTR_RES	0x00000800 /* Reserved bit, should be 1 */
199 #define CMD_HDR_ATTR_VBIST	0x00000400 /* Vendor BIST */
200 #define CMD_HDR_ATTR_SNOOP	0x00000200 /* Snoop enable for all descriptor */
201 #define CMD_HDR_ATTR_FPDMA	0x00000100 /* FPDMA queued command */
202 #define CMD_HDR_ATTR_RESET	0x00000080 /* Reset - a SRST or device reset */
203 #define CMD_HDR_ATTR_BIST	0x00000040 /* BIST - require the host to enter BIST mode */
204 #define CMD_HDR_ATTR_ATAPI	0x00000020 /* ATAPI command */
205 #define CMD_HDR_ATTR_TAG	0x0000001f /* TAG mask */
206 
207 /* command type
208 */
209 enum cmd_type {
210 	CMD_VENDOR_BIST,
211 	CMD_BIST,
212 	CMD_RESET,	/* SRST or device reset */
213 	CMD_ATAPI,
214 	CMD_NCQ,
215 	CMD_ATA,	/* None of all above */
216 };
217 
218 /*
219 * Command Header Table
220 */
221 typedef struct cmd_hdr_tbl {
222 	cmd_hdr_entry_t cmd_slot[SATA_HC_MAX_CMD];
223 } __attribute__ ((packed)) cmd_hdr_tbl_t;
224 
225 #define SATA_HC_CMD_HDR_TBL_SIZE	sizeof(struct cmd_hdr_tbl)
226 #define SATA_HC_CMD_HDR_TBL_ALIGN	4
227 
228 /*
229 * PRD entry - Physical Region Descriptor entry
230 */
231 typedef struct prd_entry {
232 	u32 dba;	/* Data base address, 4 bytes aligned */
233 	u32 res1;
234 	u32 res2;
235 	u32 ext_c_ddc;	/* Indirect PRD flags, snoop and data word count */
236 } __attribute__ ((packed)) prd_entry_t;
237 
238 #define SATA_HC_CMD_DESC_PRD_SIZE	sizeof(struct prd_entry)
239 
240 /* dba
241 */
242 #define PRD_ENTRY_DBA_ALIGN	4
243 
244 /* ext_c_ddc
245 */
246 #define PRD_ENTRY_EXT		0x80000000 /* extension flag */
247 #ifdef CONFIG_FSL_SATA_V2
248 #define PRD_ENTRY_DATA_SNOOP	0x10000000 /* Data snoop enable */
249 #else
250 #define PRD_ENTRY_DATA_SNOOP	0x00400000 /* Data snoop enable */
251 #endif
252 #define PRD_ENTRY_LEN_MASK	0x003fffff /* Data word count */
253 
254 #define PRD_ENTRY_MAX_XFER_SZ	(PRD_ENTRY_LEN_MASK + 1)
255 
256 /*
257  * This SATA host controller supports a max of 16 direct PRD entries, but if use
258  * chained indirect PRD entries, then the contollers supports upto a max of 63
259  * entries including direct and indirect PRD entries.
260  * The PRDT is an array of 63 PRD entries contigiously, but the PRD entries#15
261  * will be setup as an indirect descriptor, pointing to it's next (contigious)
262  * PRD entries#16.
263  */
264 #define SATA_HC_MAX_PRD		63 /* Max PRD entry numbers per command */
265 #define SATA_HC_MAX_PRD_DIRECT	16 /* Direct PRDT entries */
266 #define SATA_HC_MAX_PRD_USABLE	(SATA_HC_MAX_PRD - 1)
267 #define SATA_HC_MAX_XFER_LEN	0x4000000
268 
269 /*
270 * PRDT - Physical Region Descriptor Table
271 */
272 typedef struct prdt {
273 	prd_entry_t prdt[SATA_HC_MAX_PRD];
274 } __attribute__ ((packed)) prdt_t;
275 
276 /*
277 * Command Descriptor
278 */
279 #define SATA_HC_CMD_DESC_CFIS_SIZE	32 /* bytes */
280 #define SATA_HC_CMD_DESC_SFIS_SIZE	32 /* bytes */
281 #define SATA_HC_CMD_DESC_ACMD_SIZE	16 /* bytes */
282 #define SATA_HC_CMD_DESC_RES		16 /* bytes */
283 
284 typedef struct cmd_desc {
285 	u8 cfis[SATA_HC_CMD_DESC_CFIS_SIZE];
286 	u8 sfis[SATA_HC_CMD_DESC_SFIS_SIZE];
287 	u8 acmd[SATA_HC_CMD_DESC_ACMD_SIZE];
288 	u8 res[SATA_HC_CMD_DESC_RES];
289 	prd_entry_t prdt[SATA_HC_MAX_PRD];
290 } __attribute__ ((packed)) cmd_desc_t;
291 
292 #define SATA_HC_CMD_DESC_SIZE		sizeof(struct cmd_desc)
293 #define SATA_HC_CMD_DESC_ALIGN		4
294 
295 /*
296  * SATA device driver info
297  */
298 typedef struct fsl_sata_info {
299 	u32	sata_reg_base;
300 	u32	flags;
301 } fsl_sata_info_t;
302 
303 #define FLAGS_DMA	0x00000000
304 #define FLAGS_FPDMA	0x00000001
305 
306 /*
307  * SATA device driver struct
308  */
309 typedef struct fsl_sata {
310 	char		name[12];
311 	fsl_sata_reg_t	*reg_base;		/* the base address of controller register */
312 	void		*cmd_hdr_tbl_offset;	/* alloc address of command header table */
313 	cmd_hdr_tbl_t	*cmd_hdr;		/* aligned address of command header table */
314 	void		*cmd_desc_offset;	/* alloc address of command descriptor */
315 	cmd_desc_t	*cmd_desc;		/* aligned address of command descriptor */
316 	int		link;			/* PHY link status */
317 	/* device attribute */
318 	int		ata_device_type;	/* device type */
319 	int		lba48;
320 	int		queue_depth;		/* Max NCQ queue depth */
321 	u16		pio;
322 	u16		mwdma;
323 	u16		udma;
324 	int		wcache;
325 	int		flush;
326 	int		flush_ext;
327 } fsl_sata_t;
328 
329 #define READ_CMD	0
330 #define WRITE_CMD	1
331 
332 #endif /* __FSL_SATA_H__ */
333