Line data Source code
1 0 : /*
2 : * Copyright (c) 2018 Intel Corporation
3 : *
4 : * SPDX-License-Identifier: Apache-2.0
5 : */
6 : #ifndef ZEPHYR_INCLUDE_TRACING_TRACING_H_
7 : #define ZEPHYR_INCLUDE_TRACING_TRACING_H_
8 :
9 : #include "tracking.h"
10 :
11 : #if defined CONFIG_SEGGER_SYSTEMVIEW
12 : #include "tracing_sysview.h"
13 : #elif defined CONFIG_TRACING_CTF
14 : #include "tracing_ctf.h"
15 : #elif defined CONFIG_TRACING_TEST
16 : #include "tracing_test.h"
17 : #elif defined CONFIG_TRACING_USER
18 : #include "tracing_user.h"
19 : #else
20 : /**
21 : * @brief Tracing
22 : *
23 : * The tracing subsystem provides hooks that permits you to collect data from
24 : * your application and allows tools running on a host to visualize the
25 : * inner-working of the kernel and various other subsystems.
26 : *
27 : * @defgroup subsys_tracing Tracing
28 : * @ingroup os_services
29 : * @{
30 : */
31 :
32 : /**
33 : * @brief Tracing APIs
34 : * @defgroup subsys_tracing_apis Tracing APIs
35 : * @{
36 : */
37 :
38 : /**
39 : * @brief Thread Tracing APIs
40 : * @defgroup subsys_tracing_apis_thread Thread Tracing APIs
41 : * @{
42 : */
43 :
44 : /**
45 : * @brief Called when entering a k_thread_foreach call
46 : */
47 1 : #define sys_port_trace_k_thread_foreach_enter()
48 :
49 : /**
50 : * @brief Called when exiting a k_thread_foreach call
51 : */
52 1 : #define sys_port_trace_k_thread_foreach_exit()
53 :
54 : /**
55 : * @brief Called when entering a k_thread_foreach_unlocked
56 : */
57 1 : #define sys_port_trace_k_thread_foreach_unlocked_enter()
58 :
59 : /**
60 : * @brief Called when exiting a k_thread_foreach_unlocked
61 : */
62 1 : #define sys_port_trace_k_thread_foreach_unlocked_exit()
63 :
64 : /**
65 : * @brief Trace creating a Thread
66 : * @param new_thread Thread object
67 : */
68 1 : #define sys_port_trace_k_thread_create(new_thread)
69 :
70 : /**
71 : * @brief Trace Thread entering user mode
72 : */
73 1 : #define sys_port_trace_k_thread_user_mode_enter()
74 :
75 : /**
76 : * @brief Called when entering a k_thread_join
77 : * @param thread Thread object
78 : * @param timeout Timeout period
79 : */
80 1 : #define sys_port_trace_k_thread_join_enter(thread, timeout)
81 :
82 : /**
83 : * @brief Called when k_thread_join blocks
84 : * @param thread Thread object
85 : * @param timeout Timeout period
86 : */
87 1 : #define sys_port_trace_k_thread_join_blocking(thread, timeout)
88 :
89 : /**
90 : * @brief Called when exiting k_thread_join
91 : * @param thread Thread object
92 : * @param timeout Timeout period
93 : * @param ret Return value
94 : */
95 1 : #define sys_port_trace_k_thread_join_exit(thread, timeout, ret)
96 :
97 : /**
98 : * @brief Called when entering k_thread_sleep
99 : * @param timeout Timeout period
100 : */
101 1 : #define sys_port_trace_k_thread_sleep_enter(timeout)
102 :
103 : /**
104 : * @brief Called when exiting k_thread_sleep
105 : * @param timeout Timeout period
106 : * @param ret Return value
107 : */
108 1 : #define sys_port_trace_k_thread_sleep_exit(timeout, ret)
109 :
110 : /**
111 : * @brief Called when entering k_thread_msleep
112 : * @param ms Duration in milliseconds
113 : */
114 1 : #define sys_port_trace_k_thread_msleep_enter(ms)
115 :
116 : /**
117 : * @brief Called when exiting k_thread_msleep
118 : * @param ms Duration in milliseconds
119 : * @param ret Return value
120 : */
121 1 : #define sys_port_trace_k_thread_msleep_exit(ms, ret)
122 :
123 : /**
124 : * @brief Called when entering k_thread_usleep
125 : * @param us Duration in microseconds
126 : */
127 1 : #define sys_port_trace_k_thread_usleep_enter(us)
128 :
129 : /**
130 : * @brief Called when exiting k_thread_usleep
131 : * @param us Duration in microseconds
132 : * @param ret Return value
133 : */
134 1 : #define sys_port_trace_k_thread_usleep_exit(us, ret)
135 :
136 : /**
137 : * @brief Called when entering k_thread_busy_wait
138 : * @param usec_to_wait Duration in microseconds
139 : */
140 1 : #define sys_port_trace_k_thread_busy_wait_enter(usec_to_wait)
141 :
142 : /**
143 : * @brief Called when exiting k_thread_busy_wait
144 : * @param usec_to_wait Duration in microseconds
145 : */
146 1 : #define sys_port_trace_k_thread_busy_wait_exit(usec_to_wait)
147 :
148 : /**
149 : * @brief Called when a thread yields
150 : */
151 1 : #define sys_port_trace_k_thread_yield()
152 :
153 : /**
154 : * @brief Called when a thread wakes up
155 : * @param thread Thread object
156 : */
157 1 : #define sys_port_trace_k_thread_wakeup(thread)
158 :
159 : /**
160 : * @brief Called when a thread is started
161 : * @param thread Thread object
162 : */
163 1 : #define sys_port_trace_k_thread_start(thread)
164 :
165 : /**
166 : * @brief Called when a thread is being aborted
167 : * @param thread Thread object
168 : */
169 1 : #define sys_port_trace_k_thread_abort(thread)
170 :
171 : /**
172 : * @brief Called when a thread enters the k_thread_abort routine
173 : * @param thread Thread object
174 : */
175 1 : #define sys_port_trace_k_thread_abort_enter(thread)
176 :
177 : /**
178 : * @brief Called when a thread exits the k_thread_abort routine
179 : * @param thread Thread object
180 : */
181 1 : #define sys_port_trace_k_thread_abort_exit(thread)
182 :
183 : /**
184 : * @brief Called when setting priority of a thread
185 : * @param thread Thread object
186 : */
187 1 : #define sys_port_trace_k_thread_priority_set(thread)
188 :
189 : /**
190 : * @brief Called when a thread enters the k_thread_suspend
191 : * function.
192 : * @param thread Thread object
193 : */
194 1 : #define sys_port_trace_k_thread_suspend_enter(thread)
195 :
196 : /**
197 : * @brief Called when a thread exits the k_thread_suspend
198 : * function.
199 : * @param thread Thread object
200 : */
201 1 : #define sys_port_trace_k_thread_suspend_exit(thread)
202 :
203 : /**
204 : * @brief Called when a thread enters the resume from suspension
205 : * function.
206 : * @param thread Thread object
207 : */
208 1 : #define sys_port_trace_k_thread_resume_enter(thread)
209 :
210 : /**
211 : * @brief Called when a thread exits the resumed from suspension
212 : * function.
213 : * @param thread Thread object
214 : */
215 1 : #define sys_port_trace_k_thread_resume_exit(thread)
216 :
217 : /**
218 : * @brief Called when the thread scheduler is locked
219 : */
220 1 : #define sys_port_trace_k_thread_sched_lock()
221 :
222 : /**
223 : * @brief Called when the thread scheduler is unlocked
224 : */
225 1 : #define sys_port_trace_k_thread_sched_unlock()
226 :
227 : /**
228 : * @brief Called when a thread name is set
229 : * @param thread Thread object
230 : * @param ret Return value
231 : */
232 1 : #define sys_port_trace_k_thread_name_set(thread, ret)
233 :
234 : /**
235 : * @brief Called before a thread has been selected to run
236 : */
237 1 : #define sys_port_trace_k_thread_switched_out()
238 :
239 : /**
240 : * @brief Called after a thread has been selected to run
241 : */
242 1 : #define sys_port_trace_k_thread_switched_in()
243 :
244 : /**
245 : * @brief Called when a thread is ready to run
246 : * @param thread Thread object
247 : */
248 1 : #define sys_port_trace_k_thread_ready(thread)
249 :
250 : /**
251 : * @brief Called when a thread is pending
252 : * @param thread Thread object
253 : */
254 1 : #define sys_port_trace_k_thread_pend(thread)
255 :
256 : /**
257 : * @brief Provide information about specific thread
258 : * @param thread Thread object
259 : */
260 1 : #define sys_port_trace_k_thread_info(thread)
261 :
262 : /**
263 : * @brief Trace implicit thread wakeup invocation by the scheduler
264 : * @param thread Thread object
265 : */
266 1 : #define sys_port_trace_k_thread_sched_wakeup(thread)
267 :
268 : /**
269 : * @brief Trace implicit thread abort invocation by the scheduler
270 : * @param thread Thread object
271 : */
272 1 : #define sys_port_trace_k_thread_sched_abort(thread)
273 :
274 : /**
275 : * @brief Trace implicit thread set priority invocation by the scheduler
276 : * @param thread Thread object
277 : * @param prio Thread priority
278 : */
279 1 : #define sys_port_trace_k_thread_sched_priority_set(thread, prio)
280 :
281 : /**
282 : * @brief Trace implicit thread ready invocation by the scheduler
283 : * @param thread Thread object
284 : */
285 1 : #define sys_port_trace_k_thread_sched_ready(thread)
286 :
287 : /**
288 : * @brief Trace implicit thread pend invocation by the scheduler
289 : * @param thread Thread object
290 : */
291 1 : #define sys_port_trace_k_thread_sched_pend(thread)
292 :
293 : /**
294 : * @brief Trace implicit thread resume invocation by the scheduler
295 : * @param thread Thread object
296 : */
297 1 : #define sys_port_trace_k_thread_sched_resume(thread)
298 :
299 : /**
300 : * @brief Trace implicit thread suspend invocation by the scheduler
301 : * @param thread Thread object
302 : */
303 1 : #define sys_port_trace_k_thread_sched_suspend(thread)
304 :
305 : /** @}c*/ /* end of subsys_tracing_apis_thread */
306 :
307 : /**
308 : * @brief Work Tracing APIs
309 : * @defgroup subsys_tracing_apis_work Work Tracing APIs
310 : * @{
311 : */
312 :
313 : /**
314 : * @brief Trace initialisation of a Work structure
315 : * @param work Work structure
316 : */
317 1 : #define sys_port_trace_k_work_init(work)
318 :
319 : /**
320 : * @brief Trace submit work to work queue call entry
321 : * @param queue Work queue structure
322 : * @param work Work structure
323 : */
324 1 : #define sys_port_trace_k_work_submit_to_queue_enter(queue, work)
325 :
326 : /**
327 : * @brief Trace submit work to work queue call exit
328 : * @param queue Work queue structure
329 : * @param work Work structure
330 : * @param ret Return value
331 : */
332 1 : #define sys_port_trace_k_work_submit_to_queue_exit(queue, work, ret)
333 :
334 : /**
335 : * @brief Trace submit work to system work queue call entry
336 : * @param work Work structure
337 : */
338 1 : #define sys_port_trace_k_work_submit_enter(work)
339 :
340 : /**
341 : * @brief Trace submit work to system work queue call exit
342 : * @param work Work structure
343 : * @param ret Return value
344 : */
345 1 : #define sys_port_trace_k_work_submit_exit(work, ret)
346 :
347 : /**
348 : * @brief Trace flush work call entry
349 : * @param work Work structure
350 : */
351 1 : #define sys_port_trace_k_work_flush_enter(work)
352 :
353 : /**
354 : * @brief Trace flush work call blocking
355 : * @param work Work structure
356 : * @param timeout Timeout period
357 : */
358 1 : #define sys_port_trace_k_work_flush_blocking(work, timeout)
359 :
360 : /**
361 : * @brief Trace flush work call exit
362 : * @param work Work structure
363 : * @param ret Return value
364 : */
365 1 : #define sys_port_trace_k_work_flush_exit(work, ret)
366 :
367 : /**
368 : * @brief Trace cancel work call entry
369 : * @param work Work structure
370 : */
371 1 : #define sys_port_trace_k_work_cancel_enter(work)
372 :
373 : /**
374 : * @brief Trace cancel work call exit
375 : * @param work Work structure
376 : * @param ret Return value
377 : */
378 1 : #define sys_port_trace_k_work_cancel_exit(work, ret)
379 :
380 : /**
381 : * @brief Trace cancel sync work call entry
382 : * @param work Work structure
383 : * @param sync Sync object
384 : */
385 1 : #define sys_port_trace_k_work_cancel_sync_enter(work, sync)
386 :
387 : /**
388 : * @brief Trace cancel sync work call blocking
389 : * @param work Work structure
390 : * @param sync Sync object
391 : */
392 1 : #define sys_port_trace_k_work_cancel_sync_blocking(work, sync)
393 :
394 : /**
395 : * @brief Trace cancel sync work call exit
396 : * @param work Work structure
397 : * @param sync Sync object
398 : * @param ret Return value
399 : */
400 1 : #define sys_port_trace_k_work_cancel_sync_exit(work, sync, ret)
401 :
402 : /** @} */ /* end of subsys_tracing_apis_work */
403 :
404 : /**
405 : * @brief Work Queue Tracing APIs
406 : * @defgroup subsys_tracing_apis_work_q Work Queue Tracing APIs
407 : * @{
408 : */
409 :
410 : /**
411 : * @brief Trace initialisation of a Work Queue structure
412 : * @param queue Work Queue structure
413 : */
414 1 : #define sys_port_trace_k_work_queue_init(queue)
415 :
416 : /**
417 : * @brief Trace start of a Work Queue call entry
418 : * @param queue Work Queue structure
419 : */
420 1 : #define sys_port_trace_k_work_queue_start_enter(queue)
421 :
422 : /**
423 : * @brief Trace start of a Work Queue call exit
424 : * @param queue Work Queue structure
425 : */
426 1 : #define sys_port_trace_k_work_queue_start_exit(queue)
427 :
428 : /**
429 : * @brief Trace stop of a Work Queue call entry
430 : * @param queue Work Queue structure
431 : * @param timeout Timeout period
432 : */
433 1 : #define sys_port_trace_k_work_queue_stop_enter(queue, timeout)
434 :
435 : /**
436 : * @brief Trace stop of a Work Queue call blocking
437 : * @param queue Work Queue structure
438 : * @param timeout Timeout period
439 : */
440 1 : #define sys_port_trace_k_work_queue_stop_blocking(queue, timeout)
441 :
442 : /**
443 : * @brief Trace stop of a Work Queue call exit
444 : * @param queue Work Queue structure
445 : * @param timeout Timeout period
446 : * @param ret Return value
447 : */
448 1 : #define sys_port_trace_k_work_queue_stop_exit(queue, timeout, ret)
449 :
450 : /**
451 : * @brief Trace Work Queue drain call entry
452 : * @param queue Work Queue structure
453 : */
454 1 : #define sys_port_trace_k_work_queue_drain_enter(queue)
455 :
456 : /**
457 : * @brief Trace Work Queue drain call exit
458 : * @param queue Work Queue structure
459 : * @param ret Return value
460 : */
461 1 : #define sys_port_trace_k_work_queue_drain_exit(queue, ret)
462 :
463 : /**
464 : * @brief Trace Work Queue unplug call entry
465 : * @param queue Work Queue structure
466 : */
467 1 : #define sys_port_trace_k_work_queue_unplug_enter(queue)
468 :
469 : /**
470 : * @brief Trace Work Queue unplug call exit
471 : * @param queue Work Queue structure
472 : * @param ret Return value
473 : */
474 1 : #define sys_port_trace_k_work_queue_unplug_exit(queue, ret)
475 :
476 : /** @} */ /* end of subsys_tracing_apis_work_q */
477 :
478 : /**
479 : * @brief Work Delayable Tracing APIs
480 : * @defgroup subsys_tracing_apis_work_delayable Work Delayable Tracing APIs
481 : * @{
482 : */
483 :
484 : /**
485 : * @brief Trace initialisation of a Delayable Work structure
486 : * @param dwork Delayable Work structure
487 : */
488 1 : #define sys_port_trace_k_work_delayable_init(dwork)
489 :
490 : /**
491 : * @brief Trace schedule delayable work for queue enter
492 : * @param queue Work Queue structure
493 : * @param dwork Delayable Work structure
494 : * @param delay Delay period
495 : */
496 1 : #define sys_port_trace_k_work_schedule_for_queue_enter(queue, dwork, delay)
497 :
498 : /**
499 : * @brief Trace schedule delayable work for queue exit
500 : * @param queue Work Queue structure
501 : * @param dwork Delayable Work structure
502 : * @param delay Delay period
503 : * @param ret Return value
504 : */
505 1 : #define sys_port_trace_k_work_schedule_for_queue_exit(queue, dwork, delay, ret)
506 :
507 : /**
508 : * @brief Trace schedule delayable work for system work queue enter
509 : * @param dwork Delayable Work structure
510 : * @param delay Delay period
511 : */
512 1 : #define sys_port_trace_k_work_schedule_enter(dwork, delay)
513 :
514 : /**
515 : * @brief Trace schedule delayable work for system work queue exit
516 : * @param dwork Delayable Work structure
517 : * @param delay Delay period
518 : * @param ret Return value
519 : */
520 1 : #define sys_port_trace_k_work_schedule_exit(dwork, delay, ret)
521 :
522 : /**
523 : * @brief Trace reschedule delayable work for queue enter
524 : * @param queue Work Queue structure
525 : * @param dwork Delayable Work structure
526 : * @param delay Delay period
527 : */
528 1 : #define sys_port_trace_k_work_reschedule_for_queue_enter(queue, dwork, delay)
529 :
530 : /**
531 : * @brief Trace reschedule delayable work for queue exit
532 : * @param queue Work Queue structure
533 : * @param dwork Delayable Work structure
534 : * @param delay Delay period
535 : * @param ret Return value
536 : */
537 1 : #define sys_port_trace_k_work_reschedule_for_queue_exit(queue, dwork, delay, ret)
538 :
539 : /**
540 : * @brief Trace reschedule delayable work for system queue enter
541 : * @param dwork Delayable Work structure
542 : * @param delay Delay period
543 : */
544 1 : #define sys_port_trace_k_work_reschedule_enter(dwork, delay)
545 :
546 : /**
547 : * @brief Trace reschedule delayable work for system queue exit
548 : * @param dwork Delayable Work structure
549 : * @param delay Delay period
550 : * @param ret Return value
551 : */
552 1 : #define sys_port_trace_k_work_reschedule_exit(dwork, delay, ret)
553 :
554 : /**
555 : * @brief Trace delayable work flush enter
556 : * @param dwork Delayable Work structure
557 : * @param sync Sync object
558 : */
559 1 : #define sys_port_trace_k_work_flush_delayable_enter(dwork, sync)
560 :
561 : /**
562 : * @brief Trace delayable work flush exit
563 : * @param dwork Delayable Work structure
564 : * @param sync Sync object
565 : * @param ret Return value
566 : */
567 1 : #define sys_port_trace_k_work_flush_delayable_exit(dwork, sync, ret)
568 :
569 : /**
570 : * @brief Trace delayable work cancel enter
571 : * @param dwork Delayable Work structure
572 : */
573 1 : #define sys_port_trace_k_work_cancel_delayable_enter(dwork)
574 :
575 : /**
576 : * @brief Trace delayable work cancel enter
577 : * @param dwork Delayable Work structure
578 : * @param ret Return value
579 : */
580 1 : #define sys_port_trace_k_work_cancel_delayable_exit(dwork, ret)
581 :
582 : /**
583 : * @brief Trace delayable work cancel sync enter
584 : * @param dwork Delayable Work structure
585 : * @param sync Sync object
586 : */
587 1 : #define sys_port_trace_k_work_cancel_delayable_sync_enter(dwork, sync)
588 :
589 : /**
590 : * @brief Trace delayable work cancel sync enter
591 : * @param dwork Delayable Work structure
592 : * @param sync Sync object
593 : * @param ret Return value
594 : */
595 1 : #define sys_port_trace_k_work_cancel_delayable_sync_exit(dwork, sync, ret)
596 :
597 : /** @} */ /* end of subsys_tracing_apis_work_delayable */
598 :
599 : /**
600 : * @brief Work Poll Tracing APIs
601 : * @defgroup subsys_tracing_apis_work_poll Work Poll Tracing APIs
602 : * @{
603 : */
604 :
605 : /**
606 : * @brief Trace initialisation of a Work Poll structure enter
607 : * @param work Work structure
608 : */
609 1 : #define sys_port_trace_k_work_poll_init_enter(work)
610 :
611 : /**
612 : * @brief Trace initialisation of a Work Poll structure exit
613 : * @param work Work structure
614 : */
615 1 : #define sys_port_trace_k_work_poll_init_exit(work)
616 :
617 : /**
618 : * @brief Trace work poll submit to queue enter
619 : * @param work_q Work queue
620 : * @param work Work structure
621 : * @param timeout Timeout period
622 : */
623 1 : #define sys_port_trace_k_work_poll_submit_to_queue_enter(work_q, work, timeout)
624 :
625 : /**
626 : * @brief Trace work poll submit to queue blocking
627 : * @param work_q Work queue
628 : * @param work Work structure
629 : * @param timeout Timeout period
630 : */
631 1 : #define sys_port_trace_k_work_poll_submit_to_queue_blocking(work_q, work, timeout)
632 :
633 : /**
634 : * @brief Trace work poll submit to queue exit
635 : * @param work_q Work queue
636 : * @param work Work structure
637 : * @param timeout Timeout period
638 : * @param ret Return value
639 : */
640 1 : #define sys_port_trace_k_work_poll_submit_to_queue_exit(work_q, work, timeout, ret)
641 :
642 : /**
643 : * @brief Trace work poll submit to system queue enter
644 : * @param work Work structure
645 : * @param timeout Timeout period
646 : */
647 1 : #define sys_port_trace_k_work_poll_submit_enter(work, timeout)
648 :
649 : /**
650 : * @brief Trace work poll submit to system queue exit
651 : * @param work Work structure
652 : * @param timeout Timeout period
653 : * @param ret Return value
654 : */
655 1 : #define sys_port_trace_k_work_poll_submit_exit(work, timeout, ret)
656 :
657 : /**
658 : * @brief Trace work poll cancel enter
659 : * @param work Work structure
660 : */
661 1 : #define sys_port_trace_k_work_poll_cancel_enter(work)
662 :
663 : /**
664 : * @brief Trace work poll cancel exit
665 : * @param work Work structure
666 : * @param ret Return value
667 : */
668 1 : #define sys_port_trace_k_work_poll_cancel_exit(work, ret)
669 :
670 : /** @} */ /* end of subsys_tracing_apis_work_poll */
671 :
672 : /**
673 : * @brief Poll Tracing APIs
674 : * @defgroup subsys_tracing_apis_poll Poll Tracing APIs
675 : * @{
676 : */
677 :
678 : /**
679 : * @brief Trace initialisation of a Poll Event
680 : * @param event Poll Event
681 : */
682 1 : #define sys_port_trace_k_poll_api_event_init(event)
683 :
684 : /**
685 : * @brief Trace Polling call start
686 : * @param events Poll Events
687 : */
688 1 : #define sys_port_trace_k_poll_api_poll_enter(events)
689 :
690 : /**
691 : * @brief Trace Polling call outcome
692 : * @param events Poll Events
693 : * @param ret Return value
694 : */
695 1 : #define sys_port_trace_k_poll_api_poll_exit(events, ret)
696 :
697 : /**
698 : * @brief Trace initialisation of a Poll Signal
699 : * @param signal Poll Signal
700 : */
701 1 : #define sys_port_trace_k_poll_api_signal_init(signal)
702 :
703 : /**
704 : * @brief Trace resetting of Poll Signal
705 : * @param signal Poll Signal
706 : */
707 1 : #define sys_port_trace_k_poll_api_signal_reset(signal)
708 :
709 : /**
710 : * @brief Trace checking of Poll Signal
711 : * @param signal Poll Signal
712 : */
713 1 : #define sys_port_trace_k_poll_api_signal_check(signal)
714 :
715 : /**
716 : * @brief Trace raising of Poll Signal
717 : * @param signal Poll Signal
718 : * @param ret Return value
719 : */
720 1 : #define sys_port_trace_k_poll_api_signal_raise(signal, ret)
721 :
722 : /** @} */ /* end of subsys_tracing_apis_poll */
723 :
724 : /**
725 : * @brief Semaphore Tracing APIs
726 : * @defgroup subsys_tracing_apis_sem Semaphore Tracing APIs
727 : * @{
728 : */
729 :
730 : /**
731 : * @brief Trace initialisation of a Semaphore
732 : * @param sem Semaphore object
733 : * @param ret Return value
734 : */
735 1 : #define sys_port_trace_k_sem_init(sem, ret)
736 :
737 : /**
738 : * @brief Trace giving a Semaphore entry
739 : * @param sem Semaphore object
740 : */
741 1 : #define sys_port_trace_k_sem_give_enter(sem)
742 :
743 : /**
744 : * @brief Trace giving a Semaphore exit
745 : * @param sem Semaphore object
746 : */
747 1 : #define sys_port_trace_k_sem_give_exit(sem)
748 :
749 : /**
750 : * @brief Trace taking a Semaphore attempt start
751 : * @param sem Semaphore object
752 : * @param timeout Timeout period
753 : */
754 1 : #define sys_port_trace_k_sem_take_enter(sem, timeout)
755 :
756 : /**
757 : * @brief Trace taking a Semaphore attempt blocking
758 : * @param sem Semaphore object
759 : * @param timeout Timeout period
760 : */
761 1 : #define sys_port_trace_k_sem_take_blocking(sem, timeout)
762 :
763 : /**
764 : * @brief Trace taking a Semaphore attempt outcome
765 : * @param sem Semaphore object
766 : * @param timeout Timeout period
767 : * @param ret Return value
768 : */
769 1 : #define sys_port_trace_k_sem_take_exit(sem, timeout, ret)
770 :
771 : /**
772 : * @brief Trace resetting a Semaphore
773 : * @param sem Semaphore object
774 : */
775 1 : #define sys_port_trace_k_sem_reset(sem)
776 :
777 : /** @} */ /* end of subsys_tracing_apis_sem */
778 :
779 : /**
780 : * @brief Mutex Tracing APIs
781 : * @defgroup subsys_tracing_apis_mutex Mutex Tracing APIs
782 : * @{
783 : */
784 :
785 : /**
786 : * @brief Trace initialization of Mutex
787 : * @param mutex Mutex object
788 : * @param ret Return value
789 : */
790 1 : #define sys_port_trace_k_mutex_init(mutex, ret)
791 :
792 : /**
793 : * @brief Trace Mutex lock attempt start
794 : * @param mutex Mutex object
795 : * @param timeout Timeout period
796 : */
797 1 : #define sys_port_trace_k_mutex_lock_enter(mutex, timeout)
798 :
799 : /**
800 : * @brief Trace Mutex lock attempt blocking
801 : * @param mutex Mutex object
802 : * @param timeout Timeout period
803 : */
804 1 : #define sys_port_trace_k_mutex_lock_blocking(mutex, timeout)
805 :
806 : /**
807 : * @brief Trace Mutex lock attempt outcome
808 : * @param mutex Mutex object
809 : * @param timeout Timeout period
810 : * @param ret Return value
811 : */
812 1 : #define sys_port_trace_k_mutex_lock_exit(mutex, timeout, ret)
813 :
814 : /**
815 : * @brief Trace Mutex unlock entry
816 : * @param mutex Mutex object
817 : */
818 1 : #define sys_port_trace_k_mutex_unlock_enter(mutex)
819 :
820 : /**
821 : * @brief Trace Mutex unlock exit
822 : */
823 1 : #define sys_port_trace_k_mutex_unlock_exit(mutex, ret)
824 :
825 : /** @} */ /* end of subsys_tracing_apis_mutex */
826 :
827 : /**
828 : * @brief Conditional Variable Tracing APIs
829 : * @defgroup subsys_tracing_apis_condvar Conditional Variable Tracing APIs
830 : * @{
831 : */
832 :
833 : /**
834 : * @brief Trace initialization of Conditional Variable
835 : * @param condvar Conditional Variable object
836 : * @param ret Return value
837 : */
838 1 : #define sys_port_trace_k_condvar_init(condvar, ret)
839 :
840 : /**
841 : * @brief Trace Conditional Variable signaling start
842 : * @param condvar Conditional Variable object
843 : */
844 1 : #define sys_port_trace_k_condvar_signal_enter(condvar)
845 :
846 : /**
847 : * @brief Trace Conditional Variable signaling blocking
848 : * @param condvar Conditional Variable object
849 : * @param timeout Timeout period
850 : */
851 1 : #define sys_port_trace_k_condvar_signal_blocking(condvar, timeout)
852 :
853 : /**
854 : * @brief Trace Conditional Variable signaling outcome
855 : * @param condvar Conditional Variable object
856 : * @param ret Return value
857 : */
858 1 : #define sys_port_trace_k_condvar_signal_exit(condvar, ret)
859 :
860 : /**
861 : * @brief Trace Conditional Variable broadcast enter
862 : * @param condvar Conditional Variable object
863 : */
864 1 : #define sys_port_trace_k_condvar_broadcast_enter(condvar)
865 :
866 : /**
867 : * @brief Trace Conditional Variable broadcast exit
868 : * @param condvar Conditional Variable object
869 : * @param ret Return value
870 : */
871 1 : #define sys_port_trace_k_condvar_broadcast_exit(condvar, ret)
872 :
873 : /**
874 : * @brief Trace Conditional Variable wait enter
875 : * @param condvar Conditional Variable object
876 : */
877 1 : #define sys_port_trace_k_condvar_wait_enter(condvar)
878 :
879 : /**
880 : * @brief Trace Conditional Variable wait exit
881 : * @param condvar Conditional Variable object
882 : * @param ret Return value
883 : */
884 1 : #define sys_port_trace_k_condvar_wait_exit(condvar, ret)
885 :
886 : /** @} */ /* end of subsys_tracing_apis_condvar */
887 :
888 : /**
889 : * @brief Queue Tracing APIs
890 : * @defgroup subsys_tracing_apis_queue Queue Tracing APIs
891 : * @{
892 : */
893 :
894 : /**
895 : * @brief Trace initialization of Queue
896 : * @param queue Queue object
897 : */
898 1 : #define sys_port_trace_k_queue_init(queue)
899 :
900 : /**
901 : * @brief Trace Queue cancel wait
902 : * @param queue Queue object
903 : */
904 1 : #define sys_port_trace_k_queue_cancel_wait(queue)
905 :
906 : /**
907 : * @brief Trace Queue insert attempt entry
908 : * @param queue Queue object
909 : * @param alloc Allocation flag
910 : */
911 1 : #define sys_port_trace_k_queue_queue_insert_enter(queue, alloc)
912 :
913 : /**
914 : * @brief Trace Queue insert attempt blocking
915 : * @param queue Queue object
916 : * @param alloc Allocation flag
917 : * @param timeout Timeout period
918 : */
919 1 : #define sys_port_trace_k_queue_queue_insert_blocking(queue, alloc, timeout)
920 :
921 : /**
922 : * @brief Trace Queue insert attempt outcome
923 : * @param queue Queue object
924 : * @param alloc Allocation flag
925 : * @param ret Return value
926 : */
927 1 : #define sys_port_trace_k_queue_queue_insert_exit(queue, alloc, ret)
928 :
929 : /**
930 : * @brief Trace Queue append enter
931 : * @param queue Queue object
932 : */
933 1 : #define sys_port_trace_k_queue_append_enter(queue)
934 :
935 : /**
936 : * @brief Trace Queue append exit
937 : * @param queue Queue object
938 : */
939 1 : #define sys_port_trace_k_queue_append_exit(queue)
940 :
941 : /**
942 : * @brief Trace Queue alloc append enter
943 : * @param queue Queue object
944 : */
945 1 : #define sys_port_trace_k_queue_alloc_append_enter(queue)
946 :
947 : /**
948 : * @brief Trace Queue alloc append exit
949 : * @param queue Queue object
950 : * @param ret Return value
951 : */
952 1 : #define sys_port_trace_k_queue_alloc_append_exit(queue, ret)
953 :
954 : /**
955 : * @brief Trace Queue prepend enter
956 : * @param queue Queue object
957 : */
958 1 : #define sys_port_trace_k_queue_prepend_enter(queue)
959 :
960 : /**
961 : * @brief Trace Queue prepend exit
962 : * @param queue Queue object
963 : */
964 1 : #define sys_port_trace_k_queue_prepend_exit(queue)
965 :
966 : /**
967 : * @brief Trace Queue alloc prepend enter
968 : * @param queue Queue object
969 : */
970 1 : #define sys_port_trace_k_queue_alloc_prepend_enter(queue)
971 :
972 : /**
973 : * @brief Trace Queue alloc prepend exit
974 : * @param queue Queue object
975 : * @param ret Return value
976 : */
977 1 : #define sys_port_trace_k_queue_alloc_prepend_exit(queue, ret)
978 :
979 : /**
980 : * @brief Trace Queue insert attempt entry
981 : * @param queue Queue object
982 : */
983 1 : #define sys_port_trace_k_queue_insert_enter(queue)
984 :
985 : /**
986 : * @brief Trace Queue insert attempt blocking
987 : * @param queue Queue object
988 : * @param timeout Timeout period
989 : */
990 1 : #define sys_port_trace_k_queue_insert_blocking(queue, timeout)
991 :
992 : /**
993 : * @brief Trace Queue insert attempt exit
994 : * @param queue Queue object
995 : */
996 1 : #define sys_port_trace_k_queue_insert_exit(queue)
997 :
998 : /**
999 : * @brief Trace Queue append list enter
1000 : * @param queue Queue object
1001 : */
1002 1 : #define sys_port_trace_k_queue_append_list_enter(queue)
1003 :
1004 : /**
1005 : * @brief Trace Queue append list exit
1006 : * @param queue Queue object
1007 : * @param ret Return value
1008 : */
1009 1 : #define sys_port_trace_k_queue_append_list_exit(queue, ret)
1010 :
1011 : /**
1012 : * @brief Trace Queue merge slist enter
1013 : * @param queue Queue object
1014 : */
1015 1 : #define sys_port_trace_k_queue_merge_slist_enter(queue)
1016 :
1017 : /**
1018 : * @brief Trace Queue merge slist exit
1019 : * @param queue Queue object
1020 : * @param ret Return value
1021 : */
1022 1 : #define sys_port_trace_k_queue_merge_slist_exit(queue, ret)
1023 :
1024 : /**
1025 : * @brief Trace Queue get attempt enter
1026 : * @param queue Queue object
1027 : * @param timeout Timeout period
1028 : */
1029 1 : #define sys_port_trace_k_queue_get_enter(queue, timeout)
1030 :
1031 : /**
1032 : * @brief Trace Queue get attempt blockings
1033 : * @param queue Queue object
1034 : * @param timeout Timeout period
1035 : */
1036 1 : #define sys_port_trace_k_queue_get_blocking(queue, timeout)
1037 :
1038 : /**
1039 : * @brief Trace Queue get attempt outcome
1040 : * @param queue Queue object
1041 : * @param timeout Timeout period
1042 : * @param ret Return value
1043 : */
1044 1 : #define sys_port_trace_k_queue_get_exit(queue, timeout, ret)
1045 :
1046 : /**
1047 : * @brief Trace Queue remove enter
1048 : * @param queue Queue object
1049 : */
1050 1 : #define sys_port_trace_k_queue_remove_enter(queue)
1051 :
1052 : /**
1053 : * @brief Trace Queue remove exit
1054 : * @param queue Queue object
1055 : * @param ret Return value
1056 : */
1057 1 : #define sys_port_trace_k_queue_remove_exit(queue, ret)
1058 :
1059 : /**
1060 : * @brief Trace Queue unique append enter
1061 : * @param queue Queue object
1062 : */
1063 1 : #define sys_port_trace_k_queue_unique_append_enter(queue)
1064 :
1065 : /**
1066 : * @brief Trace Queue unique append exit
1067 : * @param queue Queue object
1068 : *
1069 : * @param ret Return value
1070 : */
1071 1 : #define sys_port_trace_k_queue_unique_append_exit(queue, ret)
1072 :
1073 : /**
1074 : * @brief Trace Queue peek head
1075 : * @param queue Queue object
1076 : * @param ret Return value
1077 : */
1078 1 : #define sys_port_trace_k_queue_peek_head(queue, ret)
1079 :
1080 : /**
1081 : * @brief Trace Queue peek tail
1082 : * @param queue Queue object
1083 : * @param ret Return value
1084 : */
1085 1 : #define sys_port_trace_k_queue_peek_tail(queue, ret)
1086 :
1087 : /** @} */ /* end of subsys_tracing_apis_queue */
1088 :
1089 : /**
1090 : * @brief FIFO Tracing APIs
1091 : * @defgroup subsys_tracing_apis_fifo FIFO Tracing APIs
1092 : * @{
1093 : */
1094 :
1095 : /**
1096 : * @brief Trace initialization of FIFO Queue entry
1097 : * @param fifo FIFO object
1098 : */
1099 1 : #define sys_port_trace_k_fifo_init_enter(fifo)
1100 :
1101 : /**
1102 : * @brief Trace initialization of FIFO Queue exit
1103 : * @param fifo FIFO object
1104 : */
1105 1 : #define sys_port_trace_k_fifo_init_exit(fifo)
1106 :
1107 : /**
1108 : * @brief Trace FIFO Queue cancel wait entry
1109 : * @param fifo FIFO object
1110 : */
1111 1 : #define sys_port_trace_k_fifo_cancel_wait_enter(fifo)
1112 :
1113 : /**
1114 : * @brief Trace FIFO Queue cancel wait exit
1115 : * @param fifo FIFO object
1116 : */
1117 1 : #define sys_port_trace_k_fifo_cancel_wait_exit(fifo)
1118 :
1119 : /**
1120 : * @brief Trace FIFO Queue put entry
1121 : * @param fifo FIFO object
1122 : * @param data Data item
1123 : */
1124 1 : #define sys_port_trace_k_fifo_put_enter(fifo, data)
1125 :
1126 : /**
1127 : * @brief Trace FIFO Queue put exit
1128 : * @param fifo FIFO object
1129 : * @param data Data item
1130 : */
1131 1 : #define sys_port_trace_k_fifo_put_exit(fifo, data)
1132 :
1133 : /**
1134 : * @brief Trace FIFO Queue alloc put entry
1135 : * @param fifo FIFO object
1136 : * @param data Data item
1137 : */
1138 1 : #define sys_port_trace_k_fifo_alloc_put_enter(fifo, data)
1139 :
1140 : /**
1141 : * @brief Trace FIFO Queue alloc put exit
1142 : * @param fifo FIFO object
1143 : * @param data Data item
1144 : * @param ret Return value
1145 : */
1146 1 : #define sys_port_trace_k_fifo_alloc_put_exit(fifo, data, ret)
1147 :
1148 : /**
1149 : * @brief Trace FIFO Queue put list entry
1150 : * @param fifo FIFO object
1151 : * @param head First ll-node
1152 : * @param tail Last ll-node
1153 : */
1154 1 : #define sys_port_trace_k_fifo_put_list_enter(fifo, head, tail)
1155 :
1156 : /**
1157 : * @brief Trace FIFO Queue put list exit
1158 : * @param fifo FIFO object
1159 : * @param head First ll-node
1160 : * @param tail Last ll-node
1161 : */
1162 1 : #define sys_port_trace_k_fifo_put_list_exit(fifo, head, tail)
1163 :
1164 : /**
1165 : * @brief Trace FIFO Queue put slist entry
1166 : * @param fifo FIFO object
1167 : * @param list Syslist object
1168 : */
1169 1 : #define sys_port_trace_k_fifo_alloc_put_slist_enter(fifo, list)
1170 :
1171 : /**
1172 : * @brief Trace FIFO Queue put slist exit
1173 : * @param fifo FIFO object
1174 : * @param list Syslist object
1175 : */
1176 1 : #define sys_port_trace_k_fifo_alloc_put_slist_exit(fifo, list)
1177 :
1178 : /**
1179 : * @brief Trace FIFO Queue get entry
1180 : * @param fifo FIFO object
1181 : * @param timeout Timeout period
1182 : */
1183 1 : #define sys_port_trace_k_fifo_get_enter(fifo, timeout)
1184 :
1185 : /**
1186 : * @brief Trace FIFO Queue get exit
1187 : * @param fifo FIFO object
1188 : * @param timeout Timeout period
1189 : * @param ret Return value
1190 : */
1191 1 : #define sys_port_trace_k_fifo_get_exit(fifo, timeout, ret)
1192 :
1193 : /**
1194 : * @brief Trace FIFO Queue peek head entry
1195 : * @param fifo FIFO object
1196 : */
1197 1 : #define sys_port_trace_k_fifo_peek_head_enter(fifo)
1198 :
1199 : /**
1200 : * @brief Trace FIFO Queue peek head exit
1201 : * @param fifo FIFO object
1202 : * @param ret Return value
1203 : */
1204 1 : #define sys_port_trace_k_fifo_peek_head_exit(fifo, ret)
1205 :
1206 : /**
1207 : * @brief Trace FIFO Queue peek tail entry
1208 : * @param fifo FIFO object
1209 : */
1210 1 : #define sys_port_trace_k_fifo_peek_tail_enter(fifo)
1211 :
1212 : /**
1213 : * @brief Trace FIFO Queue peek tail exit
1214 : * @param fifo FIFO object
1215 : * @param ret Return value
1216 : */
1217 1 : #define sys_port_trace_k_fifo_peek_tail_exit(fifo, ret)
1218 :
1219 : /** @} */ /* end of subsys_tracing_apis_fifo */
1220 :
1221 : /**
1222 : * @brief LIFO Tracing APIs
1223 : * @defgroup subsys_tracing_apis_lifo LIFO Tracing APIs
1224 : * @{
1225 : */
1226 :
1227 : /**
1228 : * @brief Trace initialization of LIFO Queue entry
1229 : * @param lifo LIFO object
1230 : */
1231 1 : #define sys_port_trace_k_lifo_init_enter(lifo)
1232 :
1233 : /**
1234 : * @brief Trace initialization of LIFO Queue exit
1235 : * @param lifo LIFO object
1236 : */
1237 1 : #define sys_port_trace_k_lifo_init_exit(lifo)
1238 :
1239 : /**
1240 : * @brief Trace LIFO Queue put entry
1241 : * @param lifo LIFO object
1242 : * @param data Data item
1243 : */
1244 1 : #define sys_port_trace_k_lifo_put_enter(lifo, data)
1245 :
1246 : /**
1247 : * @brief Trace LIFO Queue put exit
1248 : * @param lifo LIFO object
1249 : * @param data Data item
1250 : */
1251 1 : #define sys_port_trace_k_lifo_put_exit(lifo, data)
1252 :
1253 : /**
1254 : * @brief Trace LIFO Queue alloc put entry
1255 : * @param lifo LIFO object
1256 : * @param data Data item
1257 : */
1258 1 : #define sys_port_trace_k_lifo_alloc_put_enter(lifo, data)
1259 :
1260 : /**
1261 : * @brief Trace LIFO Queue alloc put exit
1262 : * @param lifo LIFO object
1263 : * @param data Data item
1264 : * @param ret Return value
1265 : */
1266 1 : #define sys_port_trace_k_lifo_alloc_put_exit(lifo, data, ret)
1267 :
1268 : /**
1269 : * @brief Trace LIFO Queue get entry
1270 : * @param lifo LIFO object
1271 : * @param timeout Timeout period
1272 : */
1273 1 : #define sys_port_trace_k_lifo_get_enter(lifo, timeout)
1274 :
1275 : /**
1276 : * @brief Trace LIFO Queue get exit
1277 : * @param lifo LIFO object
1278 : * @param timeout Timeout period
1279 : * @param ret Return value
1280 : */
1281 1 : #define sys_port_trace_k_lifo_get_exit(lifo, timeout, ret)
1282 :
1283 : /** @} */ /* end of subsys_tracing_apis_lifo */
1284 :
1285 : /**
1286 : * @brief Stack Tracing APIs
1287 : * @defgroup subsys_tracing_apis_stack Stack Tracing APIs
1288 : * @{
1289 : */
1290 :
1291 : /**
1292 : * @brief Trace initialization of Stack
1293 : * @param stack Stack object
1294 : */
1295 1 : #define sys_port_trace_k_stack_init(stack)
1296 :
1297 : /**
1298 : * @brief Trace Stack alloc init attempt entry
1299 : * @param stack Stack object
1300 : */
1301 1 : #define sys_port_trace_k_stack_alloc_init_enter(stack)
1302 :
1303 : /**
1304 : * @brief Trace Stack alloc init outcome
1305 : * @param stack Stack object
1306 : * @param ret Return value
1307 : */
1308 1 : #define sys_port_trace_k_stack_alloc_init_exit(stack, ret)
1309 :
1310 : /**
1311 : * @brief Trace Stack cleanup attempt entry
1312 : * @param stack Stack object
1313 : */
1314 1 : #define sys_port_trace_k_stack_cleanup_enter(stack)
1315 :
1316 : /**
1317 : * @brief Trace Stack cleanup outcome
1318 : * @param stack Stack object
1319 : * @param ret Return value
1320 : */
1321 1 : #define sys_port_trace_k_stack_cleanup_exit(stack, ret)
1322 :
1323 : /**
1324 : * @brief Trace Stack push attempt entry
1325 : * @param stack Stack object
1326 : */
1327 1 : #define sys_port_trace_k_stack_push_enter(stack)
1328 :
1329 : /**
1330 : * @brief Trace Stack push attempt outcome
1331 : * @param stack Stack object
1332 : * @param ret Return value
1333 : */
1334 1 : #define sys_port_trace_k_stack_push_exit(stack, ret)
1335 :
1336 : /**
1337 : * @brief Trace Stack pop attempt entry
1338 : * @param stack Stack object
1339 : * @param timeout Timeout period
1340 : */
1341 1 : #define sys_port_trace_k_stack_pop_enter(stack, timeout)
1342 :
1343 : /**
1344 : * @brief Trace Stack pop attempt blocking
1345 : * @param stack Stack object
1346 : * @param timeout Timeout period
1347 : */
1348 1 : #define sys_port_trace_k_stack_pop_blocking(stack, timeout)
1349 :
1350 : /**
1351 : * @brief Trace Stack pop attempt outcome
1352 : * @param stack Stack object
1353 : * @param timeout Timeout period
1354 : * @param ret Return value
1355 : */
1356 1 : #define sys_port_trace_k_stack_pop_exit(stack, timeout, ret)
1357 :
1358 : /** @} */ /* end of subsys_tracing_apis_stack */
1359 :
1360 : /**
1361 : * @brief Message Queue Tracing APIs
1362 : * @defgroup subsys_tracing_apis_msgq Message Queue Tracing APIs
1363 : * @{
1364 : */
1365 :
1366 : /**
1367 : * @brief Trace initialization of Message Queue
1368 : * @param msgq Message Queue object
1369 : */
1370 1 : #define sys_port_trace_k_msgq_init(msgq)
1371 :
1372 : /**
1373 : * @brief Trace Message Queue alloc init attempt entry
1374 : * @param msgq Message Queue object
1375 : */
1376 1 : #define sys_port_trace_k_msgq_alloc_init_enter(msgq)
1377 :
1378 : /**
1379 : * @brief Trace Message Queue alloc init attempt outcome
1380 : * @param msgq Message Queue object
1381 : * @param ret Return value
1382 : */
1383 1 : #define sys_port_trace_k_msgq_alloc_init_exit(msgq, ret)
1384 :
1385 : /**
1386 : * @brief Trace Message Queue cleanup attempt entry
1387 : * @param msgq Message Queue object
1388 : */
1389 1 : #define sys_port_trace_k_msgq_cleanup_enter(msgq)
1390 :
1391 : /**
1392 : * @brief Trace Message Queue cleanup attempt outcome
1393 : * @param msgq Message Queue object
1394 : * @param ret Return value
1395 : */
1396 1 : #define sys_port_trace_k_msgq_cleanup_exit(msgq, ret)
1397 :
1398 : /**
1399 : * @brief Trace Message Queue put attempt entry
1400 : * @param msgq Message Queue object
1401 : * @param timeout Timeout period
1402 : */
1403 1 : #define sys_port_trace_k_msgq_put_enter(msgq, timeout)
1404 :
1405 : /**
1406 : * @brief Trace Message Queue put attempt blocking
1407 : * @param msgq Message Queue object
1408 : * @param timeout Timeout period
1409 : */
1410 1 : #define sys_port_trace_k_msgq_put_blocking(msgq, timeout)
1411 :
1412 : /**
1413 : * @brief Trace Message Queue put attempt outcome
1414 : * @param msgq Message Queue object
1415 : * @param timeout Timeout period
1416 : * @param ret Return value
1417 : */
1418 1 : #define sys_port_trace_k_msgq_put_exit(msgq, timeout, ret)
1419 :
1420 : /**
1421 : * @brief Trace Message Queue put at front attempt entry
1422 : * @param msgq Message Queue object
1423 : * @param timeout Timeout period
1424 : */
1425 1 : #define sys_port_trace_k_msgq_put_front_enter(msgq, timeout)
1426 :
1427 : /**
1428 : * @brief Trace Message Queue put at front attempt blocking
1429 : * @param msgq Message Queue object
1430 : * @param timeout Timeout period
1431 : */
1432 1 : #define sys_port_trace_k_msgq_put_front_blocking(msgq, timeout)
1433 :
1434 : /**
1435 : * @brief Trace Message Queue put at front attempt outcome
1436 : * @param msgq Message Queue object
1437 : * @param timeout Timeout period
1438 : * @param ret Return value
1439 : */
1440 1 : #define sys_port_trace_k_msgq_put_front_exit(msgq, timeout, ret)
1441 :
1442 : /**
1443 : * @brief Trace Message Queue get attempt entry
1444 : * @param msgq Message Queue object
1445 : * @param timeout Timeout period
1446 : */
1447 1 : #define sys_port_trace_k_msgq_get_enter(msgq, timeout)
1448 :
1449 : /**
1450 : * @brief Trace Message Queue get attempt blockings
1451 : * @param msgq Message Queue object
1452 : * @param timeout Timeout period
1453 : */
1454 1 : #define sys_port_trace_k_msgq_get_blocking(msgq, timeout)
1455 :
1456 : /**
1457 : * @brief Trace Message Queue get attempt outcome
1458 : * @param msgq Message Queue object
1459 : * @param timeout Timeout period
1460 : * @param ret Return value
1461 : */
1462 1 : #define sys_port_trace_k_msgq_get_exit(msgq, timeout, ret)
1463 :
1464 : /**
1465 : * @brief Trace Message Queue peek
1466 : * @param msgq Message Queue object
1467 : * @param ret Return value
1468 : */
1469 1 : #define sys_port_trace_k_msgq_peek(msgq, ret)
1470 :
1471 : /**
1472 : * @brief Trace Message Queue purge
1473 : * @param msgq Message Queue object
1474 : */
1475 1 : #define sys_port_trace_k_msgq_purge(msgq)
1476 :
1477 : /** @} */ /* end of subsys_tracing_apis_msgq */
1478 :
1479 : /**
1480 : * @brief Mailbox Tracing APIs
1481 : * @defgroup subsys_tracing_apis_mbox Mailbox Tracing APIs
1482 : * @{
1483 : */
1484 :
1485 : /**
1486 : * @brief Trace initialization of Mailbox
1487 : * @param mbox Mailbox object
1488 : */
1489 1 : #define sys_port_trace_k_mbox_init(mbox)
1490 :
1491 : /**
1492 : * @brief Trace Mailbox message put attempt entry
1493 : * @param mbox Mailbox object
1494 : * @param timeout Timeout period
1495 : */
1496 1 : #define sys_port_trace_k_mbox_message_put_enter(mbox, timeout)
1497 :
1498 : /**
1499 : * @brief Trace Mailbox message put attempt blocking
1500 : * @param mbox Mailbox object
1501 : * @param timeout Timeout period
1502 : */
1503 1 : #define sys_port_trace_k_mbox_message_put_blocking(mbox, timeout)
1504 :
1505 : /**
1506 : * @brief Trace Mailbox message put attempt outcome
1507 : * @param mbox Mailbox object
1508 : * @param timeout Timeout period
1509 : * @param ret Return value
1510 : */
1511 1 : #define sys_port_trace_k_mbox_message_put_exit(mbox, timeout, ret)
1512 :
1513 : /**
1514 : * @brief Trace Mailbox put attempt entry
1515 : * @param mbox Mailbox object
1516 : * @param timeout Timeout period
1517 : */
1518 1 : #define sys_port_trace_k_mbox_put_enter(mbox, timeout)
1519 :
1520 : /**
1521 : * @brief Trace Mailbox put attempt blocking
1522 : * @param mbox Mailbox object
1523 : * @param timeout Timeout period
1524 : * @param ret Return value
1525 : */
1526 1 : #define sys_port_trace_k_mbox_put_exit(mbox, timeout, ret)
1527 :
1528 : /**
1529 : * @brief Trace Mailbox async put entry
1530 : * @param mbox Mailbox object
1531 : * @param sem Semaphore object
1532 : */
1533 1 : #define sys_port_trace_k_mbox_async_put_enter(mbox, sem)
1534 :
1535 : /**
1536 : * @brief Trace Mailbox async put exit
1537 : * @param mbox Mailbox object
1538 : * @param sem Semaphore object
1539 : */
1540 1 : #define sys_port_trace_k_mbox_async_put_exit(mbox, sem)
1541 :
1542 : /**
1543 : * @brief Trace Mailbox get attempt entry
1544 : * @param mbox Mailbox entry
1545 : * @param timeout Timeout period
1546 : */
1547 1 : #define sys_port_trace_k_mbox_get_enter(mbox, timeout)
1548 :
1549 : /**
1550 : * @brief Trace Mailbox get attempt blocking
1551 : * @param mbox Mailbox entry
1552 : * @param timeout Timeout period
1553 : */
1554 1 : #define sys_port_trace_k_mbox_get_blocking(mbox, timeout)
1555 :
1556 : /**
1557 : * @brief Trace Mailbox get attempt outcome
1558 : * @param mbox Mailbox entry
1559 : * @param timeout Timeout period
1560 : * @param ret Return value
1561 : */
1562 1 : #define sys_port_trace_k_mbox_get_exit(mbox, timeout, ret)
1563 :
1564 : /**
1565 : * @brief Trace Mailbox data get
1566 : * @brief rx_msg Receive Message object
1567 : */
1568 1 : #define sys_port_trace_k_mbox_data_get(rx_msg)
1569 :
1570 : /** @} */ /* end of subsys_tracing_apis_mbox */
1571 :
1572 : /**
1573 : * @brief Pipe Tracing APIs
1574 : * @defgroup subsys_tracing_apis_pipe Pipe Tracing APIs
1575 : * @{
1576 : */
1577 :
1578 : /**
1579 : * @brief Trace initialization of Pipe
1580 : * @param pipe Pipe object
1581 : * @param buffer data buffer
1582 : * @param size data buffer size
1583 : */
1584 1 : #define sys_port_trace_k_pipe_init(pipe, buffer, size)
1585 :
1586 : /**
1587 : * @brief Trace Pipe reset entry
1588 : * @param pipe Pipe object
1589 : */
1590 1 : #define sys_port_trace_k_pipe_reset_enter(pipe)
1591 :
1592 : /**
1593 : * @brief Trace Pipe reset exit
1594 : * @param pipe Pipe object
1595 : */
1596 1 : #define sys_port_trace_k_pipe_reset_exit(pipe)
1597 :
1598 : /**
1599 : * @brief Trace Pipe close entry
1600 : * @param pipe Pipe object
1601 : */
1602 1 : #define sys_port_trace_k_pipe_close_enter(pipe)
1603 :
1604 : /**
1605 : * @brief Trace Pipe close exit
1606 : * @param pipe Pipe object
1607 : */
1608 1 : #define sys_port_trace_k_pipe_close_exit(pipe)
1609 :
1610 : /**
1611 : * @brief Trace Pipe write attempt entry
1612 : * @param pipe Pipe object
1613 : * @param data pointer to data
1614 : * @param len length of data
1615 : * @param timeout Timeout period
1616 : */
1617 1 : #define sys_port_trace_k_pipe_write_enter(pipe, data, len, timeout)
1618 :
1619 : /**
1620 : * @brief Trace Pipe write attempt blocking
1621 : * @param pipe Pipe object
1622 : * @param timeout Timeout period
1623 : */
1624 1 : #define sys_port_trace_k_pipe_write_blocking(pipe, timeout)
1625 :
1626 : /**
1627 : * @brief Trace Pipe write attempt outcome
1628 : * @param pipe Pipe object
1629 : * @param ret Return value
1630 : */
1631 1 : #define sys_port_trace_k_pipe_write_exit(pipe, ret)
1632 :
1633 : /**
1634 : * @brief Trace Pipe read attempt entry
1635 : * @param pipe Pipe object
1636 : * @param data Pointer to data
1637 : * @param len Length of data
1638 : * @param timeout Timeout period
1639 : */
1640 1 : #define sys_port_trace_k_pipe_read_enter(pipe, data, len, timeout)
1641 :
1642 : /**
1643 : * @brief Trace Pipe read attempt blocking
1644 : * @param pipe Pipe object
1645 : * @param timeout Timeout period
1646 : */
1647 1 : #define sys_port_trace_k_pipe_read_blocking(pipe, timeout)
1648 :
1649 : /**
1650 : * @brief Trace Pipe read attempt outcome
1651 : * @param pipe Pipe object
1652 : * @param ret Return value
1653 : */
1654 1 : #define sys_port_trace_k_pipe_read_exit(pipe, ret)
1655 :
1656 : /** @} */ /* end of subsys_tracing_apis_pipe */
1657 :
1658 : /**
1659 : * @brief Heap Tracing APIs
1660 : * @defgroup subsys_tracing_apis_heap Heap Tracing APIs
1661 : * @{
1662 : */
1663 :
1664 : /**
1665 : * @brief Trace initialization of Heap
1666 : * @param h Heap object
1667 : */
1668 1 : #define sys_port_trace_k_heap_init(h)
1669 :
1670 : /**
1671 : * @brief Trace Heap aligned alloc attempt entry
1672 : * @param h Heap object
1673 : * @param timeout Timeout period
1674 : */
1675 1 : #define sys_port_trace_k_heap_aligned_alloc_enter(h, timeout)
1676 :
1677 : /**
1678 : * @brief Trace Heap align alloc attempt blocking
1679 : * @param h Heap object
1680 : * @param timeout Timeout period
1681 : */
1682 1 : #define sys_port_trace_k_heap_alloc_helper_blocking(h, timeout)
1683 :
1684 : /**
1685 : * @brief Trace Heap align alloc attempt outcome
1686 : * @param h Heap object
1687 : * @param timeout Timeout period
1688 : * @param ret Return value
1689 : */
1690 1 : #define sys_port_trace_k_heap_aligned_alloc_exit(h, timeout, ret)
1691 :
1692 : /**
1693 : * @brief Trace Heap alloc enter
1694 : * @param h Heap object
1695 : * @param timeout Timeout period
1696 : */
1697 1 : #define sys_port_trace_k_heap_alloc_enter(h, timeout)
1698 :
1699 : /**
1700 : * @brief Trace Heap alloc exit
1701 : * @param h Heap object
1702 : * @param timeout Timeout period
1703 : * @param ret Return value
1704 : */
1705 1 : #define sys_port_trace_k_heap_alloc_exit(h, timeout, ret)
1706 :
1707 : /**
1708 : * @brief Trace Heap calloc enter
1709 : * @param h Heap object
1710 : * @param timeout Timeout period
1711 : */
1712 1 : #define sys_port_trace_k_heap_calloc_enter(h, timeout)
1713 :
1714 : /**
1715 : * @brief Trace Heap calloc exit
1716 : * @param h Heap object
1717 : * @param timeout Timeout period
1718 : * @param ret Return value
1719 : */
1720 1 : #define sys_port_trace_k_heap_calloc_exit(h, timeout, ret)
1721 :
1722 : /**
1723 : * @brief Trace Heap free
1724 : * @param h Heap object
1725 : */
1726 1 : #define sys_port_trace_k_heap_free(h)
1727 :
1728 : /**
1729 : * @brief Trace Heap realloc enter
1730 : * @param h Heap object
1731 : * @param ptr Pointer to reallocate
1732 : * @param bytes Bytes to reallocate
1733 : * @param timeout Timeout period
1734 : */
1735 1 : #define sys_port_trace_k_heap_realloc_enter(h, ptr, bytes, timeout)
1736 :
1737 : /**
1738 : * @brief Trace Heap realloc exit
1739 : * @param h Heap object
1740 : * @param ptr Pointer to reallocate
1741 : * @param bytes Bytes to reallocate
1742 : * @param timeout Timeout period
1743 : * @param ret Return value
1744 : */
1745 1 : #define sys_port_trace_k_heap_realloc_exit(h, ptr, bytes, timeout, ret)
1746 :
1747 : /**
1748 : * @brief Trace System Heap aligned alloc enter
1749 : * @param heap Heap object
1750 : */
1751 1 : #define sys_port_trace_k_heap_sys_k_aligned_alloc_enter(heap)
1752 :
1753 : /**
1754 : * @brief Trace System Heap aligned alloc exit
1755 : * @param heap Heap object
1756 : * @param ret Return value
1757 : */
1758 1 : #define sys_port_trace_k_heap_sys_k_aligned_alloc_exit(heap, ret)
1759 :
1760 : /**
1761 : * @brief Trace System Heap aligned alloc enter
1762 : * @param heap Heap object
1763 : */
1764 1 : #define sys_port_trace_k_heap_sys_k_malloc_enter(heap)
1765 :
1766 : /**
1767 : * @brief Trace System Heap aligned alloc exit
1768 : * @param heap Heap object
1769 : * @param ret Return value
1770 : */
1771 1 : #define sys_port_trace_k_heap_sys_k_malloc_exit(heap, ret)
1772 :
1773 : /**
1774 : * @brief Trace System Heap free entry
1775 : * @param heap Heap object
1776 : * @param heap_ref Heap reference
1777 : */
1778 1 : #define sys_port_trace_k_heap_sys_k_free_enter(heap, heap_ref)
1779 :
1780 : /**
1781 : * @brief Trace System Heap free exit
1782 : * @param heap Heap object
1783 : * @param heap_ref Heap reference
1784 : */
1785 1 : #define sys_port_trace_k_heap_sys_k_free_exit(heap, heap_ref)
1786 :
1787 : /**
1788 : * @brief Trace System heap calloc enter
1789 : * @param heap
1790 : */
1791 1 : #define sys_port_trace_k_heap_sys_k_calloc_enter(heap)
1792 :
1793 : /**
1794 : * @brief Trace System heap calloc exit
1795 : * @param heap Heap object
1796 : * @param ret Return value
1797 : */
1798 1 : #define sys_port_trace_k_heap_sys_k_calloc_exit(heap, ret)
1799 :
1800 : /**
1801 : * @brief Trace System heap realloc enter
1802 : * @param heap
1803 : * @param ptr
1804 : */
1805 1 : #define sys_port_trace_k_heap_sys_k_realloc_enter(heap, ptr)
1806 :
1807 : /**
1808 : * @brief Trace System heap realloc exit
1809 : * @param heap Heap object
1810 : * @param ptr Memory pointer
1811 : * @param ret Return value
1812 : */
1813 1 : #define sys_port_trace_k_heap_sys_k_realloc_exit(heap, ptr, ret)
1814 :
1815 : /** @} */ /* end of subsys_tracing_apis_heap */
1816 :
1817 : /**
1818 : * @brief Memory Slab Tracing APIs
1819 : * @defgroup subsys_tracing_apis_mslab Memory Slab Tracing APIs
1820 : * @{
1821 : */
1822 :
1823 : /**
1824 : * @brief Trace initialization of Memory Slab
1825 : * @param slab Memory Slab object
1826 : * @param rc Return value
1827 : */
1828 1 : #define sys_port_trace_k_mem_slab_init(slab, rc)
1829 :
1830 : /**
1831 : * @brief Trace Memory Slab alloc attempt entry
1832 : * @param slab Memory Slab object
1833 : * @param timeout Timeout period
1834 : */
1835 1 : #define sys_port_trace_k_mem_slab_alloc_enter(slab, timeout)
1836 :
1837 : /**
1838 : * @brief Trace Memory Slab alloc attempt blocking
1839 : * @param slab Memory Slab object
1840 : * @param timeout Timeout period
1841 : */
1842 1 : #define sys_port_trace_k_mem_slab_alloc_blocking(slab, timeout)
1843 :
1844 : /**
1845 : * @brief Trace Memory Slab alloc attempt outcome
1846 : * @param slab Memory Slab object
1847 : * @param timeout Timeout period
1848 : * @param ret Return value
1849 : */
1850 1 : #define sys_port_trace_k_mem_slab_alloc_exit(slab, timeout, ret)
1851 :
1852 : /**
1853 : * @brief Trace Memory Slab free entry
1854 : * @param slab Memory Slab object
1855 : */
1856 1 : #define sys_port_trace_k_mem_slab_free_enter(slab)
1857 :
1858 : /**
1859 : * @brief Trace Memory Slab free exit
1860 : * @param slab Memory Slab object
1861 : */
1862 1 : #define sys_port_trace_k_mem_slab_free_exit(slab)
1863 :
1864 : /** @} */ /* end of subsys_tracing_apis_mslab */
1865 :
1866 : /**
1867 : * @brief Timer Tracing APIs
1868 : * @defgroup subsys_tracing_apis_timer Timer Tracing APIs
1869 : * @{
1870 : */
1871 :
1872 : /**
1873 : * @brief Trace initialization of Timer
1874 : * @param timer Timer object
1875 : */
1876 1 : #define sys_port_trace_k_timer_init(timer)
1877 :
1878 : /**
1879 : * @brief Trace Timer start
1880 : * @param timer Timer object
1881 : * @param duration Timer duration
1882 : * @param period Timer period
1883 : */
1884 1 : #define sys_port_trace_k_timer_start(timer, duration, period)
1885 :
1886 : /**
1887 : * @brief Trace Timer stop
1888 : * @param timer Timer object
1889 : */
1890 1 : #define sys_port_trace_k_timer_stop(timer)
1891 :
1892 : /**
1893 : * @brief Trace Timer status sync entry
1894 : * @param timer Timer object
1895 : */
1896 1 : #define sys_port_trace_k_timer_status_sync_enter(timer)
1897 :
1898 : /**
1899 : * @brief Trace Timer Status sync blocking
1900 : * @param timer Timer object
1901 : * @param timeout Timeout period
1902 : */
1903 1 : #define sys_port_trace_k_timer_status_sync_blocking(timer, timeout)
1904 :
1905 : /**
1906 : * @brief Trace Time Status sync outcome
1907 : * @param timer Timer object
1908 : * @param result Return value
1909 : */
1910 1 : #define sys_port_trace_k_timer_status_sync_exit(timer, result)
1911 :
1912 : /** @} */ /* end of subsys_tracing_apis_timer */
1913 :
1914 : /**
1915 : * @brief Event Tracing APIs
1916 : * @defgroup subsys_tracing_apis_event Event Tracing APIs
1917 : * @{
1918 : */
1919 :
1920 : /**
1921 : * @brief Trace initialisation of an Event
1922 : * @param event Event object
1923 : */
1924 1 : #define sys_port_trace_k_event_init(event)
1925 :
1926 : /**
1927 : * @brief Trace posting of an Event call entry
1928 : * @param event Event object
1929 : * @param events Set of posted events
1930 : * @param events_mask Mask to apply against posted events
1931 : */
1932 1 : #define sys_port_trace_k_event_post_enter(event, events, events_mask)
1933 :
1934 : /**
1935 : * @brief Trace posting of an Event call exit
1936 : * @param event Event object
1937 : * @param events Set of posted events
1938 : * @param events_mask Mask to apply against posted events
1939 : */
1940 1 : #define sys_port_trace_k_event_post_exit(event, events, events_mask)
1941 :
1942 : /**
1943 : * @brief Trace waiting of an Event call entry
1944 : * @param event Event object
1945 : * @param events Set of events for which to wait
1946 : * @param options Event wait options
1947 : * @param timeout Timeout period
1948 : */
1949 1 : #define sys_port_trace_k_event_wait_enter(event, events, options, timeout)
1950 :
1951 : /**
1952 : * @brief Trace waiting of an Event call exit
1953 : * @param event Event object
1954 : * @param events Set of events for which to wait
1955 : * @param options Event wait options
1956 : * @param timeout Timeout period
1957 : */
1958 1 : #define sys_port_trace_k_event_wait_blocking(event, events, options, timeout)
1959 :
1960 : /**
1961 : * @brief Trace waiting of an Event call exit
1962 : * @param event Event object
1963 : * @param events Set of events for which to wait
1964 : * @param ret Set of received events
1965 : */
1966 1 : #define sys_port_trace_k_event_wait_exit(event, events, ret)
1967 :
1968 : /** @} */ /* end of subsys_tracing_apis_event */
1969 :
1970 : /**
1971 : * @brief System PM Tracing APIs
1972 : * @defgroup subsys_tracing_apis_pm_system System PM Tracing APIs
1973 : * @{
1974 : */
1975 :
1976 : /**
1977 : * @brief Trace system suspend call entry.
1978 : * @param ticks Ticks.
1979 : */
1980 1 : #define sys_port_trace_pm_system_suspend_enter(ticks)
1981 :
1982 : /**
1983 : * @brief Trace system suspend call exit.
1984 : * @param ticks Ticks.
1985 : * @param state PM state.
1986 : */
1987 1 : #define sys_port_trace_pm_system_suspend_exit(ticks, state)
1988 :
1989 : /** @} */ /* end of subsys_tracing_apis_pm_system */
1990 :
1991 : /**
1992 : * @brief PM Device Runtime Tracing APIs
1993 : * @defgroup subsys_tracing_apis_pm_device_runtime PM Device Runtime Tracing APIs
1994 : * @{
1995 : */
1996 :
1997 : /**
1998 : * @brief Trace getting a device call entry.
1999 : * @param dev Device instance.
2000 : */
2001 1 : #define sys_port_trace_pm_device_runtime_get_enter(dev)
2002 :
2003 : /**
2004 : * @brief Trace getting a device call exit.
2005 : * @param dev Device instance.
2006 : * @param ret Return value.
2007 : */
2008 1 : #define sys_port_trace_pm_device_runtime_get_exit(dev, ret)
2009 :
2010 : /**
2011 : * @brief Trace putting a device call entry.
2012 : * @param dev Device instance.
2013 : */
2014 1 : #define sys_port_trace_pm_device_runtime_put_enter(dev)
2015 :
2016 : /**
2017 : * @brief Trace putting a device call exit.
2018 : * @param dev Device instance.
2019 : * @param ret Return value.
2020 : */
2021 1 : #define sys_port_trace_pm_device_runtime_put_exit(dev, ret)
2022 :
2023 : /**
2024 : * @brief Trace putting a device (asynchronously) call entry.
2025 : * @param dev Device instance.
2026 : * @param delay Time to delay the operation
2027 : */
2028 1 : #define sys_port_trace_pm_device_runtime_put_async_enter(dev, delay)
2029 :
2030 : /**
2031 : * @brief Trace putting a device (asynchronously) call exit.
2032 : * @param dev Device instance.
2033 : * @param delay Time to delay the operation.
2034 : * @param ret Return value.
2035 : */
2036 1 : #define sys_port_trace_pm_device_runtime_put_async_exit(dev, delay, ret)
2037 :
2038 : /**
2039 : * @brief Trace enabling device runtime PM call entry.
2040 : * @param dev Device instance.
2041 : */
2042 1 : #define sys_port_trace_pm_device_runtime_enable_enter(dev)
2043 :
2044 : /**
2045 : * @brief Trace enabling device runtime PM call exit.
2046 : * @param dev Device instance.
2047 : * @param ret Return value.
2048 : */
2049 1 : #define sys_port_trace_pm_device_runtime_enable_exit(dev, ret)
2050 :
2051 : /**
2052 : * @brief Trace disabling device runtime PM call entry.
2053 : * @param dev Device instance.
2054 : */
2055 1 : #define sys_port_trace_pm_device_runtime_disable_enter(dev)
2056 :
2057 : /**
2058 : * @brief Trace disabling device runtime PM call exit.
2059 : * @param dev Device instance.
2060 : * @param ret Return value.
2061 : */
2062 1 : #define sys_port_trace_pm_device_runtime_disable_exit(dev, ret)
2063 :
2064 : /** @} */ /* end of subsys_tracing_apis_pm_device_runtime */
2065 :
2066 : /**
2067 : * @brief Network Core Tracing APIs
2068 : * @defgroup subsys_tracing_apis_net Network Core Tracing APIs
2069 : * @{
2070 : */
2071 :
2072 : /**
2073 : * @brief Trace network data receive
2074 : * @param iface Network interface
2075 : * @param pkt Received network packet
2076 : */
2077 1 : #define sys_port_trace_net_recv_data_enter(iface, pkt)
2078 :
2079 : /**
2080 : * @brief Trace network data receive attempt
2081 : * @param iface Network interface
2082 : * @param pkt Received network packet
2083 : * @param ret Return value
2084 : */
2085 1 : #define sys_port_trace_net_recv_data_exit(iface, pkt, ret)
2086 :
2087 : /**
2088 : * @brief Trace network data send
2089 : * @param pkt Network packet to send
2090 : */
2091 1 : #define sys_port_trace_net_send_data_enter(pkt)
2092 :
2093 : /**
2094 : * @brief Trace network data send attempt
2095 : * @param pkt Received network packet
2096 : * @param ret Return value
2097 : */
2098 1 : #define sys_port_trace_net_send_data_exit(pkt, ret)
2099 :
2100 : /**
2101 : * @brief Trace network data receive time
2102 : * @param pkt Received network packet
2103 : * @param end_time When the RX processing stopped for this pkt (in ticks)
2104 : */
2105 1 : #define sys_port_trace_net_rx_time(pkt, end_time)
2106 :
2107 : /**
2108 : * @brief Trace network data sent time
2109 : * @param pkt Sent network packet
2110 : * @param end_time When the TX processing stopped for this pkt (in ticks)
2111 : */
2112 1 : #define sys_port_trace_net_tx_time(pkt, end_time)
2113 :
2114 : /** @} */ /* end of subsys_tracing_apis_net */
2115 :
2116 : /**
2117 : * @brief Network Socket Tracing APIs
2118 : * @defgroup subsys_tracing_apis_socket Network Socket Tracing APIs
2119 : * @{
2120 : */
2121 :
2122 : /**
2123 : * @brief Trace init of network sockets
2124 : * @param socket Network socket is returned
2125 : * @param family Socket address family
2126 : * @param type Socket type
2127 : * @param proto Socket protocol
2128 : */
2129 1 : #define sys_port_trace_socket_init(socket, family, type, proto)
2130 :
2131 : /**
2132 : * @brief Trace close of network sockets
2133 : * @param socket Socket object
2134 : */
2135 1 : #define sys_port_trace_socket_close_enter(socket)
2136 :
2137 : /**
2138 : * @brief Trace network socket close attempt
2139 : * @param socket Socket object
2140 : * @param ret Return value
2141 : */
2142 1 : #define sys_port_trace_socket_close_exit(socket, ret)
2143 :
2144 : /**
2145 : * @brief Trace shutdown of network sockets
2146 : * @param socket Socket object
2147 : * @param how Socket shutdown type
2148 : */
2149 1 : #define sys_port_trace_socket_shutdown_enter(socket, how)
2150 :
2151 : /**
2152 : * @brief Trace network socket shutdown attempt
2153 : * @param socket Socket object
2154 : * @param ret Return value
2155 : */
2156 1 : #define sys_port_trace_socket_shutdown_exit(socket, ret)
2157 :
2158 : /**
2159 : * @brief Trace bind of network sockets
2160 : * @param socket Socket object
2161 : * @param addr Network address to bind
2162 : * @param addrlen Address length
2163 : */
2164 1 : #define sys_port_trace_socket_bind_enter(socket, addr, addrlen)
2165 :
2166 : /**
2167 : * @brief Trace network socket bind attempt
2168 : * @param socket Socket object
2169 : * @param ret Return value
2170 : */
2171 1 : #define sys_port_trace_socket_bind_exit(socket, ret)
2172 :
2173 : /**
2174 : * @brief Trace connect of network sockets
2175 : * @param socket Socket object
2176 : * @param addr Network address to bind
2177 : * @param addrlen Address length
2178 : */
2179 1 : #define sys_port_trace_socket_connect_enter(socket, addr, addrlen)
2180 :
2181 : /**
2182 : * @brief Trace network socket connect attempt
2183 : * @param socket Socket object
2184 : * @param ret Return value
2185 : */
2186 1 : #define sys_port_trace_socket_connect_exit(socket, ret)
2187 :
2188 : /**
2189 : * @brief Trace listen of network sockets
2190 : * @param socket Socket object
2191 : * @param backlog Socket backlog length
2192 : */
2193 1 : #define sys_port_trace_socket_listen_enter(socket, backlog)
2194 :
2195 : /**
2196 : * @brief Trace network socket listen attempt
2197 : * @param socket Socket object
2198 : * @param ret Return value
2199 : */
2200 1 : #define sys_port_trace_socket_listen_exit(socket, ret)
2201 :
2202 : /**
2203 : * @brief Trace accept of network sockets
2204 : * @param socket Socket object
2205 : */
2206 1 : #define sys_port_trace_socket_accept_enter(socket)
2207 :
2208 : /**
2209 : * @brief Trace network socket accept attempt
2210 : * @param socket Socket object
2211 : * @param addr Peer network address
2212 : * @param addrlen Network address length
2213 : * @param ret Return value
2214 : */
2215 1 : #define sys_port_trace_socket_accept_exit(socket, addr, addrlen, ret)
2216 :
2217 : /**
2218 : * @brief Trace sendto of network sockets
2219 : * @param socket Socket object
2220 : * @param len Length of the data to send
2221 : * @param flags Flags for this send operation
2222 : * @param dest_addr Destination network address
2223 : * @param addrlen Network address length
2224 : */
2225 1 : #define sys_port_trace_socket_sendto_enter(socket, len, flags, dest_addr, addrlen)
2226 :
2227 : /**
2228 : * @brief Trace network socket sendto attempt
2229 : * @param socket Socket object
2230 : * @param ret Return value
2231 : */
2232 1 : #define sys_port_trace_socket_sendto_exit(socket, ret)
2233 :
2234 : /**
2235 : * @brief Trace sendmsg of network sockets
2236 : * @param socket Socket object
2237 : * @param msg Data to send
2238 : * @param flags Flags for this send operation
2239 : */
2240 1 : #define sys_port_trace_socket_sendmsg_enter(socket, msg, flags)
2241 :
2242 : /**
2243 : * @brief Trace network socket sendmsg attempt
2244 : * @param socket Socket object
2245 : * @param ret Return value
2246 : */
2247 1 : #define sys_port_trace_socket_sendmsg_exit(socket, ret)
2248 :
2249 : /**
2250 : * @brief Trace recvfrom of network sockets
2251 : * @param socket Socket object
2252 : * @param max_len Maximum length of the data we can receive
2253 : * @param flags Flags for this receive operation
2254 : * @param addr Remote network address
2255 : * @param addrlen Network address length
2256 : */
2257 1 : #define sys_port_trace_socket_recvfrom_enter(socket, max_len, flags, addr, addrlen)
2258 :
2259 : /**
2260 : * @brief Trace network socket recvfrom attempt
2261 : * @param socket Socket object
2262 : * @param src_addr Peer network address that send the data
2263 : * @param addrlen Length of the network address
2264 : * @param ret Return value
2265 : */
2266 1 : #define sys_port_trace_socket_recvfrom_exit(socket, src_addr, addrlen, ret)
2267 :
2268 : /**
2269 : * @brief Trace recvmsg of network sockets
2270 : * @param socket Socket object
2271 : * @param msg Message buffer to receive
2272 : * @param flags Flags for this receive operation
2273 : */
2274 1 : #define sys_port_trace_socket_recvmsg_enter(socket, msg, flags)
2275 :
2276 : /**
2277 : * @brief Trace network socket recvmsg attempt
2278 : * @param socket Socket object
2279 : * @param msg Message buffer received
2280 : * @param ret Return value
2281 : */
2282 1 : #define sys_port_trace_socket_recvmsg_exit(socket, msg, ret)
2283 :
2284 : /**
2285 : * @brief Trace fcntl of network sockets
2286 : * @param socket Socket object
2287 : * @param cmd Command to set for this socket
2288 : * @param flags Flags for this receive operation
2289 : */
2290 1 : #define sys_port_trace_socket_fcntl_enter(socket, cmd, flags)
2291 :
2292 : /**
2293 : * @brief Trace network socket fcntl attempt
2294 : * @param socket Socket object
2295 : * @param ret Return value
2296 : */
2297 1 : #define sys_port_trace_socket_fcntl_exit(socket, ret)
2298 :
2299 : /**
2300 : * @brief Trace ioctl of network sockets
2301 : * @param socket Socket object
2302 : * @param req Request to set for this socket
2303 : */
2304 1 : #define sys_port_trace_socket_ioctl_enter(socket, req)
2305 :
2306 : /**
2307 : * @brief Trace network socket ioctl attempt
2308 : * @param socket Socket object
2309 : * @param ret Return value
2310 : */
2311 1 : #define sys_port_trace_socket_ioctl_exit(socket, ret)
2312 :
2313 : /**
2314 : * @brief Trace polling of network sockets
2315 : * @param fds Set of socket object
2316 : * @param nfds Number of socket objects in the set
2317 : * @param timeout Timeout for the poll operation
2318 : */
2319 1 : #define sys_port_trace_socket_poll_enter(fds, nfds, timeout)
2320 :
2321 : /**
2322 : * @brief Trace network socket poll attempt
2323 : * @param fds Set of socket object
2324 : * @param nfds Number of socket objects in the set
2325 : * @param ret Return value
2326 : */
2327 1 : #define sys_port_trace_socket_poll_exit(fds, nfds, ret)
2328 :
2329 : /**
2330 : * @brief Trace getsockopt of network sockets
2331 : * @param socket Socket object
2332 : * @param level Option level
2333 : * @param optname Option name
2334 : */
2335 1 : #define sys_port_trace_socket_getsockopt_enter(socket, level, optname)
2336 :
2337 : /**
2338 : * @brief Trace network socket getsockopt attempt
2339 : * @param socket Socket object
2340 : * @param level Option level
2341 : * @param optname Option name
2342 : * @param optval Option value
2343 : * @param optlen Option value length
2344 : * @param ret Return value
2345 : */
2346 1 : #define sys_port_trace_socket_getsockopt_exit(socket, level, optname, optval, optlen, ret)
2347 :
2348 : /**
2349 : * @brief Trace setsockopt of network sockets
2350 : * @param socket Socket object
2351 : * @param level Option level
2352 : * @param optname Option name
2353 : * @param optval Option value
2354 : * @param optlen Option value length
2355 : */
2356 1 : #define sys_port_trace_socket_setsockopt_enter(socket, level, optname, optval, optlen)
2357 :
2358 : /**
2359 : * @brief Trace network socket setsockopt attempt
2360 : * @param socket Socket object
2361 : * @param ret Return value
2362 : */
2363 1 : #define sys_port_trace_socket_setsockopt_exit(socket, ret)
2364 :
2365 : /**
2366 : * @brief Trace getpeername of network sockets
2367 : * @param socket Socket object
2368 : */
2369 1 : #define sys_port_trace_socket_getpeername_enter(socket)
2370 :
2371 : /**
2372 : * @brief Trace network socket getpeername attempt
2373 : * @param socket Socket object
2374 : * @param addr Peer socket network address
2375 : * @param addrlen Length of the network address
2376 : * @param ret Return value
2377 : */
2378 1 : #define sys_port_trace_socket_getpeername_exit(socket, addr, addrlen, ret)
2379 :
2380 : /**
2381 : * @brief Trace getsockname of network sockets
2382 : * @param socket Socket object
2383 : */
2384 1 : #define sys_port_trace_socket_getsockname_enter(socket)
2385 :
2386 : /**
2387 : * @brief Trace network socket getsockname attempt
2388 : * @param socket Socket object
2389 : * @param addr Local socket network address
2390 : * @param addrlen Length of the network address
2391 : * @param ret Return value
2392 : */
2393 1 : #define sys_port_trace_socket_getsockname_exit(socket, addr, addrlen, ret)
2394 :
2395 : /**
2396 : * @brief Trace socketpair enter call
2397 : * @param family Network address family
2398 : * @param type Socket type
2399 : * @param proto Socket protocol
2400 : * @param sv Socketpair buffer
2401 : */
2402 1 : #define sys_port_trace_socket_socketpair_enter(family, type, proto, sv)
2403 :
2404 : /**
2405 : * @brief Trace network socketpair open attempt
2406 : * @param socket_A Socketpair first socket object
2407 : * @param socket_B Socketpair second socket object
2408 : * @param ret Return value
2409 : */
2410 1 : #define sys_port_trace_socket_socketpair_exit(socket_A, socket_B, ret)
2411 :
2412 : /** @} */ /* end of subsys_tracing_apis_socket */
2413 :
2414 : /**
2415 : * @brief Named Tracing APIs
2416 : * @defgroup subsys_tracing_apis_named Named tracing APIs
2417 : * @{
2418 : */
2419 :
2420 : /*
2421 : * @brief Called by user to generate named events
2422 : *
2423 : * @param name name of event. Tracing subsystems may place a limit on
2424 : * the length of this string
2425 : * @param arg0 arbitrary user-provided data for this event
2426 : * @param arg1 arbitrary user-provided data for this event
2427 : */
2428 0 : #define sys_trace_named_event(name, arg0, arg1)
2429 :
2430 : /** @} */ /* end of subsys_tracing_apis_named */
2431 :
2432 : /**
2433 : * @brief GPIO Tracing APIs
2434 : * @defgroup subsys_tracing_apis_gpio GPIO Tracing APIs
2435 : * @{
2436 : */
2437 :
2438 : /**
2439 : * @brief Trace GPIO pin interrupt configure enter call
2440 : * @param port Pointer to device structure for the driver instance
2441 : * @param pin GPIO pin number
2442 : * @param flags Interrupt configuration flags as defined by GPIO_INT_*
2443 : */
2444 1 : #define sys_port_trace_gpio_pin_interrupt_configure_enter(port, pin, flags)
2445 :
2446 : /**
2447 : * @brief Trace GPIO pin interrupt configure exit call
2448 : * @param port Pointer to device structure for the driver instance
2449 : * @param pin GPIO pin number
2450 : * @param ret Return value
2451 : */
2452 1 : #define sys_port_trace_gpio_pin_interrupt_configure_exit(port, pin, ret)
2453 :
2454 : /**
2455 : * @brief Trace GPIO single pin configure enter call
2456 : * @param port Pointer to device structure for the driver instance
2457 : * @param pin GPIO pin number to configure
2458 : * @param flags GPIO pin configuration flags
2459 : */
2460 1 : #define sys_port_trace_gpio_pin_configure_enter(port, pin, flags)
2461 :
2462 : /**
2463 : * @brief Trace GPIO single pin configure exit call
2464 : * @param port Pointer to device structure for the driver instance
2465 : * @param pin GPIO pin number to configure
2466 : * @param ret Return value
2467 : */
2468 1 : #define sys_port_trace_gpio_pin_configure_exit(port, pin, ret)
2469 :
2470 : /**
2471 : * @brief Trace GPIO port get direction enter call
2472 : * @param port Pointer to device structure for the driver instance
2473 : * @param map Bitmap of pin directions to query
2474 : * @param inputs Pointer to a variable where input directions will be stored
2475 : * @param outputs Pointer to a variable where output directions will be stored
2476 : */
2477 1 : #define sys_port_trace_gpio_port_get_direction_enter(port, map, inputs, outputs)
2478 :
2479 : /**
2480 : * @brief Trace GPIO port get direction exit call
2481 : * @param port Pointer to device structure for the driver instance
2482 : * @param ret Return value
2483 : */
2484 1 : #define sys_port_trace_gpio_port_get_direction_exit(port, ret)
2485 :
2486 : /**
2487 : * @brief Trace GPIO pin gent config enter call
2488 : * @param port Pointer to device structure for the driver instance
2489 : * @param pin GPIO pin number to configure
2490 : * @param flags GPIO pin configuration flags
2491 : */
2492 1 : #define sys_port_trace_gpio_pin_get_config_enter(port, pin, flags)
2493 :
2494 : /**
2495 : * @brief Trace GPIO pin get config exit call
2496 : * @param port Pointer to device structure for the driver instance
2497 : * @param pin GPIO pin number to configure
2498 : * @param ret Return value
2499 : */
2500 1 : #define sys_port_trace_gpio_pin_get_config_exit(port, pin, ret)
2501 :
2502 : /**
2503 : * @brief Trace GPIO port get raw enter call
2504 : * @param port Pointer to device structure for the driver instance
2505 : * @param value Pointer to a variable where the raw value will be stored
2506 : */
2507 1 : #define sys_port_trace_gpio_port_get_raw_enter(port, value)
2508 :
2509 : /**
2510 : * @brief Trace GPIO port get raw exit call
2511 : * @param port Pointer to device structure for the driver instance
2512 : * @param ret Return value
2513 : */
2514 1 : #define sys_port_trace_gpio_port_get_raw_exit(port, ret)
2515 :
2516 : /**
2517 : * @brief Trace GPIO port set masked raw enter call
2518 : * @param port Pointer to device structure for the driver instance
2519 : * @param mask Mask indicating which pins will be modified
2520 : * @param value Value to be written to the output pins
2521 : */
2522 1 : #define sys_port_trace_gpio_port_set_masked_raw_enter(port, mask, value)
2523 :
2524 : /**
2525 : * @brief Trace GPIO port set masked raw exit call
2526 : * @param port Pointer to device structure for the driver instance
2527 : * @param ret Return value
2528 : */
2529 1 : #define sys_port_trace_gpio_port_set_masked_raw_exit(port, ret)
2530 :
2531 : /**
2532 : * @brief Trace GPIO port set bits raw enter call
2533 : * @param port Pointer to device structure for the driver instance
2534 : * @param pins Value indicating which pins will be modified
2535 : */
2536 1 : #define sys_port_trace_gpio_port_set_bits_raw_enter(port, pins)
2537 :
2538 : /**
2539 : * @brief Trace GPIO port set bits raw exit call
2540 : * @param port Pointer to device structure for the driver instance
2541 : * @param ret Return value
2542 : */
2543 1 : #define sys_port_trace_gpio_port_set_bits_raw_exit(port, ret)
2544 :
2545 : /**
2546 : * @brief Trace GPIO port clear bits raw enter call
2547 : * @param port Pointer to device structure for the driver instance
2548 : * @param pins Value indicating which pins will be modified
2549 : */
2550 1 : #define sys_port_trace_gpio_port_clear_bits_raw_enter(port, pins)
2551 :
2552 : /**
2553 : * @brief Trace GPIO port clear bits raw exit call
2554 : * @param port Pointer to device structure for the driver instance
2555 : * @param ret Return value
2556 : */
2557 1 : #define sys_port_trace_gpio_port_clear_bits_raw_exit(port, ret)
2558 :
2559 : /**
2560 : * @brief Trace GPIO port toggle bits enter call
2561 : * @param port Pointer to device structure for the driver instance
2562 : * @param pins Value indicating which pins will be modified
2563 : */
2564 1 : #define sys_port_trace_gpio_port_toggle_bits_enter(port, pins)
2565 :
2566 : /**
2567 : * @brief Trace GPIO port toggle bits exit call
2568 : * @param port Pointer to device structure for the driver instance
2569 : * @param ret Return value
2570 : */
2571 1 : #define sys_port_trace_gpio_port_toggle_bits_exit(port, ret)
2572 :
2573 : /**
2574 : * @brief Trace GPIO init callback enter call
2575 : * @param callback A valid application's callback structure pointer
2576 : * @param handler A valid handler function pointer
2577 : * @param pin_mask A bit mask of relevant pins for the handler
2578 : */
2579 1 : #define sys_port_trace_gpio_init_callback_enter(callback, handler, pin_mask)
2580 :
2581 : /**
2582 : * @brief Trace GPIO init callback exit call
2583 : * @param callback A valid application's callback structure pointer
2584 : */
2585 1 : #define sys_port_trace_gpio_init_callback_exit(callback)
2586 :
2587 : /**
2588 : * @brief Trace GPIO add callback enter call
2589 : * @param port Pointer to device structure for the driver instance
2590 : * @param callback A valid application's callback structure pointer
2591 : */
2592 1 : #define sys_port_trace_gpio_add_callback_enter(port, callback)
2593 :
2594 : /**
2595 : * @brief Trace GPIO add callback exit call
2596 : * @param port Pointer to device structure for the driver instance
2597 : * @param ret Return value
2598 : */
2599 1 : #define sys_port_trace_gpio_add_callback_exit(port, ret)
2600 :
2601 : /**
2602 : * @brief Trace GPIO remove callback enter call
2603 : * @param port Pointer to device structure for the driver instance
2604 : * @param callback A valid application's callback structure pointer
2605 : */
2606 1 : #define sys_port_trace_gpio_remove_callback_enter(port, callback)
2607 :
2608 : /**
2609 : * @brief Trace GPIO remove callback exit call
2610 : * @param port Pointer to device structure for the driver instance
2611 : * @param ret Return value
2612 : */
2613 1 : #define sys_port_trace_gpio_remove_callback_exit(port, ret)
2614 :
2615 : /**
2616 : * @brief Trace GPIO get pending interrupt enter call
2617 : * @param dev Pointer to the device structure for the device instance
2618 : */
2619 1 : #define sys_port_trace_gpio_get_pending_int_enter(dev)
2620 :
2621 : /**
2622 : * @brief Trace GPIO get pending interrupt exit call
2623 : * @param dev Pointer to the device structure for the device instance
2624 : * @param ret Return value
2625 : */
2626 1 : #define sys_port_trace_gpio_get_pending_int_exit(dev, ret)
2627 :
2628 : /**
2629 : * @brief
2630 : * @param list @ref sys_slist_t representing gpio_callback pointers
2631 : * @param port @ref device representing the GPIO port
2632 : * @param pins @ref gpio_pin_t representing the pins
2633 : */
2634 1 : #define sys_port_trace_gpio_fire_callbacks_enter(list, port, pins)
2635 :
2636 : /**
2637 : * @brief
2638 : * @param port @ref device representing the GPIO port
2639 : * @param callback @ref gpio_callback a valid Application's callback structure pointer
2640 : */
2641 1 : #define sys_port_trace_gpio_fire_callback(port, callback)
2642 :
2643 : /** @} */ /* end of subsys_tracing_apis_gpio */
2644 :
2645 : #if defined(CONFIG_PERCEPIO_TRACERECORDER)
2646 : #include "tracing_tracerecorder.h"
2647 :
2648 : /**
2649 : * @brief Called when the cpu exits the idle state
2650 : */
2651 : void sys_trace_idle_exit(void);
2652 :
2653 : #else
2654 : /**
2655 : * @brief Called when entering an ISR
2656 : */
2657 1 : void sys_trace_isr_enter(void);
2658 :
2659 : /**
2660 : * @brief Called when exiting an ISR
2661 : */
2662 1 : void sys_trace_isr_exit(void);
2663 :
2664 : /**
2665 : * @brief Called when exiting an ISR and switching to scheduler
2666 : */
2667 1 : void sys_trace_isr_exit_to_scheduler(void);
2668 :
2669 : /**
2670 : * @brief Called when the cpu enters the idle state
2671 : */
2672 1 : void sys_trace_idle(void);
2673 :
2674 : /**
2675 : * @brief Called when the cpu exits the idle state
2676 : */
2677 1 : void sys_trace_idle_exit(void);
2678 :
2679 : #endif /* CONFIG_PERCEPIO_TRACERECORDER */
2680 :
2681 : /**
2682 : * @brief Called when entering an init function
2683 : */
2684 1 : #define sys_trace_sys_init_enter(entry, level)
2685 :
2686 : /**
2687 : * @brief Called when exiting an init function
2688 : */
2689 1 : #define sys_trace_sys_init_exit(entry, level, result)
2690 :
2691 : /** @} */ /* end of subsys_tracing_apis */
2692 :
2693 : /** @} */ /* end of subsys_tracing */
2694 :
2695 : #endif
2696 : #endif /* ZEPHYR_INCLUDE_TRACING_TRACING_H_ */
|
