1 // SPDX-License-Identifier: GPL-2.0+
3  * PCI <-> OF mapping helpers
21 	if (!dev->bus->dev.of_node)  in pci_set_of_node()
23 	dev->dev.of_node = of_pci_find_child_device(dev->bus->dev.of_node,  in pci_set_of_node()
24 						    dev->devfn);  in pci_set_of_node()
25 	if (dev->dev.of_node)  in pci_set_of_node()
26 		dev->dev.fwnode = &dev->dev.of_node->fwnode;  in pci_set_of_node()
31 	of_node_put(dev->dev.of_node);  in pci_release_of_node()
32 	dev->dev.of_node = NULL;  in pci_release_of_node()
33 	dev->dev.fwnode = NULL;  in pci_release_of_node()
36 void pci_set_bus_of_node(struct pci_bus *bus)  in pci_set_bus_of_node()  argument
40 	if (bus->self == NULL) {  in pci_set_bus_of_node()
41 		node = pcibios_get_phb_of_node(bus);  in pci_set_bus_of_node()
43 		node = of_node_get(bus->self->dev.of_node);  in pci_set_bus_of_node()
44 		if (node && of_property_read_bool(node, "external-facing"))  in pci_set_bus_of_node()
45 			bus->self->external_facing = true;  in pci_set_bus_of_node()
48 	bus->dev.of_node = node;  in pci_set_bus_of_node()
50 	if (bus->dev.of_node)  in pci_set_bus_of_node()
51 		bus->dev.fwnode = &bus->dev.of_node->fwnode;  in pci_set_bus_of_node()
54 void pci_release_bus_of_node(struct pci_bus *bus)  in pci_release_bus_of_node()  argument
56 	of_node_put(bus->dev.of_node);  in pci_release_bus_of_node()
57 	bus->dev.of_node = NULL;  in pci_release_bus_of_node()
58 	bus->dev.fwnode = NULL;  in pci_release_bus_of_node()
61 struct device_node * __weak pcibios_get_phb_of_node(struct pci_bus *bus)  in pcibios_get_phb_of_node()  argument
64 	if (WARN_ON(bus->self || bus->parent))  in pcibios_get_phb_of_node()
69 	 * create above the root bus or its own parent. Normally only  in pcibios_get_phb_of_node()
72 	if (bus->bridge->of_node)  in pcibios_get_phb_of_node()
73 		return of_node_get(bus->bridge->of_node);  in pcibios_get_phb_of_node()
74 	if (bus->bridge->parent && bus->bridge->parent->of_node)  in pcibios_get_phb_of_node()
75 		return of_node_get(bus->bridge->parent->of_node);  in pcibios_get_phb_of_node()
79 struct irq_domain *pci_host_bridge_of_msi_domain(struct pci_bus *bus)  in pci_host_bridge_of_msi_domain()  argument
84 	if (!bus->dev.of_node)  in pci_host_bridge_of_msi_domain()
88 	d = of_msi_get_domain(&bus->dev, bus->dev.of_node, DOMAIN_BUS_PCI_MSI);  in pci_host_bridge_of_msi_domain()
93 	 * If we don't have an msi-parent property, look for a domain  in pci_host_bridge_of_msi_domain()
96 	d = irq_find_matching_host(bus->dev.of_node, DOMAIN_BUS_PCI_MSI);  in pci_host_bridge_of_msi_domain()
100 	return irq_find_host(bus->dev.of_node);  in pci_host_bridge_of_msi_domain()
108 	if (dev && dev->of_node)  in pci_host_of_has_msi_map()
109 		return of_get_property(dev->of_node, "msi-map", NULL);  in pci_host_of_has_msi_map()
134 		 * Some OFs create a parent node "multifunc-device" as  in of_pci_find_child_device()
135 		 * a fake root for all functions of a multi-function  in of_pci_find_child_device()
138 		if (of_node_name_eq(node, "multifunc-device")) {  in of_pci_find_child_device()
152  * of_pci_get_devfn() - Get device and function numbers for a device node
155  * Parses a standard 5-cell PCI resource and returns an 8-bit value that can
174  * of_pci_parse_bus_range() - parse the bus-range property of a PCI device
176  * @res: address to a struct resource to return the bus-range
178  * Returns 0 on success or a negative error-code on failure.
185 	error = of_property_read_u32_array(node, "bus-range", bus_range,  in of_pci_parse_bus_range()
190 	res->name = node->name;  in of_pci_parse_bus_range()
191 	res->start = bus_range[0];  in of_pci_parse_bus_range()
192 	res->end = bus_range[1];  in of_pci_parse_bus_range()
193 	res->flags = IORESOURCE_BUS;  in of_pci_parse_bus_range()
200  * of_get_pci_domain_nr - Find the host bridge domain number
205  * a property called "linux,pci-domain" of the given device node.
208  * * > 0	- On success, an associated domain number.
209  * * -EINVAL	- The property "linux,pci-domain" does not exist.
210  * * -ENODATA	- The linux,pci-domain" property does not have value.
211  * * -EOVERFLOW	- Invalid "linux,pci-domain" property value.
213  * Returns the associated domain number from DT in the range [0-0xffff], or
221 	error = of_property_read_u32(node, "linux,pci-domain", &domain);  in of_get_pci_domain_nr()
230  * of_pci_check_probe_only - Setup probe only mode if linux,pci-probe-only
238 	ret = of_property_read_u32(of_chosen, "linux,pci-probe-only", &val);  in of_pci_check_probe_only()
240 		if (ret == -ENODATA || ret == -EOVERFLOW)  in of_pci_check_probe_only()
241 			pr_warn("linux,pci-probe-only without valid value, ignoring\n");  in of_pci_check_probe_only()
255  * devm_of_pci_get_host_bridge_resources() - Resource-managed parsing of PCI
258  * @busno: bus number associated with the bridge root bus
260  * @resources: list where the range of resources will be added after DT parsing
261  * @ib_resources: list where the range of inbound resources (with addresses
262  *                from 'dma-ranges') will be added after DT parsing
264  * address for the start of the I/O range. Can be NULL if the caller doesn't
271  * It returns zero if the range parsing has been successful or a standard error
280 	struct device_node *dev_node = dev->of_node;  in devm_of_pci_get_host_bridge_resources()
283 	struct of_pci_range range;  in devm_of_pci_get_host_bridge_resources()  local
293 		return -ENOMEM;  in devm_of_pci_get_host_bridge_resources()
299 		bus_range->start = busno;  in devm_of_pci_get_host_bridge_resources()
300 		bus_range->end = bus_max;  in devm_of_pci_get_host_bridge_resources()
301 		bus_range->flags = IORESOURCE_BUS;  in devm_of_pci_get_host_bridge_resources()
302 		dev_info(dev, "  No bus range found for %pOF, using %pR\n",  in devm_of_pci_get_host_bridge_resources()
305 		if (bus_range->end > bus_range->start + bus_max)  in devm_of_pci_get_host_bridge_resources()
306 			bus_range->end = bus_range->start + bus_max;  in devm_of_pci_get_host_bridge_resources()
316 	for_each_of_pci_range(&parser, &range) {  in devm_of_pci_get_host_bridge_resources()
318 		if ((range.flags & IORESOURCE_TYPE_BITS) == IORESOURCE_IO)  in devm_of_pci_get_host_bridge_resources()
320 		else if ((range.flags & IORESOURCE_TYPE_BITS) == IORESOURCE_MEM)  in devm_of_pci_get_host_bridge_resources()
324 		dev_info(dev, "  %6s %#012llx..%#012llx -> %#012llx\n",  in devm_of_pci_get_host_bridge_resources()
325 			 range_type, range.cpu_addr,  in devm_of_pci_get_host_bridge_resources()
326 			 range.cpu_addr + range.size - 1, range.pci_addr);  in devm_of_pci_get_host_bridge_resources()
329 		 * If we failed translation or got a zero-sized region  in devm_of_pci_get_host_bridge_resources()
330 		 * then skip this range  in devm_of_pci_get_host_bridge_resources()
332 		if (range.cpu_addr == OF_BAD_ADDR || range.size == 0)  in devm_of_pci_get_host_bridge_resources()
335 		err = of_pci_range_to_resource(&range, dev_node, &tmp_res);  in devm_of_pci_get_host_bridge_resources()
341 			err = -ENOMEM;  in devm_of_pci_get_host_bridge_resources()
347 …dev_err(dev, "I/O range found for %pOF. Please provide an io_base pointer to save CPU base address…  in devm_of_pci_get_host_bridge_resources()
349 				err = -EINVAL;  in devm_of_pci_get_host_bridge_resources()
353 …dev_warn(dev, "More than one I/O resource converted for %pOF. CPU base address for old range lost!…  in devm_of_pci_get_host_bridge_resources()
355 			*io_base = range.cpu_addr;  in devm_of_pci_get_host_bridge_resources()
357 			res->flags &= ~IORESOURCE_MEM_64;  in devm_of_pci_get_host_bridge_resources()
360 		pci_add_resource_offset(resources, res,	res->start - range.pci_addr);  in devm_of_pci_get_host_bridge_resources()
363 	/* Check for dma-ranges property */  in devm_of_pci_get_host_bridge_resources()
370 	dev_dbg(dev, "Parsing dma-ranges property...\n");  in devm_of_pci_get_host_bridge_resources()
371 	for_each_of_pci_range(&parser, &range) {  in devm_of_pci_get_host_bridge_resources()
374 		 * If we failed translation or got a zero-sized region  in devm_of_pci_get_host_bridge_resources()
375 		 * then skip this range  in devm_of_pci_get_host_bridge_resources()
377 		if (((range.flags & IORESOURCE_TYPE_BITS) != IORESOURCE_MEM) ||  in devm_of_pci_get_host_bridge_resources()
378 		    range.cpu_addr == OF_BAD_ADDR || range.size == 0)  in devm_of_pci_get_host_bridge_resources()
381 		dev_info(dev, "  %6s %#012llx..%#012llx -> %#012llx\n",  in devm_of_pci_get_host_bridge_resources()
382 			 "IB MEM", range.cpu_addr,  in devm_of_pci_get_host_bridge_resources()
383 			 range.cpu_addr + range.size - 1, range.pci_addr);  in devm_of_pci_get_host_bridge_resources()
386 		err = of_pci_range_to_resource(&range, dev_node, &tmp_res);  in devm_of_pci_get_host_bridge_resources()
392 			err = -ENOMEM;  in devm_of_pci_get_host_bridge_resources()
398 			if (entry->res->start > res->start)  in devm_of_pci_get_host_bridge_resources()
401 		pci_add_resource_offset(&entry->node, res,  in devm_of_pci_get_host_bridge_resources()
402 					res->start - range.pci_addr);  in devm_of_pci_get_host_bridge_resources()
414  * of_irq_parse_pci - Resolve the interrupt for a PCI device
419  * device-node exists for a given pci_dev, it will use normal OF tree
421  * PCI tree until an device-node is found, at which point it will finish
445 	 * interrupt spec.  we assume #interrupt-cells is 1, which is standard  in of_irq_parse_pci()
453 		return -ENODEV;  in of_irq_parse_pci()
458 		ppdev = pdev->bus->self;  in of_irq_parse_pci()
462 			ppnode = pci_bus_to_OF_node(pdev->bus);  in of_irq_parse_pci()
466 				rc = -EINVAL;  in of_irq_parse_pci()
475 		 * Ok, we have found a parent with a device-node, hand over to  in of_irq_parse_pci()
478 		 * resolution. Note that we use the linux bus number which may  in of_irq_parse_pci()
479 		 * not match your firmware bus numbering.  in of_irq_parse_pci()
480 		 * Fortunately, in most cases, interrupt-map-mask doesn't  in of_irq_parse_pci()
481 		 * include the bus number as part of the matching.  in of_irq_parse_pci()
497 	out_irq->np = ppnode;  in of_irq_parse_pci()
498 	out_irq->args_count = 1;  in of_irq_parse_pci()
499 	out_irq->args[0] = pin;  in of_irq_parse_pci()
500 	laddr[0] = cpu_to_be32((pdev->bus->number << 16) | (pdev->devfn << 8));  in of_irq_parse_pci()
507 	if (rc == -ENOENT) {  in of_irq_parse_pci()
508 		dev_warn(&pdev->dev,  in of_irq_parse_pci()
509 			"%s: no interrupt-map found, INTx interrupts not available\n",  in of_irq_parse_pci()
514 		dev_err(&pdev->dev, "%s: failed with rc=%d\n", __func__, rc);  in of_irq_parse_pci()
520  * of_irq_parse_and_map_pci() - Decode a PCI IRQ from the device tree and map to a VIRQ
550 	INIT_LIST_HEAD(&bridge->windows);  in pci_parse_request_of_pci_ranges()
551 	INIT_LIST_HEAD(&bridge->dma_ranges);  in pci_parse_request_of_pci_ranges()
553 	err = devm_of_pci_get_host_bridge_resources(dev, 0, 0xff, &bridge->windows,  in pci_parse_request_of_pci_ranges()
554 						    &bridge->dma_ranges, &iobase);  in pci_parse_request_of_pci_ranges()
558 	err = devm_request_pci_bus_resources(dev, &bridge->windows);  in pci_parse_request_of_pci_ranges()
562 	resource_list_for_each_entry_safe(win, tmp, &bridge->windows) {  in pci_parse_request_of_pci_ranges()
563 		struct resource *res = win->res;  in pci_parse_request_of_pci_ranges()
575 			res_valid |= !(res->flags & IORESOURCE_PREFETCH);  in pci_parse_request_of_pci_ranges()
577 			if (!(res->flags & IORESOURCE_PREFETCH))  in pci_parse_request_of_pci_ranges()
586 		dev_warn(dev, "non-prefetchable memory resource required\n");  in pci_parse_request_of_pci_ranges()
593 	if (!dev->of_node)  in devm_of_pci_bridge_init()
596 	bridge->swizzle_irq = pci_common_swizzle;  in devm_of_pci_bridge_init()
597 	bridge->map_irq = of_irq_parse_and_map_pci;  in devm_of_pci_bridge_init()
605  * of_pci_get_max_link_speed - Find the maximum link speed of the given device node.
609  * a property called "max-link-speed" of the given device node.
612  * * > 0	- On success, a maximum link speed.
613  * * -EINVAL	- Invalid "max-link-speed" property value, or failure to access
623 	if (of_property_read_u32(node, "max-link-speed", &max_link_speed) ||  in of_pci_get_max_link_speed()
625 		return -EINVAL;  in of_pci_get_max_link_speed()