]> git.kernelconcepts.de Git - karo-tx-uboot.git/blob - include/ata.h
Cleanup coding style; update CHANGELOG
[karo-tx-uboot.git] / include / ata.h
1 /*
2  * (C) Copyright 2000
3  * Wolfgang Denk, DENX Software Engineering, wd@denx.de.
4  *
5  * See file CREDITS for list of people who contributed to this
6  * project.
7  *
8  * This program is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU General Public License as
10  * published by the Free Software Foundation; either version 2 of
11  * the License, or (at your option) any later version.
12  *
13  * This program is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16  * GNU General Public License for more details.
17  *
18  * You should have received a copy of the GNU General Public License
19  * along with this program; if not, write to the Free Software
20  * Foundation, Inc., 59 Temple Place, Suite 330, Boston,
21  * MA 02111-1307 USA
22  */
23
24 /*
25  * Most of the following information was derived from the document
26  * "Information Technology - AT Attachment-3 Interface (ATA-3)"
27  * which can be found at:
28  * http://www.dt.wdc.com/ata/ata-3/ata3r5v.zip
29  * ftp://poctok.iae.nsk.su/pub/asm/Documents/IDE/ATA3R5V.ZIP
30  * ftp://ftp.fee.vutbr.cz/pub/doc/io/ata/ata-3/ata3r5v.zip
31  */
32
33 #ifndef _ATA_H
34 #define _ATA_H
35
36 /* Register addressing depends on the hardware design; for instance,
37  * 8-bit (register) and 16-bit (data) accesses might use different
38  * address spaces. This is implemented by the following definitions.
39  */
40 #ifndef CFG_ATA_STRIDE
41 #define CFG_ATA_STRIDE  1
42 #endif
43
44 #define ATA_IO_DATA(x)  (CFG_ATA_DATA_OFFSET+((x) * CFG_ATA_STRIDE))
45 #define ATA_IO_REG(x)   (CFG_ATA_REG_OFFSET +((x) * CFG_ATA_STRIDE))
46 #define ATA_IO_ALT(x)   (CFG_ATA_ALT_OFFSET +((x) * CFG_ATA_STRIDE))
47
48 /*
49  * I/O Register Descriptions
50  */
51 #define ATA_DATA_REG    ATA_IO_DATA(0)
52 #define ATA_ERROR_REG   ATA_IO_REG(1)
53 #define ATA_SECT_CNT    ATA_IO_REG(2)
54 #define ATA_SECT_NUM    ATA_IO_REG(3)
55 #define ATA_CYL_LOW     ATA_IO_REG(4)
56 #define ATA_CYL_HIGH    ATA_IO_REG(5)
57 #define ATA_DEV_HD      ATA_IO_REG(6)
58 #define ATA_COMMAND     ATA_IO_REG(7)
59 #define ATA_DATA_EVEN   ATA_IO_REG(8)
60 #define ATA_DATA_ODD    ATA_IO_REG(9)
61 #define ATA_STATUS      ATA_COMMAND
62 #define ATA_DEV_CTL     ATA_IO_ALT(6)
63 #define ATA_LBA_LOW     ATA_SECT_NUM
64 #define ATA_LBA_MID     ATA_CYL_LOW
65 #define ATA_LBA_HIGH    ATA_CYL_HIGH
66 #define ATA_LBA_SEL     ATA_DEV_CTL
67
68 /*
69  * Status register bits
70  */
71 #define ATA_STAT_BUSY   0x80    /* Device Busy                  */
72 #define ATA_STAT_READY  0x40    /* Device Ready                 */
73 #define ATA_STAT_FAULT  0x20    /* Device Fault                 */
74 #define ATA_STAT_SEEK   0x10    /* Device Seek Complete         */
75 #define ATA_STAT_DRQ    0x08    /* Data Request (ready)         */
76 #define ATA_STAT_CORR   0x04    /* Corrected Data Error         */
77 #define ATA_STAT_INDEX  0x02    /* Vendor specific              */
78 #define ATA_STAT_ERR    0x01    /* Error                        */
79
80 /*
81  * Device / Head Register Bits
82  */
83 #define ATA_DEVICE(x)   ((x & 1)<<4)
84 #define ATA_LBA         0xE0
85
86 enum {
87         ATA_MAX_DEVICES = 1,    /* per bus/port */
88         ATA_MAX_PRD = 256,      /* we could make these 256/256 */
89         ATA_SECT_SIZE = 256,    /*256 words per sector */
90
91         /* bits in ATA command block registers */
92         ATA_HOB = (1 << 7),     /* LBA48 selector */
93         ATA_NIEN = (1 << 1),    /* disable-irq flag */
94         /*ATA_LBA                 = (1 << 6), */ /* LBA28 selector */
95         ATA_DEV1 = (1 << 4),    /* Select Device 1 (slave) */
96         ATA_DEVICE_OBS = (1 << 7) | (1 << 5),   /* obs bits in dev reg */
97         ATA_DEVCTL_OBS = (1 << 3),      /* obsolete bit in devctl reg */
98         ATA_BUSY = (1 << 7),    /* BSY status bit */
99         ATA_DRDY = (1 << 6),    /* device ready */
100         ATA_DF = (1 << 5),      /* device fault */
101         ATA_DRQ = (1 << 3),     /* data request i/o */
102         ATA_ERR = (1 << 0),     /* have an error */
103         ATA_SRST = (1 << 2),    /* software reset */
104         ATA_ABORTED = (1 << 2), /* command aborted */
105         /* ATA command block registers */
106         ATA_REG_DATA = 0x00,
107         ATA_REG_ERR = 0x01,
108         ATA_REG_NSECT = 0x02,
109         ATA_REG_LBAL = 0x03,
110         ATA_REG_LBAM = 0x04,
111         ATA_REG_LBAH = 0x05,
112         ATA_REG_DEVICE = 0x06,
113         ATA_REG_STATUS = 0x07,
114         ATA_PCI_CTL_OFS = 0x02,
115         /* and their aliases */
116         ATA_REG_FEATURE = ATA_REG_ERR,
117         ATA_REG_CMD = ATA_REG_STATUS,
118         ATA_REG_BYTEL = ATA_REG_LBAM,
119         ATA_REG_BYTEH = ATA_REG_LBAH,
120         ATA_REG_DEVSEL = ATA_REG_DEVICE,
121         ATA_REG_IRQ = ATA_REG_NSECT,
122
123         /* SETFEATURES stuff */
124         SETFEATURES_XFER = 0x03,
125         XFER_UDMA_7 = 0x47,
126         XFER_UDMA_6 = 0x46,
127         XFER_UDMA_5 = 0x45,
128         XFER_UDMA_4 = 0x44,
129         XFER_UDMA_3 = 0x43,
130         XFER_UDMA_2 = 0x42,
131         XFER_UDMA_1 = 0x41,
132         XFER_UDMA_0 = 0x40,
133         XFER_MW_DMA_2 = 0x22,
134         XFER_MW_DMA_1 = 0x21,
135         XFER_MW_DMA_0 = 0x20,
136         XFER_PIO_4 = 0x0C,
137         XFER_PIO_3 = 0x0B,
138         XFER_PIO_2 = 0x0A,
139         XFER_PIO_1 = 0x09,
140         XFER_PIO_0 = 0x08,
141         XFER_SW_DMA_2 = 0x12,
142         XFER_SW_DMA_1 = 0x11,
143         XFER_SW_DMA_0 = 0x10,
144         XFER_PIO_SLOW = 0x00
145 };
146 /*
147  * ATA Commands (only mandatory commands listed here)
148  */
149 #define ATA_CMD_READ    0x20    /* Read Sectors (with retries)  */
150 #define ATA_CMD_READN   0x21    /* Read Sectors ( no  retries)  */
151 #define ATA_CMD_WRITE   0x30    /* Write Sectores (with retries)*/
152 #define ATA_CMD_WRITEN  0x31    /* Write Sectors  ( no  retries)*/
153 #define ATA_CMD_VRFY    0x40    /* Read Verify  (with retries)  */
154 #define ATA_CMD_VRFYN   0x41    /* Read verify  ( no  retries)  */
155 #define ATA_CMD_SEEK    0x70    /* Seek                         */
156 #define ATA_CMD_DIAG    0x90    /* Execute Device Diagnostic    */
157 #define ATA_CMD_INIT    0x91    /* Initialize Device Parameters */
158 #define ATA_CMD_RD_MULT 0xC4    /* Read Multiple                */
159 #define ATA_CMD_WR_MULT 0xC5    /* Write Multiple               */
160 #define ATA_CMD_SETMULT 0xC6    /* Set Multiple Mode            */
161 #define ATA_CMD_RD_DMA  0xC8    /* Read DMA (with retries)      */
162 #define ATA_CMD_RD_DMAN 0xC9    /* Read DMS ( no  retries)      */
163 #define ATA_CMD_WR_DMA  0xCA    /* Write DMA (with retries)     */
164 #define ATA_CMD_WR_DMAN 0xCB    /* Write DMA ( no  retires)     */
165 #define ATA_CMD_IDENT   0xEC    /* Identify Device              */
166 #define ATA_CMD_SETF    0xEF    /* Set Features                 */
167 #define ATA_CMD_CHK_PWR 0xE5    /* Check Power Mode             */
168
169 #define ATA_CMD_READ_EXT 0x24   /* Read Sectors (with retries)  with 48bit addressing */
170 #define ATA_CMD_WRITE_EXT       0x34    /* Write Sectores (with retries) with 48bit addressing */
171 #define ATA_CMD_VRFY_EXT        0x42    /* Read Verify  (with retries)  with 48bit addressing */
172
173 /*
174  * ATAPI Commands
175  */
176 #define ATAPI_CMD_IDENT 0xA1 /* Identify AT Atachment Packed Interface Device */
177 #define ATAPI_CMD_PACKET 0xA0 /* Packed Command */
178
179
180 #define ATAPI_CMD_INQUIRY 0x12
181 #define ATAPI_CMD_REQ_SENSE 0x03
182 #define ATAPI_CMD_READ_CAP 0x25
183 #define ATAPI_CMD_START_STOP 0x1B
184 #define ATAPI_CMD_READ_12 0xA8
185
186
187 #define ATA_GET_ERR()   inb(ATA_STATUS)
188 #define ATA_GET_STAT()  inb(ATA_STATUS)
189 #define ATA_OK_STAT(stat,good,bad)      (((stat)&((good)|(bad)))==(good))
190 #define ATA_BAD_R_STAT  (ATA_STAT_BUSY  | ATA_STAT_ERR)
191 #define ATA_BAD_W_STAT  (ATA_BAD_R_STAT | ATA_STAT_FAULT)
192 #define ATA_BAD_STAT    (ATA_BAD_R_STAT | ATA_STAT_DRQ)
193 #define ATA_DRIVE_READY (ATA_READY_STAT | ATA_STAT_SEEK)
194 #define ATA_DATA_READY  (ATA_STAT_DRQ)
195
196 #define ATA_BLOCKSIZE   512     /* bytes */
197 #define ATA_BLOCKSHIFT  9       /* 2 ^ ATA_BLOCKSIZESHIFT = 512 */
198 #define ATA_SECTORWORDS (512 / sizeof(unsigned long))
199
200 #ifndef ATA_RESET_TIME
201 #define ATA_RESET_TIME  60      /* spec allows up to 31 seconds */
202 #endif
203
204 /* ------------------------------------------------------------------------- */
205
206 /*
207  * structure returned by ATA_CMD_IDENT, as per ANSI ATA2 rev.2f spec
208  */
209 typedef struct hd_driveid {
210         unsigned short  config;         /* lots of obsolete bit flags */
211         unsigned short  cyls;           /* "physical" cyls */
212         unsigned short  reserved2;      /* reserved (word 2) */
213         unsigned short  heads;          /* "physical" heads */
214         unsigned short  track_bytes;    /* unformatted bytes per track */
215         unsigned short  sector_bytes;   /* unformatted bytes per sector */
216         unsigned short  sectors;        /* "physical" sectors per track */
217         unsigned short  vendor0;        /* vendor unique */
218         unsigned short  vendor1;        /* vendor unique */
219         unsigned short  vendor2;        /* vendor unique */
220         unsigned char   serial_no[20];  /* 0 = not_specified */
221         unsigned short  buf_type;
222         unsigned short  buf_size;       /* 512 byte increments; 0 = not_specified */
223         unsigned short  ecc_bytes;      /* for r/w long cmds; 0 = not_specified */
224         unsigned char   fw_rev[8];      /* 0 = not_specified */
225         unsigned char   model[40];      /* 0 = not_specified */
226         unsigned char   max_multsect;   /* 0=not_implemented */
227         unsigned char   vendor3;        /* vendor unique */
228         unsigned short  dword_io;       /* 0=not_implemented; 1=implemented */
229         unsigned char   vendor4;        /* vendor unique */
230         unsigned char   capability;     /* bits 0:DMA 1:LBA 2:IORDYsw 3:IORDYsup*/
231         unsigned short  reserved50;     /* reserved (word 50) */
232         unsigned char   vendor5;        /* vendor unique */
233         unsigned char   tPIO;           /* 0=slow, 1=medium, 2=fast */
234         unsigned char   vendor6;        /* vendor unique */
235         unsigned char   tDMA;           /* 0=slow, 1=medium, 2=fast */
236         unsigned short  field_valid;    /* bits 0:cur_ok 1:eide_ok */
237         unsigned short  cur_cyls;       /* logical cylinders */
238         unsigned short  cur_heads;      /* logical heads */
239         unsigned short  cur_sectors;    /* logical sectors per track */
240         unsigned short  cur_capacity0;  /* logical total sectors on drive */
241         unsigned short  cur_capacity1;  /*  (2 words, misaligned int)     */
242         unsigned char   multsect;       /* current multiple sector count */
243         unsigned char   multsect_valid; /* when (bit0==1) multsect is ok */
244         unsigned int    lba_capacity;   /* total number of sectors */
245         unsigned short  dma_1word;      /* single-word dma info */
246         unsigned short  dma_mword;      /* multiple-word dma info */
247         unsigned short  eide_pio_modes; /* bits 0:mode3 1:mode4 */
248         unsigned short  eide_dma_min;   /* min mword dma cycle time (ns) */
249         unsigned short  eide_dma_time;  /* recommended mword dma cycle time (ns) */
250         unsigned short  eide_pio;       /* min cycle time (ns), no IORDY  */
251         unsigned short  eide_pio_iordy; /* min cycle time (ns), with IORDY */
252         unsigned short  words69_70[2];  /* reserved words 69-70 */
253         unsigned short  words71_74[4];  /* reserved words 71-74 */
254         unsigned short  queue_depth;    /*  */
255         unsigned short  words76_79[4];  /* reserved words 76-79 */
256         unsigned short  major_rev_num;  /*  */
257         unsigned short  minor_rev_num;  /*  */
258         unsigned short  command_set_1;  /* bits 0:Smart 1:Security 2:Removable 3:PM */
259         unsigned short  command_set_2;  /* bits 14:Smart Enabled 13:0 zero 10:lba48 support*/
260         unsigned short  cfsse;          /* command set-feature supported extensions */
261         unsigned short  cfs_enable_1;   /* command set-feature enabled */
262         unsigned short  cfs_enable_2;   /* command set-feature enabled */
263         unsigned short  csf_default;    /* command set-feature default */
264         unsigned short  dma_ultra;      /*  */
265         unsigned short  word89;         /* reserved (word 89) */
266         unsigned short  word90;         /* reserved (word 90) */
267         unsigned short  CurAPMvalues;   /* current APM values */
268         unsigned short  word92;         /* reserved (word 92) */
269         unsigned short  hw_config;      /* hardware config */
270         unsigned short  words94_99[6];/* reserved words 94-99 */
271         /*unsigned long long  lba48_capacity; /--* 4 16bit values containing lba 48 total number of sectors */
272         unsigned short  lba48_capacity[4]; /* 4 16bit values containing lba 48 total number of sectors */
273         unsigned short  words104_125[22];/* reserved words 104-125 */
274         unsigned short  last_lun;       /* reserved (word 126) */
275         unsigned short  word127;        /* reserved (word 127) */
276         unsigned short  dlf;            /* device lock function
277                                          * 15:9 reserved
278                                          * 8    security level 1:max 0:high
279                                          * 7:6  reserved
280                                          * 5    enhanced erase
281                                          * 4    expire
282                                          * 3    frozen
283                                          * 2    locked
284                                          * 1    en/disabled
285                                          * 0    capability
286                                          */
287         unsigned short  csfo;           /* current set features options
288                                          * 15:4 reserved
289                                          * 3    auto reassign
290                                          * 2    reverting
291                                          * 1    read-look-ahead
292                                          * 0    write cache
293                                          */
294         unsigned short  words130_155[26];/* reserved vendor words 130-155 */
295         unsigned short  word156;
296         unsigned short  words157_159[3];/* reserved vendor words 157-159 */
297         unsigned short  words160_255[95];/* reserved words 160-255 */
298 } hd_driveid_t;
299
300
301 /*
302  * PIO Mode Configuration
303  *
304  * See ATA-3 (AT Attachment-3 Interface) documentation, Figure 14 / Table 21
305  */
306
307 typedef struct {
308         unsigned int    t_setup;        /* Setup  Time in [ns] or clocks        */
309         unsigned int    t_length;       /* Length Time in [ns] or clocks        */
310         unsigned int    t_hold;         /* Hold   Time in [ns] or clocks        */
311 }
312 pio_config_t;
313
314 #define IDE_MAX_PIO_MODE        4       /* max suppurted PIO mode               */
315
316 /* ------------------------------------------------------------------------- */
317
318 #endif /* _ATA_H */