1 // SPDX-License-Identifier: GPL-2.0-only 2 /* 3 * Helper routines to scan the device tree for PCI devices and busses 4 * 5 * Migrated out of PowerPC architecture pci_64.c file by Grant Likely 6 * <grant.likely@secretlab.ca> so that these routines are available for 7 * 32 bit also. 8 * 9 * Copyright (C) 2003 Anton Blanchard <anton@au.ibm.com>, IBM 10 * Rework, based on alpha PCI code. 11 * Copyright (c) 2009 Secret Lab Technologies Ltd. 12 */ 13 14 #include <linux/pci.h> 15 #include <linux/export.h> 16 #include <linux/of.h> 17 #include <asm/pci-bridge.h> 18 19 /** 20 * get_int_prop - Decode a u32 from a device tree property 21 */ 22 static u32 get_int_prop(struct device_node *np, const char *name, u32 def) 23 { 24 const __be32 *prop; 25 int len; 26 27 prop = of_get_property(np, name, &len); 28 if (prop && len >= 4) 29 return of_read_number(prop, 1); 30 return def; 31 } 32 33 /** 34 * pci_parse_of_flags - Parse the flags cell of a device tree PCI address 35 * @addr0: value of 1st cell of a device tree PCI address. 36 * @bridge: Set this flag if the address is from a bridge 'ranges' property 37 * 38 * PCI Bus Binding to IEEE Std 1275-1994 39 * 40 * Bit# 33222222 22221111 11111100 00000000 41 * 10987654 32109876 54321098 76543210 42 * phys.hi cell: npt000ss bbbbbbbb dddddfff rrrrrrrr 43 * phys.mid cell: hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 44 * phys.lo cell: llllllll llllllll llllllll llllllll 45 * 46 * where: 47 * n is 0 if the address is relocatable, 1 otherwise 48 * p is 1 if the addressable region is "prefetchable", 0 otherwise 49 * t is 1 if the address is aliased (for non-relocatable I/O), 50 * below 1 MB (for Memory),or below 64 KB (for relocatable I/O). 51 * ss is the space code, denoting the address space: 52 * 00 denotes Configuration Space 53 * 01 denotes I/O Space 54 * 10 denotes 32-bit-address Memory Space 55 * 11 denotes 64-bit-address Memory Space 56 * bbbbbbbb is the 8-bit Bus Number 57 * ddddd is the 5-bit Device Number 58 * fff is the 3-bit Function Number 59 * rrrrrrrr is the 8-bit Register Number 60 */ 61 #define OF_PCI_ADDR0_SPACE(ss) (((ss)&3)<<24) 62 #define OF_PCI_ADDR0_SPACE_CFG OF_PCI_ADDR0_SPACE(0) 63 #define OF_PCI_ADDR0_SPACE_IO OF_PCI_ADDR0_SPACE(1) 64 #define OF_PCI_ADDR0_SPACE_MMIO32 OF_PCI_ADDR0_SPACE(2) 65 #define OF_PCI_ADDR0_SPACE_MMIO64 OF_PCI_ADDR0_SPACE(3) 66 #define OF_PCI_ADDR0_SPACE_MASK OF_PCI_ADDR0_SPACE(3) 67 #define OF_PCI_ADDR0_RELOC (1UL<<31) 68 #define OF_PCI_ADDR0_PREFETCH (1UL<<30) 69 #define OF_PCI_ADDR0_ALIAS (1UL<<29) 70 #define OF_PCI_ADDR0_BUS 0x00FF0000UL 71 #define OF_PCI_ADDR0_DEV 0x0000F800UL 72 #define OF_PCI_ADDR0_FN 0x00000700UL 73 #define OF_PCI_ADDR0_BARREG 0x000000FFUL 74 75 unsigned int pci_parse_of_flags(u32 addr0, int bridge) 76 { 77 unsigned int flags = 0, as = addr0 & OF_PCI_ADDR0_SPACE_MASK; 78 79 if (as == OF_PCI_ADDR0_SPACE_MMIO32 || as == OF_PCI_ADDR0_SPACE_MMIO64) { 80 flags = IORESOURCE_MEM | PCI_BASE_ADDRESS_SPACE_MEMORY; 81 82 if (as == OF_PCI_ADDR0_SPACE_MMIO64) 83 flags |= PCI_BASE_ADDRESS_MEM_TYPE_64 | IORESOURCE_MEM_64; 84 85 if (addr0 & OF_PCI_ADDR0_ALIAS) 86 flags |= PCI_BASE_ADDRESS_MEM_TYPE_1M; 87 88 if (addr0 & OF_PCI_ADDR0_PREFETCH) 89 flags |= IORESOURCE_PREFETCH | 90 PCI_BASE_ADDRESS_MEM_PREFETCH; 91 92 /* Note: We don't know whether the ROM has been left enabled 93 * by the firmware or not. We mark it as disabled (ie, we do 94 * not set the IORESOURCE_ROM_ENABLE flag) for now rather than 95 * do a config space read, it will be force-enabled if needed 96 */ 97 if (!bridge && (addr0 & OF_PCI_ADDR0_BARREG) == PCI_ROM_ADDRESS) 98 flags |= IORESOURCE_READONLY; 99 100 } else if (as == OF_PCI_ADDR0_SPACE_IO) 101 flags = IORESOURCE_IO | PCI_BASE_ADDRESS_SPACE_IO; 102 103 if (flags) 104 flags |= IORESOURCE_SIZEALIGN; 105 106 return flags; 107 } 108 109 /** 110 * of_pci_parse_addrs - Parse PCI addresses assigned in the device tree node 111 * @node: device tree node for the PCI device 112 * @dev: pci_dev structure for the device 113 * 114 * This function parses the 'assigned-addresses' property of a PCI devices' 115 * device tree node and writes them into the associated pci_dev structure. 116 */ 117 static void of_pci_parse_addrs(struct device_node *node, struct pci_dev *dev) 118 { 119 u64 base, size; 120 unsigned int flags; 121 struct pci_bus_region region; 122 struct resource *res; 123 const __be32 *addrs; 124 u32 i; 125 int proplen; 126 bool mark_unset = false; 127 128 addrs = of_get_property(node, "assigned-addresses", &proplen); 129 if (!addrs || !proplen) { 130 addrs = of_get_property(node, "reg", &proplen); 131 if (!addrs || !proplen) 132 return; 133 mark_unset = true; 134 } 135 136 pr_debug(" parse addresses (%d bytes) @ %p\n", proplen, addrs); 137 for (; proplen >= 20; proplen -= 20, addrs += 5) { 138 flags = pci_parse_of_flags(of_read_number(addrs, 1), 0); 139 if (!flags) 140 continue; 141 base = of_read_number(&addrs[1], 2); 142 size = of_read_number(&addrs[3], 2); 143 if (!size) 144 continue; 145 i = of_read_number(addrs, 1) & 0xff; 146 pr_debug(" base: %llx, size: %llx, i: %x\n", 147 (unsigned long long)base, 148 (unsigned long long)size, i); 149 150 if (PCI_BASE_ADDRESS_0 <= i && i <= PCI_BASE_ADDRESS_5) { 151 res = &dev->resource[(i - PCI_BASE_ADDRESS_0) >> 2]; 152 } else if (i == dev->rom_base_reg) { 153 res = &dev->resource[PCI_ROM_RESOURCE]; 154 flags |= IORESOURCE_READONLY; 155 } else { 156 printk(KERN_ERR "PCI: bad cfg reg num 0x%x\n", i); 157 continue; 158 } 159 res->flags = flags; 160 if (mark_unset) 161 res->flags |= IORESOURCE_UNSET; 162 res->name = pci_name(dev); 163 region.start = base; 164 region.end = base + size - 1; 165 pcibios_bus_to_resource(dev->bus, res, ®ion); 166 } 167 } 168 169 /** 170 * of_create_pci_dev - Given a device tree node on a pci bus, create a pci_dev 171 * @node: device tree node pointer 172 * @bus: bus the device is sitting on 173 * @devfn: PCI function number, extracted from device tree by caller. 174 */ 175 struct pci_dev *of_create_pci_dev(struct device_node *node, 176 struct pci_bus *bus, int devfn) 177 { 178 struct pci_dev *dev; 179 180 dev = pci_alloc_dev(bus); 181 if (!dev) 182 return NULL; 183 184 pr_debug(" create device, devfn: %x, type: %s\n", devfn, 185 of_node_get_device_type(node)); 186 187 dev->dev.of_node = of_node_get(node); 188 dev->dev.parent = bus->bridge; 189 dev->dev.bus = &pci_bus_type; 190 dev->devfn = devfn; 191 dev->multifunction = 0; /* maybe a lie? */ 192 dev->needs_freset = 0; /* pcie fundamental reset required */ 193 set_pcie_port_type(dev); 194 195 pci_dev_assign_slot(dev); 196 dev->vendor = get_int_prop(node, "vendor-id", 0xffff); 197 dev->device = get_int_prop(node, "device-id", 0xffff); 198 dev->subsystem_vendor = get_int_prop(node, "subsystem-vendor-id", 0); 199 dev->subsystem_device = get_int_prop(node, "subsystem-id", 0); 200 201 dev->cfg_size = pci_cfg_space_size(dev); 202 203 dev_set_name(&dev->dev, "%04x:%02x:%02x.%d", pci_domain_nr(bus), 204 dev->bus->number, PCI_SLOT(devfn), PCI_FUNC(devfn)); 205 dev->class = get_int_prop(node, "class-code", 0); 206 dev->revision = get_int_prop(node, "revision-id", 0); 207 208 pr_debug(" class: 0x%x\n", dev->class); 209 pr_debug(" revision: 0x%x\n", dev->revision); 210 211 dev->current_state = PCI_UNKNOWN; /* unknown power state */ 212 dev->error_state = pci_channel_io_normal; 213 dev->dma_mask = 0xffffffff; 214 215 /* 216 * Assume 64-bit addresses for MSI initially. Will be changed to 32-bit 217 * if MSI (rather than MSI-X) capability does not have 218 * PCI_MSI_FLAGS_64BIT. Can also be overridden by driver. 219 */ 220 dev->msi_addr_mask = DMA_BIT_MASK(64); 221 222 /* Early fixups, before probing the BARs */ 223 pci_fixup_device(pci_fixup_early, dev); 224 225 if (of_node_is_type(node, "pci") || of_node_is_type(node, "pciex")) { 226 /* a PCI-PCI bridge */ 227 dev->hdr_type = PCI_HEADER_TYPE_BRIDGE; 228 dev->rom_base_reg = PCI_ROM_ADDRESS1; 229 set_pcie_hotplug_bridge(dev); 230 } else if (of_node_is_type(node, "cardbus")) { 231 dev->hdr_type = PCI_HEADER_TYPE_CARDBUS; 232 } else { 233 dev->hdr_type = PCI_HEADER_TYPE_NORMAL; 234 dev->rom_base_reg = PCI_ROM_ADDRESS; 235 /* Maybe do a default OF mapping here */ 236 dev->irq = 0; 237 } 238 239 of_pci_parse_addrs(node, dev); 240 241 pr_debug(" adding to system ...\n"); 242 243 pci_device_add(dev, bus); 244 245 return dev; 246 } 247 EXPORT_SYMBOL(of_create_pci_dev); 248 249 /** 250 * of_scan_pci_bridge - Set up a PCI bridge and scan for child nodes 251 * @dev: pci_dev structure for the bridge 252 * 253 * of_scan_bus() calls this routine for each PCI bridge that it finds, and 254 * this routine in turn call of_scan_bus() recursively to scan for more child 255 * devices. 256 */ 257 void of_scan_pci_bridge(struct pci_dev *dev) 258 { 259 struct device_node *node = dev->dev.of_node; 260 struct pci_bus *bus; 261 struct pci_controller *phb; 262 const __be32 *busrange, *ranges; 263 int len, i, mode; 264 struct pci_bus_region region; 265 struct resource *res; 266 unsigned int flags; 267 u64 size; 268 269 pr_debug("of_scan_pci_bridge(%pOF)\n", node); 270 271 /* parse bus-range property */ 272 busrange = of_get_property(node, "bus-range", &len); 273 if (busrange == NULL || len != 8) { 274 printk(KERN_DEBUG "Can't get bus-range for PCI-PCI bridge %pOF\n", 275 node); 276 return; 277 } 278 ranges = of_get_property(node, "ranges", &len); 279 if (ranges == NULL) { 280 printk(KERN_DEBUG "Can't get ranges for PCI-PCI bridge %pOF\n", 281 node); 282 return; 283 } 284 285 bus = pci_find_bus(pci_domain_nr(dev->bus), 286 of_read_number(busrange, 1)); 287 if (!bus) { 288 bus = pci_add_new_bus(dev->bus, dev, 289 of_read_number(busrange, 1)); 290 if (!bus) { 291 printk(KERN_ERR "Failed to create pci bus for %pOF\n", 292 node); 293 return; 294 } 295 } 296 297 bus->primary = dev->bus->number; 298 pci_bus_insert_busn_res(bus, of_read_number(busrange, 1), 299 of_read_number(busrange+1, 1)); 300 bus->bridge_ctl = 0; 301 302 /* parse ranges property */ 303 /* PCI #address-cells == 3 and #size-cells == 2 always */ 304 res = &dev->resource[PCI_BRIDGE_RESOURCES]; 305 for (i = 0; i < PCI_NUM_RESOURCES - PCI_BRIDGE_RESOURCES; ++i) { 306 res->flags = 0; 307 bus->resource[i] = res; 308 ++res; 309 } 310 i = 1; 311 for (; len >= 32; len -= 32, ranges += 8) { 312 flags = pci_parse_of_flags(of_read_number(ranges, 1), 1); 313 size = of_read_number(&ranges[6], 2); 314 if (flags == 0 || size == 0) 315 continue; 316 if (flags & IORESOURCE_IO) { 317 res = bus->resource[0]; 318 if (res->flags) { 319 printk(KERN_ERR "PCI: ignoring extra I/O range" 320 " for bridge %pOF\n", node); 321 continue; 322 } 323 } else { 324 if (i >= PCI_NUM_RESOURCES - PCI_BRIDGE_RESOURCES) { 325 printk(KERN_ERR "PCI: too many memory ranges" 326 " for bridge %pOF\n", node); 327 continue; 328 } 329 res = bus->resource[i]; 330 ++i; 331 } 332 res->flags = flags; 333 region.start = of_read_number(&ranges[1], 2); 334 region.end = region.start + size - 1; 335 pcibios_bus_to_resource(dev->bus, res, ®ion); 336 } 337 sprintf(bus->name, "PCI Bus %04x:%02x", pci_domain_nr(bus), 338 bus->number); 339 pr_debug(" bus name: %s\n", bus->name); 340 341 phb = pci_bus_to_host(bus); 342 343 mode = PCI_PROBE_NORMAL; 344 if (phb->controller_ops.probe_mode) 345 mode = phb->controller_ops.probe_mode(bus); 346 pr_debug(" probe mode: %d\n", mode); 347 348 if (mode == PCI_PROBE_DEVTREE) 349 of_scan_bus(node, bus); 350 else if (mode == PCI_PROBE_NORMAL) 351 pci_scan_child_bus(bus); 352 } 353 EXPORT_SYMBOL(of_scan_pci_bridge); 354 355 static struct pci_dev *of_scan_pci_dev(struct pci_bus *bus, 356 struct device_node *dn) 357 { 358 struct pci_dev *dev = NULL; 359 const __be32 *reg; 360 int reglen, devfn; 361 #ifdef CONFIG_EEH 362 struct eeh_dev *edev = pdn_to_eeh_dev(PCI_DN(dn)); 363 #endif 364 365 pr_debug(" * %pOF\n", dn); 366 if (!of_device_is_available(dn)) 367 return NULL; 368 369 reg = of_get_property(dn, "reg", ®len); 370 if (reg == NULL || reglen < 20) 371 return NULL; 372 devfn = (of_read_number(reg, 1) >> 8) & 0xff; 373 374 /* Check if the PCI device is already there */ 375 dev = pci_get_slot(bus, devfn); 376 if (dev) { 377 pci_dev_put(dev); 378 return dev; 379 } 380 381 /* Device removed permanently ? */ 382 #ifdef CONFIG_EEH 383 if (edev && (edev->mode & EEH_DEV_REMOVED)) 384 return NULL; 385 #endif 386 387 /* create a new pci_dev for this device */ 388 dev = of_create_pci_dev(dn, bus, devfn); 389 if (!dev) 390 return NULL; 391 392 pr_debug(" dev header type: %x\n", dev->hdr_type); 393 return dev; 394 } 395 396 /** 397 * __of_scan_bus - given a PCI bus node, setup bus and scan for child devices 398 * @node: device tree node for the PCI bus 399 * @bus: pci_bus structure for the PCI bus 400 * @rescan_existing: Flag indicating bus has already been set up 401 */ 402 static void __of_scan_bus(struct device_node *node, struct pci_bus *bus, 403 int rescan_existing) 404 { 405 struct device_node *child; 406 struct pci_dev *dev; 407 408 pr_debug("of_scan_bus(%pOF) bus no %d...\n", 409 node, bus->number); 410 411 /* Scan direct children */ 412 for_each_child_of_node(node, child) { 413 dev = of_scan_pci_dev(bus, child); 414 if (!dev) 415 continue; 416 pr_debug(" dev header type: %x\n", dev->hdr_type); 417 } 418 419 /* Apply all fixups necessary. We don't fixup the bus "self" 420 * for an existing bridge that is being rescanned 421 */ 422 if (!rescan_existing) 423 pcibios_setup_bus_self(bus); 424 425 /* Now scan child busses */ 426 for_each_pci_bridge(dev, bus) 427 of_scan_pci_bridge(dev); 428 } 429 430 /** 431 * of_scan_bus - given a PCI bus node, setup bus and scan for child devices 432 * @node: device tree node for the PCI bus 433 * @bus: pci_bus structure for the PCI bus 434 */ 435 void of_scan_bus(struct device_node *node, struct pci_bus *bus) 436 { 437 __of_scan_bus(node, bus, 0); 438 } 439 EXPORT_SYMBOL_GPL(of_scan_bus); 440 441 /** 442 * of_rescan_bus - given a PCI bus node, scan for child devices 443 * @node: device tree node for the PCI bus 444 * @bus: pci_bus structure for the PCI bus 445 * 446 * Same as of_scan_bus, but for a pci_bus structure that has already been 447 * setup. 448 */ 449 void of_rescan_bus(struct device_node *node, struct pci_bus *bus) 450 { 451 __of_scan_bus(node, bus, 1); 452 } 453 EXPORT_SYMBOL_GPL(of_rescan_bus); 454 455