| 1 | |
| 2 | *
|
| 3 | * Header file for the CDX Bus
|
| 4 | *
|
| 5 | * Copyright (C) 2022-2023, Advanced Micro Devices, Inc.
|
| 6 |
|
| 7 |
|
| 8 | #ifndef _CDX_H_
|
| 9 | #define _CDX_H_
|
| 10 |
|
| 11 | #include <linux/cdx/cdx_bus.h>
|
| 12 |
|
| 13 | |
| 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
|
| 28 | * @msi_dev_id: MSI device ID associated with CDX device
|
| 29 | * @num_msi: Number of MSI's supported by the device
|
| 30 |
|
| 31 | struct cdx_dev_params {
|
| 32 | struct cdx_controller *cdx;
|
| 33 | struct device *parent;
|
| 34 | u16 vendor;
|
| 35 | u16 device;
|
| 36 | u16 subsys_vendor;
|
| 37 | u16 subsys_device;
|
| 38 | u8 bus_num;
|
| 39 | u8 dev_num;
|
| 40 | struct resource res[MAX_CDX_DEV_RESOURCES];
|
| 41 | u8 res_count;
|
| 42 | u32 req_id;
|
| 43 | u32 class;
|
| 44 | u8 revision;
|
| 45 | u32 msi_dev_id;
|
| 46 | u32 num_msi;
|
| 47 | };
|
| 48 |
|
| 49 | |
| 50 | * cdx_register_controller - Register a CDX controller and its ports
|
| 51 | * on the CDX bus.
|
| 52 | * @cdx: The CDX controller to register
|
| 53 | *
|
| 54 | * Return: -errno on failure, 0 on success.
|
| 55 |
|
| 56 | int cdx_register_controller(struct cdx_controller *cdx);
|
| 57 |
|
| 58 | |
| 59 | * cdx_unregister_controller - Unregister a CDX controller
|
| 60 | * @cdx: The CDX controller to unregister
|
| 61 |
|
| 62 | void cdx_unregister_controller(struct cdx_controller *cdx);
|
| 63 |
|
| 64 | |
| 65 | * cdx_device_add - Add a CDX device. This function adds a CDX device
|
| 66 | * on the CDX bus as per the device parameters provided
|
| 67 | * by caller. It also creates and registers an associated
|
| 68 | * Linux generic device.
|
| 69 | * @dev_params: device parameters associated with the device to be created.
|
| 70 | *
|
| 71 | * Return: -errno on failure, 0 on success.
|
| 72 |
|
| 73 | int cdx_device_add(struct cdx_dev_params *dev_params);
|
| 74 |
|
| 75 | |
| 76 | * cdx_bus_add - Add a CDX bus. This function adds a bus on the CDX bus
|
| 77 | * subsystem. It creates a CDX device for the corresponding bus and
|
| 78 | * also registers an associated Linux generic device.
|
| 79 | * @cdx: Associated CDX controller
|
| 80 | * @us_num: Bus number
|
| 81 | *
|
| 82 | * Return: associated Linux generic device pointer on success or NULL on failure.
|
| 83 |
|
| 84 | struct device *cdx_bus_add(struct cdx_controller *cdx, u8 bus_num);
|
| 85 |
|
| 86 | |
| 87 | * cdx_msi_domain_init - Init the CDX bus MSI domain.
|
| 88 | * @dev: Device of the CDX bus controller
|
| 89 | *
|
| 90 | * Return: CDX MSI domain, NULL on failure
|
| 91 |
|
| 92 | struct irq_domain *cdx_msi_domain_init(struct device *dev);
|
| 93 |
|
| 94 | #endif
|