drivers/pci/pci_internal.h

   1 /* SPDX-License-Identifier: GPL-2.0+ */
   2 /*
   3  * Internal PCI functions, not exported outside drivers/pci
   4  *
   5  * Copyright (c) 2015 Google, Inc
   6  * Written by Simon Glass <sjg@chromium.org>
   7  */
   8
   9 #ifndef __pci_internal_h
  10 #define __pci_internal_h
  11
  12 /**
  13  * dm_pciauto_prescan_setup_bridge() - Set up a bridge for scanning
  14  *
  15  * This gets a bridge ready so that its downstream devices can be scanned.
  16  * It sets up the bus number and memory range registers. Once the scan is
  17  * completed, dm_pciauto_postscan_setup_bridge() should be called.
  18  *
  19  * @dev:        Bridge device to be scanned
  20  * @sub_bus:    Bus number of the 'other side' of the bridge
  21  */
  22 void dm_pciauto_prescan_setup_bridge(struct udevice *dev, int sub_bus);
  23
  24 /**
  25  * dm_pciauto_postscan_setup_bridge() - Finish set up of a bridge after scanning
  26  *
  27  * This should be called after a bus scan is complete. It adjusts the memory
  28  * ranges to fit with the devices actually found on the other side (downstream)
  29  * of the bridge.
  30  *
  31  * @dev:        Bridge device that was scanned
  32  * @sub_bus:    Bus number of the 'other side' of the bridge
  33  */
  34 void dm_pciauto_postscan_setup_bridge(struct udevice *dev, int sub_bus);
  35
  36 /**
  37  * dm_pciauto_config_device() - Configure a PCI device ready for use
  38  *
  39  * If the device is a bridge, downstream devices will be probed.
  40  *
  41  * @dev:        Device to configure
  42  * @return the maximum PCI bus number found by this device. If there are no
  43  * bridges, this just returns the device's bus number. If the device is a
  44  * bridge then it will return a larger number, depending on the devices on
  45  * that bridge. On error, returns a -ve error number.
  46  */
  47 int dm_pciauto_config_device(struct udevice *dev);
  48
  49 /**
  50  * pci_get_bus() - Get a pointer to a bus, given its number
  51  *
  52  * This looks up a PCI bus based on its bus number. The bus is probed if
  53  * necessary.
  54  *
  55  * @busnum:     PCI bus number to look up
  56  * @busp:       Returns PCI bus on success
  57  * @return 0 on success, or -ve error
  58  */
  59 int pci_get_bus(int busnum, struct udevice **busp);
  60
  61 #endif