You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
94 lines
2.4 KiB
C
94 lines
2.4 KiB
C
2 years ago
|
/*
|
||
|
|
* Percepio Trace Recorder for Tracealyzer v4.6.0
|
||
|
|
* Copyright 2021 Percepio AB
|
||
|
|
* www.percepio.com
|
||
|
|
*
|
||
|
|
* SPDX-License-Identifier: Apache-2.0
|
||
|
|
*/
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @file
|
||
|
|
*
|
||
|
|
* @brief Public trace extension APIs.
|
||
|
|
*/
|
||
|
|
|
||
|
|
#ifndef TRC_EXTENSION_H
|
||
|
|
#define TRC_EXTENSION_H
|
||
|
|
|
||
|
|
#if (TRC_USE_TRACEALYZER_RECORDER == 1)
|
||
|
|
|
||
|
|
#if (TRC_CFG_RECORDER_MODE == TRC_RECORDER_MODE_STREAMING)
|
||
|
|
|
||
|
|
#include <trcTypes.h>
|
||
|
|
|
||
|
|
#ifdef __cplusplus
|
||
|
|
extern "C" {
|
||
|
|
#endif
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @defgroup trace_extension_apis Trace Extension APIs
|
||
|
|
* @ingroup trace_recorder_apis
|
||
|
|
* @{
|
||
|
|
*/
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief Creates trace extension.
|
||
|
|
*
|
||
|
|
* @param[in] szName Name.
|
||
|
|
* @param[in] uiMajor Major version.
|
||
|
|
* @param[in] uiMinor Minor version.
|
||
|
|
* @param[in] uiPatch Patch version.
|
||
|
|
* @param[in] uiEventCount Event count.
|
||
|
|
* @param[out] pxExtensionHandle Pointer to uninitialized extension handle.
|
||
|
|
*
|
||
|
|
* @retval TRC_FAIL Failure
|
||
|
|
* @retval TRC_SUCCESS Success
|
||
|
|
*/
|
||
|
|
traceResult xTraceExtensionCreate(const char *szName, uint8_t uiMajor, uint8_t uiMinor, uint16_t uiPatch, uint32_t uiEventCount, TraceExtensionHandle_t *pxExtensionHandle);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief Gets extension base event id.
|
||
|
|
*
|
||
|
|
* @param[in] xExtensionHandle Pointer to initialized extension handle.
|
||
|
|
* @param[out] puiBaseEventId Base event id.
|
||
|
|
*
|
||
|
|
* @retval TRC_FAIL Failure
|
||
|
|
* @retval TRC_SUCCESS Success
|
||
|
|
*/
|
||
|
|
traceResult xTraceExtensionGetBaseEventId(TraceExtensionHandle_t xExtensionHandle, uint32_t *puiBaseEventId);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief Gets extension event id.
|
||
|
|
*
|
||
|
|
* @param[in] xExtensionHandle Pointer to initialized extension handle.
|
||
|
|
* @param[in] uiLocalEventId Local event id.
|
||
|
|
* @param[out] puiGlobalEventId Global event id.
|
||
|
|
*
|
||
|
|
* @retval TRC_FAIL Failure
|
||
|
|
* @retval TRC_SUCCESS Success
|
||
|
|
*/
|
||
|
|
traceResult xTraceExtensionGetEventId(TraceExtensionHandle_t xExtensionHandle, uint32_t uiLocalEventId, uint32_t *puiGlobalEventId);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief Gets extension configuration name.
|
||
|
|
*
|
||
|
|
* @param[in] xExtensionHandle Pointer to initialized extension handle.
|
||
|
|
* @param[out] pszName Name.
|
||
|
|
*
|
||
|
|
* @retval TRC_FAIL Failure
|
||
|
|
* @retval TRC_SUCCESS Success
|
||
|
|
*/
|
||
|
|
traceResult xTraceExtensionGetConfigName(TraceExtensionHandle_t xExtensionHandle, const char **pszName);
|
||
|
|
|
||
|
|
/** @} */
|
||
|
|
|
||
|
|
#ifdef __cplusplus
|
||
|
|
}
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#endif /* (TRC_CFG_RECORDER_MODE == TRC_RECORDER_MODE_STREAMING) */
|
||
|
|
|
||
|
|
#endif /* (TRC_USE_TRACEALYZER_RECORDER == 1) */
|
||
|
|
|
||
|
|
#endif /* TRC_EXTENSION_H */
|