Skip to content
Snippets Groups Projects
pci_internal.h 1.94 KiB
Newer Older
  • Learn to ignore specific revisions
  • /*
     * Internal PCI functions, not exported outside drivers/pci
     *
     * Copyright (c) 2015 Google, Inc
     * Written by Simon Glass <sjg@chromium.org>
     *
     * SPDX-License-Identifier:	GPL-2.0+
     */
    
    #ifndef __pci_internal_h
    #define __pci_internal_h
    
    /**
     * dm_pciauto_prescan_setup_bridge() - Set up a bridge for scanning
     *
     * This gets a bridge ready so that its downstream devices can be scanned.
     * It sets up the bus number and memory range registers. Once the scan is
     * completed, dm_pciauto_postscan_setup_bridge() should be called.
     *
     * @dev:	Bridge device to be scanned
     * @sub_bus:	Bus number of the 'other side' of the bridge
     */
    void dm_pciauto_prescan_setup_bridge(struct udevice *dev, int sub_bus);
    
    /**
     * dm_pciauto_postscan_setup_bridge() - Finish set up of a bridge after scanning
     *
     * This should be called after a bus scan is complete. It adjusts the memory
     * ranges to fit with the devices actually found on the other side (downstream)
     * of the bridge.
     *
     * @dev:	Bridge device that was scanned
     * @sub_bus:	Bus number of the 'other side' of the bridge
     */
    void dm_pciauto_postscan_setup_bridge(struct udevice *dev, int sub_bus);
    
    /**
     * dm_pciauto_config_device() - Configure a PCI device ready for use
     *
     * If the device is a bridge, downstream devices will be probed.
     *
     * @dev:	Device to configure
     * @return the maximum PCI bus number found by this device. If there are no
     * bridges, this just returns the device's bus number. If the device is a
     * bridge then it will return a larger number, depending on the devices on
     * that bridge. On error, returns a -ve error number.
     */
    int dm_pciauto_config_device(struct udevice *dev);
    
    
    /**
     * pci_get_bus() - Get a pointer to a bus, given its number
     *
     * This looks up a PCI bus based on its bus number. The bus is probed if
     * necessary.
     *
     * @busnum:	PCI bus number to look up
     * @busp:	Returns PCI bus on success
     * @return 0 on success, or -ve error
     */
    int pci_get_bus(int busnum, struct udevice **busp);