intel/compute-runtime
1
0
Fork 0
mirror of https://github.com/intel/compute-runtime.git synced 2026-01-03 06:49:52 +08:00
Code Issues Packages Projects Releases Wiki Activity

refactor: add driver experimental entry points for tracer apis

Browse Source 
Related-To: NEO-13770

Signed-off-by: Joshua Santosh Ranjan <joshua.santosh.ranjan@intel.com>
This commit is contained in:
Joshua Santosh Ranjan
2025-02-04 06:52:18 +00:00
committed by Compute-Runtime-Automation
parent 1e5e7fa6be
commit 5efbf1d04c
3 changed files with 249 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

119
level_zero/api/driver_experimental/public/zex_metric.cpp
View File

@@ -18,6 +18,58 @@ ze_result_t ZE_APICALL zetIntelCommandListAppendMarkerExp(zet_command_list_handl
return metricGroupImp->getMetricSource().appendMarker(hCommandList, hMetricGroup, value);
}
ze_result_t ZE_APICALL zetIntelMetricTracerCreateExp(zet_context_handle_t hContext,
zet_device_handle_t hDevice,
uint32_t metricGroupCount,
zet_metric_group_handle_t *phMetricGroups,
zet_intel_metric_tracer_exp_desc_t *desc,
ze_event_handle_t hNotificationEvent,
zet_intel_metric_tracer_exp_handle_t *phMetricTracer) {
return L0::metricTracerCreate(hContext, hDevice, metricGroupCount, phMetricGroups, desc, hNotificationEvent, phMetricTracer);
}
ze_result_t ZE_APICALL zetIntelMetricTracerDestroyExp(zet_intel_metric_tracer_exp_handle_t hMetricTracer) {
return L0::metricTracerDestroy(hMetricTracer);
}
ze_result_t ZE_APICALL zetIntelMetricTracerEnableExp(zet_intel_metric_tracer_exp_handle_t hMetricTracer,
ze_bool_t synchronous) {
return L0::metricTracerEnable(hMetricTracer, synchronous);
}
ze_result_t ZE_APICALL zetIntelMetricTracerDisableExp(zet_intel_metric_tracer_exp_handle_t hMetricTracer,
ze_bool_t synchronous) {
return L0::metricTracerDisable(hMetricTracer, synchronous);
}
ze_result_t ZE_APICALL zetIntelMetricTracerReadDataExp(zet_intel_metric_tracer_exp_handle_t hMetricTracer,
size_t *pRawDataSize, uint8_t *pRawData) {
return L0::metricTracerReadData(hMetricTracer, pRawDataSize, pRawData);
}
ze_result_t ZE_APICALL zetIntelMetricDecoderCreateExp(zet_intel_metric_tracer_exp_handle_t hMetricTracer,
zet_intel_metric_decoder_exp_handle_t *phMetricDecoder) {
return L0::metricDecoderCreate(hMetricTracer, phMetricDecoder);
}
ze_result_t ZE_APICALL zetIntelMetricDecoderDestroyExp(zet_intel_metric_decoder_exp_handle_t phMetricDecoder) {
return L0::metricDecoderDestroy(phMetricDecoder);
}
ze_result_t ZE_APICALL zetIntelMetricDecoderGetDecodableMetricsExp(zet_intel_metric_decoder_exp_handle_t hMetricDecoder,
uint32_t *pCount,
zet_metric_handle_t *phMetrics) {
return L0::metricDecoderGetDecodableMetrics(hMetricDecoder, pCount, phMetrics);
}
ze_result_t ZE_APICALL zetIntelMetricTracerDecodeExp(zet_intel_metric_decoder_exp_handle_t phMetricDecoder,
size_t *pRawDataSize, uint8_t *pRawData, uint32_t metricsCount,
zet_metric_handle_t *phMetrics, uint32_t *pSetCount, uint32_t *pMetricEntriesCountPerSet,
uint32_t *pMetricEntriesCount, zet_intel_metric_entry_exp_t *pMetricEntries) {
return L0::metricTracerDecode(phMetricDecoder, pRawDataSize, pRawData, metricsCount, phMetrics,
pSetCount, pMetricEntriesCountPerSet, pMetricEntriesCount, pMetricEntries);
}
} // namespace L0
extern "C" {
@@ -29,4 +81,71 @@ zetIntelCommandListAppendMarkerExp(
uint32_t value) {
return L0::zetIntelCommandListAppendMarkerExp(hCommandList, hMetricGroup, value);
}
ze_result_t ZE_APICALL zetIntelMetricTracerCreateExp(
zet_context_handle_t hContext,
zet_device_handle_t hDevice,
uint32_t metricGroupCount,
zet_metric_group_handle_t *phMetricGroups,
zet_intel_metric_tracer_exp_desc_t *desc,
ze_event_handle_t hNotificationEvent,
zet_intel_metric_tracer_exp_handle_t *phMetricTracer) {
return L0::zetIntelMetricTracerCreateExp(hContext, hDevice, metricGroupCount, phMetricGroups, desc, hNotificationEvent, phMetricTracer);
}
ze_result_t ZE_APICALL zetIntelMetricTracerDestroyExp(
zet_intel_metric_tracer_exp_handle_t hMetricTracer) {
return L0::zetIntelMetricTracerDestroyExp(hMetricTracer);
}
ze_result_t ZE_APICALL zetIntelMetricTracerEnableExp(
zet_intel_metric_tracer_exp_handle_t hMetricTracer,
ze_bool_t synchronous) {
return L0::zetIntelMetricTracerEnableExp(hMetricTracer, synchronous);
}
ze_result_t ZE_APICALL zetIntelMetricTracerDisableExp(
zet_intel_metric_tracer_exp_handle_t hMetricTracer,
ze_bool_t synchronous) {
return L0::zetIntelMetricTracerDisableExp(hMetricTracer, synchronous);
}
ze_result_t ZE_APICALL zetIntelMetricTracerReadDataExp(
zet_intel_metric_tracer_exp_handle_t hMetricTracer,
size_t *pRawDataSize,
uint8_t *pRawData) {
return L0::zetIntelMetricTracerReadDataExp(hMetricTracer, pRawDataSize, pRawData);
}
ze_result_t ZE_APICALL zetIntelMetricDecoderCreateExp(
zet_intel_metric_tracer_exp_handle_t hMetricTracer,
zet_intel_metric_decoder_exp_handle_t *phMetricDecoder) {
return L0::zetIntelMetricDecoderCreateExp(hMetricTracer, phMetricDecoder);
}
ze_result_t ZE_APICALL zetIntelMetricDecoderDestroyExp(
zet_intel_metric_decoder_exp_handle_t phMetricDecoder) {
return L0::zetIntelMetricDecoderDestroyExp(phMetricDecoder);
}
ze_result_t ZE_APICALL zetIntelMetricDecoderGetDecodableMetricsExp(
zet_intel_metric_decoder_exp_handle_t hMetricDecoder,
uint32_t *pCount,
zet_metric_handle_t *phMetrics) {
return L0::zetIntelMetricDecoderGetDecodableMetricsExp(hMetricDecoder, pCount, phMetrics);
}
ze_result_t ZE_APICALL zetIntelMetricTracerDecodeExp(
zet_intel_metric_decoder_exp_handle_t phMetricDecoder,
size_t *pRawDataSize,
uint8_t *pRawData,
uint32_t metricsCount,
zet_metric_handle_t *phMetrics,
uint32_t *pSetCount,
uint32_t *pMetricEntriesCountPerSet,
uint32_t *pMetricEntriesCount,
zet_intel_metric_entry_exp_t *pMetricEntries) {
return L0::zetIntelMetricTracerDecodeExp(phMetricDecoder, pRawDataSize, pRawData, metricsCount, phMetrics, pSetCount,
pMetricEntriesCountPerSet, pMetricEntriesCount, pMetricEntries);
}
}

9
level_zero/core/source/driver/extension_function_address.cpp
View File

@@ -63,6 +63,15 @@ void *ExtensionFunctionAddressHelper::getExtensionFunctionAddress(const std::str
RETURN_FUNC_PTR_IF_EXIST(zeIntelCommandListAppendSignalExternalSemaphoresExp);
RETURN_FUNC_PTR_IF_EXIST(zeIntelDeviceReleaseExternalSemaphoreExp);
RETURN_FUNC_PTR_IF_EXIST(zetIntelCommandListAppendMarkerExp);
RETURN_FUNC_PTR_IF_EXIST(zetIntelMetricTracerCreateExp);
RETURN_FUNC_PTR_IF_EXIST(zetIntelMetricTracerDestroyExp);
RETURN_FUNC_PTR_IF_EXIST(zetIntelMetricTracerEnableExp);
RETURN_FUNC_PTR_IF_EXIST(zetIntelMetricTracerDisableExp);
RETURN_FUNC_PTR_IF_EXIST(zetIntelMetricTracerReadDataExp);
RETURN_FUNC_PTR_IF_EXIST(zetIntelMetricDecoderCreateExp);
RETURN_FUNC_PTR_IF_EXIST(zetIntelMetricDecoderDestroyExp);
RETURN_FUNC_PTR_IF_EXIST(zetIntelMetricDecoderGetDecodableMetricsExp);
RETURN_FUNC_PTR_IF_EXIST(zetIntelMetricTracerDecodeExp);
#undef RETURN_FUNC_PTR_IF_EXIST

121
level_zero/include/level_zero/zet_intel_gpu_metric.h
View File

@@ -45,6 +45,127 @@ ze_result_t ZE_APICALL zetIntelCommandListAppendMarkerExp(zet_command_list_handl
zet_metric_group_handle_t hMetricGroup,
uint32_t value);
typedef zet_metric_tracer_exp_desc_t zet_intel_metric_tracer_exp_desc_t;
typedef zet_metric_tracer_exp_handle_t zet_intel_metric_tracer_exp_handle_t;
typedef zet_metric_decoder_exp_handle_t zet_intel_metric_decoder_exp_handle_t;
typedef zet_metric_entry_exp_t zet_intel_metric_entry_exp_t;
ze_result_t ZE_APICALL zetIntelMetricTracerCreateExp(
zet_context_handle_t hContext, ///< [in] handle of the context object
zet_device_handle_t hDevice, ///< [in] handle of the device
uint32_t metricGroupCount, ///< [in] metric group count
zet_metric_group_handle_t *phMetricGroups, ///< [in][range(0, metricGroupCount )] handles of the metric groups to
///< trace
zet_intel_metric_tracer_exp_desc_t *desc, ///< [in,out] metric tracer descriptor
ze_event_handle_t hNotificationEvent, ///< [in][optional] event used for report availability notification. Note:
///< If buffer is not drained when the event it flagged, there is a risk of
///< HW event buffer being overrun
zet_intel_metric_tracer_exp_handle_t *phMetricTracer ///< [out] handle of the metric tracer
);
ze_result_t ZE_APICALL zetIntelMetricTracerDestroyExp(
zet_intel_metric_tracer_exp_handle_t hMetricTracer ///< [in] handle of the metric tracer
);
ze_result_t ZE_APICALL zetIntelMetricTracerEnableExp(
zet_intel_metric_tracer_exp_handle_t hMetricTracer, ///< [in] handle of the metric tracer
ze_bool_t synchronous ///< [in] request synchronous behavior. Confirmation of successful
///< asynchronous operation is done by calling ::zetMetricTracerReadDataExp()
///< and checking the return status: ::ZE_RESULT_NOT_READY will be returned
///< when the tracer is inactive. ::ZE_RESULT_SUCCESS will be returned
///< when the tracer is active.
);
ze_result_t ZE_APICALL zetIntelMetricTracerDisableExp(
zet_intel_metric_tracer_exp_handle_t hMetricTracer, ///< [in] handle of the metric tracer
ze_bool_t synchronous ///< [in] request synchronous behavior. Confirmation of successful
///< asynchronous operation is done by calling ::zetMetricTracerReadDataExp()
///< and checking the return status: ::ZE_RESULT_SUCCESS will be returned
///< when the tracer is active or when it is inactive but still has data.
///< ::ZE_RESULT_NOT_READY will be returned when the tracer is inactive and
///< has no more data to be retrieved.
);
ze_result_t ZE_APICALL zetIntelMetricTracerReadDataExp(
zet_intel_metric_tracer_exp_handle_t hMetricTracer, ///< [in] handle of the metric tracer
size_t *pRawDataSize, ///< [in,out] pointer to size in bytes of raw data requested to read.
///< if size is zero, then the driver will update the value with the total
///< size in bytes needed for all data available.
///< if size is non-zero, then driver will only retrieve that amount of
///< data.
///< if size is larger than size needed for all data, then driver will
///< update the value with the actual size needed.
uint8_t *pRawData ///< [in,out][optional][range(0, *pRawDataSize)] buffer containing tracer
///< data in raw format
);
ze_result_t ZE_APICALL zetIntelMetricDecoderCreateExp(
zet_intel_metric_tracer_exp_handle_t hMetricTracer, ///< [in] handle of the metric tracer
zet_intel_metric_decoder_exp_handle_t *phMetricDecoder ///< [out] handle of the metric decoder object
);
ze_result_t ZE_APICALL zetIntelMetricDecoderDestroyExp(
zet_intel_metric_decoder_exp_handle_t phMetricDecoder ///< [in] handle of the metric decoder object
);
ze_result_t ZE_APICALL zetIntelMetricDecoderGetDecodableMetricsExp(
zet_intel_metric_decoder_exp_handle_t hMetricDecoder, ///< [in] handle of the metric decoder object
uint32_t *pCount, ///< [in,out] pointer to number of decodable metric in the hMetricDecoder
///< handle. If count is zero, then the driver shall
///< update the value with the total number of decodable metrics available
///< in the decoder. if count is greater than zero
///< but less than the total number of decodable metrics available in the
///< decoder, then only that number will be returned.
///< if count is greater than the number of decodable metrics available in
///< the decoder, then the driver shall update the
///< value with the actual number of decodable metrics available.
zet_metric_handle_t *phMetrics ///< [in,out] [range(0, *pCount)] array of handles of decodable metrics in
///< the hMetricDecoder handle provided.
);
ze_result_t ZE_APICALL zetIntelMetricTracerDecodeExp(
zet_intel_metric_decoder_exp_handle_t phMetricDecoder, ///< [in] handle of the metric decoder object
size_t *pRawDataSize, ///< [in,out] size in bytes of raw data buffer. If pMetricEntriesCount is
///< greater than zero but less than total number of
///< decodable metrics available in the raw data buffer, then driver shall
///< update this value with actual number of raw
///< data bytes processed.
uint8_t *pRawData, ///< [in,out][optional][range(0, *pRawDataSize)] buffer containing tracer
///< data in raw format
uint32_t metricsCount, ///< [in] number of decodable metrics in the tracer for which the
///< hMetricDecoder handle was provided. See
///< ::zetMetricDecoderGetDecodableMetricsExp(). If metricCount is greater
///< than zero but less than the number decodable
///< metrics available in the raw data buffer, then driver shall only
///< decode those.
zet_metric_handle_t *phMetrics, ///< [in] [range(0, metricsCount)] array of handles of decodable metrics in
///< the decoder for which the hMetricDecoder handle was
///< provided. Metrics handles are expected to be for decodable metrics,
///< see ::zetMetricDecoderGetDecodableMetricsExp()
uint32_t *pSetCount, ///< [in,out] pointer to number of metric sets. If count is zero, then the
///< driver shall update the value with the total
///< number of metric sets to be decoded. If count is greater than the
///< number available in the raw data buffer, then the
///< driver shall update the value with the actual number of metric sets to
///< be decoded. There is a 1:1 relation between
///< the number of sets and sub-devices returned in the decoded entries.
uint32_t *pMetricEntriesCountPerSet, ///< [in,out][optional][range(0, *pSetCount)] buffer of metric entries
///< counts per metric set, one value per set.
uint32_t *pMetricEntriesCount, ///< [in,out] pointer to the total number of metric entries decoded, for
///< all metric sets. If count is zero, then the
///< driver shall update the value with the total number of metric entries
///< to be decoded. If count is greater than zero
///< but less than the total number of metric entries available in the raw
///< data, then user provided number will be decoded.
///< If count is greater than the number available in the raw data buffer,
///< then the driver shall update the value with
///< the actual number of decodable metric entries decoded. If set to null,
///< then driver will only update the value of
///< pSetCount.
zet_intel_metric_entry_exp_t *pMetricEntries ///< [in,out][optional][range(0, *pMetricEntriesCount)] buffer containing
///< decoded metric entries
);
#if defined(__cplusplus)
} // extern "C"
#endif