/* SPDX-License-Identifier: MIT */ /* * Copyright © 2014-2021 Intel Corporation */ #ifndef _ABI_GUC_ACTIONS_ABI_H #define _ABI_GUC_ACTIONS_ABI_H /** * DOC: HOST2GUC_SELF_CFG * * This message is used by Host KMD to setup of the `GuC Self Config KLVs`_. * * This message must be sent as `MMIO HXG Message`_. * * +---+-------+--------------------------------------------------------------+ * | | Bits | Description | * +===+=======+==============================================================+ * | 0 | 31 | ORIGIN = GUC_HXG_ORIGIN_HOST_ | * | +-------+--------------------------------------------------------------+ * | | 30:28 | TYPE = GUC_HXG_TYPE_REQUEST_ | * | +-------+--------------------------------------------------------------+ * | | 27:16 | DATA0 = MBZ | * | +-------+--------------------------------------------------------------+ * | | 15:0 | ACTION = _`GUC_ACTION_HOST2GUC_SELF_CFG` = 0x0508 | * +---+-------+--------------------------------------------------------------+ * | 1 | 31:16 | **KLV_KEY** - KLV key, see `GuC Self Config KLVs`_ | * | +-------+--------------------------------------------------------------+ * | | 15:0 | **KLV_LEN** - KLV length | * | | | | * | | | - 32 bit KLV = 1 | * | | | - 64 bit KLV = 2 | * +---+-------+--------------------------------------------------------------+ * | 2 | 31:0 | **VALUE32** - Bits 31-0 of the KLV value | * +---+-------+--------------------------------------------------------------+ * | 3 | 31:0 | **VALUE64** - Bits 63-32 of the KLV value (**KLV_LEN** = 2) | * +---+-------+--------------------------------------------------------------+ * * +---+-------+--------------------------------------------------------------+ * | | Bits | Description | * +===+=======+==============================================================+ * | 0 | 31 | ORIGIN = GUC_HXG_ORIGIN_GUC_ | * | +-------+--------------------------------------------------------------+ * | | 30:28 | TYPE = GUC_HXG_TYPE_RESPONSE_SUCCESS_ | * | +-------+--------------------------------------------------------------+ * | | 27:0 | DATA0 = **NUM** - 1 if KLV was parsed, 0 if not recognized | * +---+-------+--------------------------------------------------------------+ */ #define GUC_ACTION_HOST2GUC_SELF_CFG … #define HOST2GUC_SELF_CFG_REQUEST_MSG_LEN … #define HOST2GUC_SELF_CFG_REQUEST_MSG_0_MBZ … #define HOST2GUC_SELF_CFG_REQUEST_MSG_1_KLV_KEY … #define HOST2GUC_SELF_CFG_REQUEST_MSG_1_KLV_LEN … #define HOST2GUC_SELF_CFG_REQUEST_MSG_2_VALUE32 … #define HOST2GUC_SELF_CFG_REQUEST_MSG_3_VALUE64 … #define HOST2GUC_SELF_CFG_RESPONSE_MSG_LEN … #define HOST2GUC_SELF_CFG_RESPONSE_MSG_0_NUM … /** * DOC: HOST2GUC_CONTROL_CTB * * This H2G action allows Vf Host to enable or disable H2G and G2H `CT Buffer`_. * * This message must be sent as `MMIO HXG Message`_. * * +---+-------+--------------------------------------------------------------+ * | | Bits | Description | * +===+=======+==============================================================+ * | 0 | 31 | ORIGIN = GUC_HXG_ORIGIN_HOST_ | * | +-------+--------------------------------------------------------------+ * | | 30:28 | TYPE = GUC_HXG_TYPE_REQUEST_ | * | +-------+--------------------------------------------------------------+ * | | 27:16 | DATA0 = MBZ | * | +-------+--------------------------------------------------------------+ * | | 15:0 | ACTION = _`GUC_ACTION_HOST2GUC_CONTROL_CTB` = 0x4509 | * +---+-------+--------------------------------------------------------------+ * | 1 | 31:0 | **CONTROL** - control `CTB based communication`_ | * | | | | * | | | - _`GUC_CTB_CONTROL_DISABLE` = 0 | * | | | - _`GUC_CTB_CONTROL_ENABLE` = 1 | * +---+-------+--------------------------------------------------------------+ * * +---+-------+--------------------------------------------------------------+ * | | Bits | Description | * +===+=======+==============================================================+ * | 0 | 31 | ORIGIN = GUC_HXG_ORIGIN_GUC_ | * | +-------+--------------------------------------------------------------+ * | | 30:28 | TYPE = GUC_HXG_TYPE_RESPONSE_SUCCESS_ | * | +-------+--------------------------------------------------------------+ * | | 27:0 | DATA0 = MBZ | * +---+-------+--------------------------------------------------------------+ */ #define GUC_ACTION_HOST2GUC_CONTROL_CTB … #define HOST2GUC_CONTROL_CTB_REQUEST_MSG_LEN … #define HOST2GUC_CONTROL_CTB_REQUEST_MSG_0_MBZ … #define HOST2GUC_CONTROL_CTB_REQUEST_MSG_1_CONTROL … #define GUC_CTB_CONTROL_DISABLE … #define GUC_CTB_CONTROL_ENABLE … #define HOST2GUC_CONTROL_CTB_RESPONSE_MSG_LEN … #define HOST2GUC_CONTROL_CTB_RESPONSE_MSG_0_MBZ … /* legacy definitions */ enum xe_guc_action { … }; enum xe_guc_preempt_options { … }; enum xe_guc_report_status { … }; enum xe_guc_sleep_state_status { … }; #define GUC_LOG_CONTROL_LOGGING_ENABLED … #define GUC_LOG_CONTROL_VERBOSITY_SHIFT … #define GUC_LOG_CONTROL_VERBOSITY_MASK … #define GUC_LOG_CONTROL_DEFAULT_LOGGING … #define XE_GUC_TLB_INVAL_TYPE_SHIFT … #define XE_GUC_TLB_INVAL_MODE_SHIFT … /* Flush PPC or SMRO caches along with TLB invalidation request */ #define XE_GUC_TLB_INVAL_FLUSH_CACHE … enum xe_guc_tlb_invalidation_type { … }; /* * 0: Heavy mode of Invalidation: * The pipeline of the engine(s) for which the invalidation is targeted to is * blocked, and all the in-flight transactions are guaranteed to be Globally * Observed before completing the TLB invalidation * 1: Lite mode of Invalidation: * TLBs of the targeted engine(s) are immediately invalidated. * In-flight transactions are NOT guaranteed to be Globally Observed before * completing TLB invalidation. * Light Invalidation Mode is to be used only when * it can be guaranteed (by SW) that the address translations remain invariant * for the in-flight transactions across the TLB invalidation. In other words, * this mode can be used when the TLB invalidation is intended to clear out the * stale cached translations that are no longer in use. Light Invalidation Mode * is much faster than the Heavy Invalidation Mode, as it does not wait for the * in-flight transactions to be GOd. */ enum xe_guc_tlb_inval_mode { … }; #endif