SWDEV-527202: Moving ATT to experimental (#335)

* Moving ATT to experimental * Formatting + rebase * Addressing review comments * Formatting * Update source/lib/att-tool/waitcnt/analysis.cpp --------- Co-authored-by: Giovanni Baraldi <gbaraldi@amd.com> Co-authored-by: Madsen, Jonathan <Jonathan.Madsen@amd.com>
2025-04-17 21:43:15 +02:00
parent d7c903654e
commit 46818b0167
58 changed files with 62 additions and 117 deletions
@@ -0,0 +1,70 @@
+// MIT License
+//
+// Copyright (c) 2024-2025 Advanced Micro Devices, Inc. All rights reserved.
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in all
+// copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+// SOFTWARE.
+
+#pragma once
+
+#include <rocprofiler-sdk/agent.h>
+#include <rocprofiler-sdk/defines.h>
+#include <rocprofiler-sdk/experimental/thread-trace/core.h>
+#include <rocprofiler-sdk/fwd.h>
+#include <rocprofiler-sdk/hsa.h>
+
+ROCPROFILER_EXTERN_C_INIT
+
+/**
+ * @defgroup THREAD_TRACE Thread Trace Service
+ * @brief Provides API calls to enable and handle thread trace data
+ *
+ * @{
+ */
+
+/**
+ * @brief Configure Thread Trace Service for agent. There may only be one agent profile
+ * configured per context and can be only one active context that is profiling a single agent
+ * at a time. Multiple agent contexts can be started at the same time if they are profiling
+ * different agents.
+ *
+ * @param [in] context_id context id
+ * @param [in] parameters List of ATT-specific parameters.
+ * @param [in] num_parameters Number of parameters. Zero is allowed.
+ * @param [in] agent_id agent to configure profiling on.
+ * @param [in] shader_callback Callback fn where the collected data will be sent to.
+ * @param [in] callback_userdata Passed back to user in shader_callback.
+ * @return ::rocprofiler_status_t
+ * @retval ROCPROFILER_STATUS_SUCCESS on success
+ * @retval ROCPROFILER_STATUS_ERROR_CONFIGURATION_LOCKED for configuration locked
+ * @retval ROCPROFILER_STATUS_ERROR_CONTEXT_INVALID for conflicting configurations in the same ctx
+ * @retval ROCPROFILER_STATUS_ERROR_CONTEXT_NOT_FOUND for invalid context id
+ * @retval ROCPROFILER_STATUS_ERROR_INVALID_ARGUMENT for invalid rocprofiler_att_parameter_t
+ */
+rocprofiler_status_t
+rocprofiler_configure_device_thread_trace_service(
+    rocprofiler_context_id_t               context_id,
+    rocprofiler_agent_id_t                 agent_id,
+    rocprofiler_att_parameter_t*           parameters,
+    size_t                                 num_parameters,
+    rocprofiler_att_shader_data_callback_t shader_callback,
+    rocprofiler_user_data_t                callback_userdata) ROCPROFILER_API;
+
+/** @} */
+
+ROCPROFILER_EXTERN_C_FINI