mirror of
https://github.com/torvalds/linux.git
synced 2024-09-21 07:23:06 +00:00
fa10f41309
CDX controller provides subsystem vendor, subsystem device, class and revision info of the device along with vendor and device ID in native endian format. CDX Bus system uses this information to bind the cdx device to the cdx device driver. Co-developed-by: Puneet Gupta <puneet.gupta@amd.com> Signed-off-by: Puneet Gupta <puneet.gupta@amd.com> Co-developed-by: Nipun Gupta <nipun.gupta@amd.com> Signed-off-by: Nipun Gupta <nipun.gupta@amd.com> Signed-off-by: Abhijit Gangurde <abhijit.gangurde@amd.com> Reviewed-by: Pieter Jansen van Vuuren <pieter.jansen-van-vuuren@amd.com> Tested-by: Nikhil Agarwal <nikhil.agarwal@amd.com> Link: https://lore.kernel.org/r/20231017160505.10640-8-abhijit.gangurde@amd.com Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
83 lines
2.3 KiB
C
83 lines
2.3 KiB
C
/* SPDX-License-Identifier: GPL-2.0
|
|
*
|
|
* Header file for the CDX Bus
|
|
*
|
|
* Copyright (C) 2022-2023, Advanced Micro Devices, Inc.
|
|
*/
|
|
|
|
#ifndef _CDX_H_
|
|
#define _CDX_H_
|
|
|
|
#include <linux/cdx/cdx_bus.h>
|
|
|
|
/**
|
|
* struct cdx_dev_params - CDX device parameters
|
|
* @cdx: CDX controller associated with the device
|
|
* @parent: Associated CDX Bus device
|
|
* @vendor: Vendor ID for CDX device
|
|
* @device: Device ID for CDX device
|
|
* @subsys_vendor: Sub vendor ID for CDX device
|
|
* @subsys_device: Sub device ID for CDX device
|
|
* @bus_num: Bus number for this CDX device
|
|
* @dev_num: Device number for this device
|
|
* @res: array of MMIO region entries
|
|
* @res_count: number of valid MMIO regions
|
|
* @req_id: Requestor ID associated with CDX device
|
|
* @class: Class of the CDX Device
|
|
* @revision: Revision of the CDX device
|
|
*/
|
|
struct cdx_dev_params {
|
|
struct cdx_controller *cdx;
|
|
struct device *parent;
|
|
u16 vendor;
|
|
u16 device;
|
|
u16 subsys_vendor;
|
|
u16 subsys_device;
|
|
u8 bus_num;
|
|
u8 dev_num;
|
|
struct resource res[MAX_CDX_DEV_RESOURCES];
|
|
u8 res_count;
|
|
u32 req_id;
|
|
u32 class;
|
|
u8 revision;
|
|
};
|
|
|
|
/**
|
|
* cdx_register_controller - Register a CDX controller and its ports
|
|
* on the CDX bus.
|
|
* @cdx: The CDX controller to register
|
|
*
|
|
* Return: -errno on failure, 0 on success.
|
|
*/
|
|
int cdx_register_controller(struct cdx_controller *cdx);
|
|
|
|
/**
|
|
* cdx_unregister_controller - Unregister a CDX controller
|
|
* @cdx: The CDX controller to unregister
|
|
*/
|
|
void cdx_unregister_controller(struct cdx_controller *cdx);
|
|
|
|
/**
|
|
* cdx_device_add - Add a CDX device. This function adds a CDX device
|
|
* on the CDX bus as per the device parameters provided
|
|
* by caller. It also creates and registers an associated
|
|
* Linux generic device.
|
|
* @dev_params: device parameters associated with the device to be created.
|
|
*
|
|
* Return: -errno on failure, 0 on success.
|
|
*/
|
|
int cdx_device_add(struct cdx_dev_params *dev_params);
|
|
|
|
/**
|
|
* cdx_bus_add - Add a CDX bus. This function adds a bus on the CDX bus
|
|
* subsystem. It creates a CDX device for the corresponding bus and
|
|
* also registers an associated Linux generic device.
|
|
* @cdx: Associated CDX controller
|
|
* @us_num: Bus number
|
|
*
|
|
* Return: associated Linux generic device pointer on success or NULL on failure.
|
|
*/
|
|
struct device *cdx_bus_add(struct cdx_controller *cdx, u8 bus_num);
|
|
|
|
#endif /* _CDX_H_ */
|