[J-u-boot.git] / drivers / pci / pci_internal.h

/* SPDX-License-Identifier: GPL-2.0+ */
/*
 * Internal PCI functions, not exported outside drivers/pci
 *
 * Copyright (c) 2015 Google, Inc
 * Written by Simon Glass <[email protected]>
 */

#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);

#endif
Commit	Line	Data
83d290c5	1	/* SPDX-License-Identifier: GPL-2.0+ */
5e23b8b4 SG	2	/*
	3	* Internal PCI functions, not exported outside drivers/pci
	4	*
	5	* Copyright (c) 2015 Google, Inc
	6	* Written by Simon Glass <[email protected]>
5e23b8b4 SG	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
185f812c	42	* Return: the maximum PCI bus number found by this device. If there are no
5e23b8b4 SG	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
a6eb93b3 SG	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
185f812c	57	* Return: 0 on success, or -ve error
a6eb93b3 SG	58	*/
	59	int pci_get_bus(int busnum, struct udevice **busp);
	60
5e23b8b4	61	#endif