From 67c033d39a42d3594afae35f3ea1bf131e0dbd87 Mon Sep 17 00:00:00 2001 From: Sebastian Huber Date: Mon, 26 Jul 2021 15:53:26 +0200 Subject: validation: Test rtems_interrupt_handler_iterate() Update #3269. --- testsuites/validation/tc-intr-handler-iterate.c | 636 ++++++++++++++++++++++++ 1 file changed, 636 insertions(+) create mode 100644 testsuites/validation/tc-intr-handler-iterate.c (limited to 'testsuites/validation') diff --git a/testsuites/validation/tc-intr-handler-iterate.c b/testsuites/validation/tc-intr-handler-iterate.c new file mode 100644 index 0000000000..707ea44527 --- /dev/null +++ b/testsuites/validation/tc-intr-handler-iterate.c @@ -0,0 +1,636 @@ +/* SPDX-License-Identifier: BSD-2-Clause */ + +/** + * @file + * + * @ingroup RTEMSTestCaseRtemsIntrReqHandlerIterate + */ + +/* + * Copyright (C) 2021 embedded brains GmbH (http://www.embedded-brains.de) + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE + * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF + * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + * POSSIBILITY OF SUCH DAMAGE. + */ + +/* + * This file is part of the RTEMS quality process and was automatically + * generated. If you find something that needs to be fixed or + * worded better please post a report or patch to an RTEMS mailing list + * or raise a bug report: + * + * https://www.rtems.org/bugs.html + * + * For information on updating and regenerating please refer to the How-To + * section in the Software Requirements Engineering chapter of the + * RTEMS Software Engineering manual. The manual is provided as a part of + * a release. For development sources please refer to the online + * documentation at: + * + * https://docs.rtems.org + */ + +#ifdef HAVE_CONFIG_H +#include "config.h" +#endif + +#include +#include + +#include "tx-support.h" + +#include + +/** + * @defgroup RTEMSTestCaseRtemsIntrReqHandlerIterate \ + * spec:/rtems/intr/req/handler-iterate + * + * @ingroup RTEMSTestSuiteTestsuitesValidation0 + * + * @{ + */ + +typedef enum { + RtemsIntrReqHandlerIterate_Pre_Vector_Valid, + RtemsIntrReqHandlerIterate_Pre_Vector_Invalid, + RtemsIntrReqHandlerIterate_Pre_Vector_NA +} RtemsIntrReqHandlerIterate_Pre_Vector; + +typedef enum { + RtemsIntrReqHandlerIterate_Pre_Routine_Valid, + RtemsIntrReqHandlerIterate_Pre_Routine_Null, + RtemsIntrReqHandlerIterate_Pre_Routine_NA +} RtemsIntrReqHandlerIterate_Pre_Routine; + +typedef enum { + RtemsIntrReqHandlerIterate_Pre_Init_Yes, + RtemsIntrReqHandlerIterate_Pre_Init_No, + RtemsIntrReqHandlerIterate_Pre_Init_NA +} RtemsIntrReqHandlerIterate_Pre_Init; + +typedef enum { + RtemsIntrReqHandlerIterate_Pre_ISR_Yes, + RtemsIntrReqHandlerIterate_Pre_ISR_No, + RtemsIntrReqHandlerIterate_Pre_ISR_NA +} RtemsIntrReqHandlerIterate_Pre_ISR; + +typedef enum { + RtemsIntrReqHandlerIterate_Post_Status_Ok, + RtemsIntrReqHandlerIterate_Post_Status_InvAddr, + RtemsIntrReqHandlerIterate_Post_Status_IncStat, + RtemsIntrReqHandlerIterate_Post_Status_InvId, + RtemsIntrReqHandlerIterate_Post_Status_CalledFromISR, + RtemsIntrReqHandlerIterate_Post_Status_NA +} RtemsIntrReqHandlerIterate_Post_Status; + +typedef enum { + RtemsIntrReqHandlerIterate_Post_Visit_Yes, + RtemsIntrReqHandlerIterate_Post_Visit_Nop, + RtemsIntrReqHandlerIterate_Post_Visit_NA +} RtemsIntrReqHandlerIterate_Post_Visit; + +/** + * @brief Test context for spec:/rtems/intr/req/handler-iterate test case. + */ +typedef struct { + /** + * @brief If this member is true, then the service was initialized during + * setup. + */ + bool initialized_during_setup; + + /** + * @brief This member provides the vector number of a testable interrupt + * vector. + */ + rtems_vector_number test_vector; + + /** + * @brief If this member is true, then the service shall be initialized. + */ + bool initialized; + + /** + * @brief If this member is true, then rtems_interrupt_handler_iterate() + * shall be called from within interrupt context. + */ + bool isr; + + /** + * @brief This member provides the count of visited entries. + */ + uint32_t visited_entries; + + /** + * @brief This member provides an rtems_interrupt_entry object. + */ + rtems_interrupt_entry entry; + + /** + * @brief This member specifies if the ``vector`` parameter value. + */ + rtems_vector_number vector; + + /** + * @brief This member specifies if the ``routine`` parameter value. + */ + rtems_interrupt_per_handler_routine routine; + + /** + * @brief This member contains the return value of the + * rtems_interrupt_handler_iterate() call. + */ + rtems_status_code status; + + /** + * @brief This member defines the pre-condition states for the next action. + */ + size_t pcs[ 4 ]; + + /** + * @brief This member indicates if the test action loop is currently + * executed. + */ + bool in_action_loop; +} RtemsIntrReqHandlerIterate_Context; + +static RtemsIntrReqHandlerIterate_Context + RtemsIntrReqHandlerIterate_Instance; + +static const char * const RtemsIntrReqHandlerIterate_PreDesc_Vector[] = { + "Valid", + "Invalid", + "NA" +}; + +static const char * const RtemsIntrReqHandlerIterate_PreDesc_Routine[] = { + "Valid", + "Null", + "NA" +}; + +static const char * const RtemsIntrReqHandlerIterate_PreDesc_Init[] = { + "Yes", + "No", + "NA" +}; + +static const char * const RtemsIntrReqHandlerIterate_PreDesc_ISR[] = { + "Yes", + "No", + "NA" +}; + +static const char * const * const RtemsIntrReqHandlerIterate_PreDesc[] = { + RtemsIntrReqHandlerIterate_PreDesc_Vector, + RtemsIntrReqHandlerIterate_PreDesc_Routine, + RtemsIntrReqHandlerIterate_PreDesc_Init, + RtemsIntrReqHandlerIterate_PreDesc_ISR, + NULL +}; + +typedef RtemsIntrReqHandlerIterate_Context Context; + +static char entry_arg; + +static char visitor_arg; + +static const char entry_info[] = "Entry"; + +static void EntryRoutine( void *arg ) +{ + Context *ctx; + rtems_status_code sc; + + (void) arg; + ctx = T_fixture_context(); + sc = rtems_interrupt_vector_disable( ctx->test_vector ); + T_rsc_success( sc ); + + T_eq_ptr( arg, &entry_arg ); +} + +static void VisitorRoutine( + void *arg, + const char *info, + rtems_option options, + rtems_interrupt_handler handler_routine, + void *handler_arg +) +{ + Context *ctx; + + ctx = T_fixture_context(); + ++ctx->visited_entries; + T_eq_ptr( arg, &visitor_arg ); + T_eq_ptr( info, entry_info ); + T_eq_u32( options, RTEMS_INTERRUPT_UNIQUE ); + T_eq_ptr( handler_routine, EntryRoutine ); + T_eq_ptr( handler_arg, &entry_arg ); +} + +static void Action( void *arg ) +{ + Context *ctx; + + ctx = arg; + ctx->visited_entries = 0; + + bsp_interrupt_set_handler_unique( + BSP_INTERRUPT_HANDLER_TABLE_SIZE, + ctx->initialized + ); + + ctx->status = rtems_interrupt_handler_iterate( + ctx->vector, + ctx->routine, + &visitor_arg + ); + + bsp_interrupt_set_handler_unique( + BSP_INTERRUPT_HANDLER_TABLE_SIZE, + ctx->initialized_during_setup + ); +} + +static void RtemsIntrReqHandlerIterate_Pre_Vector_Prepare( + RtemsIntrReqHandlerIterate_Context *ctx, + RtemsIntrReqHandlerIterate_Pre_Vector state +) +{ + switch ( state ) { + case RtemsIntrReqHandlerIterate_Pre_Vector_Valid: { + /* + * While the ``vector`` parameter is associated with an interrupt vector. + */ + ctx->vector = ctx->test_vector; + break; + } + + case RtemsIntrReqHandlerIterate_Pre_Vector_Invalid: { + /* + * While the ``vector`` parameter is not associated with an interrupt + * vector. + */ + ctx->vector = BSP_INTERRUPT_VECTOR_COUNT; + break; + } + + case RtemsIntrReqHandlerIterate_Pre_Vector_NA: + break; + } +} + +static void RtemsIntrReqHandlerIterate_Pre_Routine_Prepare( + RtemsIntrReqHandlerIterate_Context *ctx, + RtemsIntrReqHandlerIterate_Pre_Routine state +) +{ + switch ( state ) { + case RtemsIntrReqHandlerIterate_Pre_Routine_Valid: { + /* + * While the visitor routine specified by the ``routine`` parameter is + * valid. + */ + ctx->routine = VisitorRoutine; + break; + } + + case RtemsIntrReqHandlerIterate_Pre_Routine_Null: { + /* + * While the visitor routine specified by the ``routine`` parameter is + * equal to NULL. + */ + ctx->routine = NULL; + break; + } + + case RtemsIntrReqHandlerIterate_Pre_Routine_NA: + break; + } +} + +static void RtemsIntrReqHandlerIterate_Pre_Init_Prepare( + RtemsIntrReqHandlerIterate_Context *ctx, + RtemsIntrReqHandlerIterate_Pre_Init state +) +{ + switch ( state ) { + case RtemsIntrReqHandlerIterate_Pre_Init_Yes: { + /* + * While the service is initialized. + */ + ctx->initialized = true; + break; + } + + case RtemsIntrReqHandlerIterate_Pre_Init_No: { + /* + * While the service is not initialized. + */ + ctx->initialized = false; + break; + } + + case RtemsIntrReqHandlerIterate_Pre_Init_NA: + break; + } +} + +static void RtemsIntrReqHandlerIterate_Pre_ISR_Prepare( + RtemsIntrReqHandlerIterate_Context *ctx, + RtemsIntrReqHandlerIterate_Pre_ISR state +) +{ + switch ( state ) { + case RtemsIntrReqHandlerIterate_Pre_ISR_Yes: { + /* + * While rtems_interrupt_handler_iterate() is called from within + * interrupt context. + */ + ctx->isr = true; + break; + } + + case RtemsIntrReqHandlerIterate_Pre_ISR_No: { + /* + * While rtems_interrupt_handler_iterate() is not called from within + * interrupt context. + */ + ctx->isr = false; + break; + } + + case RtemsIntrReqHandlerIterate_Pre_ISR_NA: + break; + } +} + +static void RtemsIntrReqHandlerIterate_Post_Status_Check( + RtemsIntrReqHandlerIterate_Context *ctx, + RtemsIntrReqHandlerIterate_Post_Status state +) +{ + switch ( state ) { + case RtemsIntrReqHandlerIterate_Post_Status_Ok: { + /* + * The return status of rtems_interrupt_handler_iterate() shall be + * RTEMS_SUCCESSFUL. + */ + T_rsc_success( ctx->status ); + break; + } + + case RtemsIntrReqHandlerIterate_Post_Status_InvAddr: { + /* + * The return status of rtems_interrupt_handler_iterate() shall be + * RTEMS_INVALID_ADDRESS. + */ + T_rsc( ctx->status, RTEMS_INVALID_ADDRESS ); + break; + } + + case RtemsIntrReqHandlerIterate_Post_Status_IncStat: { + /* + * The return status of rtems_interrupt_handler_iterate() shall be + * RTEMS_INCORRECT_STATE. + */ + T_rsc( ctx->status, RTEMS_INCORRECT_STATE ); + break; + } + + case RtemsIntrReqHandlerIterate_Post_Status_InvId: { + /* + * The return status of rtems_interrupt_handler_iterate() shall be + * RTEMS_INVALID_ID. + */ + T_rsc( ctx->status, RTEMS_INVALID_ID ); + break; + } + + case RtemsIntrReqHandlerIterate_Post_Status_CalledFromISR: { + /* + * The return status of rtems_interrupt_handler_iterate() shall be + * RTEMS_CALLED_FROM_ISR. + */ + T_rsc( ctx->status, RTEMS_CALLED_FROM_ISR ); + break; + } + + case RtemsIntrReqHandlerIterate_Post_Status_NA: + break; + } +} + +static void RtemsIntrReqHandlerIterate_Post_Visit_Check( + RtemsIntrReqHandlerIterate_Context *ctx, + RtemsIntrReqHandlerIterate_Post_Visit state +) +{ + switch ( state ) { + case RtemsIntrReqHandlerIterate_Post_Visit_Yes: { + /* + * For each interrupt entry installed at the interrupt vector specified + * by ``vector`` the visitor routine specified by ``routine`` shall be + * called with the argument specified by ``arg``, the entry information, + * the entry install options, the entry handler routine, and the entry + * handler argument. + */ + T_eq_u32( ctx->visited_entries, 1 ); + break; + } + + case RtemsIntrReqHandlerIterate_Post_Visit_Nop: { + /* + * The visitor routine specified by ``routine`` shall not be called. + */ + T_eq_u32( ctx->visited_entries, 0 ); + break; + } + + case RtemsIntrReqHandlerIterate_Post_Visit_NA: + break; + } +} + +static void RtemsIntrReqHandlerIterate_Setup( + RtemsIntrReqHandlerIterate_Context *ctx +) +{ + rtems_status_code sc; + + ctx->initialized_during_setup = bsp_interrupt_is_initialized(); + ctx->test_vector = GetTestableInterruptVector(); + rtems_interrupt_entry_initialize( + &ctx->entry, + EntryRoutine, + &entry_arg, + entry_info + ); + sc = rtems_interrupt_entry_install( + ctx->test_vector, + RTEMS_INTERRUPT_UNIQUE, + &ctx->entry + ); + T_rsc_success( sc ); +} + +static void RtemsIntrReqHandlerIterate_Setup_Wrap( void *arg ) +{ + RtemsIntrReqHandlerIterate_Context *ctx; + + ctx = arg; + ctx->in_action_loop = false; + RtemsIntrReqHandlerIterate_Setup( ctx ); +} + +static void RtemsIntrReqHandlerIterate_Action( + RtemsIntrReqHandlerIterate_Context *ctx +) +{ + if ( ctx->isr ) { + CallWithinISR( Action, ctx ); + } else { + Action( ctx ); + } +} + +typedef struct { + uint16_t Skip : 1; + uint16_t Pre_Vector_NA : 1; + uint16_t Pre_Routine_NA : 1; + uint16_t Pre_Init_NA : 1; + uint16_t Pre_ISR_NA : 1; + uint16_t Post_Status : 3; + uint16_t Post_Visit : 2; +} RtemsIntrReqHandlerIterate_Entry; + +static const RtemsIntrReqHandlerIterate_Entry +RtemsIntrReqHandlerIterate_Entries[] = { + { 0, 0, 0, 0, 0, RtemsIntrReqHandlerIterate_Post_Status_IncStat, + RtemsIntrReqHandlerIterate_Post_Visit_Nop }, + { 0, 0, 0, 0, 0, RtemsIntrReqHandlerIterate_Post_Status_InvAddr, + RtemsIntrReqHandlerIterate_Post_Visit_NA }, + { 0, 0, 0, 0, 0, RtemsIntrReqHandlerIterate_Post_Status_IncStat, + RtemsIntrReqHandlerIterate_Post_Visit_NA }, + { 0, 0, 0, 0, 0, RtemsIntrReqHandlerIterate_Post_Status_InvId, + RtemsIntrReqHandlerIterate_Post_Visit_Nop }, + { 0, 0, 0, 0, 0, RtemsIntrReqHandlerIterate_Post_Status_CalledFromISR, + RtemsIntrReqHandlerIterate_Post_Visit_Nop }, + { 0, 0, 0, 0, 0, RtemsIntrReqHandlerIterate_Post_Status_Ok, + RtemsIntrReqHandlerIterate_Post_Visit_Yes } +}; + +static const uint8_t +RtemsIntrReqHandlerIterate_Map[] = { + 4, 5, 0, 0, 1, 1, 2, 2, 3, 3, 0, 0, 1, 1, 2, 2 +}; + +static size_t RtemsIntrReqHandlerIterate_Scope( + void *arg, + char *buf, + size_t n +) +{ + RtemsIntrReqHandlerIterate_Context *ctx; + + ctx = arg; + + if ( ctx->in_action_loop ) { + return T_get_scope( RtemsIntrReqHandlerIterate_PreDesc, buf, n, ctx->pcs ); + } + + return 0; +} + +static T_fixture RtemsIntrReqHandlerIterate_Fixture = { + .setup = RtemsIntrReqHandlerIterate_Setup_Wrap, + .stop = NULL, + .teardown = NULL, + .scope = RtemsIntrReqHandlerIterate_Scope, + .initial_context = &RtemsIntrReqHandlerIterate_Instance +}; + +static inline RtemsIntrReqHandlerIterate_Entry +RtemsIntrReqHandlerIterate_GetEntry( size_t index ) +{ + return RtemsIntrReqHandlerIterate_Entries[ + RtemsIntrReqHandlerIterate_Map[ index ] + ]; +} + +/** + * @fn void T_case_body_RtemsIntrReqHandlerIterate( void ) + */ +T_TEST_CASE_FIXTURE( + RtemsIntrReqHandlerIterate, + &RtemsIntrReqHandlerIterate_Fixture +) +{ + RtemsIntrReqHandlerIterate_Context *ctx; + size_t index; + + ctx = T_fixture_context(); + ctx->in_action_loop = true; + index = 0; + + for ( + ctx->pcs[ 0 ] = RtemsIntrReqHandlerIterate_Pre_Vector_Valid; + ctx->pcs[ 0 ] < RtemsIntrReqHandlerIterate_Pre_Vector_NA; + ++ctx->pcs[ 0 ] + ) { + for ( + ctx->pcs[ 1 ] = RtemsIntrReqHandlerIterate_Pre_Routine_Valid; + ctx->pcs[ 1 ] < RtemsIntrReqHandlerIterate_Pre_Routine_NA; + ++ctx->pcs[ 1 ] + ) { + for ( + ctx->pcs[ 2 ] = RtemsIntrReqHandlerIterate_Pre_Init_Yes; + ctx->pcs[ 2 ] < RtemsIntrReqHandlerIterate_Pre_Init_NA; + ++ctx->pcs[ 2 ] + ) { + for ( + ctx->pcs[ 3 ] = RtemsIntrReqHandlerIterate_Pre_ISR_Yes; + ctx->pcs[ 3 ] < RtemsIntrReqHandlerIterate_Pre_ISR_NA; + ++ctx->pcs[ 3 ] + ) { + RtemsIntrReqHandlerIterate_Entry entry; + + entry = RtemsIntrReqHandlerIterate_GetEntry( index ); + ++index; + + RtemsIntrReqHandlerIterate_Pre_Vector_Prepare( ctx, ctx->pcs[ 0 ] ); + RtemsIntrReqHandlerIterate_Pre_Routine_Prepare( ctx, ctx->pcs[ 1 ] ); + RtemsIntrReqHandlerIterate_Pre_Init_Prepare( ctx, ctx->pcs[ 2 ] ); + RtemsIntrReqHandlerIterate_Pre_ISR_Prepare( ctx, ctx->pcs[ 3 ] ); + RtemsIntrReqHandlerIterate_Action( ctx ); + RtemsIntrReqHandlerIterate_Post_Status_Check( + ctx, + entry.Post_Status + ); + RtemsIntrReqHandlerIterate_Post_Visit_Check( ctx, entry.Post_Visit ); + } + } + } + } +} + +/** @} */ -- cgit v1.2.3