cdx/controller/mc_cdx_pcol.h

1 /* SPDX-License-Identifier: GPL-2.0
6  * Copyright (C) 2022-2023, Advanced Micro Devices, Inc.
22  *               |                      |   \--- Response
23  *               |                      \------- Error
24  *               \------------------------------ Resync (always set)
76  *   - To advance a shared memory request if XFLAGS_EVREQ was set
77  *   - As a notification (link state, i2c event), controlled
89  *   - LEVEL==INFO    Command succeeded
90  *   - LEVEL==ERR     Command failed
101  * non-existent MCDI command MC_CMD_DEBUG_LOG.
106  * Since the event is written in big-endian byte order, this works
107  * providing bits 56-63 of the event are 0xc0.
117  * the errno value may be followed by the (0-based) number of the
125 /* Non-existent command target */
147 /* Read-only */
151 /* Out of range */
153 /* Non-recursive resource is already acquired */
177 /* V-adaptor not found. */
181 /* V-switch not found. */
189 /* Invalid v-switch type. */
191 /* Invalid v-port type. */
211  * sub-variant switching.
249  * CDX bus hosts devices (functions) that are implemented using the Composable
254  * interface for discovery and management (bus reset, FLR, BME) of such
270  * BUS_COUNT-1
278  * Enumerate CDX bus devices on a given bus
289  * Bus number to enumerate, in range 0 to BUS_COUNT-1, as returned by
298  * Number of devices present on the bus. Devices on the bus are numbered 0 to
299  * DEVICE_COUNT-1. Returns EAGAIN if number of devices unknown or if the target
300  * devices are not ready (e.g. undergoing a bus reset)
310  * on the bus using MC_CMD_BUS_ENUM_DEVICES, then loop through the range (0,
311  * DEVICE_COUNT - 1), retrieving device resource data. May return EAGAIN if the
313  * to e.g. a PL reload / bus reset), in which case the caller is expected to
314  * restart the enumeration loop. MMIO addresses are specified in terms of bus
315  * addresses (prior to any potential IOMMU translation). For versal-net, these
316  * are equivalent to APU physical addresses. Implementation note - for this to
327 /* Device bus number, in range 0 to BUS_COUNT-1 */
330 /* Device number relative to the bus, in range 0 to DEVICE_COUNT-1 for that bus */
336 /* 16-bit Vendor identifier, compliant with PCI-SIG VendorID assignment. */
339 /* 16-bit Device ID assigned by the vendor */
343  * 16-bit Subsystem Vendor ID, , compliant with PCI-SIG VendorID assignment.
349  * 16-bit Subsystem Device ID assigned by the vendor. For further device
354 /* 24-bit Device Class code, compliant with PCI-SIG Device Class codes */
357 /* 8-bit vendor-assigned revision */
363 /* MMIO region 0 base address (bus address), 0 if unused */
385 /* MMIO region 1 base address (bus address), 0 if unused */
407 /* MMIO region 2 base address (bus address), 0 if unused */
429 /* MMIO region 3 base address (bus address), 0 if unused */
462  * logic is reset in a hardware-specific way and DMA bus mastering is disabled.
472 /* Device bus number, in range 0 to BUS_COUNT-1 */
475 /* Device number relative to the bus, in range 0 to DEVICE_COUNT-1 for that bus */
509 /* Device bus number, in range 0 to BUS_COUNT-1 */
512 /* Device number relative to the bus, in range 0 to DEVICE_COUNT-1 for that bus */
544 /* Device bus number, in range 0 to BUS_COUNT-1 */
547 /* Device number relative to the bus, in range 0 to DEVICE_COUNT-1 for that bus */
566 /* MC_CMD_V2_EXTN - Encapsulation for a v2 extended command */
585  * enum: MCDI command directed to versal-net. MCDI responses of this type