[rtems commit] Add documentation for profiling
Sebastian Huber
sebh at rtems.org
Fri Mar 14 07:42:47 UTC 2014
Module: rtems
Branch: master
Commit: 0bf59cf0ae0aa28e3c09d01c3d3dd17b82283949
Changeset: http://git.rtems.org/rtems/commit/?id=0bf59cf0ae0aa28e3c09d01c3d3dd17b82283949
Author: Sebastian Huber <sebastian.huber at embedded-brains.de>
Date: Wed Mar 12 09:23:34 2014 +0100
Add documentation for profiling
---
doc/bsp_howto/support.t | 11 +++++++++++
doc/cpu_supplement/general.t | 12 ++++++++++++
2 files changed, 23 insertions(+), 0 deletions(-)
diff --git a/doc/bsp_howto/support.t b/doc/bsp_howto/support.t
index 843093a..4441636 100644
--- a/doc/bsp_howto/support.t
+++ b/doc/bsp_howto/support.t
@@ -283,6 +283,17 @@ Interrupt Controller model which does not require the BSP to implement
@code{set_vector}. BSPs for these architectures must provide a different
set of support routines.
+ at section Interrupt Delay Profiling
+
+The RTEMS profiling needs support by the BSP for the interrupt delay times. In
+case profiling is enabled via the RTEMS build configuration option
+ at code{--enable-profiling} (in this case the pre-processor symbol
+ at code{RTEMS_PROFILING} is defined) a BSP may provide data for the interrupt
+delay times. The BSP can feed interrupt delay times with the
+ at code{_Profiling_Update_max_interrupt_delay()} function
+(@code{#include <rtems/score/profiling.h>}). For an example please have a look
+at @code{c/src/lib/libbsp/sparc/leon3/clock/ckinit.c}.
+
@section Programmable Interrupt Controller API
A BSP can use the PIC API to install Interrupt Service Routines through
diff --git a/doc/cpu_supplement/general.t b/doc/cpu_supplement/general.t
index deca4de..9c952a7 100644
--- a/doc/cpu_supplement/general.t
+++ b/doc/cpu_supplement/general.t
@@ -362,6 +362,18 @@ provide the following two functions
counter values.
@end itemize
+ at section Interrupt Profiling
+
+The RTEMS profiling needs support by the CPU port for the interrupt entry and
+exit times. In case profiling is enabled via the RTEMS build configuration
+option @code{--enable-profiling} (in this case the pre-processor symbol
+ at code{RTEMS_PROFILING} is defined) the CPU port may provide data for the
+interrupt entry and exit times of the outer-most interrupt. The CPU port can
+feed interrupt entry and exit times with the
+ at code{_Profiling_Outer_most_interrupt_entry_and_exit()} function
+(@code{#include <rtems/score/profiling.h>}). For an example please have a look
+at @code{cpukit/score/cpu/arm/arm_exc_interrupt.S}.
+
@c
@c
@c
More information about the vc
mailing list