sys/dev/ahci/ahci_pci.c

   1 /*-
   2  * Copyright (c) 2009-2012 Alexander Motin <mav@FreeBSD.org>
   3  * All rights reserved.
   4  *
   5  * Redistribution and use in source and binary forms, with or without
   6  * modification, are permitted provided that the following conditions
   7  * are met:
   8  * 1. Redistributions of source code must retain the above copyright
   9  *    notice, this list of conditions and the following disclaimer,
  10  *    without modification, immediately at the beginning of the file.
  11  * 2. Redistributions in binary form must reproduce the above copyright
  12  *    notice, this list of conditions and the following disclaimer in the
  13  *    documentation and/or other materials provided with the distribution.
  14  *
  15  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  16  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  17  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  18  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  19  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  20  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  21  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  22  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  23  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  24  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  25  */
  26
  27 #include <sys/cdefs.h>
  28 __FBSDID("$FreeBSD$");
  29
  30 #include <sys/param.h>
  31 #include <sys/module.h>
  32 #include <sys/systm.h>
  33 #include <sys/kernel.h>
  34 #include <sys/bus.h>
  35 #include <sys/conf.h>
  36 #include <sys/endian.h>
  37 #include <sys/malloc.h>
  38 #include <sys/lock.h>
  39 #include <sys/mutex.h>
  40 #include <sys/sysctl.h>
  41 #include <sys/taskqueue.h>
  42 #include <sys/tree.h>
  43 #include <machine/stdarg.h>
  44 #include <machine/resource.h>
  45 #include <machine/bus.h>
  46 #include <sys/rman.h>
  47 #include <dev/pci/pcivar.h>
  48 #include <dev/pci/pcireg.h>
  49 #include <dev/iommu/iommu.h>
  50 #include "ahci.h"
  51
  52 static int force_ahci = 1;
  53 TUNABLE_INT("hw.ahci.force", &force_ahci);
  54
  55 static const struct {
  56         uint32_t        id;
  57         uint8_t         rev;
  58         const char      *name;
  59         int             quirks;
  60 } ahci_ids[] = {
  61         {0x43801002, 0x00, "AMD SB600",
  62             AHCI_Q_NOMSI | AHCI_Q_ATI_PMP_BUG | AHCI_Q_MAXIO_64K},
  63         {0x43901002, 0x00, "AMD SB7x0/SB8x0/SB9x0",
  64             AHCI_Q_ATI_PMP_BUG | AHCI_Q_1MSI},
  65         {0x43911002, 0x00, "AMD SB7x0/SB8x0/SB9x0",
  66             AHCI_Q_ATI_PMP_BUG | AHCI_Q_1MSI},
  67         {0x43921002, 0x00, "AMD SB7x0/SB8x0/SB9x0",
  68             AHCI_Q_ATI_PMP_BUG | AHCI_Q_1MSI},
  69         {0x43931002, 0x00, "AMD SB7x0/SB8x0/SB9x0",
  70             AHCI_Q_ATI_PMP_BUG | AHCI_Q_1MSI},
  71         {0x43941002, 0x00, "AMD SB7x0/SB8x0/SB9x0",
  72             AHCI_Q_ATI_PMP_BUG | AHCI_Q_1MSI},
  73         /* Not sure SB8x0/SB9x0 needs this quirk. Be conservative though */
  74         {0x43951002, 0x00, "AMD SB8x0/SB9x0",   AHCI_Q_ATI_PMP_BUG},
  75         {0x43b61022, 0x00, "AMD X399",          0},
  76         {0x43b51022, 0x00, "AMD 300 Series",    0}, /* X370 */
  77         {0x43b71022, 0x00, "AMD 300 Series",    0}, /* B350 */
  78         {0x78001022, 0x00, "AMD Hudson-2",      0},
  79         {0x78011022, 0x00, "AMD Hudson-2",      0},
  80         {0x78021022, 0x00, "AMD Hudson-2",      0},
  81         {0x78031022, 0x00, "AMD Hudson-2",      0},
  82         {0x78041022, 0x00, "AMD Hudson-2",      0},
  83         {0x79001022, 0x00, "AMD KERNCZ",        0},
  84         {0x79011022, 0x00, "AMD KERNCZ",        0},
  85         {0x79021022, 0x00, "AMD KERNCZ",        0},
  86         {0x79031022, 0x00, "AMD KERNCZ",        0},
  87         {0x79041022, 0x00, "AMD KERNCZ",        0},
  88         {0x06011b21, 0x00, "ASMedia ASM1060",   AHCI_Q_NOCCS|AHCI_Q_NOAUX},
  89         {0x06021b21, 0x00, "ASMedia ASM1060",   AHCI_Q_NOCCS|AHCI_Q_NOAUX},
  90         {0x06111b21, 0x00, "ASMedia ASM1061",   AHCI_Q_NOCCS|AHCI_Q_NOAUX},
  91         {0x06121b21, 0x00, "ASMedia ASM1062",   AHCI_Q_NOCCS|AHCI_Q_NOAUX},
  92         {0x06201b21, 0x00, "ASMedia ASM106x",   AHCI_Q_NOCCS|AHCI_Q_NOAUX},
  93         {0x06211b21, 0x00, "ASMedia ASM106x",   AHCI_Q_NOCCS|AHCI_Q_NOAUX},
  94         {0x06221b21, 0x00, "ASMedia ASM106x",   AHCI_Q_NOCCS|AHCI_Q_NOAUX},
  95         {0x06241b21, 0x00, "ASMedia ASM106x",   AHCI_Q_NOCCS|AHCI_Q_NOAUX},
  96         {0x06251b21, 0x00, "ASMedia ASM106x",   AHCI_Q_NOCCS|AHCI_Q_NOAUX},
  97         {0x79011d94, 0x00, "Hygon KERNCZ",      0},
  98         {0x26528086, 0x00, "Intel ICH6",        AHCI_Q_NOFORCE},
  99         {0x26538086, 0x00, "Intel ICH6M",       AHCI_Q_NOFORCE},
 100         {0x26818086, 0x00, "Intel ESB2",        0},
 101         {0x26828086, 0x00, "Intel ESB2",        0},
 102         {0x26838086, 0x00, "Intel ESB2",        0},
 103         {0x27c18086, 0x00, "Intel ICH7",        0},
 104         {0x27c38086, 0x00, "Intel ICH7",        0},
 105         {0x27c58086, 0x00, "Intel ICH7M",       0},
 106         {0x27c68086, 0x00, "Intel ICH7M",       0},
 107         {0x28218086, 0x00, "Intel ICH8",        0},
 108         {0x28228086, 0x00, "Intel ICH8+ (RAID)",        0},
 109         {0x28248086, 0x00, "Intel ICH8",        0},
 110         {0x28298086, 0x00, "Intel ICH8M",       0},
 111         {0x282a8086, 0x00, "Intel ICH8M+ (RAID)",       0},
 112         {0x29228086, 0x00, "Intel ICH9",        0},
 113         {0x29238086, 0x00, "Intel ICH9",        0},
 114         {0x29248086, 0x00, "Intel ICH9",        0},
 115         {0x29258086, 0x00, "Intel ICH9",        0},
 116         {0x29278086, 0x00, "Intel ICH9",        0},
 117         {0x29298086, 0x00, "Intel ICH9M",       0},
 118         {0x292a8086, 0x00, "Intel ICH9M",       0},
 119         {0x292b8086, 0x00, "Intel ICH9M",       0},
 120         {0x292c8086, 0x00, "Intel ICH9M",       0},
 121         {0x292f8086, 0x00, "Intel ICH9M",       0},
 122         {0x294d8086, 0x00, "Intel ICH9",        0},
 123         {0x294e8086, 0x00, "Intel ICH9M",       0},
 124         {0x3a058086, 0x00, "Intel ICH10 (RAID)",        0},
 125         {0x3a228086, 0x00, "Intel ICH10",       0},
 126         {0x3a258086, 0x00, "Intel ICH10 (RAID)",        0},
 127         {0x3b228086, 0x00, "Intel Ibex Peak",   0},
 128         {0x3b238086, 0x00, "Intel Ibex Peak",   0},
 129         {0x3b258086, 0x00, "Intel Ibex Peak (RAID)",    0},
 130         {0x3b298086, 0x00, "Intel Ibex Peak-M", 0},
 131         {0x3b2c8086, 0x00, "Intel Ibex Peak-M (RAID)",  0},
 132         {0x3b2f8086, 0x00, "Intel Ibex Peak-M", 0},
 133         {0x19b08086, 0x00, "Intel Denverton",   0},
 134         {0x19b18086, 0x00, "Intel Denverton",   0},
 135         {0x19b28086, 0x00, "Intel Denverton",   0},
 136         {0x19b38086, 0x00, "Intel Denverton",   0},
 137         {0x19b48086, 0x00, "Intel Denverton",   0},
 138         {0x19b58086, 0x00, "Intel Denverton",   0},
 139         {0x19b68086, 0x00, "Intel Denverton",   0},
 140         {0x19b78086, 0x00, "Intel Denverton",   0},
 141         {0x19be8086, 0x00, "Intel Denverton",   0},
 142         {0x19bf8086, 0x00, "Intel Denverton",   0},
 143         {0x19c08086, 0x00, "Intel Denverton",   0},
 144         {0x19c18086, 0x00, "Intel Denverton",   0},
 145         {0x19c28086, 0x00, "Intel Denverton",   0},
 146         {0x19c38086, 0x00, "Intel Denverton",   0},
 147         {0x19c48086, 0x00, "Intel Denverton",   0},
 148         {0x19c58086, 0x00, "Intel Denverton",   0},
 149         {0x19c68086, 0x00, "Intel Denverton",   0},
 150         {0x19c78086, 0x00, "Intel Denverton",   0},
 151         {0x19ce8086, 0x00, "Intel Denverton",   0},
 152         {0x19cf8086, 0x00, "Intel Denverton",   0},
 153         {0x1c028086, 0x00, "Intel Cougar Point",        0},
 154         {0x1c038086, 0x00, "Intel Cougar Point",        0},
 155         {0x1c048086, 0x00, "Intel Cougar Point (RAID)", 0},
 156         {0x1c058086, 0x00, "Intel Cougar Point (RAID)", 0},
 157         {0x1c068086, 0x00, "Intel Cougar Point (RAID)", 0},
 158         {0x1d028086, 0x00, "Intel Patsburg",    0},
 159         {0x1d048086, 0x00, "Intel Patsburg",    0},
 160         {0x1d068086, 0x00, "Intel Patsburg",    0},
 161         {0x28268086, 0x00, "Intel Patsburg+ (RAID)",    0},
 162         {0x1e028086, 0x00, "Intel Panther Point",       0},
 163         {0x1e038086, 0x00, "Intel Panther Point",       0},
 164         {0x1e048086, 0x00, "Intel Panther Point (RAID)",        0},
 165         {0x1e058086, 0x00, "Intel Panther Point (RAID)",        0},
 166         {0x1e068086, 0x00, "Intel Panther Point (RAID)",        0},
 167         {0x1e078086, 0x00, "Intel Panther Point (RAID)",        0},
 168         {0x1e0e8086, 0x00, "Intel Panther Point (RAID)",        0},
 169         {0x1e0f8086, 0x00, "Intel Panther Point (RAID)",        0},
 170         {0x1f228086, 0x00, "Intel Avoton",      0},
 171         {0x1f238086, 0x00, "Intel Avoton",      0},
 172         {0x1f248086, 0x00, "Intel Avoton (RAID)",       0},
 173         {0x1f258086, 0x00, "Intel Avoton (RAID)",       0},
 174         {0x1f268086, 0x00, "Intel Avoton (RAID)",       0},
 175         {0x1f278086, 0x00, "Intel Avoton (RAID)",       0},
 176         {0x1f2e8086, 0x00, "Intel Avoton (RAID)",       0},
 177         {0x1f2f8086, 0x00, "Intel Avoton (RAID)",       0},
 178         {0x1f328086, 0x00, "Intel Avoton",      0},
 179         {0x1f338086, 0x00, "Intel Avoton",      0},
 180         {0x1f348086, 0x00, "Intel Avoton (RAID)",       0},
 181         {0x1f358086, 0x00, "Intel Avoton (RAID)",       0},
 182         {0x1f368086, 0x00, "Intel Avoton (RAID)",       0},
 183         {0x1f378086, 0x00, "Intel Avoton (RAID)",       0},
 184         {0x1f3e8086, 0x00, "Intel Avoton (RAID)",       0},
 185         {0x1f3f8086, 0x00, "Intel Avoton (RAID)",       0},
 186         {0x23a38086, 0x00, "Intel Coleto Creek",        0},
 187         {0x5ae38086, 0x00, "Intel Apollo Lake", 0},
 188         {0x8c028086, 0x00, "Intel Lynx Point",  0},
 189         {0x8c038086, 0x00, "Intel Lynx Point",  0},
 190         {0x8c048086, 0x00, "Intel Lynx Point (RAID)",   0},
 191         {0x8c058086, 0x00, "Intel Lynx Point (RAID)",   0},
 192         {0x8c068086, 0x00, "Intel Lynx Point (RAID)",   0},
 193         {0x8c078086, 0x00, "Intel Lynx Point (RAID)",   0},
 194         {0x8c0e8086, 0x00, "Intel Lynx Point (RAID)",   0},
 195         {0x8c0f8086, 0x00, "Intel Lynx Point (RAID)",   0},
 196         {0x8c828086, 0x00, "Intel Wildcat Point",       0},
 197         {0x8c838086, 0x00, "Intel Wildcat Point",       0},
 198         {0x8c848086, 0x00, "Intel Wildcat Point (RAID)",        0},
 199         {0x8c858086, 0x00, "Intel Wildcat Point (RAID)",        0},
 200         {0x8c868086, 0x00, "Intel Wildcat Point (RAID)",        0},
 201         {0x8c878086, 0x00, "Intel Wildcat Point (RAID)",        0},
 202         {0x8c8e8086, 0x00, "Intel Wildcat Point (RAID)",        0},
 203         {0x8c8f8086, 0x00, "Intel Wildcat Point (RAID)",        0},
 204         {0x8d028086, 0x00, "Intel Wellsburg",   0},
 205         {0x8d048086, 0x00, "Intel Wellsburg (RAID)",    0},
 206         {0x8d068086, 0x00, "Intel Wellsburg (RAID)",    0},
 207         {0x8d628086, 0x00, "Intel Wellsburg",   0},
 208         {0x8d648086, 0x00, "Intel Wellsburg (RAID)",    0},
 209         {0x8d668086, 0x00, "Intel Wellsburg (RAID)",    0},
 210         {0x8d6e8086, 0x00, "Intel Wellsburg (RAID)",    0},
 211         {0x28238086, 0x00, "Intel Wellsburg+ (RAID)",   0},
 212         {0x28278086, 0x00, "Intel Wellsburg+ (RAID)",   0},
 213         {0x9c028086, 0x00, "Intel Lynx Point-LP",       0},
 214         {0x9c038086, 0x00, "Intel Lynx Point-LP",       0},
 215         {0x9c048086, 0x00, "Intel Lynx Point-LP (RAID)",        0},
 216         {0x9c058086, 0x00, "Intel Lynx Point-LP (RAID)",        0},
 217         {0x9c068086, 0x00, "Intel Lynx Point-LP (RAID)",        0},
 218         {0x9c078086, 0x00, "Intel Lynx Point-LP (RAID)",        0},
 219         {0x9c0e8086, 0x00, "Intel Lynx Point-LP (RAID)",        0},
 220         {0x9c0f8086, 0x00, "Intel Lynx Point-LP (RAID)",        0},
 221         {0x9c838086, 0x00, "Intel Wildcat Point-LP",    0},
 222         {0x9c858086, 0x00, "Intel Wildcat Point-LP (RAID)",     0},
 223         {0x9c878086, 0x00, "Intel Wildcat Point-LP (RAID)",     0},
 224         {0x9c8f8086, 0x00, "Intel Wildcat Point-LP (RAID)",     0},
 225         {0x9d038086, 0x00, "Intel Sunrise Point-LP",    0},
 226         {0x9d058086, 0x00, "Intel Sunrise Point-LP (RAID)",     0},
 227         {0x9d078086, 0x00, "Intel Sunrise Point-LP (RAID)",     0},
 228         {0xa1028086, 0x00, "Intel Sunrise Point",       0},
 229         {0xa1038086, 0x00, "Intel Sunrise Point",       0},
 230         {0xa1058086, 0x00, "Intel Sunrise Point (RAID)",        0},
 231         {0xa1068086, 0x00, "Intel Sunrise Point (RAID)",        0},
 232         {0xa1078086, 0x00, "Intel Sunrise Point (RAID)",        0},
 233         {0xa10f8086, 0x00, "Intel Sunrise Point (RAID)",        0},
 234         {0xa1828086, 0x00, "Intel Lewisburg",   0},
 235         {0xa1868086, 0x00, "Intel Lewisburg (RAID)",    0},
 236         {0xa1d28086, 0x00, "Intel Lewisburg",   0},
 237         {0xa1d68086, 0x00, "Intel Lewisburg (RAID)",    0},
 238         {0xa2028086, 0x00, "Intel Lewisburg",   0},
 239         {0xa2068086, 0x00, "Intel Lewisburg (RAID)",    0},
 240         {0xa2528086, 0x00, "Intel Lewisburg",   0},
 241         {0xa2568086, 0x00, "Intel Lewisburg (RAID)",    0},
 242         {0xa2828086, 0x00, "Intel Union Point", 0},
 243         {0xa2868086, 0x00, "Intel Union Point (RAID)",  0},
 244         {0xa28e8086, 0x00, "Intel Union Point (RAID)",  0},
 245         {0xa3528086, 0x00, "Intel Cannon Lake", 0},
 246         {0xa3538086, 0x00, "Intel Cannon Lake", 0},
 247         {0x23238086, 0x00, "Intel DH89xxCC",    0},
 248         {0x2360197b, 0x00, "JMicron JMB360",    0},
 249         {0x2361197b, 0x00, "JMicron JMB361",    AHCI_Q_NOFORCE | AHCI_Q_1CH},
 250         {0x2362197b, 0x00, "JMicron JMB362",    0},
 251         {0x2363197b, 0x00, "JMicron JMB363",    AHCI_Q_NOFORCE},
 252         {0x2365197b, 0x00, "JMicron JMB365",    AHCI_Q_NOFORCE},
 253         {0x2366197b, 0x00, "JMicron JMB366",    AHCI_Q_NOFORCE},
 254         {0x2368197b, 0x00, "JMicron JMB368",    AHCI_Q_NOFORCE},
 255         {0x2392197b, 0x00, "JMicron JMB388",    AHCI_Q_IOMMU_BUSWIDE},
 256         {0x0585197b, 0x00, "JMicron JMB58x",    0},
 257         {0x01221c28, 0x00, "Lite-On Plextor M6E (Marvell 88SS9183)",
 258             AHCI_Q_IOMMU_BUSWIDE},
 259         {0x611111ab, 0x00, "Marvell 88SE6111",  AHCI_Q_NOFORCE | AHCI_Q_NOPMP |
 260             AHCI_Q_1CH | AHCI_Q_EDGEIS},
 261         {0x612111ab, 0x00, "Marvell 88SE6121",  AHCI_Q_NOFORCE | AHCI_Q_NOPMP |
 262             AHCI_Q_2CH | AHCI_Q_EDGEIS | AHCI_Q_NONCQ | AHCI_Q_NOCOUNT},
 263         {0x614111ab, 0x00, "Marvell 88SE6141",  AHCI_Q_NOFORCE | AHCI_Q_NOPMP |
 264             AHCI_Q_4CH | AHCI_Q_EDGEIS | AHCI_Q_NONCQ | AHCI_Q_NOCOUNT},
 265         {0x614511ab, 0x00, "Marvell 88SE6145",  AHCI_Q_NOFORCE | AHCI_Q_NOPMP |
 266             AHCI_Q_4CH | AHCI_Q_EDGEIS | AHCI_Q_NONCQ | AHCI_Q_NOCOUNT},
 267         {0x91201b4b, 0x00, "Marvell 88SE912x",  AHCI_Q_EDGEIS |
 268             AHCI_Q_IOMMU_BUSWIDE},
 269         {0x91231b4b, 0x11, "Marvell 88SE912x",  AHCI_Q_ALTSIG |
 270             AHCI_Q_IOMMU_BUSWIDE},
 271         {0x91231b4b, 0x00, "Marvell 88SE912x",  AHCI_Q_EDGEIS | AHCI_Q_SATA2 |
 272             AHCI_Q_IOMMU_BUSWIDE},
 273         {0x91251b4b, 0x00, "Marvell 88SE9125",  0},
 274         {0x91281b4b, 0x00, "Marvell 88SE9128",  AHCI_Q_ALTSIG |
 275             AHCI_Q_IOMMU_BUSWIDE},
 276         {0x91301b4b, 0x00, "Marvell 88SE9130",  AHCI_Q_ALTSIG |
 277             AHCI_Q_IOMMU_BUSWIDE},
 278         {0x91701b4b, 0x00, "Marvell 88SE9170",  AHCI_Q_IOMMU_BUSWIDE},
 279         {0x91721b4b, 0x00, "Marvell 88SE9172",  AHCI_Q_IOMMU_BUSWIDE},
 280         {0x917a1b4b, 0x00, "Marvell 88SE917A",  AHCI_Q_IOMMU_BUSWIDE},
 281         {0x91821b4b, 0x00, "Marvell 88SE9182",  AHCI_Q_IOMMU_BUSWIDE},
 282         {0x91831b4b, 0x00, "Marvell 88SS9183",  AHCI_Q_IOMMU_BUSWIDE},
 283         {0x91a01b4b, 0x00, "Marvell 88SE91Ax",  AHCI_Q_IOMMU_BUSWIDE},
 284         {0x92151b4b, 0x00, "Marvell 88SE9215",  0},
 285         {0x92201b4b, 0x00, "Marvell 88SE9220",  AHCI_Q_ALTSIG |
 286             AHCI_Q_IOMMU_BUSWIDE},
 287         {0x92301b4b, 0x00, "Marvell 88SE9230",  AHCI_Q_ALTSIG |
 288             AHCI_Q_IOMMU_BUSWIDE},
 289         {0x92351b4b, 0x00, "Marvell 88SE9235",  0},
 290         {0x06201103, 0x00, "HighPoint RocketRAID 620",  0},
 291         {0x06201b4b, 0x00, "HighPoint RocketRAID 620",  0},
 292         {0x06221103, 0x00, "HighPoint RocketRAID 622",  0},
 293         {0x06221b4b, 0x00, "HighPoint RocketRAID 622",  0},
 294         {0x06401103, 0x00, "HighPoint RocketRAID 640",  0},
 295         {0x06401b4b, 0x00, "HighPoint RocketRAID 640",  0},
 296         {0x06441103, 0x00, "HighPoint RocketRAID 644",  0},
 297         {0x06441b4b, 0x00, "HighPoint RocketRAID 644",  0},
 298         {0x06411103, 0x00, "HighPoint RocketRAID 640L", 0},
 299         {0x06421103, 0x00, "HighPoint RocketRAID 642L", AHCI_Q_IOMMU_BUSWIDE},
 300         {0x06451103, 0x00, "HighPoint RocketRAID 644L", AHCI_Q_IOMMU_BUSWIDE},
 301         {0x044c10de, 0x00, "NVIDIA MCP65",      AHCI_Q_NOAA},
 302         {0x044d10de, 0x00, "NVIDIA MCP65",      AHCI_Q_NOAA},
 303         {0x044e10de, 0x00, "NVIDIA MCP65",      AHCI_Q_NOAA},
 304         {0x044f10de, 0x00, "NVIDIA MCP65",      AHCI_Q_NOAA},
 305         {0x045c10de, 0x00, "NVIDIA MCP65",      AHCI_Q_NOAA},
 306         {0x045d10de, 0x00, "NVIDIA MCP65",      AHCI_Q_NOAA},
 307         {0x045e10de, 0x00, "NVIDIA MCP65",      AHCI_Q_NOAA},
 308         {0x045f10de, 0x00, "NVIDIA MCP65",      AHCI_Q_NOAA},
 309         {0x055010de, 0x00, "NVIDIA MCP67",      AHCI_Q_NOAA},
 310         {0x055110de, 0x00, "NVIDIA MCP67",      AHCI_Q_NOAA},
 311         {0x055210de, 0x00, "NVIDIA MCP67",      AHCI_Q_NOAA},
 312         {0x055310de, 0x00, "NVIDIA MCP67",      AHCI_Q_NOAA},
 313         {0x055410de, 0x00, "NVIDIA MCP67",      AHCI_Q_NOAA},
 314         {0x055510de, 0x00, "NVIDIA MCP67",      AHCI_Q_NOAA},
 315         {0x055610de, 0x00, "NVIDIA MCP67",      AHCI_Q_NOAA},
 316         {0x055710de, 0x00, "NVIDIA MCP67",      AHCI_Q_NOAA},
 317         {0x055810de, 0x00, "NVIDIA MCP67",      AHCI_Q_NOAA},
 318         {0x055910de, 0x00, "NVIDIA MCP67",      AHCI_Q_NOAA},
 319         {0x055A10de, 0x00, "NVIDIA MCP67",      AHCI_Q_NOAA},
 320         {0x055B10de, 0x00, "NVIDIA MCP67",      AHCI_Q_NOAA},
 321         {0x058410de, 0x00, "NVIDIA MCP67",      AHCI_Q_NOAA},
 322         {0x07f010de, 0x00, "NVIDIA MCP73",      AHCI_Q_NOAA},
 323         {0x07f110de, 0x00, "NVIDIA MCP73",      AHCI_Q_NOAA},
 324         {0x07f210de, 0x00, "NVIDIA MCP73",      AHCI_Q_NOAA},
 325         {0x07f310de, 0x00, "NVIDIA MCP73",      AHCI_Q_NOAA},
 326         {0x07f410de, 0x00, "NVIDIA MCP73",      AHCI_Q_NOAA},
 327         {0x07f510de, 0x00, "NVIDIA MCP73",      AHCI_Q_NOAA},
 328         {0x07f610de, 0x00, "NVIDIA MCP73",      AHCI_Q_NOAA},
 329         {0x07f710de, 0x00, "NVIDIA MCP73",      AHCI_Q_NOAA},
 330         {0x07f810de, 0x00, "NVIDIA MCP73",      AHCI_Q_NOAA},
 331         {0x07f910de, 0x00, "NVIDIA MCP73",      AHCI_Q_NOAA},
 332         {0x07fa10de, 0x00, "NVIDIA MCP73",      AHCI_Q_NOAA},
 333         {0x07fb10de, 0x00, "NVIDIA MCP73",      AHCI_Q_NOAA},
 334         {0x0ad010de, 0x00, "NVIDIA MCP77",      AHCI_Q_NOAA},
 335         {0x0ad110de, 0x00, "NVIDIA MCP77",      AHCI_Q_NOAA},
 336         {0x0ad210de, 0x00, "NVIDIA MCP77",      AHCI_Q_NOAA},
 337         {0x0ad310de, 0x00, "NVIDIA MCP77",      AHCI_Q_NOAA},
 338         {0x0ad410de, 0x00, "NVIDIA MCP77",      AHCI_Q_NOAA},
 339         {0x0ad510de, 0x00, "NVIDIA MCP77",      AHCI_Q_NOAA},
 340         {0x0ad610de, 0x00, "NVIDIA MCP77",      AHCI_Q_NOAA},
 341         {0x0ad710de, 0x00, "NVIDIA MCP77",      AHCI_Q_NOAA},
 342         {0x0ad810de, 0x00, "NVIDIA MCP77",      AHCI_Q_NOAA},
 343         {0x0ad910de, 0x00, "NVIDIA MCP77",      AHCI_Q_NOAA},
 344         {0x0ada10de, 0x00, "NVIDIA MCP77",      AHCI_Q_NOAA},
 345         {0x0adb10de, 0x00, "NVIDIA MCP77",      AHCI_Q_NOAA},
 346         {0x0ab410de, 0x00, "NVIDIA MCP79",      AHCI_Q_NOAA},
 347         {0x0ab510de, 0x00, "NVIDIA MCP79",      AHCI_Q_NOAA},
 348         {0x0ab610de, 0x00, "NVIDIA MCP79",      AHCI_Q_NOAA},
 349         {0x0ab710de, 0x00, "NVIDIA MCP79",      AHCI_Q_NOAA},
 350         {0x0ab810de, 0x00, "NVIDIA MCP79",      AHCI_Q_NOAA},
 351         {0x0ab910de, 0x00, "NVIDIA MCP79",      AHCI_Q_NOAA},
 352         {0x0aba10de, 0x00, "NVIDIA MCP79",      AHCI_Q_NOAA},
 353         {0x0abb10de, 0x00, "NVIDIA MCP79",      AHCI_Q_NOAA},
 354         {0x0abc10de, 0x00, "NVIDIA MCP79",      AHCI_Q_NOAA},
 355         {0x0abd10de, 0x00, "NVIDIA MCP79",      AHCI_Q_NOAA},
 356         {0x0abe10de, 0x00, "NVIDIA MCP79",      AHCI_Q_NOAA},
 357         {0x0abf10de, 0x00, "NVIDIA MCP79",      AHCI_Q_NOAA},
 358         {0x0d8410de, 0x00, "NVIDIA MCP89",      AHCI_Q_NOAA},
 359         {0x0d8510de, 0x00, "NVIDIA MCP89",      AHCI_Q_NOFORCE|AHCI_Q_NOAA},
 360         {0x0d8610de, 0x00, "NVIDIA MCP89",      AHCI_Q_NOAA},
 361         {0x0d8710de, 0x00, "NVIDIA MCP89",      AHCI_Q_NOAA},
 362         {0x0d8810de, 0x00, "NVIDIA MCP89",      AHCI_Q_NOAA},
 363         {0x0d8910de, 0x00, "NVIDIA MCP89",      AHCI_Q_NOAA},
 364         {0x0d8a10de, 0x00, "NVIDIA MCP89",      AHCI_Q_NOAA},
 365         {0x0d8b10de, 0x00, "NVIDIA MCP89",      AHCI_Q_NOAA},
 366         {0x0d8c10de, 0x00, "NVIDIA MCP89",      AHCI_Q_NOAA},
 367         {0x0d8d10de, 0x00, "NVIDIA MCP89",      AHCI_Q_NOAA},
 368         {0x0d8e10de, 0x00, "NVIDIA MCP89",      AHCI_Q_NOAA},
 369         {0x0d8f10de, 0x00, "NVIDIA MCP89",      AHCI_Q_NOAA},
 370         {0x3781105a, 0x00, "Promise TX8660",    0},
 371         {0x33491106, 0x00, "VIA VT8251",        AHCI_Q_NOPMP|AHCI_Q_NONCQ},
 372         {0x62871106, 0x00, "VIA VT8251",        AHCI_Q_NOPMP|AHCI_Q_NONCQ},
 373         {0x11841039, 0x00, "SiS 966",           0},
 374         {0x11851039, 0x00, "SiS 968",           0},
 375         {0x01861039, 0x00, "SiS 968",           0},
 376         {0xa01c177d, 0x00, "ThunderX",          AHCI_Q_ABAR0|AHCI_Q_1MSI},
 377         {0x00311c36, 0x00, "Annapurna",         AHCI_Q_FORCE_PI|AHCI_Q_RESTORE_CAP|AHCI_Q_NOMSIX},
 378         {0x1600144d, 0x00, "Samsung",           AHCI_Q_NOMSI},
 379         {0x00000000, 0x00, NULL,                0}
 380 };
 381
 382 static int
 383 ahci_pci_ctlr_reset(device_t dev)
 384 {
 385
 386         return(ahci_ctlr_reset(dev));
 387 }
 388
 389 static int
 390 ahci_probe(device_t dev)
 391 {
 392         char buf[64];
 393         int i, valid = 0;
 394         uint32_t devid = pci_get_devid(dev);
 395         uint8_t revid = pci_get_revid(dev);
 396
 397         /*
 398          * Ensure it is not a PCI bridge (some vendors use
 399          * the same PID and VID in PCI bridge and AHCI cards).
 400          */
 401         if (pci_get_class(dev) == PCIC_BRIDGE)
 402                 return (ENXIO);
 403
 404         /* Is this a possible AHCI candidate? */
 405         if (pci_get_class(dev) == PCIC_STORAGE &&
 406             pci_get_subclass(dev) == PCIS_STORAGE_SATA &&
 407             pci_get_progif(dev) == PCIP_STORAGE_SATA_AHCI_1_0)
 408                 valid = 1;
 409         else if (pci_get_class(dev) == PCIC_STORAGE &&
 410             pci_get_subclass(dev) == PCIS_STORAGE_RAID)
 411                 valid = 2;
 412         /* Is this a known AHCI chip? */
 413         for (i = 0; ahci_ids[i].id != 0; i++) {
 414                 if (ahci_ids[i].id == devid &&
 415                     ahci_ids[i].rev <= revid &&
 416                     (valid || (force_ahci == 1 &&
 417                      !(ahci_ids[i].quirks & AHCI_Q_NOFORCE)))) {
 418                         /* Do not attach JMicrons with single PCI function. */
 419                         if (pci_get_vendor(dev) == 0x197b &&
 420                             (ahci_ids[i].quirks & AHCI_Q_NOFORCE) &&
 421                             (pci_read_config(dev, 0xdf, 1) & 0x40) == 0)
 422                                 return (ENXIO);
 423                         snprintf(buf, sizeof(buf), "%s AHCI SATA controller",
 424                             ahci_ids[i].name);
 425                         device_set_desc_copy(dev, buf);
 426                         return (BUS_PROBE_DEFAULT);
 427                 }
 428         }
 429         if (valid != 1)
 430                 return (ENXIO);
 431         device_set_desc_copy(dev, "AHCI SATA controller");
 432         return (BUS_PROBE_DEFAULT);
 433 }
 434
 435 static int
 436 ahci_ata_probe(device_t dev)
 437 {
 438         char buf[64];
 439         int i;
 440         uint32_t devid = pci_get_devid(dev);
 441         uint8_t revid = pci_get_revid(dev);
 442
 443         if ((intptr_t)device_get_ivars(dev) >= 0)
 444                 return (ENXIO);
 445         /* Is this a known AHCI chip? */
 446         for (i = 0; ahci_ids[i].id != 0; i++) {
 447                 if (ahci_ids[i].id == devid &&
 448                     ahci_ids[i].rev <= revid) {
 449                         snprintf(buf, sizeof(buf), "%s AHCI SATA controller",
 450                             ahci_ids[i].name);
 451                         device_set_desc_copy(dev, buf);
 452                         return (BUS_PROBE_DEFAULT);
 453                 }
 454         }
 455         device_set_desc_copy(dev, "AHCI SATA controller");
 456         return (BUS_PROBE_DEFAULT);
 457 }
 458
 459 static int
 460 ahci_pci_read_msix_bars(device_t dev, uint8_t *table_bar, uint8_t *pba_bar)
 461 {
 462         int cap_offset = 0, ret;
 463         uint32_t val;
 464
 465         if ((table_bar == NULL) || (pba_bar == NULL))
 466                 return (EINVAL);
 467
 468         ret = pci_find_cap(dev, PCIY_MSIX, &cap_offset);
 469         if (ret != 0)
 470                 return (EINVAL);
 471
 472         val = pci_read_config(dev, cap_offset + PCIR_MSIX_TABLE, 4);
 473         *table_bar = PCIR_BAR(val & PCIM_MSIX_BIR_MASK);
 474
 475         val = pci_read_config(dev, cap_offset + PCIR_MSIX_PBA, 4);
 476         *pba_bar = PCIR_BAR(val & PCIM_MSIX_BIR_MASK);
 477
 478         return (0);
 479 }
 480
 481 static int
 482 ahci_pci_attach(device_t dev)
 483 {
 484         struct ahci_controller *ctlr = device_get_softc(dev);
 485         int     error, i;
 486         uint32_t devid = pci_get_devid(dev);
 487         uint8_t revid = pci_get_revid(dev);
 488         int msi_count, msix_count;
 489         uint8_t table_bar = 0, pba_bar = 0;
 490         uint32_t caps, pi;
 491
 492         msi_count = pci_msi_count(dev);
 493         msix_count = pci_msix_count(dev);
 494
 495         i = 0;
 496         while (ahci_ids[i].id != 0 &&
 497             (ahci_ids[i].id != devid ||
 498              ahci_ids[i].rev > revid))
 499                 i++;
 500         ctlr->quirks = ahci_ids[i].quirks;
 501
 502         if (ctlr->quirks & AHCI_Q_IOMMU_BUSWIDE) {
 503                 /*
 504                  * The controller issues DMA requests from PCI function 1,
 505                  * but the device is not multifunction.
 506                  * Ref: https://bugzilla.kernel.org/show_bug.cgi?id=42679
 507                  */
 508                 bus_dma_iommu_set_buswide(dev);
 509         }
 510
 511         /* Limit speed for my onboard JMicron external port.
 512          * It is not eSATA really, limit to SATA 1 */
 513         if (pci_get_devid(dev) == 0x2363197b &&
 514             pci_get_subvendor(dev) == 0x1043 &&
 515             pci_get_subdevice(dev) == 0x81e4)
 516                 ctlr->quirks |= AHCI_Q_SATA1_UNIT0;
 517         resource_int_value(device_get_name(dev), device_get_unit(dev),
 518             "quirks", &ctlr->quirks);
 519         ctlr->vendorid = pci_get_vendor(dev);
 520         ctlr->deviceid = pci_get_device(dev);
 521         ctlr->subvendorid = pci_get_subvendor(dev);
 522         ctlr->subdeviceid = pci_get_subdevice(dev);
 523
 524         /* Default AHCI Base Address is BAR(5), Cavium uses BAR(0) */
 525         if (ctlr->quirks & AHCI_Q_ABAR0)
 526                 ctlr->r_rid = PCIR_BAR(0);
 527         else
 528                 ctlr->r_rid = PCIR_BAR(5);
 529         if (!(ctlr->r_mem = bus_alloc_resource_any(dev, SYS_RES_MEMORY,
 530             &ctlr->r_rid, RF_ACTIVE)))
 531                 return ENXIO;
 532
 533         /*
 534          * Intel RAID hardware can remap NVMe devices inside its BAR.
 535          * Try to detect this. Either we have to add the device
 536          * here, or the user has to change the mode in the BIOS
 537          * from RST to AHCI.
 538          */
 539         if (pci_get_vendor(dev) == 0x8086) {
 540                 uint32_t vscap;
 541
 542                 vscap = ATA_INL(ctlr->r_mem, AHCI_VSCAP);
 543                 if (vscap & 1) {
 544                         uint32_t cap = ATA_INL(ctlr->r_mem, 0x800); /* Intel's REMAP CAP */
 545                         int i;
 546
 547                         ctlr->remap_offset = 0x4000;
 548                         ctlr->remap_size = 0x4000;
 549
 550                         /*
 551                          * Check each of the devices that might be remapped to
 552                          * make sure they are an nvme device. At the present,
 553                          * nvme are the only known devices remapped.
 554                          */
 555                         for (i = 0; i < 3; i++) {
 556                                 if (cap & (1 << i) &&
 557                                     (ATA_INL(ctlr->r_mem, 0x880 + i * 0x80) ==
 558                                      ((PCIC_STORAGE << 16) |
 559                                       (PCIS_STORAGE_NVM << 8) |
 560                                       PCIP_STORAGE_NVM_ENTERPRISE_NVMHCI_1_0))) {
 561                                         ctlr->remapped_devices++;
 562                                 }
 563                         }
 564
 565                         /* If we have any remapped device, disable MSI */
 566                         if (ctlr->remapped_devices > 0) {
 567                                 device_printf(dev, "Detected %d nvme remapped devices\n",
 568                                     ctlr->remapped_devices);
 569                                 ctlr->quirks |= (AHCI_Q_NOMSIX | AHCI_Q_NOMSI);
 570                         }
 571                 }
 572         }
 573
 574         if (ctlr->quirks & AHCI_Q_NOMSIX)
 575                 msix_count = 0;
 576
 577         /* Read MSI-x BAR IDs if supported */
 578         if (msix_count > 0) {
 579                 error = ahci_pci_read_msix_bars(dev, &table_bar, &pba_bar);
 580                 if (error == 0) {
 581                         ctlr->r_msix_tab_rid = table_bar;
 582                         ctlr->r_msix_pba_rid = pba_bar;
 583                 } else {
 584                         /* Failed to read BARs, disable MSI-x */
 585                         msix_count = 0;
 586                 }
 587         }
 588
 589         /* Allocate resources for MSI-x table and PBA */
 590         if (msix_count > 0) {
 591                 /*
 592                  * Allocate new MSI-x table only if not
 593                  * allocated before.
 594                  */
 595                 ctlr->r_msix_table = NULL;
 596                 if (ctlr->r_msix_tab_rid != ctlr->r_rid) {
 597                         /* Separate BAR for MSI-x */
 598                         ctlr->r_msix_table = bus_alloc_resource_any(dev, SYS_RES_MEMORY,
 599                             &ctlr->r_msix_tab_rid, RF_ACTIVE);
 600                         if (ctlr->r_msix_table == NULL) {
 601                                 ahci_free_mem(dev);
 602                                 return (ENXIO);
 603                         }
 604                 }
 605
 606                 /*
 607                  * Allocate new PBA table only if not
 608                  * allocated before.
 609                  */
 610                 ctlr->r_msix_pba = NULL;
 611                 if ((ctlr->r_msix_pba_rid != ctlr->r_msix_tab_rid) &&
 612                     (ctlr->r_msix_pba_rid != ctlr->r_rid)) {
 613                         /* Separate BAR for PBA */
 614                         ctlr->r_msix_pba = bus_alloc_resource_any(dev, SYS_RES_MEMORY,
 615                             &ctlr->r_msix_pba_rid, RF_ACTIVE);
 616                         if (ctlr->r_msix_pba == NULL) {
 617                                 ahci_free_mem(dev);
 618                                 return (ENXIO);
 619                         }
 620                 }
 621         }
 622
 623         pci_enable_busmaster(dev);
 624         /* Reset controller */
 625         if ((error = ahci_pci_ctlr_reset(dev)) != 0) {
 626                 ahci_free_mem(dev);
 627                 return (error);
 628         }
 629
 630         /* Setup interrupts. */
 631
 632         /* Setup MSI register parameters */
 633         /* Process hints. */
 634         caps = ATA_INL(ctlr->r_mem, AHCI_CAP);
 635         pi = ATA_INL(ctlr->r_mem, AHCI_PI);
 636         if (ctlr->quirks & AHCI_Q_NOMSI)
 637                 ctlr->msi = 0;
 638         else if ((ctlr->quirks & AHCI_Q_1MSI) ||
 639             ((caps & (AHCI_CAP_NPMASK | AHCI_CAP_CCCS)) == 0 && pi == 1))
 640                 ctlr->msi = 1;
 641         else
 642                 ctlr->msi = 2;
 643         resource_int_value(device_get_name(dev),
 644             device_get_unit(dev), "msi", &ctlr->msi);
 645         ctlr->numirqs = 1;
 646         if (msi_count == 0 && msix_count == 0)
 647                 ctlr->msi = 0;
 648         if (ctlr->msi < 0)
 649                 ctlr->msi = 0;
 650         else if (ctlr->msi == 1) {
 651                 msi_count = min(1, msi_count);
 652                 msix_count = min(1, msix_count);
 653         } else if (ctlr->msi > 1)
 654                 ctlr->msi = 2;
 655
 656         /* Allocate MSI/MSI-x if needed/present. */
 657         if (ctlr->msi > 0) {
 658                 error = ENXIO;
 659
 660                 /* Try to allocate MSI-x first */
 661                 if (msix_count > 0) {
 662                         error = pci_alloc_msix(dev, &msix_count);
 663                         if (error == 0)
 664                                 ctlr->numirqs = msix_count;
 665                 }
 666
 667                 /*
 668                  * Try to allocate MSI if msi_count is greater than 0
 669                  * and if MSI-x allocation failed.
 670                  */
 671                 if ((error != 0) && (msi_count > 0)) {
 672                         error = pci_alloc_msi(dev, &msi_count);
 673                         if (error == 0)
 674                                 ctlr->numirqs = msi_count;
 675                 }
 676
 677                 /* Both MSI and MSI-x allocations failed */
 678                 if (error != 0) {
 679                         ctlr->msi = 0;
 680                         device_printf(dev, "Failed to allocate MSI/MSI-x, "
 681                             "falling back to INTx\n");
 682                 }
 683         }
 684
 685         error = ahci_attach(dev);
 686         if (error != 0) {
 687                 if (ctlr->msi > 0)
 688                         pci_release_msi(dev);
 689                 ahci_free_mem(dev);
 690         }
 691         return error;
 692 }
 693
 694 static int
 695 ahci_pci_detach(device_t dev)
 696 {
 697
 698         ahci_detach(dev);
 699         pci_release_msi(dev);
 700         return (0);
 701 }
 702
 703 static int
 704 ahci_pci_suspend(device_t dev)
 705 {
 706         struct ahci_controller *ctlr = device_get_softc(dev);
 707
 708         bus_generic_suspend(dev);
 709         /* Disable interupts, so the state change(s) doesn't trigger */
 710         ATA_OUTL(ctlr->r_mem, AHCI_GHC,
 711              ATA_INL(ctlr->r_mem, AHCI_GHC) & (~AHCI_GHC_IE));
 712         return 0;
 713 }
 714
 715 static int
 716 ahci_pci_resume(device_t dev)
 717 {
 718         int res;
 719
 720         if ((res = ahci_pci_ctlr_reset(dev)) != 0)
 721                 return (res);
 722         ahci_ctlr_setup(dev);
 723         return (bus_generic_resume(dev));
 724 }
 725
 726 static device_method_t ahci_methods[] = {
 727         DEVMETHOD(device_probe,     ahci_probe),
 728         DEVMETHOD(device_attach,    ahci_pci_attach),
 729         DEVMETHOD(device_detach,    ahci_pci_detach),
 730         DEVMETHOD(device_suspend,   ahci_pci_suspend),
 731         DEVMETHOD(device_resume,    ahci_pci_resume),
 732         DEVMETHOD(bus_print_child,  ahci_print_child),
 733         DEVMETHOD(bus_alloc_resource,       ahci_alloc_resource),
 734         DEVMETHOD(bus_release_resource,     ahci_release_resource),
 735         DEVMETHOD(bus_setup_intr,   ahci_setup_intr),
 736         DEVMETHOD(bus_teardown_intr,ahci_teardown_intr),
 737         DEVMETHOD(bus_child_location_str, ahci_child_location_str),
 738         DEVMETHOD(bus_get_dma_tag,  ahci_get_dma_tag),
 739         DEVMETHOD_END
 740 };
 741 static driver_t ahci_driver = {
 742         "ahci",
 743         ahci_methods,
 744         sizeof(struct ahci_controller)
 745 };
 746 DRIVER_MODULE(ahci, pci, ahci_driver, ahci_devclass, NULL, NULL);
 747 /* Also matches class / subclass / progid XXX need to add when we have masking support */
 748 MODULE_PNP_INFO("W32:vendor/device", pci, ahci, ahci_ids,
 749     nitems(ahci_ids) - 1);
 750 static device_method_t ahci_ata_methods[] = {
 751         DEVMETHOD(device_probe,     ahci_ata_probe),
 752         DEVMETHOD(device_attach,    ahci_pci_attach),
 753         DEVMETHOD(device_detach,    ahci_pci_detach),
 754         DEVMETHOD(device_suspend,   ahci_pci_suspend),
 755         DEVMETHOD(device_resume,    ahci_pci_resume),
 756         DEVMETHOD(bus_print_child,  ahci_print_child),
 757         DEVMETHOD(bus_alloc_resource,       ahci_alloc_resource),
 758         DEVMETHOD(bus_release_resource,     ahci_release_resource),
 759         DEVMETHOD(bus_setup_intr,   ahci_setup_intr),
 760         DEVMETHOD(bus_teardown_intr,ahci_teardown_intr),
 761         DEVMETHOD(bus_child_location_str, ahci_child_location_str),
 762         DEVMETHOD_END
 763 };
 764 static driver_t ahci_ata_driver = {
 765         "ahci",
 766         ahci_ata_methods,
 767         sizeof(struct ahci_controller)
 768 };
 769 DRIVER_MODULE(ahci, atapci, ahci_ata_driver, ahci_devclass, NULL, NULL);