From 2e71bd08bae61cd7259d8c362818b4a268a393e9 Mon Sep 17 00:00:00 2001 From: Sebastian Huber Date: Mon, 18 Dec 2023 12:02:30 +0100 Subject: tm27: Add optional TM27_INTERRUPT_VECTOR_DEFAULT Let the BSP define TM27_INTERRUPT_VECTOR_DEFAULT to more efficiently and reliably get the TM27 default interrupt vector. Update #3716. --- cpukit/doxygen.h | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) (limited to 'cpukit/doxygen.h') diff --git a/cpukit/doxygen.h b/cpukit/doxygen.h index 661955a501..e61b207a7a 100644 --- a/cpukit/doxygen.h +++ b/cpukit/doxygen.h @@ -43,7 +43,23 @@ * * @ingroup RTEMSDeviceDrivers * - * @brief Time Test 27 Support + * @brief The Time Test 27 (TM27) support is used to measure the timing of + * the interrupt processing. + * + * The TMS27 support should provide two software generated interrupt requests, + * one low priority request raised by Cause_tm27_intr() and one higher priority + * request raised by Lower_tm27_intr(). Both requests should be cleared by + * Clear_tm27_intr(). A handler provided by the test should be installed + * through Install_tm27_vector(). This function should initialize the system + * so that the software generated interrupt requests can be raised and cleared. + * + * If the raise functions Cause_tm27_intr() and Lower_tm27_intr() do not + * trigger the interrupt immediately, then the TM27 support shall define + * MUST_WAIT_FOR_INTERRUPT to one, otherwise MUST_WAIT_FOR_INTERRUPT shall be + * defined to zero. + * + * The TM27 support may define TM27_INTERRUPT_VECTOR_DEFAULT to indicate the + * interrupt vector of the interrupt request raised by Cause_tm27_intr(). */ /** -- cgit v1.2.3