Define exp extension

Author: againull

scripts/core/EXP-2D-BLOCK-ARRAY-CAPABILITIES.rst

@@ -0,0 +1,62 @@
+<%
+    OneApi=tags['$OneApi']
+    x=tags['$x']
+    X=x.upper()
+%>
+
+.. _experimental-2D-block-array-capabilities:
+
+================================================================================
+2D Block Array Capabilities
+================================================================================
+
+.. warning::
+
+    Experimental features:
+
+    *   May be replaced, updated, or removed at any time.
+    *   Do not require maintaining API/ABI stability of their own additions over
+        time.
+    *   Do not require conformance testing of their own additions.
+
+
+Motivation
+--------------------------------------------------------------------------------
+Some Intel GPU devices support 2D block array operations which may be used to optimize applications on Intel GPUs.
+This extension provides a device descriptor which allows to query the 2D block array capabilities of a device.
+
+API
+--------------------------------------------------------------------------------
+
+Enums
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+* ${x}_device_info_t
+    * ${X}_DEVICE_INFO_2D_BLOCK_ARRAY_CAPABILITIES_EXP
+
+* ${x}_exp_device_2d_block_array_capability_flags_t
+    * ${X}_EXP_DEVICE_2D_BLOCK_ARRAY_CAPABILITY_FLAG_LOAD
+    * ${X}_EXP_DEVICE_2D_BLOCK_ARRAY_CAPABILITY_FLAG_STORE
+
+Changelog
+--------------------------------------------------------------------------------
+
++-----------+------------------------+
+| Revision  | Changes                |
++===========+========================+
+| 1.0       | Initial Draft          |
++-----------+------------------------+
+
+
+Support
+--------------------------------------------------------------------------------
+
+Adapters which support this experimental feature *must* return ${X}_RESULT_SUCCESS from
+the ${x}DeviceGetInfo call with the new ${X}_DEVICE_INFO_2D_BLOCK_ARRAY_CAPABILITIES_EXP
+device descriptor.
+
+
+Contributors
+--------------------------------------------------------------------------------
+
+* Artur Gainullin `artur.gainullin@intel.com <artur.gainullin@intel.com>`_

scripts/core/exp-2d-block-array-capabilities.yml

@@ -0,0 +1,36 @@
+#
+# Copyright (C) 2024 Intel Corporation
+#
+# Part of the Unified-Runtime Project, under the Apache License v2.0 with LLVM Exceptions.
+# See LICENSE.TXT
+# SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
+#
+# See YaML.md for syntax definition
+#
+--- #--------------------------------------------------------------------------
+type: header
+desc: "Intel $OneApi Unified Runtime Experimental device descriptor for querying Intel device 2D block array capabilities"
+ordinal: "99"
+--- #--------------------------------------------------------------------------
+type: enum
+extend: true
+typed_etors: true
+desc: "Extension enum to $x_device_info_t to query Intel device 2D block array capabilities."
+name: $x_device_info_t
+etors:
+    - name: 2D_BLOCK_ARRAY_CAPABILITIES_EXP
+      value: "0x2022"
+      desc: "[$x_exp_device_2d_block_array_capability_flags_t] return a bit-field of Intel GPU 2D block array capabilities"
+--- #--------------------------------------------------------------------------
+type: enum
+desc: "Intel GPU 2D block array capabilities"
+class: $xDevice
+name: $x_exp_device_2d_block_array_capability_flags_t
+etors:
+    - name: LOAD
+      desc: "Load instructions are supported"
+      value: "$X_BIT(0)"
+    - name: STORE
+      desc: "Store instructions are supported"
+      value: "$X_BIT(1)"
+