1 /*- 2 * SPDX-License-Identifier: BSD-2-Clause-FreeBSD 3 * 4 * Copyright (c) 1998 - 2008 Søren Schmidt <sos@FreeBSD.org> 5 * Copyright (c) 2009-2012 Alexander Motin <mav@FreeBSD.org> 6 * All rights reserved. 7 * 8 * Redistribution and use in source and binary forms, with or without 9 * modification, are permitted provided that the following conditions 10 * are met: 11 * 1. Redistributions of source code must retain the above copyright 12 * notice, this list of conditions and the following disclaimer, 13 * without modification, immediately at the beginning of the file. 14 * 2. Redistributions in binary form must reproduce the above copyright 15 * notice, this list of conditions and the following disclaimer in the 16 * documentation and/or other materials provided with the distribution. 17 * 18 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 19 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 20 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 21 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 22 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 23 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 24 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 25 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 26 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 27 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 28 * 29 * $FreeBSD$ 30 */ 31 32 /* ATA register defines */ 33 #define ATA_DATA 0 /* (RW) data */ 34 35 #define ATA_FEATURE 1 /* (W) feature */ 36 #define ATA_F_DMA 0x01 /* enable DMA */ 37 #define ATA_F_OVL 0x02 /* enable overlap */ 38 39 #define ATA_COUNT 2 /* (W) sector count */ 40 41 #define ATA_SECTOR 3 /* (RW) sector # */ 42 #define ATA_CYL_LSB 4 /* (RW) cylinder# LSB */ 43 #define ATA_CYL_MSB 5 /* (RW) cylinder# MSB */ 44 #define ATA_DRIVE 6 /* (W) Sector/Drive/Head */ 45 #define ATA_D_LBA 0x40 /* use LBA addressing */ 46 #define ATA_D_IBM 0xa0 /* 512 byte sectors, ECC */ 47 48 #define ATA_COMMAND 7 /* (W) command */ 49 50 #define ATA_ERROR 8 /* (R) error */ 51 #define ATA_E_ILI 0x01 /* illegal length */ 52 #define ATA_E_NM 0x02 /* no media */ 53 #define ATA_E_ABORT 0x04 /* command aborted */ 54 #define ATA_E_MCR 0x08 /* media change request */ 55 #define ATA_E_IDNF 0x10 /* ID not found */ 56 #define ATA_E_MC 0x20 /* media changed */ 57 #define ATA_E_UNC 0x40 /* uncorrectable data */ 58 #define ATA_E_ICRC 0x80 /* UDMA crc error */ 59 #define ATA_E_ATAPI_SENSE_MASK 0xf0 /* ATAPI sense key mask */ 60 61 #define ATA_IREASON 9 /* (R) interrupt reason */ 62 #define ATA_I_CMD 0x01 /* cmd (1) | data (0) */ 63 #define ATA_I_IN 0x02 /* read (1) | write (0) */ 64 #define ATA_I_RELEASE 0x04 /* released bus (1) */ 65 #define ATA_I_TAGMASK 0xf8 /* tag mask */ 66 67 #define ATA_STATUS 10 /* (R) status */ 68 #define ATA_ALTSTAT 11 /* (R) alternate status */ 69 #define ATA_S_ERROR 0x01 /* error */ 70 #define ATA_S_INDEX 0x02 /* index */ 71 #define ATA_S_CORR 0x04 /* data corrected */ 72 #define ATA_S_DRQ 0x08 /* data request */ 73 #define ATA_S_DSC 0x10 /* drive seek completed */ 74 #define ATA_S_SERVICE 0x10 /* drive needs service */ 75 #define ATA_S_DWF 0x20 /* drive write fault */ 76 #define ATA_S_DMA 0x20 /* DMA ready */ 77 #define ATA_S_READY 0x40 /* drive ready */ 78 #define ATA_S_BUSY 0x80 /* busy */ 79 80 #define ATA_CONTROL 12 /* (W) control */ 81 #define ATA_A_IDS 0x02 /* disable interrupts */ 82 #define ATA_A_RESET 0x04 /* RESET controller */ 83 #define ATA_A_4BIT 0x08 /* 4 head bits */ 84 #define ATA_A_HOB 0x80 /* High Order Byte enable */ 85 86 /* SATA register defines */ 87 #define ATA_SSTATUS 13 88 #define ATA_SS_DET_MASK 0x0000000f 89 #define ATA_SS_DET_NO_DEVICE 0x00000000 90 #define ATA_SS_DET_DEV_PRESENT 0x00000001 91 #define ATA_SS_DET_PHY_ONLINE 0x00000003 92 #define ATA_SS_DET_PHY_OFFLINE 0x00000004 93 94 #define ATA_SS_SPD_MASK 0x000000f0 95 #define ATA_SS_SPD_NO_SPEED 0x00000000 96 #define ATA_SS_SPD_GEN1 0x00000010 97 #define ATA_SS_SPD_GEN2 0x00000020 98 #define ATA_SS_SPD_GEN3 0x00000030 99 100 #define ATA_SS_IPM_MASK 0x00000f00 101 #define ATA_SS_IPM_NO_DEVICE 0x00000000 102 #define ATA_SS_IPM_ACTIVE 0x00000100 103 #define ATA_SS_IPM_PARTIAL 0x00000200 104 #define ATA_SS_IPM_SLUMBER 0x00000600 105 #define ATA_SS_IPM_DEVSLEEP 0x00000800 106 107 #define ATA_SERROR 14 108 #define ATA_SE_DATA_CORRECTED 0x00000001 109 #define ATA_SE_COMM_CORRECTED 0x00000002 110 #define ATA_SE_DATA_ERR 0x00000100 111 #define ATA_SE_COMM_ERR 0x00000200 112 #define ATA_SE_PROT_ERR 0x00000400 113 #define ATA_SE_HOST_ERR 0x00000800 114 #define ATA_SE_PHY_CHANGED 0x00010000 115 #define ATA_SE_PHY_IERROR 0x00020000 116 #define ATA_SE_COMM_WAKE 0x00040000 117 #define ATA_SE_DECODE_ERR 0x00080000 118 #define ATA_SE_PARITY_ERR 0x00100000 119 #define ATA_SE_CRC_ERR 0x00200000 120 #define ATA_SE_HANDSHAKE_ERR 0x00400000 121 #define ATA_SE_LINKSEQ_ERR 0x00800000 122 #define ATA_SE_TRANSPORT_ERR 0x01000000 123 #define ATA_SE_UNKNOWN_FIS 0x02000000 124 #define ATA_SE_EXCHANGED 0x04000000 125 126 #define ATA_SCONTROL 15 127 #define ATA_SC_DET_MASK 0x0000000f 128 #define ATA_SC_DET_IDLE 0x00000000 129 #define ATA_SC_DET_RESET 0x00000001 130 #define ATA_SC_DET_DISABLE 0x00000004 131 132 #define ATA_SC_SPD_MASK 0x000000f0 133 #define ATA_SC_SPD_NO_SPEED 0x00000000 134 #define ATA_SC_SPD_SPEED_GEN1 0x00000010 135 #define ATA_SC_SPD_SPEED_GEN2 0x00000020 136 #define ATA_SC_SPD_SPEED_GEN3 0x00000030 137 138 #define ATA_SC_IPM_MASK 0x00000f00 139 #define ATA_SC_IPM_NONE 0x00000000 140 #define ATA_SC_IPM_DIS_PARTIAL 0x00000100 141 #define ATA_SC_IPM_DIS_SLUMBER 0x00000200 142 #define ATA_SC_IPM_DIS_DEVSLEEP 0x00000400 143 144 #define ATA_SACTIVE 16 145 146 #define AHCI_MAX_PORTS 32 147 #define AHCI_MAX_SLOTS 32 148 #define AHCI_MAX_IRQS 16 149 150 /* SATA AHCI v1.0 register defines */ 151 #define AHCI_CAP 0x00 152 #define AHCI_CAP_NPMASK 0x0000001f 153 #define AHCI_CAP_SXS 0x00000020 154 #define AHCI_CAP_EMS 0x00000040 155 #define AHCI_CAP_CCCS 0x00000080 156 #define AHCI_CAP_NCS 0x00001F00 157 #define AHCI_CAP_NCS_SHIFT 8 158 #define AHCI_CAP_PSC 0x00002000 159 #define AHCI_CAP_SSC 0x00004000 160 #define AHCI_CAP_PMD 0x00008000 161 #define AHCI_CAP_FBSS 0x00010000 162 #define AHCI_CAP_SPM 0x00020000 163 #define AHCI_CAP_SAM 0x00080000 164 #define AHCI_CAP_ISS 0x00F00000 165 #define AHCI_CAP_ISS_SHIFT 20 166 #define AHCI_CAP_SCLO 0x01000000 167 #define AHCI_CAP_SAL 0x02000000 168 #define AHCI_CAP_SALP 0x04000000 169 #define AHCI_CAP_SSS 0x08000000 170 #define AHCI_CAP_SMPS 0x10000000 171 #define AHCI_CAP_SSNTF 0x20000000 172 #define AHCI_CAP_SNCQ 0x40000000 173 #define AHCI_CAP_64BIT 0x80000000 174 175 #define AHCI_GHC 0x04 176 #define AHCI_GHC_AE 0x80000000 177 #define AHCI_GHC_MRSM 0x00000004 178 #define AHCI_GHC_IE 0x00000002 179 #define AHCI_GHC_HR 0x00000001 180 181 #define AHCI_IS 0x08 182 #define AHCI_PI 0x0c 183 #define AHCI_VS 0x10 184 185 #define AHCI_CCCC 0x14 186 #define AHCI_CCCC_TV_MASK 0xffff0000 187 #define AHCI_CCCC_TV_SHIFT 16 188 #define AHCI_CCCC_CC_MASK 0x0000ff00 189 #define AHCI_CCCC_CC_SHIFT 8 190 #define AHCI_CCCC_INT_MASK 0x000000f8 191 #define AHCI_CCCC_INT_SHIFT 3 192 #define AHCI_CCCC_EN 0x00000001 193 #define AHCI_CCCP 0x18 194 195 #define AHCI_EM_LOC 0x1C 196 #define AHCI_EM_CTL 0x20 197 #define AHCI_EM_MR 0x00000001 198 #define AHCI_EM_TM 0x00000100 199 #define AHCI_EM_RST 0x00000200 200 #define AHCI_EM_LED 0x00010000 201 #define AHCI_EM_SAFTE 0x00020000 202 #define AHCI_EM_SES2 0x00040000 203 #define AHCI_EM_SGPIO 0x00080000 204 #define AHCI_EM_SMB 0x01000000 205 #define AHCI_EM_XMT 0x02000000 206 #define AHCI_EM_ALHD 0x04000000 207 #define AHCI_EM_PM 0x08000000 208 209 #define AHCI_CAP2 0x24 210 #define AHCI_CAP2_BOH 0x00000001 211 #define AHCI_CAP2_NVMP 0x00000002 212 #define AHCI_CAP2_APST 0x00000004 213 #define AHCI_CAP2_SDS 0x00000008 214 #define AHCI_CAP2_SADM 0x00000010 215 #define AHCI_CAP2_DESO 0x00000020 216 217 #define AHCI_BOHC 0x28 218 #define AHCI_BOHC_BOS 0x00000001 219 #define AHCI_BOHC_OOS 0x00000002 220 #define AHCI_BOHC_SOOE 0x00000004 221 #define AHCI_BOHC_OOC 0x00000008 222 #define AHCI_BOHC_BB 0x00000010 223 224 #define AHCI_VSCAP 0xa4 225 #define AHCI_OFFSET 0x100 226 #define AHCI_STEP 0x80 227 228 #define AHCI_P_CLB 0x00 229 #define AHCI_P_CLBU 0x04 230 #define AHCI_P_FB 0x08 231 #define AHCI_P_FBU 0x0c 232 #define AHCI_P_IS 0x10 233 #define AHCI_P_IE 0x14 234 #define AHCI_P_IX_DHR 0x00000001 235 #define AHCI_P_IX_PS 0x00000002 236 #define AHCI_P_IX_DS 0x00000004 237 #define AHCI_P_IX_SDB 0x00000008 238 #define AHCI_P_IX_UF 0x00000010 239 #define AHCI_P_IX_DP 0x00000020 240 #define AHCI_P_IX_PC 0x00000040 241 #define AHCI_P_IX_MP 0x00000080 242 243 #define AHCI_P_IX_PRC 0x00400000 244 #define AHCI_P_IX_IPM 0x00800000 245 #define AHCI_P_IX_OF 0x01000000 246 #define AHCI_P_IX_INF 0x04000000 247 #define AHCI_P_IX_IF 0x08000000 248 #define AHCI_P_IX_HBD 0x10000000 249 #define AHCI_P_IX_HBF 0x20000000 250 #define AHCI_P_IX_TFE 0x40000000 251 #define AHCI_P_IX_CPD 0x80000000 252 253 #define AHCI_P_CMD 0x18 254 #define AHCI_P_CMD_ST 0x00000001 255 #define AHCI_P_CMD_SUD 0x00000002 256 #define AHCI_P_CMD_POD 0x00000004 257 #define AHCI_P_CMD_CLO 0x00000008 258 #define AHCI_P_CMD_FRE 0x00000010 259 #define AHCI_P_CMD_CCS_MASK 0x00001f00 260 #define AHCI_P_CMD_CCS_SHIFT 8 261 #define AHCI_P_CMD_ISS 0x00002000 262 #define AHCI_P_CMD_FR 0x00004000 263 #define AHCI_P_CMD_CR 0x00008000 264 #define AHCI_P_CMD_CPS 0x00010000 265 #define AHCI_P_CMD_PMA 0x00020000 266 #define AHCI_P_CMD_HPCP 0x00040000 267 #define AHCI_P_CMD_MPSP 0x00080000 268 #define AHCI_P_CMD_CPD 0x00100000 269 #define AHCI_P_CMD_ESP 0x00200000 270 #define AHCI_P_CMD_FBSCP 0x00400000 271 #define AHCI_P_CMD_APSTE 0x00800000 272 #define AHCI_P_CMD_ATAPI 0x01000000 273 #define AHCI_P_CMD_DLAE 0x02000000 274 #define AHCI_P_CMD_ALPE 0x04000000 275 #define AHCI_P_CMD_ASP 0x08000000 276 #define AHCI_P_CMD_ICC_MASK 0xf0000000 277 #define AHCI_P_CMD_NOOP 0x00000000 278 #define AHCI_P_CMD_ACTIVE 0x10000000 279 #define AHCI_P_CMD_PARTIAL 0x20000000 280 #define AHCI_P_CMD_SLUMBER 0x60000000 281 #define AHCI_P_CMD_DEVSLEEP 0x80000000 282 283 #define AHCI_P_TFD 0x20 284 #define AHCI_P_SIG 0x24 285 #define AHCI_P_SSTS 0x28 286 #define AHCI_P_SCTL 0x2c 287 #define AHCI_P_SERR 0x30 288 #define AHCI_P_SACT 0x34 289 #define AHCI_P_CI 0x38 290 #define AHCI_P_SNTF 0x3C 291 #define AHCI_P_FBS 0x40 292 #define AHCI_P_FBS_EN 0x00000001 293 #define AHCI_P_FBS_DEC 0x00000002 294 #define AHCI_P_FBS_SDE 0x00000004 295 #define AHCI_P_FBS_DEV 0x00000f00 296 #define AHCI_P_FBS_DEV_SHIFT 8 297 #define AHCI_P_FBS_ADO 0x0000f000 298 #define AHCI_P_FBS_ADO_SHIFT 12 299 #define AHCI_P_FBS_DWE 0x000f0000 300 #define AHCI_P_FBS_DWE_SHIFT 16 301 #define AHCI_P_DEVSLP 0x44 302 #define AHCI_P_DEVSLP_ADSE 0x00000001 303 #define AHCI_P_DEVSLP_DSP 0x00000002 304 #define AHCI_P_DEVSLP_DETO 0x000003fc 305 #define AHCI_P_DEVSLP_DETO_SHIFT 2 306 #define AHCI_P_DEVSLP_MDAT 0x00007c00 307 #define AHCI_P_DEVSLP_MDAT_SHIFT 10 308 #define AHCI_P_DEVSLP_DITO 0x01ff8000 309 #define AHCI_P_DEVSLP_DITO_SHIFT 15 310 #define AHCI_P_DEVSLP_DM 0x0e000000 311 #define AHCI_P_DEVSLP_DM_SHIFT 25 312 313 /* Just to be sure, if building as module. */ 314 #if MAXPHYS < 512 * 1024 315 #undef MAXPHYS 316 #define MAXPHYS 512 * 1024 317 #endif 318 /* Pessimistic prognosis on number of required S/G entries */ 319 #define AHCI_SG_ENTRIES (roundup(btoc(MAXPHYS) + 1, 8)) 320 /* Command list. 32 commands. First, 1Kbyte aligned. */ 321 #define AHCI_CL_OFFSET 0 322 #define AHCI_CL_SIZE 32 323 /* Command tables. Up to 32 commands, Each, 128byte aligned. */ 324 #define AHCI_CT_OFFSET (AHCI_CL_OFFSET + AHCI_CL_SIZE * AHCI_MAX_SLOTS) 325 #define AHCI_CT_SIZE (128 + AHCI_SG_ENTRIES * 16) 326 /* Total main work area. */ 327 #define AHCI_WORK_SIZE (AHCI_CT_OFFSET + AHCI_CT_SIZE * ch->numslots) 328 329 /* ivars value fields */ 330 #define AHCI_REMAPPED_UNIT (1 << 31) /* NVMe remapped device. */ 331 #define AHCI_EM_UNIT (1 << 30) /* Enclosure Mgmt device. */ 332 #define AHCI_UNIT 0xff /* Channel number. */ 333 334 struct ahci_dma_prd { 335 u_int64_t dba; 336 u_int32_t reserved; 337 u_int32_t dbc; /* 0 based */ 338 #define AHCI_PRD_MASK 0x003fffff /* max 4MB */ 339 #define AHCI_PRD_MAX (AHCI_PRD_MASK + 1) 340 #define AHCI_PRD_IPC (1U << 31) 341 } __packed; 342 343 struct ahci_cmd_tab { 344 u_int8_t cfis[64]; 345 u_int8_t acmd[32]; 346 u_int8_t reserved[32]; 347 struct ahci_dma_prd prd_tab[AHCI_SG_ENTRIES]; 348 } __packed; 349 350 struct ahci_cmd_list { 351 u_int16_t cmd_flags; 352 #define AHCI_CMD_ATAPI 0x0020 353 #define AHCI_CMD_WRITE 0x0040 354 #define AHCI_CMD_PREFETCH 0x0080 355 #define AHCI_CMD_RESET 0x0100 356 #define AHCI_CMD_BIST 0x0200 357 #define AHCI_CMD_CLR_BUSY 0x0400 358 359 u_int16_t prd_length; /* PRD entries */ 360 u_int32_t bytecount; 361 u_int64_t cmd_table_phys; /* 128byte aligned */ 362 } __packed; 363 364 /* misc defines */ 365 #define ATA_IRQ_RID 0 366 #define ATA_INTR_FLAGS (INTR_MPSAFE|INTR_TYPE_BIO|INTR_ENTROPY) 367 368 struct ata_dmaslot { 369 bus_dmamap_t data_map; /* data DMA map */ 370 int nsegs; /* Number of segs loaded */ 371 }; 372 373 /* structure holding DMA related information */ 374 struct ata_dma { 375 bus_dma_tag_t work_tag; /* workspace DMA tag */ 376 bus_dmamap_t work_map; /* workspace DMA map */ 377 uint8_t *work; /* workspace */ 378 bus_addr_t work_bus; /* bus address of work */ 379 bus_dma_tag_t rfis_tag; /* RFIS list DMA tag */ 380 bus_dmamap_t rfis_map; /* RFIS list DMA map */ 381 uint8_t *rfis; /* FIS receive area */ 382 bus_addr_t rfis_bus; /* bus address of rfis */ 383 bus_dma_tag_t data_tag; /* data DMA tag */ 384 }; 385 386 enum ahci_slot_states { 387 AHCI_SLOT_EMPTY, 388 AHCI_SLOT_LOADING, 389 AHCI_SLOT_RUNNING, 390 AHCI_SLOT_EXECUTING 391 }; 392 393 struct ahci_slot { 394 struct ahci_channel *ch; /* Channel */ 395 u_int8_t slot; /* Number of this slot */ 396 enum ahci_slot_states state; /* Slot state */ 397 union ccb *ccb; /* CCB occupying slot */ 398 struct ata_dmaslot dma; /* DMA data of this slot */ 399 struct callout timeout; /* Execution timeout */ 400 }; 401 402 struct ahci_device { 403 int revision; 404 int mode; 405 u_int bytecount; 406 u_int atapi; 407 u_int tags; 408 u_int caps; 409 }; 410 411 struct ahci_led { 412 device_t dev; /* Device handle */ 413 struct cdev *led; 414 uint8_t num; /* Number of this led */ 415 uint8_t state; /* State of this led */ 416 }; 417 418 #define AHCI_NUM_LEDS 3 419 420 /* structure describing an ATA channel */ 421 struct ahci_channel { 422 device_t dev; /* Device handle */ 423 int unit; /* Physical channel */ 424 struct resource *r_mem; /* Memory of this channel */ 425 struct resource *r_irq; /* Interrupt of this channel */ 426 void *ih; /* Interrupt handle */ 427 struct ata_dma dma; /* DMA data */ 428 struct cam_sim *sim; 429 struct cam_path *path; 430 uint32_t caps; /* Controller capabilities */ 431 uint32_t caps2; /* Controller capabilities */ 432 uint32_t chcaps; /* Channel capabilities */ 433 uint32_t chscaps; /* Channel sleep capabilities */ 434 uint16_t vendorid; /* Vendor ID from the bus */ 435 uint16_t deviceid; /* Device ID from the bus */ 436 uint16_t subvendorid; /* Subvendor ID from the bus */ 437 uint16_t subdeviceid; /* Subdevice ID from the bus */ 438 int quirks; 439 int numslots; /* Number of present slots */ 440 int pm_level; /* power management level */ 441 int devices; /* What is present */ 442 int pm_present; /* PM presence reported */ 443 int fbs_enabled; /* FIS-based switching enabled */ 444 445 void (*start)(struct ahci_channel *); 446 447 union ccb *hold[AHCI_MAX_SLOTS]; 448 struct ahci_slot slot[AHCI_MAX_SLOTS]; 449 uint32_t oslots; /* Occupied slots */ 450 uint32_t rslots; /* Running slots */ 451 uint32_t aslots; /* Slots with atomic commands */ 452 uint32_t eslots; /* Slots in error */ 453 uint32_t toslots; /* Slots in timeout */ 454 int lastslot; /* Last used slot */ 455 int taggedtarget; /* Last tagged target */ 456 int numrslots; /* Number of running slots */ 457 int numrslotspd[16];/* Number of running slots per dev */ 458 int numtslots; /* Number of tagged slots */ 459 int numtslotspd[16];/* Number of tagged slots per dev */ 460 int numhslots; /* Number of held slots */ 461 int recoverycmd; /* Our READ LOG active */ 462 int fatalerr; /* Fatal error happened */ 463 int resetting; /* Hard-reset in progress. */ 464 int resetpolldiv; /* Hard-reset poll divider. */ 465 int listening; /* SUD bit is cleared. */ 466 int wrongccs; /* CCS field in CMD was wrong */ 467 union ccb *frozen; /* Frozen command */ 468 struct callout pm_timer; /* Power management events */ 469 struct callout reset_timer; /* Hard-reset timeout */ 470 471 struct ahci_device user[16]; /* User-specified settings */ 472 struct ahci_device curr[16]; /* Current settings */ 473 474 struct mtx_padalign mtx; /* state lock */ 475 STAILQ_HEAD(, ccb_hdr) doneq; /* queue of completed CCBs */ 476 int batch; /* doneq is in use */ 477 478 int disablephy; /* keep PHY disabled */ 479 }; 480 481 struct ahci_enclosure { 482 device_t dev; /* Device handle */ 483 struct resource *r_memc; /* Control register */ 484 struct resource *r_memt; /* Transmit buffer */ 485 struct resource *r_memr; /* Receive buffer */ 486 struct cam_sim *sim; 487 struct cam_path *path; 488 struct mtx mtx; /* state lock */ 489 struct ahci_led leds[AHCI_MAX_PORTS * 3]; 490 uint32_t capsem; /* Controller capabilities */ 491 uint8_t status[AHCI_MAX_PORTS][4]; /* ArrayDev statuses */ 492 int quirks; 493 int channels; 494 uint32_t ichannels; 495 }; 496 497 /* structure describing a AHCI controller */ 498 struct ahci_controller { 499 device_t dev; 500 bus_dma_tag_t dma_tag; 501 int r_rid; 502 int r_msix_tab_rid; 503 int r_msix_pba_rid; 504 uint16_t vendorid; /* Vendor ID from the bus */ 505 uint16_t deviceid; /* Device ID from the bus */ 506 uint16_t subvendorid; /* Subvendor ID from the bus */ 507 uint16_t subdeviceid; /* Subdevice ID from the bus */ 508 struct resource *r_mem; 509 struct resource *r_msix_table; 510 struct resource *r_msix_pba; 511 struct rman sc_iomem; 512 struct ahci_controller_irq { 513 struct ahci_controller *ctlr; 514 struct resource *r_irq; 515 void *handle; 516 int r_irq_rid; 517 int mode; 518 #define AHCI_IRQ_MODE_ALL 0 519 #define AHCI_IRQ_MODE_AFTER 1 520 #define AHCI_IRQ_MODE_ONE 2 521 } irqs[AHCI_MAX_IRQS]; 522 uint32_t caps; /* Controller capabilities */ 523 uint32_t caps2; /* Controller capabilities */ 524 uint32_t capsem; /* Controller capabilities */ 525 uint32_t emloc; /* EM buffer location */ 526 int quirks; 527 int numirqs; 528 int channels; 529 uint32_t ichannels; 530 int ccc; /* CCC timeout */ 531 int cccv; /* CCC vector */ 532 int direct; /* Direct command completion */ 533 int msi; /* MSI interupts */ 534 int remapped_devices; /* Remapped NVMe devices */ 535 uint32_t remap_offset; 536 uint32_t remap_size; 537 struct { 538 void (*function)(void *); 539 void *argument; 540 } interrupt[AHCI_MAX_PORTS]; 541 void (*ch_start)(struct ahci_channel *); 542 int dma_coherent; /* DMA is cache-coherent */ 543 struct mtx ch_mtx; /* Lock for attached channels */ 544 struct ahci_channel *ch[AHCI_MAX_PORTS]; /* Attached channels */ 545 }; 546 547 enum ahci_err_type { 548 AHCI_ERR_NONE, /* No error */ 549 AHCI_ERR_INVALID, /* Error detected by us before submitting. */ 550 AHCI_ERR_INNOCENT, /* Innocent victim. */ 551 AHCI_ERR_TFE, /* Task File Error. */ 552 AHCI_ERR_SATA, /* SATA error. */ 553 AHCI_ERR_TIMEOUT, /* Command execution timeout. */ 554 AHCI_ERR_NCQ, /* NCQ command error. CCB should be put on hold 555 * until READ LOG executed to reveal error. */ 556 }; 557 558 /* macros to hide busspace uglyness */ 559 #define ATA_INB(res, offset) \ 560 bus_read_1((res), (offset)) 561 #define ATA_INW(res, offset) \ 562 bus_read_2((res), (offset)) 563 #define ATA_INL(res, offset) \ 564 bus_read_4((res), (offset)) 565 #define ATA_INSW(res, offset, addr, count) \ 566 bus_read_multi_2((res), (offset), (addr), (count)) 567 #define ATA_INSW_STRM(res, offset, addr, count) \ 568 bus_read_multi_stream_2((res), (offset), (addr), (count)) 569 #define ATA_INSL(res, offset, addr, count) \ 570 bus_read_multi_4((res), (offset), (addr), (count)) 571 #define ATA_INSL_STRM(res, offset, addr, count) \ 572 bus_read_multi_stream_4((res), (offset), (addr), (count)) 573 #define ATA_OUTB(res, offset, value) \ 574 bus_write_1((res), (offset), (value)) 575 #define ATA_OUTW(res, offset, value) \ 576 bus_write_2((res), (offset), (value)) 577 #define ATA_OUTL(res, offset, value) \ 578 bus_write_4((res), (offset), (value)) 579 #define ATA_OUTSW(res, offset, addr, count) \ 580 bus_write_multi_2((res), (offset), (addr), (count)) 581 #define ATA_OUTSW_STRM(res, offset, addr, count) \ 582 bus_write_multi_stream_2((res), (offset), (addr), (count)) 583 #define ATA_OUTSL(res, offset, addr, count) \ 584 bus_write_multi_4((res), (offset), (addr), (count)) 585 #define ATA_OUTSL_STRM(res, offset, addr, count) \ 586 bus_write_multi_stream_4((res), (offset), (addr), (count)) 587 588 /* 589 * On some platforms, we must ensure proper interdevice write ordering. 590 * The AHCI interrupt status register must be updated in HW before 591 * registers in interrupt controller. 592 * Unfortunately, only way how we can do it is readback. 593 * 594 * Currently, only ARM is known to have this issue. 595 */ 596 #if defined(__arm__) 597 #define ATA_RBL(res, offset) \ 598 bus_read_4((res), (offset)) 599 #else 600 #define ATA_RBL(res, offset) 601 #endif 602 603 #define AHCI_Q_NOFORCE 0x00000001 604 #define AHCI_Q_NOPMP 0x00000002 605 #define AHCI_Q_NONCQ 0x00000004 606 #define AHCI_Q_1CH 0x00000008 607 #define AHCI_Q_2CH 0x00000010 608 #define AHCI_Q_4CH 0x00000020 609 #define AHCI_Q_EDGEIS 0x00000040 610 #define AHCI_Q_SATA2 0x00000080 611 #define AHCI_Q_NOBSYRES 0x00000100 612 #define AHCI_Q_NOAA 0x00000200 613 #define AHCI_Q_NOCOUNT 0x00000400 614 #define AHCI_Q_ALTSIG 0x00000800 615 #define AHCI_Q_NOMSI 0x00001000 616 #define AHCI_Q_ATI_PMP_BUG 0x00002000 617 #define AHCI_Q_MAXIO_64K 0x00004000 618 #define AHCI_Q_SATA1_UNIT0 0x00008000 /* need better method for this */ 619 #define AHCI_Q_ABAR0 0x00010000 620 #define AHCI_Q_1MSI 0x00020000 621 #define AHCI_Q_FORCE_PI 0x00040000 622 #define AHCI_Q_RESTORE_CAP 0x00080000 623 #define AHCI_Q_NOMSIX 0x00100000 624 #define AHCI_Q_MRVL_SR_DEL 0x00200000 625 #define AHCI_Q_NOCCS 0x00400000 626 #define AHCI_Q_NOAUX 0x00800000 627 628 #define AHCI_Q_BIT_STRING \ 629 "\020" \ 630 "\001NOFORCE" \ 631 "\002NOPMP" \ 632 "\003NONCQ" \ 633 "\0041CH" \ 634 "\0052CH" \ 635 "\0064CH" \ 636 "\007EDGEIS" \ 637 "\010SATA2" \ 638 "\011NOBSYRES" \ 639 "\012NOAA" \ 640 "\013NOCOUNT" \ 641 "\014ALTSIG" \ 642 "\015NOMSI" \ 643 "\016ATI_PMP_BUG" \ 644 "\017MAXIO_64K" \ 645 "\020SATA1_UNIT0" \ 646 "\021ABAR0" \ 647 "\0221MSI" \ 648 "\023FORCE_PI" \ 649 "\024RESTORE_CAP" \ 650 "\025NOMSIX" \ 651 "\026MRVL_SR_DEL" \ 652 "\027NOCCS" \ 653 "\030NOAUX" 654 655 int ahci_attach(device_t dev); 656 int ahci_detach(device_t dev); 657 int ahci_setup_interrupt(device_t dev); 658 int ahci_print_child(device_t dev, device_t child); 659 struct resource *ahci_alloc_resource(device_t dev, device_t child, int type, int *rid, 660 rman_res_t start, rman_res_t end, rman_res_t count, u_int flags); 661 int ahci_release_resource(device_t dev, device_t child, int type, int rid, 662 struct resource *r); 663 int ahci_setup_intr(device_t dev, device_t child, struct resource *irq, 664 int flags, driver_filter_t *filter, driver_intr_t *function, 665 void *argument, void **cookiep); 666 int ahci_teardown_intr(device_t dev, device_t child, struct resource *irq, 667 void *cookie); 668 int ahci_child_location_str(device_t dev, device_t child, char *buf, 669 size_t buflen); 670 bus_dma_tag_t ahci_get_dma_tag(device_t dev, device_t child); 671 int ahci_ctlr_reset(device_t dev); 672 int ahci_ctlr_setup(device_t dev); 673 void ahci_free_mem(device_t dev); 674 675 /* Functions to allow AHCI EM to access other channels. */ 676 void ahci_attached(device_t dev, struct ahci_channel *ch); 677 void ahci_detached(device_t dev, struct ahci_channel *ch); 678 struct ahci_channel * ahci_getch(device_t dev, int n); 679 void ahci_putch(struct ahci_channel *ch); 680 681 extern devclass_t ahci_devclass; 682 683