xref: /linux/drivers/cdx/controller/mcdi_functions.h (revision fd7d598270724cc787982ea48bbe17ad383a8b7f)
1 /* SPDX-License-Identifier: GPL-2.0
2  *
3  * Header file for MCDI FW interaction for CDX bus.
4  *
5  * Copyright (C) 2022-2023, Advanced Micro Devices, Inc.
6  */
7 
8 #ifndef CDX_MCDI_FUNCTIONS_H
9 #define CDX_MCDI_FUNCTIONS_H
10 
11 #include "mcdi.h"
12 #include "../cdx.h"
13 
14 /**
15  * cdx_mcdi_get_num_buses - Get the total number of buses on
16  *	the controller.
17  * @cdx: pointer to MCDI interface.
18  *
19  * Return: total number of buses available on the controller,
20  *	<0 on failure
21  */
22 int cdx_mcdi_get_num_buses(struct cdx_mcdi *cdx);
23 
24 /**
25  * cdx_mcdi_get_num_devs - Get the total number of devices on
26  *	a particular bus of the controller.
27  * @cdx: pointer to MCDI interface.
28  * @bus_num: Bus number.
29  *
30  * Return: total number of devices available on the bus, <0 on failure
31  */
32 int cdx_mcdi_get_num_devs(struct cdx_mcdi *cdx, int bus_num);
33 
34 /**
35  * cdx_mcdi_get_dev_config - Get configuration for a particular
36  *	bus_num:dev_num
37  * @cdx: pointer to MCDI interface.
38  * @bus_num: Bus number.
39  * @dev_num: Device number.
40  * @dev_params: Pointer to cdx_dev_params, this is populated by this
41  *	device with the configuration corresponding to the provided
42  *	bus_num:dev_num.
43  *
44  * Return: 0 total number of devices available on the bus, <0 on failure
45  */
46 int cdx_mcdi_get_dev_config(struct cdx_mcdi *cdx,
47 			    u8 bus_num, u8 dev_num,
48 			    struct cdx_dev_params *dev_params);
49 
50 /**
51  * cdx_mcdi_reset_device - Reset cdx device represented by bus_num:dev_num
52  * @cdx: pointer to MCDI interface.
53  * @bus_num: Bus number.
54  * @dev_num: Device number.
55  *
56  * Return: 0 on success, <0 on failure
57  */
58 int cdx_mcdi_reset_device(struct cdx_mcdi *cdx,
59 			  u8 bus_num, u8 dev_num);
60 
61 #endif /* CDX_MCDI_FUNCTIONS_H */
62