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 */
461  * Asserting reset on the CDX bus causes all devices on the bus to be quiesced.
462  * DMA bus mastering is disabled and any pending DMA request are flushed. Once
465  * undefined results. While the bus reset is asserted, any of the enumeration
468  * bus is in reset. Depending on the implementation, the firmware may or may
477 /* Bus number to put in reset, in range 0 to BUS_COUNT-1 */
482  * MC_CMD_CDX_BUS_DOWN_OUT msgresponse: The bus is quiesced, no further
483  * upstream traffic for devices on this bus.
490  * After bus reset is de-asserted, devices are in a state which is functionally
492  * other words, device logic is reset in a hardware-specific way, MMIO accesses
493  * are forwarded to the device, DMA bus mastering is disabled and needs to be
494  * re-enabled with MC_CMD_CDX_DEVICE_DMA_ENABLE once the driver is ready to
496  * changed (e.g. if PL was reloaded) while the bus was in reset, the bus driver
497  * is expected to re-enumerate the bus. Returns EALREADY if the bus was already
505 /* Bus number to take out of reset, in range 0 to BUS_COUNT-1 */
509 /* MC_CMD_CDX_BUS_UP_OUT msgresponse: The bus can now be enumerated. */
516  * logic is reset in a hardware-specific way and DMA bus mastering is disabled.
526 /* Device bus number, in range 0 to BUS_COUNT-1 */
529 /* Device number relative to the bus, in range 0 to DEVICE_COUNT-1 for that bus */
563 /* Device bus number, in range 0 to BUS_COUNT-1 */
566 /* Device number relative to the bus, in range 0 to DEVICE_COUNT-1 for that bus */
598 /* Device bus number, in range 0 to BUS_COUNT-1 */
601 /* Device number relative to the bus, in range 0 to DEVICE_COUNT-1 for that bus */
620 /* MC_CMD_V2_EXTN - Encapsulation for a v2 extended command */
639  * enum: MCDI command directed to versal-net. MCDI responses of this type