| /* |
| * Copyright (c) 2018 Intel Corporation |
| * |
| * SPDX-License-Identifier: Apache-2.0 |
| */ |
| #ifndef ZEPHYR_INCLUDE_TRACING_TRACING_H_ |
| #define ZEPHYR_INCLUDE_TRACING_TRACING_H_ |
| |
| #include <zephyr/kernel.h> |
| |
| #include "tracking.h" |
| |
| #if defined CONFIG_SEGGER_SYSTEMVIEW |
| #include "tracing_sysview.h" |
| #elif defined CONFIG_TRACING_CTF |
| #include "tracing_ctf.h" |
| #elif defined CONFIG_TRACING_TEST |
| #include "tracing_test.h" |
| #elif defined CONFIG_TRACING_USER |
| #include "tracing_user.h" |
| #else |
| /** |
| * @brief Tracing |
| * |
| * The tracing subsystem provides hooks that permits you to collect data from |
| * your application and allows tools running on a host to visualize the |
| * inner-working of the kernel and various other subsystems. |
| * |
| * @defgroup subsys_tracing Tracing |
| * @ingroup subsys |
| * @{ |
| */ |
| |
| /** |
| * @brief Tracing APIs |
| * @defgroup subsys_tracing_apis Tracing APIs |
| * @{ |
| */ |
| |
| /** |
| * @brief Thread Tracing APIs |
| * @defgroup subsys_tracing_apis_thread Thread Tracing APIs |
| * @{ |
| */ |
| |
| /** |
| * @brief Called when entering a k_thread_foreach call |
| */ |
| #define sys_port_trace_k_thread_foreach_enter() |
| |
| /** |
| * @brief Called when exiting a k_thread_foreach call |
| */ |
| #define sys_port_trace_k_thread_foreach_exit() |
| |
| /** |
| * @brief Called when entering a k_thread_foreach_unlocked |
| */ |
| #define sys_port_trace_k_thread_foreach_unlocked_enter() |
| |
| /** |
| * @brief Called when exiting a k_thread_foreach_unlocked |
| */ |
| #define sys_port_trace_k_thread_foreach_unlocked_exit() |
| |
| /** |
| * @brief Trace creating a Thread |
| * @param new_thread Thread object |
| */ |
| #define sys_port_trace_k_thread_create(new_thread) |
| |
| /** |
| * @brief Trace Thread entering user mode |
| */ |
| #define sys_port_trace_k_thread_user_mode_enter() |
| |
| /** |
| * @brief Called when entering a k_thread_join |
| * @param thread Thread object |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_thread_join_enter(thread, timeout) |
| |
| /** |
| * @brief Called when k_thread_join blocks |
| * @param thread Thread object |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_thread_join_blocking(thread, timeout) |
| |
| /** |
| * @brief Called when exiting k_thread_join |
| * @param thread Thread object |
| * @param timeout Timeout period |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_thread_join_exit(thread, timeout, ret) |
| |
| /** |
| * @brief Called when entering k_thread_sleep |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_thread_sleep_enter(timeout) |
| |
| /** |
| * @brief Called when exiting k_thread_sleep |
| * @param timeout Timeout period |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_thread_sleep_exit(timeout, ret) |
| |
| /** |
| * @brief Called when entering k_thread_msleep |
| * @param ms Duration in milliseconds |
| */ |
| #define sys_port_trace_k_thread_msleep_enter(ms) |
| |
| /** |
| * @brief Called when exiting k_thread_msleep |
| * @param ms Duration in milliseconds |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_thread_msleep_exit(ms, ret) |
| |
| /** |
| * @brief Called when entering k_thread_usleep |
| * @param us Duration in microseconds |
| */ |
| #define sys_port_trace_k_thread_usleep_enter(us) |
| |
| /** |
| * @brief Called when exiting k_thread_usleep |
| * @param us Duration in microseconds |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_thread_usleep_exit(us, ret) |
| |
| /** |
| * @brief Called when entering k_thread_busy_wait |
| * @param usec_to_wait Duration in microseconds |
| */ |
| #define sys_port_trace_k_thread_busy_wait_enter(usec_to_wait) |
| |
| /** |
| * @brief Called when exiting k_thread_busy_wait |
| * @param usec_to_wait Duration in microseconds |
| */ |
| #define sys_port_trace_k_thread_busy_wait_exit(usec_to_wait) |
| |
| /** |
| * @brief Called when a thread yields |
| */ |
| #define sys_port_trace_k_thread_yield() |
| |
| /** |
| * @brief Called when a thread wakes up |
| * @param thread Thread object |
| */ |
| #define sys_port_trace_k_thread_wakeup(thread) |
| |
| /** |
| * @brief Called when a thread is started |
| * @param thread Thread object |
| */ |
| #define sys_port_trace_k_thread_start(thread) |
| |
| /** |
| * @brief Called when a thread is being aborted |
| * @param thread Thread object |
| */ |
| #define sys_port_trace_k_thread_abort(thread) |
| |
| /** |
| * @brief Called when a thread enters the k_thread_abort routine |
| * @param thread Thread object |
| */ |
| #define sys_port_trace_k_thread_abort_enter(thread) |
| |
| /** |
| * @brief Called when a thread exits the k_thread_abort routine |
| * @param thread Thread object |
| */ |
| #define sys_port_trace_k_thread_abort_exit(thread) |
| |
| /** |
| * @brief Called when setting priority of a thread |
| * @param thread Thread object |
| */ |
| #define sys_port_trace_k_thread_priority_set(thread) |
| |
| /** |
| * @brief Called when a thread enters the k_thread_suspend |
| * function. |
| * @param thread Thread object |
| */ |
| #define sys_port_trace_k_thread_suspend_enter(thread) |
| |
| /** |
| * @brief Called when a thread exits the k_thread_suspend |
| * function. |
| * @param thread Thread object |
| */ |
| #define sys_port_trace_k_thread_suspend_exit(thread) |
| |
| /** |
| * @brief Called when a thread enters the resume from suspension |
| * function. |
| * @param thread Thread object |
| */ |
| #define sys_port_trace_k_thread_resume_enter(thread) |
| |
| /** |
| * @brief Called when a thread exits the resumed from suspension |
| * function. |
| * @param thread Thread object |
| */ |
| #define sys_port_trace_k_thread_resume_exit(thread) |
| |
| /** |
| * @brief Called when the thread scheduler is locked |
| */ |
| #define sys_port_trace_k_thread_sched_lock() |
| |
| /** |
| * @brief Called when the thread scheduler is unlocked |
| */ |
| #define sys_port_trace_k_thread_sched_unlock() |
| |
| /** |
| * @brief Called when a thread name is set |
| * @param thread Thread object |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_thread_name_set(thread, ret) |
| |
| /** |
| * @brief Called before a thread has been selected to run |
| */ |
| #define sys_port_trace_k_thread_switched_out() |
| |
| /** |
| * @brief Called after a thread has been selected to run |
| */ |
| #define sys_port_trace_k_thread_switched_in() |
| |
| /** |
| * @brief Called when a thread is ready to run |
| * @param thread Thread object |
| */ |
| #define sys_port_trace_k_thread_ready(thread) |
| |
| /** |
| * @brief Called when a thread is pending |
| * @param thread Thread object |
| */ |
| #define sys_port_trace_k_thread_pend(thread) |
| |
| /** |
| * @brief Provide information about specific thread |
| * @param thread Thread object |
| */ |
| #define sys_port_trace_k_thread_info(thread) |
| |
| /** |
| * @brief Trace implicit thread wakeup invocation by the scheduler |
| * @param thread Thread object |
| */ |
| #define sys_port_trace_k_thread_sched_wakeup(thread) |
| |
| /** |
| * @brief Trace implicit thread abort invocation by the scheduler |
| * @param thread Thread object |
| */ |
| #define sys_port_trace_k_thread_sched_abort(thread) |
| |
| /** |
| * @brief Trace implicit thread set priority invocation by the scheduler |
| * @param thread Thread object |
| * @param prio Thread priority |
| */ |
| #define sys_port_trace_k_thread_sched_priority_set(thread, prio) |
| |
| /** |
| * @brief Trace implicit thread ready invocation by the scheduler |
| * @param thread Thread object |
| */ |
| #define sys_port_trace_k_thread_sched_ready(thread) |
| |
| /** |
| * @brief Trace implicit thread pend invocation by the scheduler |
| * @param thread Thread object |
| */ |
| #define sys_port_trace_k_thread_sched_pend(thread) |
| |
| /** |
| * @brief Trace implicit thread resume invocation by the scheduler |
| * @param thread Thread object |
| */ |
| #define sys_port_trace_k_thread_sched_resume(thread) |
| |
| /** |
| * @brief Trace implicit thread suspend invocation by the scheduler |
| * @param thread Thread object |
| */ |
| #define sys_port_trace_k_thread_sched_suspend(thread) |
| |
| /** @}c*/ /* end of subsys_tracing_apis_thread */ |
| |
| /** |
| * @brief Work Tracing APIs |
| * @defgroup subsys_tracing_apis_work Work Tracing APIs |
| * @{ |
| */ |
| |
| /** |
| * @brief Trace initialisation of a Work structure |
| * @param work Work structure |
| */ |
| #define sys_port_trace_k_work_init(work) |
| |
| /** |
| * @brief Trace submit work to work queue call entry |
| * @param queue Work queue structure |
| * @param work Work structure |
| */ |
| #define sys_port_trace_k_work_submit_to_queue_enter(queue, work) |
| |
| /** |
| * @brief Trace submit work to work queue call exit |
| * @param queue Work queue structure |
| * @param work Work structure |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_work_submit_to_queue_exit(queue, work, ret) |
| |
| /** |
| * @brief Trace submit work to system work queue call entry |
| * @param work Work structure |
| */ |
| #define sys_port_trace_k_work_submit_enter(work) |
| |
| /** |
| * @brief Trace submit work to system work queue call exit |
| * @param work Work structure |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_work_submit_exit(work, ret) |
| |
| /** |
| * @brief Trace flush work call entry |
| * @param work Work structure |
| */ |
| #define sys_port_trace_k_work_flush_enter(work) |
| |
| /** |
| * @brief Trace flush work call blocking |
| * @param work Work structure |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_work_flush_blocking(work, timeout) |
| |
| /** |
| * @brief Trace flush work call exit |
| * @param work Work structure |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_work_flush_exit(work, ret) |
| |
| /** |
| * @brief Trace cancel work call entry |
| * @param work Work structure |
| */ |
| #define sys_port_trace_k_work_cancel_enter(work) |
| |
| /** |
| * @brief Trace cancel work call exit |
| * @param work Work structure |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_work_cancel_exit(work, ret) |
| |
| /** |
| * @brief Trace cancel sync work call entry |
| * @param work Work structure |
| * @param sync Sync object |
| */ |
| #define sys_port_trace_k_work_cancel_sync_enter(work, sync) |
| |
| /** |
| * @brief Trace cancel sync work call blocking |
| * @param work Work structure |
| * @param sync Sync object |
| */ |
| #define sys_port_trace_k_work_cancel_sync_blocking(work, sync) |
| |
| /** |
| * @brief Trace cancel sync work call exit |
| * @param work Work structure |
| * @param sync Sync object |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_work_cancel_sync_exit(work, sync, ret) |
| |
| /** @} */ /* end of subsys_tracing_apis_work */ |
| |
| /** |
| * @brief Work Queue Tracing APIs |
| * @defgroup subsys_tracing_apis_work_q Work Queue Tracing APIs |
| * @{ |
| */ |
| |
| /** |
| * @brief Trace initialisation of a Work Queue structure |
| * @param queue Work Queue structure |
| */ |
| #define sys_port_trace_k_work_queue_init(queue) |
| |
| /** |
| * @brief Trace start of a Work Queue call entry |
| * @param queue Work Queue structure |
| */ |
| #define sys_port_trace_k_work_queue_start_enter(queue) |
| |
| /** |
| * @brief Trace start of a Work Queue call exit |
| * @param queue Work Queue structure |
| */ |
| #define sys_port_trace_k_work_queue_start_exit(queue) |
| |
| /** |
| * @brief Trace Work Queue drain call entry |
| * @param queue Work Queue structure |
| */ |
| #define sys_port_trace_k_work_queue_drain_enter(queue) |
| |
| /** |
| * @brief Trace Work Queue drain call exit |
| * @param queue Work Queue structure |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_work_queue_drain_exit(queue, ret) |
| |
| /** |
| * @brief Trace Work Queue unplug call entry |
| * @param queue Work Queue structure |
| */ |
| #define sys_port_trace_k_work_queue_unplug_enter(queue) |
| |
| /** |
| * @brief Trace Work Queue unplug call exit |
| * @param queue Work Queue structure |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_work_queue_unplug_exit(queue, ret) |
| |
| /** @} */ /* end of subsys_tracing_apis_work_q */ |
| |
| /** |
| * @brief Work Delayable Tracing APIs |
| * @defgroup subsys_tracing_apis_work_delayable Work Delayable Tracing APIs |
| * @{ |
| */ |
| |
| /** |
| * @brief Trace initialisation of a Delayable Work structure |
| * @param dwork Delayable Work structure |
| */ |
| #define sys_port_trace_k_work_delayable_init(dwork) |
| |
| /** |
| * @brief Trace schedule delayable work for queue enter |
| * @param queue Work Queue structure |
| * @param dwork Delayable Work structure |
| * @param delay Delay period |
| */ |
| #define sys_port_trace_k_work_schedule_for_queue_enter(queue, dwork, delay) |
| |
| /** |
| * @brief Trace schedule delayable work for queue exit |
| * @param queue Work Queue structure |
| * @param dwork Delayable Work structure |
| * @param delay Delay period |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_work_schedule_for_queue_exit(queue, dwork, delay, ret) |
| |
| /** |
| * @brief Trace schedule delayable work for system work queue enter |
| * @param dwork Delayable Work structure |
| * @param delay Delay period |
| */ |
| #define sys_port_trace_k_work_schedule_enter(dwork, delay) |
| |
| /** |
| * @brief Trace schedule delayable work for system work queue exit |
| * @param dwork Delayable Work structure |
| * @param delay Delay period |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_work_schedule_exit(dwork, delay, ret) |
| |
| /** |
| * @brief Trace reschedule delayable work for queue enter |
| * @param queue Work Queue structure |
| * @param dwork Delayable Work structure |
| * @param delay Delay period |
| */ |
| #define sys_port_trace_k_work_reschedule_for_queue_enter(queue, dwork, delay) |
| |
| /** |
| * @brief Trace reschedule delayable work for queue exit |
| * @param queue Work Queue structure |
| * @param dwork Delayable Work structure |
| * @param delay Delay period |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_work_reschedule_for_queue_exit(queue, dwork, delay, ret) |
| |
| /** |
| * @brief Trace reschedule delayable work for system queue enter |
| * @param dwork Delayable Work structure |
| * @param delay Delay period |
| */ |
| #define sys_port_trace_k_work_reschedule_enter(dwork, delay) |
| |
| /** |
| * @brief Trace reschedule delayable work for system queue exit |
| * @param dwork Delayable Work structure |
| * @param delay Delay period |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_work_reschedule_exit(dwork, delay, ret) |
| |
| /** |
| * @brief Trace delayable work flush enter |
| * @param dwork Delayable Work structure |
| * @param sync Sync object |
| */ |
| #define sys_port_trace_k_work_flush_delayable_enter(dwork, sync) |
| |
| /** |
| * @brief Trace delayable work flush exit |
| * @param dwork Delayable Work structure |
| * @param sync Sync object |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_work_flush_delayable_exit(dwork, sync, ret) |
| |
| /** |
| * @brief Trace delayable work cancel enter |
| * @param dwork Delayable Work structure |
| */ |
| #define sys_port_trace_k_work_cancel_delayable_enter(dwork) |
| |
| /** |
| * @brief Trace delayable work cancel enter |
| * @param dwork Delayable Work structure |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_work_cancel_delayable_exit(dwork, ret) |
| |
| /** |
| * @brief Trace delayable work cancel sync enter |
| * @param dwork Delayable Work structure |
| * @param sync Sync object |
| */ |
| #define sys_port_trace_k_work_cancel_delayable_sync_enter(dwork, sync) |
| |
| /** |
| * @brief Trace delayable work cancel sync enter |
| * @param dwork Delayable Work structure |
| * @param sync Sync object |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_work_cancel_delayable_sync_exit(dwork, sync, ret) |
| |
| /** @} */ /* end of subsys_tracing_apis_work_delayable */ |
| |
| /** |
| * @brief Work Poll Tracing APIs |
| * @defgroup subsys_tracing_apis_work_poll Work Poll Tracing APIs |
| * @{ |
| */ |
| |
| /** |
| * @brief Trace initialisation of a Work Poll structure enter |
| * @param work Work structure |
| */ |
| #define sys_port_trace_k_work_poll_init_enter(work) |
| |
| /** |
| * @brief Trace initialisation of a Work Poll structure exit |
| * @param work Work structure |
| */ |
| #define sys_port_trace_k_work_poll_init_exit(work) |
| |
| /** |
| * @brief Trace work poll submit to queue enter |
| * @param work_q Work queue |
| * @param work Work structure |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_work_poll_submit_to_queue_enter(work_q, work, timeout) |
| |
| /** |
| * @brief Trace work poll submit to queue blocking |
| * @param work_q Work queue |
| * @param work Work structure |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_work_poll_submit_to_queue_blocking(work_q, work, timeout) |
| |
| /** |
| * @brief Trace work poll submit to queue exit |
| * @param work_q Work queue |
| * @param work Work structure |
| * @param timeout Timeout period |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_work_poll_submit_to_queue_exit(work_q, work, timeout, ret) |
| |
| /** |
| * @brief Trace work poll submit to system queue enter |
| * @param work Work structure |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_work_poll_submit_enter(work, timeout) |
| |
| /** |
| * @brief Trace work poll submit to system queue exit |
| * @param work Work structure |
| * @param timeout Timeout period |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_work_poll_submit_exit(work, timeout, ret) |
| |
| /** |
| * @brief Trace work poll cancel enter |
| * @param work Work structure |
| */ |
| #define sys_port_trace_k_work_poll_cancel_enter(work) |
| |
| /** |
| * @brief Trace work poll cancel exit |
| * @param work Work structure |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_work_poll_cancel_exit(work, ret) |
| |
| /** @} */ /* end of subsys_tracing_apis_work_poll */ |
| |
| /** |
| * @brief Poll Tracing APIs |
| * @defgroup subsys_tracing_apis_poll Poll Tracing APIs |
| * @{ |
| */ |
| |
| /** |
| * @brief Trace initialisation of a Poll Event |
| * @param event Poll Event |
| */ |
| #define sys_port_trace_k_poll_api_event_init(event) |
| |
| /** |
| * @brief Trace Polling call start |
| * @param events Poll Events |
| */ |
| #define sys_port_trace_k_poll_api_poll_enter(events) |
| |
| /** |
| * @brief Trace Polling call outcome |
| * @param events Poll Events |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_poll_api_poll_exit(events, ret) |
| |
| /** |
| * @brief Trace initialisation of a Poll Signal |
| * @param signal Poll Signal |
| */ |
| #define sys_port_trace_k_poll_api_signal_init(signal) |
| |
| /** |
| * @brief Trace resetting of Poll Signal |
| * @param signal Poll Signal |
| */ |
| #define sys_port_trace_k_poll_api_signal_reset(signal) |
| |
| /** |
| * @brief Trace checking of Poll Signal |
| * @param signal Poll Signal |
| */ |
| #define sys_port_trace_k_poll_api_signal_check(signal) |
| |
| /** |
| * @brief Trace raising of Poll Signal |
| * @param signal Poll Signal |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_poll_api_signal_raise(signal, ret) |
| |
| /** @} */ /* end of subsys_tracing_apis_poll */ |
| |
| /** |
| * @brief Semaphore Tracing APIs |
| * @defgroup subsys_tracing_apis_sem Semaphore Tracing APIs |
| * @{ |
| */ |
| |
| /** |
| * @brief Trace initialisation of a Semaphore |
| * @param sem Semaphore object |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_sem_init(sem, ret) |
| |
| /** |
| * @brief Trace giving a Semaphore entry |
| * @param sem Semaphore object |
| */ |
| #define sys_port_trace_k_sem_give_enter(sem) |
| |
| /** |
| * @brief Trace giving a Semaphore exit |
| * @param sem Semaphore object |
| */ |
| #define sys_port_trace_k_sem_give_exit(sem) |
| |
| /** |
| * @brief Trace taking a Semaphore attempt start |
| * @param sem Semaphore object |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_sem_take_enter(sem, timeout) |
| |
| /** |
| * @brief Trace taking a Semaphore attempt blocking |
| * @param sem Semaphore object |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_sem_take_blocking(sem, timeout) |
| |
| /** |
| * @brief Trace taking a Semaphore attempt outcome |
| * @param sem Semaphore object |
| * @param timeout Timeout period |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_sem_take_exit(sem, timeout, ret) |
| |
| /** |
| * @brief Trace resetting a Semaphore |
| * @param sem Semaphore object |
| */ |
| #define sys_port_trace_k_sem_reset(sem) |
| |
| /** @} */ /* end of subsys_tracing_apis_sem */ |
| |
| /** |
| * @brief Mutex Tracing APIs |
| * @defgroup subsys_tracing_apis_mutex Mutex Tracing APIs |
| * @{ |
| */ |
| |
| /** |
| * @brief Trace initialization of Mutex |
| * @param mutex Mutex object |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_mutex_init(mutex, ret) |
| |
| /** |
| * @brief Trace Mutex lock attempt start |
| * @param mutex Mutex object |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_mutex_lock_enter(mutex, timeout) |
| |
| /** |
| * @brief Trace Mutex lock attempt blocking |
| * @param mutex Mutex object |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_mutex_lock_blocking(mutex, timeout) |
| |
| /** |
| * @brief Trace Mutex lock attempt outcome |
| * @param mutex Mutex object |
| * @param timeout Timeout period |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_mutex_lock_exit(mutex, timeout, ret) |
| |
| /** |
| * @brief Trace Mutex unlock entry |
| * @param mutex Mutex object |
| */ |
| #define sys_port_trace_k_mutex_unlock_enter(mutex) |
| |
| /** |
| * @brief Trace Mutex unlock exit |
| */ |
| #define sys_port_trace_k_mutex_unlock_exit(mutex, ret) |
| |
| /** @} */ /* end of subsys_tracing_apis_mutex */ |
| |
| /** |
| * @brief Conditional Variable Tracing APIs |
| * @defgroup subsys_tracing_apis_condvar Conditional Variable Tracing APIs |
| * @{ |
| */ |
| |
| /** |
| * @brief Trace initialization of Conditional Variable |
| * @param condvar Conditional Variable object |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_condvar_init(condvar, ret) |
| |
| /** |
| * @brief Trace Conditional Variable signaling start |
| * @param condvar Conditional Variable object |
| */ |
| #define sys_port_trace_k_condvar_signal_enter(condvar) |
| |
| /** |
| * @brief Trace Conditional Variable signaling blocking |
| * @param condvar Conditional Variable object |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_condvar_signal_blocking(condvar, timeout) |
| |
| /** |
| * @brief Trace Conditional Variable signaling outcome |
| * @param condvar Conditional Variable object |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_condvar_signal_exit(condvar, ret) |
| |
| /** |
| * @brief Trace Conditional Variable broadcast enter |
| * @param condvar Conditional Variable object |
| */ |
| #define sys_port_trace_k_condvar_broadcast_enter(condvar) |
| |
| /** |
| * @brief Trace Conditional Variable broadcast exit |
| * @param condvar Conditional Variable object |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_condvar_broadcast_exit(condvar, ret) |
| |
| /** |
| * @brief Trace Conditional Variable wait enter |
| * @param condvar Conditional Variable object |
| */ |
| #define sys_port_trace_k_condvar_wait_enter(condvar) |
| |
| /** |
| * @brief Trace Conditional Variable wait exit |
| * @param condvar Conditional Variable object |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_condvar_wait_exit(condvar, ret) |
| |
| /** @} */ /* end of subsys_tracing_apis_condvar */ |
| |
| /** |
| * @brief Queue Tracing APIs |
| * @defgroup subsys_tracing_apis_queue Queue Tracing APIs |
| * @{ |
| */ |
| |
| /** |
| * @brief Trace initialization of Queue |
| * @param queue Queue object |
| */ |
| #define sys_port_trace_k_queue_init(queue) |
| |
| /** |
| * @brief Trace Queue cancel wait |
| * @param queue Queue object |
| */ |
| #define sys_port_trace_k_queue_cancel_wait(queue) |
| |
| /** |
| * @brief Trace Queue insert attempt entry |
| * @param queue Queue object |
| * @param alloc Allocation flag |
| */ |
| #define sys_port_trace_k_queue_queue_insert_enter(queue, alloc) |
| |
| /** |
| * @brief Trace Queue insert attempt blocking |
| * @param queue Queue object |
| * @param alloc Allocation flag |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_queue_queue_insert_blocking(queue, alloc, timeout) |
| |
| /** |
| * @brief Trace Queue insert attempt outcome |
| * @param queue Queue object |
| * @param alloc Allocation flag |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_queue_queue_insert_exit(queue, alloc, ret) |
| |
| /** |
| * @brief Trace Queue append enter |
| * @param queue Queue object |
| */ |
| #define sys_port_trace_k_queue_append_enter(queue) |
| |
| /** |
| * @brief Trace Queue append exit |
| * @param queue Queue object |
| */ |
| #define sys_port_trace_k_queue_append_exit(queue) |
| |
| /** |
| * @brief Trace Queue alloc append enter |
| * @param queue Queue object |
| */ |
| #define sys_port_trace_k_queue_alloc_append_enter(queue) |
| |
| /** |
| * @brief Trace Queue alloc append exit |
| * @param queue Queue object |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_queue_alloc_append_exit(queue, ret) |
| |
| /** |
| * @brief Trace Queue prepend enter |
| * @param queue Queue object |
| */ |
| #define sys_port_trace_k_queue_prepend_enter(queue) |
| |
| /** |
| * @brief Trace Queue prepend exit |
| * @param queue Queue object |
| */ |
| #define sys_port_trace_k_queue_prepend_exit(queue) |
| |
| /** |
| * @brief Trace Queue alloc prepend enter |
| * @param queue Queue object |
| */ |
| #define sys_port_trace_k_queue_alloc_prepend_enter(queue) |
| |
| /** |
| * @brief Trace Queue alloc prepend exit |
| * @param queue Queue object |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_queue_alloc_prepend_exit(queue, ret) |
| |
| /** |
| * @brief Trace Queue insert attempt entry |
| * @param queue Queue object |
| */ |
| #define sys_port_trace_k_queue_insert_enter(queue) |
| |
| /** |
| * @brief Trace Queue insert attempt blocking |
| * @param queue Queue object |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_queue_insert_blocking(queue, timeout) |
| |
| /** |
| * @brief Trace Queue insert attempt exit |
| * @param queue Queue object |
| */ |
| #define sys_port_trace_k_queue_insert_exit(queue) |
| |
| /** |
| * @brief Trace Queue append list enter |
| * @param queue Queue object |
| */ |
| #define sys_port_trace_k_queue_append_list_enter(queue) |
| |
| /** |
| * @brief Trace Queue append list exit |
| * @param queue Queue object |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_queue_append_list_exit(queue, ret) |
| |
| /** |
| * @brief Trace Queue merge slist enter |
| * @param queue Queue object |
| */ |
| #define sys_port_trace_k_queue_merge_slist_enter(queue) |
| |
| /** |
| * @brief Trace Queue merge slist exit |
| * @param queue Queue object |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_queue_merge_slist_exit(queue, ret) |
| |
| /** |
| * @brief Trace Queue get attempt enter |
| * @param queue Queue object |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_queue_get_enter(queue, timeout) |
| |
| /** |
| * @brief Trace Queue get attempt blockings |
| * @param queue Queue object |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_queue_get_blocking(queue, timeout) |
| |
| /** |
| * @brief Trace Queue get attempt outcome |
| * @param queue Queue object |
| * @param timeout Timeout period |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_queue_get_exit(queue, timeout, ret) |
| |
| /** |
| * @brief Trace Queue remove enter |
| * @param queue Queue object |
| */ |
| #define sys_port_trace_k_queue_remove_enter(queue) |
| |
| /** |
| * @brief Trace Queue remove exit |
| * @param queue Queue object |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_queue_remove_exit(queue, ret) |
| |
| /** |
| * @brief Trace Queue unique append enter |
| * @param queue Queue object |
| */ |
| #define sys_port_trace_k_queue_unique_append_enter(queue) |
| |
| /** |
| * @brief Trace Queue unique append exit |
| * @param queue Queue object |
| * |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_queue_unique_append_exit(queue, ret) |
| |
| /** |
| * @brief Trace Queue peek head |
| * @param queue Queue object |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_queue_peek_head(queue, ret) |
| |
| /** |
| * @brief Trace Queue peek tail |
| * @param queue Queue object |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_queue_peek_tail(queue, ret) |
| |
| /** @} */ /* end of subsys_tracing_apis_queue */ |
| |
| /** |
| * @brief FIFO Tracing APIs |
| * @defgroup subsys_tracing_apis_fifo FIFO Tracing APIs |
| * @{ |
| */ |
| |
| /** |
| * @brief Trace initialization of FIFO Queue entry |
| * @param fifo FIFO object |
| */ |
| #define sys_port_trace_k_fifo_init_enter(fifo) |
| |
| /** |
| * @brief Trace initialization of FIFO Queue exit |
| * @param fifo FIFO object |
| */ |
| #define sys_port_trace_k_fifo_init_exit(fifo) |
| |
| /** |
| * @brief Trace FIFO Queue cancel wait entry |
| * @param fifo FIFO object |
| */ |
| #define sys_port_trace_k_fifo_cancel_wait_enter(fifo) |
| |
| /** |
| * @brief Trace FIFO Queue cancel wait exit |
| * @param fifo FIFO object |
| */ |
| #define sys_port_trace_k_fifo_cancel_wait_exit(fifo) |
| |
| /** |
| * @brief Trace FIFO Queue put entry |
| * @param fifo FIFO object |
| * @param data Data item |
| */ |
| #define sys_port_trace_k_fifo_put_enter(fifo, data) |
| |
| /** |
| * @brief Trace FIFO Queue put exit |
| * @param fifo FIFO object |
| * @param data Data item |
| */ |
| #define sys_port_trace_k_fifo_put_exit(fifo, data) |
| |
| /** |
| * @brief Trace FIFO Queue alloc put entry |
| * @param fifo FIFO object |
| * @param data Data item |
| */ |
| #define sys_port_trace_k_fifo_alloc_put_enter(fifo, data) |
| |
| /** |
| * @brief Trace FIFO Queue alloc put exit |
| * @param fifo FIFO object |
| * @param data Data item |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_fifo_alloc_put_exit(fifo, data, ret) |
| |
| /** |
| * @brief Trace FIFO Queue put list entry |
| * @param fifo FIFO object |
| * @param head First ll-node |
| * @param tail Last ll-node |
| */ |
| #define sys_port_trace_k_fifo_put_list_enter(fifo, head, tail) |
| |
| /** |
| * @brief Trace FIFO Queue put list exit |
| * @param fifo FIFO object |
| * @param head First ll-node |
| * @param tail Last ll-node |
| */ |
| #define sys_port_trace_k_fifo_put_list_exit(fifo, head, tail) |
| |
| /** |
| * @brief Trace FIFO Queue put slist entry |
| * @param fifo FIFO object |
| * @param list Syslist object |
| */ |
| #define sys_port_trace_k_fifo_alloc_put_slist_enter(fifo, list) |
| |
| /** |
| * @brief Trace FIFO Queue put slist exit |
| * @param fifo FIFO object |
| * @param list Syslist object |
| */ |
| #define sys_port_trace_k_fifo_alloc_put_slist_exit(fifo, list) |
| |
| /** |
| * @brief Trace FIFO Queue get entry |
| * @param fifo FIFO object |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_fifo_get_enter(fifo, timeout) |
| |
| /** |
| * @brief Trace FIFO Queue get exit |
| * @param fifo FIFO object |
| * @param timeout Timeout period |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_fifo_get_exit(fifo, timeout, ret) |
| |
| /** |
| * @brief Trace FIFO Queue peek head entry |
| * @param fifo FIFO object |
| */ |
| #define sys_port_trace_k_fifo_peek_head_entry(fifo) |
| |
| /** |
| * @brief Trace FIFO Queue peek head exit |
| * @param fifo FIFO object |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_fifo_peek_head_exit(fifo, ret) |
| |
| /** |
| * @brief Trace FIFO Queue peek tail entry |
| * @param fifo FIFO object |
| */ |
| #define sys_port_trace_k_fifo_peek_tail_entry(fifo) |
| |
| /** |
| * @brief Trace FIFO Queue peek tail exit |
| * @param fifo FIFO object |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_fifo_peek_tail_exit(fifo, ret) |
| |
| /** @} */ /* end of subsys_tracing_apis_fifo */ |
| |
| /** |
| * @brief LIFO Tracing APIs |
| * @defgroup subsys_tracing_apis_lifo LIFO Tracing APIs |
| * @{ |
| */ |
| |
| /** |
| * @brief Trace initialization of LIFO Queue entry |
| * @param lifo LIFO object |
| */ |
| #define sys_port_trace_k_lifo_init_enter(lifo) |
| |
| /** |
| * @brief Trace initialization of LIFO Queue exit |
| * @param lifo LIFO object |
| */ |
| #define sys_port_trace_k_lifo_init_exit(lifo) |
| |
| /** |
| * @brief Trace LIFO Queue put entry |
| * @param lifo LIFO object |
| * @param data Data item |
| */ |
| #define sys_port_trace_k_lifo_put_enter(lifo, data) |
| |
| /** |
| * @brief Trace LIFO Queue put exit |
| * @param lifo LIFO object |
| * @param data Data item |
| */ |
| #define sys_port_trace_k_lifo_put_exit(lifo, data) |
| |
| /** |
| * @brief Trace LIFO Queue alloc put entry |
| * @param lifo LIFO object |
| * @param data Data item |
| */ |
| #define sys_port_trace_k_lifo_alloc_put_enter(lifo, data) |
| |
| /** |
| * @brief Trace LIFO Queue alloc put exit |
| * @param lifo LIFO object |
| * @param data Data item |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_lifo_alloc_put_exit(lifo, data, ret) |
| |
| /** |
| * @brief Trace LIFO Queue get entry |
| * @param lifo LIFO object |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_lifo_get_enter(lifo, timeout) |
| |
| /** |
| * @brief Trace LIFO Queue get exit |
| * @param lifo LIFO object |
| * @param timeout Timeout period |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_lifo_get_exit(lifo, timeout, ret) |
| |
| /** @} */ /* end of subsys_tracing_apis_lifo */ |
| |
| /** |
| * @brief Stack Tracing APIs |
| * @defgroup subsys_tracing_apis_stack Stack Tracing APIs |
| * @{ |
| */ |
| |
| /** |
| * @brief Trace initialization of Stack |
| * @param stack Stack object |
| */ |
| #define sys_port_trace_k_stack_init(stack) |
| |
| /** |
| * @brief Trace Stack alloc init attempt entry |
| * @param stack Stack object |
| */ |
| #define sys_port_trace_k_stack_alloc_init_enter(stack) |
| |
| /** |
| * @brief Trace Stack alloc init outcome |
| * @param stack Stack object |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_stack_alloc_init_exit(stack, ret) |
| |
| /** |
| * @brief Trace Stack cleanup attempt entry |
| * @param stack Stack object |
| */ |
| #define sys_port_trace_k_stack_cleanup_enter(stack) |
| |
| /** |
| * @brief Trace Stack cleanup outcome |
| * @param stack Stack object |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_stack_cleanup_exit(stack, ret) |
| |
| /** |
| * @brief Trace Stack push attempt entry |
| * @param stack Stack object |
| */ |
| #define sys_port_trace_k_stack_push_enter(stack) |
| |
| /** |
| * @brief Trace Stack push attempt outcome |
| * @param stack Stack object |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_stack_push_exit(stack, ret) |
| |
| /** |
| * @brief Trace Stack pop attempt entry |
| * @param stack Stack object |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_stack_pop_enter(stack, timeout) |
| |
| /** |
| * @brief Trace Stack pop attempt blocking |
| * @param stack Stack object |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_stack_pop_blocking(stack, timeout) |
| |
| /** |
| * @brief Trace Stack pop attempt outcome |
| * @param stack Stack object |
| * @param timeout Timeout period |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_stack_pop_exit(stack, timeout, ret) |
| |
| /** @} */ /* end of subsys_tracing_apis_stack */ |
| |
| /** |
| * @brief Message Queue Tracing APIs |
| * @defgroup subsys_tracing_apis_msgq Message Queue Tracing APIs |
| * @{ |
| */ |
| |
| /** |
| * @brief Trace initialization of Message Queue |
| * @param msgq Message Queue object |
| */ |
| #define sys_port_trace_k_msgq_init(msgq) |
| |
| /** |
| * @brief Trace Message Queue alloc init attempt entry |
| * @param msgq Message Queue object |
| */ |
| #define sys_port_trace_k_msgq_alloc_init_enter(msgq) |
| |
| /** |
| * @brief Trace Message Queue alloc init attempt outcome |
| * @param msgq Message Queue object |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_msgq_alloc_init_exit(msgq, ret) |
| |
| /** |
| * @brief Trace Message Queue cleanup attempt entry |
| * @param msgq Message Queue object |
| */ |
| #define sys_port_trace_k_msgq_cleanup_enter(msgq) |
| |
| /** |
| * @brief Trace Message Queue cleanup attempt outcome |
| * @param msgq Message Queue object |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_msgq_cleanup_exit(msgq, ret) |
| |
| /** |
| * @brief Trace Message Queue put attempt entry |
| * @param msgq Message Queue object |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_msgq_put_enter(msgq, timeout) |
| |
| /** |
| * @brief Trace Message Queue put attempt blocking |
| * @param msgq Message Queue object |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_msgq_put_blocking(msgq, timeout) |
| |
| /** |
| * @brief Trace Message Queue put attempt outcome |
| * @param msgq Message Queue object |
| * @param timeout Timeout period |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_msgq_put_exit(msgq, timeout, ret) |
| |
| /** |
| * @brief Trace Message Queue get attempt entry |
| * @param msgq Message Queue object |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_msgq_get_enter(msgq, timeout) |
| |
| /** |
| * @brief Trace Message Queue get attempt blockings |
| * @param msgq Message Queue object |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_msgq_get_blocking(msgq, timeout) |
| |
| /** |
| * @brief Trace Message Queue get attempt outcome |
| * @param msgq Message Queue object |
| * @param timeout Timeout period |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_msgq_get_exit(msgq, timeout, ret) |
| |
| /** |
| * @brief Trace Message Queue peek |
| * @param msgq Message Queue object |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_msgq_peek(msgq, ret) |
| |
| /** |
| * @brief Trace Message Queue purge |
| * @param msgq Message Queue object |
| */ |
| #define sys_port_trace_k_msgq_purge(msgq) |
| |
| /** @} */ /* end of subsys_tracing_apis_msgq */ |
| |
| /** |
| * @brief Mailbox Tracing APIs |
| * @defgroup subsys_tracing_apis_mbox Mailbox Tracing APIs |
| * @{ |
| */ |
| |
| /** |
| * @brief Trace initialization of Mailbox |
| * @param mbox Mailbox object |
| */ |
| #define sys_port_trace_k_mbox_init(mbox) |
| |
| /** |
| * @brief Trace Mailbox message put attempt entry |
| * @param mbox Mailbox object |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_mbox_message_put_enter(mbox, timeout) |
| |
| /** |
| * @brief Trace Mailbox message put attempt blocking |
| * @param mbox Mailbox object |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_mbox_message_put_blocking(mbox, timeout) |
| |
| /** |
| * @brief Trace Mailbox message put attempt outcome |
| * @param mbox Mailbox object |
| * @param timeout Timeout period |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_mbox_message_put_exit(mbox, timeout, ret) |
| |
| /** |
| * @brief Trace Mailbox put attempt entry |
| * @param mbox Mailbox object |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_mbox_put_enter(mbox, timeout) |
| |
| /** |
| * @brief Trace Mailbox put attempt blocking |
| * @param mbox Mailbox object |
| * @param timeout Timeout period |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_mbox_put_exit(mbox, timeout, ret) |
| |
| /** |
| * @brief Trace Mailbox async put entry |
| * @param mbox Mailbox object |
| * @param sem Semaphore object |
| */ |
| #define sys_port_trace_k_mbox_async_put_enter(mbox, sem) |
| |
| /** |
| * @brief Trace Mailbox async put exit |
| * @param mbox Mailbox object |
| * @param sem Semaphore object |
| */ |
| #define sys_port_trace_k_mbox_async_put_exit(mbox, sem) |
| |
| /** |
| * @brief Trace Mailbox get attempt entry |
| * @param mbox Mailbox entry |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_mbox_get_enter(mbox, timeout) |
| |
| /** |
| * @brief Trace Mailbox get attempt blocking |
| * @param mbox Mailbox entry |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_mbox_get_blocking(mbox, timeout) |
| |
| /** |
| * @brief Trace Mailbox get attempt outcome |
| * @param mbox Mailbox entry |
| * @param timeout Timeout period |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_mbox_get_exit(mbox, timeout, ret) |
| |
| /** |
| * @brief Trace Mailbox data get |
| * @brief rx_msg Receive Message object |
| */ |
| #define sys_port_trace_k_mbox_data_get(rx_msg) |
| |
| /** @} */ /* end of subsys_tracing_apis_mbox */ |
| |
| /** |
| * @brief Pipe Tracing APIs |
| * @defgroup subsys_tracing_apis_pipe Pipe Tracing APIs |
| * @{ |
| */ |
| |
| /** |
| * @brief Trace initialization of Pipe |
| * @param pipe Pipe object |
| */ |
| #define sys_port_trace_k_pipe_init(pipe) |
| |
| /** |
| * @brief Trace Pipe cleanup entry |
| * @param pipe Pipe object |
| */ |
| #define sys_port_trace_k_pipe_cleanup_enter(pipe) |
| |
| /** |
| * @brief Trace Pipe cleanup exit |
| * @param pipe Pipe object |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_pipe_cleanup_exit(pipe, ret) |
| |
| /** |
| * @brief Trace Pipe alloc init entry |
| * @param pipe Pipe object |
| */ |
| #define sys_port_trace_k_pipe_alloc_init_enter(pipe) |
| |
| /** |
| * @brief Trace Pipe alloc init exit |
| * @param pipe Pipe object |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_pipe_alloc_init_exit(pipe, ret) |
| |
| /** |
| * @brief Trace Pipe flush entry |
| * @param pipe Pipe object |
| */ |
| #define sys_port_trace_k_pipe_flush_enter(pipe) |
| |
| /** |
| * @brief Trace Pipe flush exit |
| * @param pipe Pipe object |
| */ |
| #define sys_port_trace_k_pipe_flush_exit(pipe) |
| |
| /** |
| * @brief Trace Pipe buffer flush entry |
| * @param pipe Pipe object |
| */ |
| #define sys_port_trace_k_pipe_buffer_flush_enter(pipe) |
| |
| /** |
| * @brief Trace Pipe buffer flush exit |
| * @param pipe Pipe object |
| */ |
| #define sys_port_trace_k_pipe_buffer_flush_exit(pipe) |
| |
| /** |
| * @brief Trace Pipe put attempt entry |
| * @param pipe Pipe object |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_pipe_put_enter(pipe, timeout) |
| |
| /** |
| * @brief Trace Pipe put attempt blocking |
| * @param pipe Pipe object |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_pipe_put_blocking(pipe, timeout) |
| |
| /** |
| * @brief Trace Pipe put attempt outcome |
| * @param pipe Pipe object |
| * @param timeout Timeout period |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_pipe_put_exit(pipe, timeout, ret) |
| |
| /** |
| * @brief Trace Pipe get attempt entry |
| * @param pipe Pipe object |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_pipe_get_enter(pipe, timeout) |
| |
| /** |
| * @brief Trace Pipe get attempt blocking |
| * @param pipe Pipe object |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_pipe_get_blocking(pipe, timeout) |
| |
| /** |
| * @brief Trace Pipe get attempt outcome |
| * @param pipe Pipe object |
| * @param timeout Timeout period |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_pipe_get_exit(pipe, timeout, ret) |
| |
| /** |
| * @brief Trace Pipe block put enter |
| * @param pipe Pipe object |
| * @param sem Semaphore object |
| */ |
| #define sys_port_trace_k_pipe_block_put_enter(pipe, sem) |
| |
| /** |
| * @brief Trace Pipe block put exit |
| * @param pipe Pipe object |
| * @param sem Semaphore object |
| */ |
| #define sys_port_trace_k_pipe_block_put_exit(pipe, sem) |
| |
| /** @} */ /* end of subsys_tracing_apis_pipe */ |
| |
| /** |
| * @brief Heap Tracing APIs |
| * @defgroup subsys_tracing_apis_heap Heap Tracing APIs |
| * @{ |
| */ |
| |
| /** |
| * @brief Trace initialization of Heap |
| * @param h Heap object |
| */ |
| #define sys_port_trace_k_heap_init(h) |
| |
| /** |
| * @brief Trace Heap aligned alloc attempt entry |
| * @param h Heap object |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_heap_aligned_alloc_enter(h, timeout) |
| |
| /** |
| * @brief Trace Heap align alloc attempt blocking |
| * @param h Heap object |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_heap_aligned_alloc_blocking(h, timeout) |
| |
| /** |
| * @brief Trace Heap align alloc attempt outcome |
| * @param h Heap object |
| * @param timeout Timeout period |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_heap_aligned_alloc_exit(h, timeout, ret) |
| |
| /** |
| * @brief Trace Heap alloc enter |
| * @param h Heap object |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_heap_alloc_enter(h, timeout) |
| |
| /** |
| * @brief Trace Heap alloc exit |
| * @param h Heap object |
| * @param timeout Timeout period |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_heap_alloc_exit(h, timeout, ret) |
| |
| /** |
| * @brief Trace Heap free |
| * @param h Heap object |
| */ |
| #define sys_port_trace_k_heap_free(h) |
| |
| /** |
| * @brief Trace System Heap aligned alloc enter |
| * @param heap Heap object |
| */ |
| #define sys_port_trace_k_heap_sys_k_aligned_alloc_enter(heap) |
| |
| /** |
| * @brief Trace System Heap aligned alloc exit |
| * @param heap Heap object |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_heap_sys_k_aligned_alloc_exit(heap, ret) |
| |
| /** |
| * @brief Trace System Heap aligned alloc enter |
| * @param heap Heap object |
| */ |
| #define sys_port_trace_k_heap_sys_k_malloc_enter(heap) |
| |
| /** |
| * @brief Trace System Heap aligned alloc exit |
| * @param heap Heap object |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_heap_sys_k_malloc_exit(heap, ret) |
| |
| /** |
| * @brief Trace System Heap free entry |
| * @param heap Heap object |
| * @param heap_ref Heap reference |
| */ |
| #define sys_port_trace_k_heap_sys_k_free_enter(heap, heap_ref) |
| |
| /** |
| * @brief Trace System Heap free exit |
| * @param heap Heap object |
| * @param heap_ref Heap reference |
| */ |
| #define sys_port_trace_k_heap_sys_k_free_exit(heap, heap_ref) |
| |
| /** |
| * @brief Trace System heap calloc enter |
| * @param heap |
| */ |
| #define sys_port_trace_k_heap_sys_k_calloc_enter(heap) |
| |
| /** |
| * @brief Trace System heap calloc exit |
| * @param heap Heap object |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_heap_sys_k_calloc_exit(heap, ret) |
| |
| /** @} */ /* end of subsys_tracing_apis_heap */ |
| |
| /** |
| * @brief Memory Slab Tracing APIs |
| * @defgroup subsys_tracing_apis_mslab Memory Slab Tracing APIs |
| * @{ |
| */ |
| |
| /** |
| * @brief Trace initialization of Memory Slab |
| * @param slab Memory Slab object |
| * @param rc Return value |
| */ |
| #define sys_port_trace_k_mem_slab_init(slab, rc) |
| |
| /** |
| * @brief Trace Memory Slab alloc attempt entry |
| * @param slab Memory Slab object |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_mem_slab_alloc_enter(slab, timeout) |
| |
| /** |
| * @brief Trace Memory Slab alloc attempt blocking |
| * @param slab Memory Slab object |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_mem_slab_alloc_blocking(slab, timeout) |
| |
| /** |
| * @brief Trace Memory Slab alloc attempt outcome |
| * @param slab Memory Slab object |
| * @param timeout Timeout period |
| * @param ret Return value |
| */ |
| #define sys_port_trace_k_mem_slab_alloc_exit(slab, timeout, ret) |
| |
| /** |
| * @brief Trace Memory Slab free entry |
| * @param slab Memory Slab object |
| */ |
| #define sys_port_trace_k_mem_slab_free_enter(slab) |
| |
| /** |
| * @brief Trace Memory Slab free exit |
| * @param slab Memory Slab object |
| */ |
| #define sys_port_trace_k_mem_slab_free_exit(slab) |
| |
| /** @} */ /* end of subsys_tracing_apis_mslab */ |
| |
| /** |
| * @brief Timer Tracing APIs |
| * @defgroup subsys_tracing_apis_timer Timer Tracing APIs |
| * @{ |
| */ |
| |
| /** |
| * @brief Trace initialization of Timer |
| * @param timer Timer object |
| */ |
| #define sys_port_trace_k_timer_init(timer) |
| |
| /** |
| * @brief Trace Timer start |
| * @param timer Timer object |
| */ |
| #define sys_port_trace_k_timer_start(timer) |
| |
| /** |
| * @brief Trace Timer stop |
| * @param timer Timer object |
| */ |
| #define sys_port_trace_k_timer_stop(timer) |
| |
| /** |
| * @brief Trace Timer status sync entry |
| * @param timer Timer object |
| */ |
| #define sys_port_trace_k_timer_status_sync_enter(timer) |
| |
| /** |
| * @brief Trace Timer Status sync blocking |
| * @param timer Timer object |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_timer_status_sync_blocking(timer, timeout) |
| |
| /** |
| * @brief Trace Time Status sync outcome |
| * @param timer Timer object |
| * @param result Return value |
| */ |
| #define sys_port_trace_k_timer_status_sync_exit(timer, result) |
| |
| /** @} */ /* end of subsys_tracing_apis_timer */ |
| |
| /** |
| * @brief Event Tracing APIs |
| * @defgroup subsys_tracing_apis_event Event Tracing APIs |
| * @{ |
| */ |
| |
| /** |
| * @brief Trace initialisation of an Event |
| * @param event Event object |
| */ |
| #define sys_port_trace_k_event_init(event) |
| |
| /** |
| * @brief Trace posting of an Event call entry |
| * @param event Event object |
| * @param events Set of posted events |
| * @param events_mask Mask to apply against posted events |
| */ |
| #define sys_port_trace_k_event_post_enter(event, events, events_mask) |
| |
| /** |
| * @brief Trace posting of an Event call exit |
| * @param event Event object |
| * @param events Set of posted events |
| * @param events_mask Mask to apply against posted events |
| */ |
| #define sys_port_trace_k_event_post_exit(event, events, events_mask) |
| |
| /** |
| * @brief Trace waiting of an Event call entry |
| * @param event Event object |
| * @param events Set of events for which to wait |
| * @param options Event wait options |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_event_wait_enter(event, events, options, timeout) |
| |
| /** |
| * @brief Trace waiting of an Event call exit |
| * @param event Event object |
| * @param events Set of events for which to wait |
| * @param options Event wait options |
| * @param timeout Timeout period |
| */ |
| #define sys_port_trace_k_event_wait_blocking(event, events, options, timeout) |
| |
| /** |
| * @brief Trace waiting of an Event call exit |
| * @param event Event object |
| * @param events Set of events for which to wait |
| * @param ret Set of received events |
| */ |
| #define sys_port_trace_k_event_wait_exit(event, events, ret) |
| |
| /** @} */ /* end of subsys_tracing_apis_event */ |
| |
| /** |
| * @brief System PM Tracing APIs |
| * @defgroup subsys_tracing_apis_pm_system System PM Tracing APIs |
| * @{ |
| */ |
| |
| /** |
| * @brief Trace system suspend call entry. |
| * @param ticks Ticks. |
| */ |
| #define sys_port_trace_pm_system_suspend_enter(ticks) |
| |
| /** |
| * @brief Trace system suspend call exit. |
| * @param ticks Ticks. |
| * @param state PM state. |
| */ |
| #define sys_port_trace_pm_system_suspend_exit(ticks, state) |
| |
| /** @} */ /* end of subsys_tracing_apis_pm_system */ |
| |
| /** |
| * @brief PM Device Runtime Tracing APIs |
| * @defgroup subsys_tracing_apis_pm_device_runtime PM Device Runtime Tracing APIs |
| * @{ |
| */ |
| |
| /** |
| * @brief Trace getting a device call entry. |
| * @param dev Device instance. |
| */ |
| #define sys_port_trace_pm_device_runtime_get_enter(dev) |
| |
| /** |
| * @brief Trace getting a device call exit. |
| * @param dev Device instance. |
| * @param ret Return value. |
| */ |
| #define sys_port_trace_pm_device_runtime_get_exit(dev, ret) |
| |
| /** |
| * @brief Trace putting a device call entry. |
| * @param dev Device instance. |
| */ |
| #define sys_port_trace_pm_device_runtime_put_enter(dev) |
| |
| /** |
| * @brief Trace putting a device call exit. |
| * @param dev Device instance. |
| * @param ret Return value. |
| */ |
| #define sys_port_trace_pm_device_runtime_put_exit(dev, ret) |
| |
| /** |
| * @brief Trace putting a device (asynchronously) call entry. |
| * @param dev Device instance. |
| */ |
| #define sys_port_trace_pm_device_runtime_put_async_enter(dev) |
| |
| /** |
| * @brief Trace putting a device (asynchronously) call exit. |
| * @param dev Device instance. |
| * @param ret Return value. |
| */ |
| #define sys_port_trace_pm_device_runtime_put_async_exit(dev, ret) |
| |
| /** |
| * @brief Trace enabling device runtime PM call entry. |
| * @param dev Device instance. |
| */ |
| #define sys_port_trace_pm_device_runtime_enable_enter(dev) |
| |
| /** |
| * @brief Trace enabling device runtime PM call exit. |
| * @param dev Device instance. |
| * @param ret Return value. |
| */ |
| #define sys_port_trace_pm_device_runtime_enable_exit(dev, ret) |
| |
| /** |
| * @brief Trace disabling device runtime PM call entry. |
| * @param dev Device instance. |
| */ |
| #define sys_port_trace_pm_device_runtime_disable_enter(dev) |
| |
| /** |
| * @brief Trace disabling device runtime PM call exit. |
| * @param dev Device instance. |
| * @param ret Return value. |
| */ |
| #define sys_port_trace_pm_device_runtime_disable_exit(dev, ret) |
| |
| /** @} */ /* end of subsys_tracing_apis_pm_device_runtime */ |
| |
| #if defined(CONFIG_PERCEPIO_TRACERECORDER) |
| #include "tracing_tracerecorder.h" |
| #else |
| /** |
| * @brief Called when entering an ISR |
| */ |
| void sys_trace_isr_enter(void); |
| |
| /** |
| * @brief Called when exiting an ISR |
| */ |
| void sys_trace_isr_exit(void); |
| |
| /** |
| * @brief Called when exiting an ISR and switching to scheduler |
| */ |
| void sys_trace_isr_exit_to_scheduler(void); |
| |
| /** |
| * @brief Called when the cpu enters the idle state |
| */ |
| void sys_trace_idle(void); |
| #endif /* CONFIG_PERCEPIO_TRACERECORDER */ |
| |
| /** @} */ /* end of subsys_tracing_apis */ |
| |
| /** @} */ /* end of subsys_tracing */ |
| |
| #endif |
| #endif /* ZEPHYR_INCLUDE_TRACING_TRACING_H_ */ |
