1 /* SPDX-License-Identifier: GPL-2.0
3 * Header file for the CDX Bus
5 * Copyright (C) 2022-2023, Advanced Micro Devices, Inc.
11 #include <linux/cdx/cdx_bus.h>
14 * struct cdx_dev_params - CDX device parameters
15 * @cdx: CDX controller associated with the device
16 * @parent: Associated CDX Bus device
17 * @vendor: Vendor ID for CDX device
18 * @device: Device ID for CDX device
19 * @subsys_vendor: Sub vendor ID for CDX device
20 * @subsys_device: Sub device ID for CDX device
21 * @bus_num: Bus number for this CDX device
22 * @dev_num: Device number for this device
23 * @res: array of MMIO region entries
24 * @res_count: number of valid MMIO regions
25 * @req_id: Requestor ID associated with CDX device
26 * @class: Class of the CDX Device
27 * @revision: Revision of the CDX device
29 struct cdx_dev_params {
30 struct cdx_controller *cdx;
31 struct device *parent;
38 struct resource res[MAX_CDX_DEV_RESOURCES];
46 * cdx_register_controller - Register a CDX controller and its ports
48 * @cdx: The CDX controller to register
50 * Return: -errno on failure, 0 on success.
52 int cdx_register_controller(struct cdx_controller *cdx);
55 * cdx_unregister_controller - Unregister a CDX controller
56 * @cdx: The CDX controller to unregister
58 void cdx_unregister_controller(struct cdx_controller *cdx);
61 * cdx_device_add - Add a CDX device. This function adds a CDX device
62 * on the CDX bus as per the device parameters provided
63 * by caller. It also creates and registers an associated
64 * Linux generic device.
65 * @dev_params: device parameters associated with the device to be created.
67 * Return: -errno on failure, 0 on success.
69 int cdx_device_add(struct cdx_dev_params *dev_params);
72 * cdx_bus_add - Add a CDX bus. This function adds a bus on the CDX bus
73 * subsystem. It creates a CDX device for the corresponding bus and
74 * also registers an associated Linux generic device.
75 * @cdx: Associated CDX controller
78 * Return: associated Linux generic device pointer on success or NULL on failure.
80 struct device *cdx_bus_add(struct cdx_controller *cdx, u8 bus_num);