drivers/block/fsl_sata.h

   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_ENTERPRISE_EN          0x10000000 /* Enterprise mode enabled */
 107 #define HCONTROL_HDR_SNOOP              0x00000400 /* Command header snoop */
 108 #define HCONTROL_PMP_ATTACHED           0x00000200 /* Port multiplier attached */
 109
 110 /* Interrupt enable */
 111 #define HCONTROL_FATAL_ERR              0x00000020
 112 #define HCONTROL_PHY_RDY                0x00000010
 113 #define HCONTROL_SIGNATURE              0x00000008
 114 #define HCONTROL_SNOTIFY                0x00000004
 115 #define HCONTROL_DEVICE_ERR             0x00000002
 116 #define HCONTROL_CMD_COMPLETE           0x00000001
 117
 118 #define HCONTROL_INT_EN_ALL             (HCONTROL_FATAL_ERR | \
 119                                         HCONTROL_PHY_RDY | \
 120                                         HCONTROL_SIGNATURE | \
 121                                         HCONTROL_SNOTIFY | \
 122                                         HCONTROL_DEVICE_ERR | \
 123                                         HCONTROL_CMD_COMPLETE)
 124
 125 /* SStatus register
 126 */
 127 #define SSTATUS_IPM_MASK                0x00000780
 128 #define SSTATUS_IPM_NOPRESENT           0x00000000
 129 #define SSTATUS_IPM_ACTIVE              0x00000080
 130 #define SSTATUS_IPM_PATIAL              0x00000100
 131 #define SSTATUS_IPM_SLUMBER             0x00000300
 132
 133 #define SSTATUS_SPD_MASK                0x000000f0
 134 #define SSTATUS_SPD_GEN1                0x00000010
 135 #define SSTATUS_SPD_GEN2                0x00000020
 136
 137 #define SSTATUS_DET_MASK                0x0000000f
 138 #define SSTATUS_DET_NODEVICE            0x00000000
 139 #define SSTATUS_DET_DISCONNECT          0x00000001
 140 #define SSTATUS_DET_CONNECT             0x00000003
 141 #define SSTATUS_DET_PHY_OFFLINE         0x00000004
 142
 143 /* SControl register
 144 */
 145 #define SCONTROL_SPM_MASK               0x0000f000
 146 #define SCONTROL_SPM_GO_PARTIAL         0x00001000
 147 #define SCONTROL_SPM_GO_SLUMBER         0x00002000
 148 #define SCONTROL_SPM_GO_ACTIVE          0x00004000
 149
 150 #define SCONTROL_IPM_MASK               0x00000f00
 151 #define SCONTROL_IPM_NO_RESTRICT        0x00000000
 152 #define SCONTROL_IPM_PARTIAL            0x00000100
 153 #define SCONTROL_IPM_SLUMBER            0x00000200
 154 #define SCONTROL_IPM_PART_SLUM          0x00000300
 155
 156 #define SCONTROL_SPD_MASK               0x000000f0
 157 #define SCONTROL_SPD_NO_RESTRICT        0x00000000
 158 #define SCONTROL_SPD_GEN1               0x00000010
 159 #define SCONTROL_SPD_GEN2               0x00000020
 160
 161 #define SCONTROL_DET_MASK               0x0000000f
 162 #define SCONTROL_DET_HRESET             0x00000001
 163 #define SCONTROL_DET_DISABLE            0x00000004
 164
 165 /* TransCfg register
 166 */
 167 #define TRANSCFG_DFIS_SIZE_SHIFT        16
 168 #define TRANSCFG_RX_WATER_MARK_MASK     0x0000001f
 169
 170 /* PhyCtrlCfg register
 171 */
 172 #define PHYCTRLCFG_FPRFTI_MASK          0x00000018
 173 #define PHYCTRLCFG_LOOPBACK_MASK        0x0000000e
 174
 175 /*
 176 * Command Header Entry
 177 */
 178 typedef struct cmd_hdr_entry {
 179         u32 cda;                /* Command Descriptor Address, 4 bytes aligned */
 180         u32 prde_fis_len;       /* Number of PRD entries and FIS length */
 181         u32 ttl;                /* Total transfer length */
 182         u32 attribute;          /* the attribute of command */
 183 } __attribute__ ((packed)) cmd_hdr_entry_t;
 184
 185 #define SATA_HC_CMD_HDR_ENTRY_SIZE      sizeof(struct cmd_hdr_entry)
 186
 187 /* cda
 188 */
 189 #define CMD_HDR_CDA_ALIGN       4
 190
 191 /* prde_fis_len
 192 */
 193 #define CMD_HDR_PRD_ENTRY_SHIFT 16
 194 #define CMD_HDR_PRD_ENTRY_MASK  0x003f0000
 195 #define CMD_HDR_FIS_LEN_SHIFT   2
 196
 197 /* attribute
 198 */
 199 #define CMD_HDR_ATTR_RES        0x00000800 /* Reserved bit, should be 1 */
 200 #define CMD_HDR_ATTR_VBIST      0x00000400 /* Vendor BIST */
 201 #define CMD_HDR_ATTR_SNOOP      0x00000200 /* Snoop enable for all descriptor */
 202 #define CMD_HDR_ATTR_FPDMA      0x00000100 /* FPDMA queued command */
 203 #define CMD_HDR_ATTR_RESET      0x00000080 /* Reset - a SRST or device reset */
 204 #define CMD_HDR_ATTR_BIST       0x00000040 /* BIST - require the host to enter BIST mode */
 205 #define CMD_HDR_ATTR_ATAPI      0x00000020 /* ATAPI command */
 206 #define CMD_HDR_ATTR_TAG        0x0000001f /* TAG mask */
 207
 208 /* command type
 209 */
 210 enum cmd_type {
 211         CMD_VENDOR_BIST,
 212         CMD_BIST,
 213         CMD_RESET,      /* SRST or device reset */
 214         CMD_ATAPI,
 215         CMD_NCQ,
 216         CMD_ATA,        /* None of all above */
 217 };
 218
 219 /*
 220 * Command Header Table
 221 */
 222 typedef struct cmd_hdr_tbl {
 223         cmd_hdr_entry_t cmd_slot[SATA_HC_MAX_CMD];
 224 } __attribute__ ((packed)) cmd_hdr_tbl_t;
 225
 226 #define SATA_HC_CMD_HDR_TBL_SIZE        sizeof(struct cmd_hdr_tbl)
 227 #define SATA_HC_CMD_HDR_TBL_ALIGN       4
 228
 229 /*
 230 * PRD entry - Physical Region Descriptor entry
 231 */
 232 typedef struct prd_entry {
 233         u32 dba;        /* Data base address, 4 bytes aligned */
 234         u32 res1;
 235         u32 res2;
 236         u32 ext_c_ddc;  /* Indirect PRD flags, snoop and data word count */
 237 } __attribute__ ((packed)) prd_entry_t;
 238
 239 #define SATA_HC_CMD_DESC_PRD_SIZE       sizeof(struct prd_entry)
 240
 241 /* dba
 242 */
 243 #define PRD_ENTRY_DBA_ALIGN     4
 244
 245 /* ext_c_ddc
 246 */
 247 #define PRD_ENTRY_EXT           0x80000000 /* extension flag */
 248 #ifdef CONFIG_FSL_SATA_V2
 249 #define PRD_ENTRY_DATA_SNOOP    0x10000000 /* Data snoop enable */
 250 #else
 251 #define PRD_ENTRY_DATA_SNOOP    0x00400000 /* Data snoop enable */
 252 #endif
 253 #define PRD_ENTRY_LEN_MASK      0x003fffff /* Data word count */
 254
 255 #define PRD_ENTRY_MAX_XFER_SZ   (PRD_ENTRY_LEN_MASK + 1)
 256
 257 /*
 258  * This SATA host controller supports a max of 16 direct PRD entries, but if use
 259  * chained indirect PRD entries, then the contollers supports upto a max of 63
 260  * entries including direct and indirect PRD entries.
 261  * The PRDT is an array of 63 PRD entries contigiously, but the PRD entries#15
 262  * will be setup as an indirect descriptor, pointing to it's next (contigious)
 263  * PRD entries#16.
 264  */
 265 #define SATA_HC_MAX_PRD         63 /* Max PRD entry numbers per command */
 266 #define SATA_HC_MAX_PRD_DIRECT  16 /* Direct PRDT entries */
 267 #define SATA_HC_MAX_PRD_USABLE  (SATA_HC_MAX_PRD - 1)
 268 #define SATA_HC_MAX_XFER_LEN    0x4000000
 269
 270 /*
 271 * PRDT - Physical Region Descriptor Table
 272 */
 273 typedef struct prdt {
 274         prd_entry_t prdt[SATA_HC_MAX_PRD];
 275 } __attribute__ ((packed)) prdt_t;
 276
 277 /*
 278 * Command Descriptor
 279 */
 280 #define SATA_HC_CMD_DESC_CFIS_SIZE      32 /* bytes */
 281 #define SATA_HC_CMD_DESC_SFIS_SIZE      32 /* bytes */
 282 #define SATA_HC_CMD_DESC_ACMD_SIZE      16 /* bytes */
 283 #define SATA_HC_CMD_DESC_RES            16 /* bytes */
 284
 285 typedef struct cmd_desc {
 286         u8 cfis[SATA_HC_CMD_DESC_CFIS_SIZE];
 287         u8 sfis[SATA_HC_CMD_DESC_SFIS_SIZE];
 288         u8 acmd[SATA_HC_CMD_DESC_ACMD_SIZE];
 289         u8 res[SATA_HC_CMD_DESC_RES];
 290         prd_entry_t prdt[SATA_HC_MAX_PRD];
 291 } __attribute__ ((packed)) cmd_desc_t;
 292
 293 #define SATA_HC_CMD_DESC_SIZE           sizeof(struct cmd_desc)
 294 #define SATA_HC_CMD_DESC_ALIGN          4
 295
 296 /*
 297  * SATA device driver info
 298  */
 299 typedef struct fsl_sata_info {
 300         u32     sata_reg_base;
 301         u32     flags;
 302 } fsl_sata_info_t;
 303
 304 #define FLAGS_DMA       0x00000000
 305 #define FLAGS_FPDMA     0x00000001
 306
 307 /*
 308  * SATA device driver struct
 309  */
 310 typedef struct fsl_sata {
 311         char            name[12];
 312         fsl_sata_reg_t  *reg_base;              /* the base address of controller register */
 313         void            *cmd_hdr_tbl_offset;    /* alloc address of command header table */
 314         cmd_hdr_tbl_t   *cmd_hdr;               /* aligned address of command header table */
 315         void            *cmd_desc_offset;       /* alloc address of command descriptor */
 316         cmd_desc_t      *cmd_desc;              /* aligned address of command descriptor */
 317         int             link;                   /* PHY link status */
 318         /* device attribute */
 319         int             ata_device_type;        /* device type */
 320         int             lba48;
 321         int             queue_depth;            /* Max NCQ queue depth */
 322         u16             pio;
 323         u16             mwdma;
 324         u16             udma;
 325         int             wcache;
 326         int             flush;
 327         int             flush_ext;
 328 } fsl_sata_t;
 329
 330 #define READ_CMD        0
 331 #define WRITE_CMD       1
 332
 333 #endif /* __FSL_SATA_H__ */