summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorFrank Kühndel <frank.kuehndel@embedded-brains.de>2021-05-03 12:11:27 +0200
committerSebastian Huber <sebastian.huber@embedded-brains.de>2021-07-12 15:09:24 +0200
commite2537757c57a0bbbcf838ad17746132b96d7cb2b (patch)
tree9bac8ae8fb53f5f130de801d6c128cb9a89db176
parent182ce7fd17ff771c9065dff1bd3c1b92d91e2cc0 (diff)
validation: Code for timer cancel & rests tests
This additional manual crafted code is needed to compile the timer manager tests for rtems_timer_cancel() and rtems_timer_reset(). validation-2.yml: Add the new test files. testsuites/validation/tx-timer-server.c: New functions to permit tests to read RTEMS timer internal states.
-rw-r--r--spec/build/testsuites/validation/validation-2.yml2
-rw-r--r--testsuites/validation/tc-timer-cancel.c791
-rw-r--r--testsuites/validation/tc-timer-reset.c1036
3 files changed, 1829 insertions, 0 deletions
diff --git a/spec/build/testsuites/validation/validation-2.yml b/spec/build/testsuites/validation/validation-2.yml
index 808a78fcac..78d8566f43 100644
--- a/spec/build/testsuites/validation/validation-2.yml
+++ b/spec/build/testsuites/validation/validation-2.yml
@@ -12,7 +12,9 @@ ldflags: []
links: []
source:
- testsuites/validation/ts-validation-2.c
+- testsuites/validation/tc-timer-cancel.c
- testsuites/validation/tc-timer-initiate-server.c
+- testsuites/validation/tc-timer-reset.c
stlib: []
target: testsuites/validation/ts-validation-2.exe
type: build
diff --git a/testsuites/validation/tc-timer-cancel.c b/testsuites/validation/tc-timer-cancel.c
new file mode 100644
index 0000000000..2f947beba2
--- /dev/null
+++ b/testsuites/validation/tc-timer-cancel.c
@@ -0,0 +1,791 @@
+/* SPDX-License-Identifier: BSD-2-Clause */
+
+/**
+ * @file
+ *
+ * @ingroup RTEMSTestCaseRtemsTimerReqCancel
+ */
+
+/*
+ * 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 <rtems.h>
+
+#include "tx-support.h"
+
+#include <rtems/test.h>
+
+/**
+ * @defgroup RTEMSTestCaseRtemsTimerReqCancel spec:/rtems/timer/req/cancel
+ *
+ * @ingroup RTEMSTestSuiteTestsuitesValidation2
+ *
+ * @{
+ */
+
+typedef enum {
+ RtemsTimerReqCancel_Pre_Id_Valid,
+ RtemsTimerReqCancel_Pre_Id_Invalid,
+ RtemsTimerReqCancel_Pre_Id_NA
+} RtemsTimerReqCancel_Pre_Id;
+
+typedef enum {
+ RtemsTimerReqCancel_Pre_Context_None,
+ RtemsTimerReqCancel_Pre_Context_Interrupt,
+ RtemsTimerReqCancel_Pre_Context_Server,
+ RtemsTimerReqCancel_Pre_Context_NA
+} RtemsTimerReqCancel_Pre_Context;
+
+typedef enum {
+ RtemsTimerReqCancel_Pre_Clock_None,
+ RtemsTimerReqCancel_Pre_Clock_Ticks,
+ RtemsTimerReqCancel_Pre_Clock_Realtime,
+ RtemsTimerReqCancel_Pre_Clock_NA
+} RtemsTimerReqCancel_Pre_Clock;
+
+typedef enum {
+ RtemsTimerReqCancel_Pre_State_Inactive,
+ RtemsTimerReqCancel_Pre_State_Scheduled,
+ RtemsTimerReqCancel_Pre_State_Pending,
+ RtemsTimerReqCancel_Pre_State_NA
+} RtemsTimerReqCancel_Pre_State;
+
+typedef enum {
+ RtemsTimerReqCancel_Post_Status_Ok,
+ RtemsTimerReqCancel_Post_Status_InvId,
+ RtemsTimerReqCancel_Post_Status_NA
+} RtemsTimerReqCancel_Post_Status;
+
+typedef enum {
+ RtemsTimerReqCancel_Post_Context_None,
+ RtemsTimerReqCancel_Post_Context_Interrupt,
+ RtemsTimerReqCancel_Post_Context_Server,
+ RtemsTimerReqCancel_Post_Context_Nop,
+ RtemsTimerReqCancel_Post_Context_NA
+} RtemsTimerReqCancel_Post_Context;
+
+typedef enum {
+ RtemsTimerReqCancel_Post_Clock_None,
+ RtemsTimerReqCancel_Post_Clock_Ticks,
+ RtemsTimerReqCancel_Post_Clock_Realtime,
+ RtemsTimerReqCancel_Post_Clock_Nop,
+ RtemsTimerReqCancel_Post_Clock_NA
+} RtemsTimerReqCancel_Post_Clock;
+
+typedef enum {
+ RtemsTimerReqCancel_Post_State_Inactive,
+ RtemsTimerReqCancel_Post_State_Nop,
+ RtemsTimerReqCancel_Post_State_NA
+} RtemsTimerReqCancel_Post_State;
+
+typedef enum {
+ PRE_NONE = 0,
+ PRE_INTERRUPT = 1,
+ PRE_SERVER = 2
+} PreConditionContext;
+
+/**
+ * @brief Test context for spec:/rtems/timer/req/cancel test case.
+ */
+typedef struct {
+ /**
+ * @brief This member contains a valid id of a timer.
+ */
+ rtems_id timer_id;
+
+ /**
+ * @brief This member specifies the ``id`` parameter for the action.
+ */
+ rtems_id id_param;
+
+ /**
+ * @brief This member contains the return status of the action.
+ */
+ rtems_status_code status;
+
+ /**
+ * @brief This member contains the counter for invocations of the Timer
+ * Service Routine.
+ */
+ int invocations;
+
+ /**
+ * @brief This member specifies which pre-condition context (none, interrupt
+ * context, server context) must be created before the cancel action gets
+ * executed.
+ */
+ PreConditionContext pre_cond_contex;
+
+ /**
+ * @brief This member stores RTEMS internal clock and context settings of the
+ * timer before the execution of the test action.
+ */
+ Timer_Classes pre_class;
+
+ /**
+ * @brief This member stores the state of the timer before the execution of
+ * the test action.
+ */
+ Timer_States pre_state;
+
+ /**
+ * @brief This member stores the state of the timer after the execution of
+ * the test action.
+ */
+ Timer_States post_state;
+
+ /**
+ * @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;
+} RtemsTimerReqCancel_Context;
+
+static RtemsTimerReqCancel_Context
+ RtemsTimerReqCancel_Instance;
+
+static const char * const RtemsTimerReqCancel_PreDesc_Id[] = {
+ "Valid",
+ "Invalid",
+ "NA"
+};
+
+static const char * const RtemsTimerReqCancel_PreDesc_Context[] = {
+ "None",
+ "Interrupt",
+ "Server",
+ "NA"
+};
+
+static const char * const RtemsTimerReqCancel_PreDesc_Clock[] = {
+ "None",
+ "Ticks",
+ "Realtime",
+ "NA"
+};
+
+static const char * const RtemsTimerReqCancel_PreDesc_State[] = {
+ "Inactive",
+ "Scheduled",
+ "Pending",
+ "NA"
+};
+
+static const char * const * const RtemsTimerReqCancel_PreDesc[] = {
+ RtemsTimerReqCancel_PreDesc_Id,
+ RtemsTimerReqCancel_PreDesc_Context,
+ RtemsTimerReqCancel_PreDesc_Clock,
+ RtemsTimerReqCancel_PreDesc_State,
+ NULL
+};
+
+static const rtems_time_of_day tod_now = { 2000, 1, 1, 0, 0, 0, 0 };
+static const rtems_time_of_day tod_schedule = { 2000, 1, 1, 1, 0, 0, 0 };
+static const rtems_time_of_day tod_fire = { 2000, 1, 2, 0, 0, 0, 0 };
+
+static void TriggerTimer( void )
+{
+ /* Fire the timer service routine for ticks and realtime clock */
+ int i;
+ for ( i = 0; i < 5; i++ ) {
+ ClockTick();
+ }
+ T_rsc_success( rtems_clock_set( &tod_fire ) );
+}
+
+RTEMS_INLINE_ROUTINE void TimerServiceRoutine(
+ rtems_id timer_id,
+ void *user_data
+)
+{
+ RtemsTimerReqCancel_Context *ctx = user_data;
+ ++( ctx->invocations );
+}
+
+static void RtemsTimerReqCancel_Pre_Id_Prepare(
+ RtemsTimerReqCancel_Context *ctx,
+ RtemsTimerReqCancel_Pre_Id state
+)
+{
+ switch ( state ) {
+ case RtemsTimerReqCancel_Pre_Id_Valid: {
+ /*
+ * While the ``id`` parameter is valid.
+ */
+ ctx->id_param = ctx->timer_id;
+ break;
+ }
+
+ case RtemsTimerReqCancel_Pre_Id_Invalid: {
+ /*
+ * While the ``id`` parameter is invalid.
+ */
+ ctx->id_param = RTEMS_ID_NONE;
+ break;
+ }
+
+ case RtemsTimerReqCancel_Pre_Id_NA:
+ break;
+ }
+}
+
+static void RtemsTimerReqCancel_Pre_Context_Prepare(
+ RtemsTimerReqCancel_Context *ctx,
+ RtemsTimerReqCancel_Pre_Context state
+)
+{
+ switch ( state ) {
+ case RtemsTimerReqCancel_Pre_Context_None: {
+ /*
+ * While the Timer Service Routine has never been scheduled since
+ * creation of the timer. See also none.
+ */
+ ctx->pre_cond_contex = PRE_NONE;
+ break;
+ }
+
+ case RtemsTimerReqCancel_Pre_Context_Interrupt: {
+ /*
+ * While the timer is in interrupt context.
+ */
+ ctx->pre_cond_contex = PRE_INTERRUPT;
+ break;
+ }
+
+ case RtemsTimerReqCancel_Pre_Context_Server: {
+ /*
+ * While the timer is in server context.
+ */
+ ctx->pre_cond_contex = PRE_SERVER;
+ break;
+ }
+
+ case RtemsTimerReqCancel_Pre_Context_NA:
+ break;
+ }
+}
+
+static void RtemsTimerReqCancel_Pre_Clock_Prepare(
+ RtemsTimerReqCancel_Context *ctx,
+ RtemsTimerReqCancel_Pre_Clock state
+)
+{
+ switch ( state ) {
+ case RtemsTimerReqCancel_Pre_Clock_None: {
+ /*
+ * While the timer has never been scheduled since creation of the timer.
+ */
+ T_eq_int( ctx->pre_cond_contex, PRE_NONE );
+ break;
+ }
+
+ case RtemsTimerReqCancel_Pre_Clock_Ticks: {
+ /*
+ * While the clock used to determine when the timer will fire is the
+ * ticks based clock.
+ */
+ rtems_status_code status;
+
+ if ( ctx->pre_cond_contex == PRE_INTERRUPT ) {
+ status = rtems_timer_fire_after(
+ ctx->timer_id,
+ 1,
+ TimerServiceRoutine,
+ ctx
+ );
+ } else {
+ status = rtems_timer_server_fire_after(
+ ctx->timer_id,
+ 1,
+ TimerServiceRoutine,
+ ctx
+ );
+ }
+ T_rsc_success( status );
+ break;
+ }
+
+ case RtemsTimerReqCancel_Pre_Clock_Realtime: {
+ /*
+ * While the clock used to determine when the timer will fire is the
+ * realtime clock.
+ */
+ rtems_status_code status;
+
+ if ( ctx->pre_cond_contex == PRE_INTERRUPT ) {
+ status = rtems_timer_fire_when(
+ ctx->timer_id,
+ &tod_schedule,
+ TimerServiceRoutine,
+ ctx
+ );
+ } else {
+ status = rtems_timer_server_fire_when(
+ ctx->timer_id,
+ &tod_schedule,
+ TimerServiceRoutine,
+ ctx
+ );
+ }
+ T_rsc_success( status );
+ break;
+ }
+
+ case RtemsTimerReqCancel_Pre_Clock_NA:
+ break;
+ }
+}
+
+static void RtemsTimerReqCancel_Pre_State_Prepare(
+ RtemsTimerReqCancel_Context *ctx,
+ RtemsTimerReqCancel_Pre_State state
+)
+{
+ switch ( state ) {
+ case RtemsTimerReqCancel_Pre_State_Inactive: {
+ /*
+ * While the timer is in inactive state.
+ */
+ TriggerTimer();
+ T_eq_int(
+ ctx->invocations,
+ ( ctx->pre_cond_contex == PRE_NONE ) ? 0 : 1
+ );
+ ctx->invocations = 0;
+ ctx->pre_state = TIMER_INACTIVE;
+ break;
+ }
+
+ case RtemsTimerReqCancel_Pre_State_Scheduled: {
+ /*
+ * While the timer is in scheduled state.
+ */
+ /* The timer was already scheduled in the "Clock" pre-conditions. */
+ ctx->pre_state = TIMER_SCHEDULED;
+ break;
+ }
+
+ case RtemsTimerReqCancel_Pre_State_Pending: {
+ /*
+ * While the timer is in pending state.
+ */
+ T_rsc_success( rtems_task_suspend( GetTimerServerTaskId() ) );
+ TriggerTimer();
+ T_eq_int( ctx->invocations, 0 );
+ ctx->pre_state = TIMER_PENDING;
+ break;
+ }
+
+ case RtemsTimerReqCancel_Pre_State_NA:
+ break;
+ }
+}
+
+static void RtemsTimerReqCancel_Post_Status_Check(
+ RtemsTimerReqCancel_Context *ctx,
+ RtemsTimerReqCancel_Post_Status state
+)
+{
+ switch ( state ) {
+ case RtemsTimerReqCancel_Post_Status_Ok: {
+ /*
+ * The return status of rtems_timer_cancel() shall be RTEMS_SUCCESSFUL.
+ */
+ T_rsc_success( ctx->status );
+ break;
+ }
+
+ case RtemsTimerReqCancel_Post_Status_InvId: {
+ /*
+ * The return status of rtems_timer_cancel() shall be RTEMS_INVALID_ID.
+ */
+ T_rsc( ctx->status, RTEMS_INVALID_ID );
+ break;
+ }
+
+ case RtemsTimerReqCancel_Post_Status_NA:
+ break;
+ }
+}
+
+static void RtemsTimerReqCancel_Post_Context_Check(
+ RtemsTimerReqCancel_Context *ctx,
+ RtemsTimerReqCancel_Post_Context state
+)
+{
+ Timer_Classes class;
+ class = GetTimerClass( ctx->timer_id );
+
+ switch ( state ) {
+ case RtemsTimerReqCancel_Post_Context_None: {
+ /*
+ * The timer shall have never been scheduled. See also none.
+ */
+ T_eq_int( class, TIMER_DORMANT );
+ break;
+ }
+
+ case RtemsTimerReqCancel_Post_Context_Interrupt: {
+ /*
+ * The timer shall be in interrupt context.
+ */
+ T_eq_int( class & TIMER_CLASS_BIT_ON_TASK, 0 );
+ break;
+ }
+
+ case RtemsTimerReqCancel_Post_Context_Server: {
+ /*
+ * The timer shall be in server context.
+ */
+ T_eq_int( class & TIMER_CLASS_BIT_ON_TASK, TIMER_CLASS_BIT_ON_TASK );
+ break;
+ }
+
+ case RtemsTimerReqCancel_Post_Context_Nop: {
+ /*
+ * Objects referenced by the ``id`` parameter in past call to
+ * rtems_timer_cancel() shall not be accessed by the rtems_timer_cancel()
+ * call. See also Nop.
+ */
+ T_eq_int( class, ctx->pre_class );
+ break;
+ }
+
+ case RtemsTimerReqCancel_Post_Context_NA:
+ break;
+ }
+}
+
+static void RtemsTimerReqCancel_Post_Clock_Check(
+ RtemsTimerReqCancel_Context *ctx,
+ RtemsTimerReqCancel_Post_Clock state
+)
+{
+ Timer_Classes class;
+ class = GetTimerClass( ctx->timer_id );
+
+ switch ( state ) {
+ case RtemsTimerReqCancel_Post_Clock_None: {
+ /*
+ * The timer shall have never been scheduled.
+ */
+ T_eq_int( class, TIMER_DORMANT );
+ break;
+ }
+
+ case RtemsTimerReqCancel_Post_Clock_Ticks: {
+ /*
+ * The timer shall use the ticks based clock.
+ */
+ T_eq_int( class & TIMER_CLASS_BIT_TIME_OF_DAY, 0 );
+ break;
+ }
+
+ case RtemsTimerReqCancel_Post_Clock_Realtime: {
+ /*
+ * The timer shall use the realtime clock.
+ */
+ T_eq_int(
+ class & TIMER_CLASS_BIT_TIME_OF_DAY,
+ TIMER_CLASS_BIT_TIME_OF_DAY
+ );
+ break;
+ }
+
+ case RtemsTimerReqCancel_Post_Clock_Nop: {
+ /*
+ * Objects referenced by the ``id`` parameter in past call to
+ * rtems_timer_cancel() shall not be accessed by the rtems_timer_cancel()
+ * call.
+ */
+ T_eq_int( class, ctx->pre_class );
+ break;
+ }
+
+ case RtemsTimerReqCancel_Post_Clock_NA:
+ break;
+ }
+}
+
+static void RtemsTimerReqCancel_Post_State_Check(
+ RtemsTimerReqCancel_Context *ctx,
+ RtemsTimerReqCancel_Post_State state
+)
+{
+ switch ( state ) {
+ case RtemsTimerReqCancel_Post_State_Inactive: {
+ /*
+ * The timer shall be in inactive state.
+ */
+ /* Try to fire the timer service routine - which should not fire. */
+ TriggerTimer();
+ T_eq_int( ctx->invocations, 0 );
+ break;
+ }
+
+ case RtemsTimerReqCancel_Post_State_Nop: {
+ /*
+ * Objects referenced by the ``id`` parameter in past call to
+ * rtems_timer_cancel() shall not be accessed by the rtems_timer_cancel()
+ * call.
+ */
+ T_eq_int( ctx->post_state, ctx->pre_state );
+ break;
+ }
+
+ case RtemsTimerReqCancel_Post_State_NA:
+ break;
+ }
+}
+
+static void RtemsTimerReqCancel_Setup( RtemsTimerReqCancel_Context *ctx )
+{
+ rtems_status_code status;
+ status = rtems_timer_initiate_server(
+ RTEMS_TIMER_SERVER_DEFAULT_PRIORITY,
+ RTEMS_MINIMUM_STACK_SIZE,
+ RTEMS_DEFAULT_ATTRIBUTES
+ );
+ T_rsc_success( status );
+}
+
+static void RtemsTimerReqCancel_Setup_Wrap( void *arg )
+{
+ RtemsTimerReqCancel_Context *ctx;
+
+ ctx = arg;
+ ctx->in_action_loop = false;
+ RtemsTimerReqCancel_Setup( ctx );
+}
+
+/**
+ * @brief Make sure the timer server is not running and the realtime clock is
+ * not set after this test.
+ */
+static void RtemsTimerReqCancel_Teardown( RtemsTimerReqCancel_Context *ctx )
+{
+ DeleteTimerServer();
+ UnsetClock();
+}
+
+static void RtemsTimerReqCancel_Teardown_Wrap( void *arg )
+{
+ RtemsTimerReqCancel_Context *ctx;
+
+ ctx = arg;
+ ctx->in_action_loop = false;
+ RtemsTimerReqCancel_Teardown( ctx );
+}
+
+static void RtemsTimerReqCancel_Prepare( RtemsTimerReqCancel_Context *ctx )
+{
+ rtems_status_code status;
+ status = rtems_timer_create(
+ rtems_build_name( 'T', 'I', 'M', 'E' ),
+ &ctx->timer_id
+ );
+ T_rsc_success( status );
+
+ ctx->invocations = 0;
+ T_rsc_success( rtems_clock_set( &tod_now ) );
+}
+
+static void RtemsTimerReqCancel_Action( RtemsTimerReqCancel_Context *ctx )
+{
+ ctx->pre_class = GetTimerClass( ctx->timer_id );
+ ctx->status = rtems_timer_cancel( ctx->id_param );
+ ctx->post_state = GetTimerState( ctx->timer_id );
+ /* Ignoring return status: the timer server task may be suspended or not. */
+ rtems_task_resume( GetTimerServerTaskId() );
+}
+
+static void RtemsTimerReqCancel_Cleanup( RtemsTimerReqCancel_Context *ctx )
+{
+ T_rsc_success( rtems_timer_delete( ctx->timer_id ) );
+}
+
+typedef struct {
+ uint16_t Skip : 1;
+ uint16_t Pre_Id_NA : 1;
+ uint16_t Pre_Context_NA : 1;
+ uint16_t Pre_Clock_NA : 1;
+ uint16_t Pre_State_NA : 1;
+ uint16_t Post_Status : 2;
+ uint16_t Post_Context : 3;
+ uint16_t Post_Clock : 3;
+ uint16_t Post_State : 2;
+} RtemsTimerReqCancel_Entry;
+
+static const RtemsTimerReqCancel_Entry
+RtemsTimerReqCancel_Entries[] = {
+ { 1, 0, 0, 0, 0, RtemsTimerReqCancel_Post_Status_NA,
+ RtemsTimerReqCancel_Post_Context_NA, RtemsTimerReqCancel_Post_Clock_NA,
+ RtemsTimerReqCancel_Post_State_NA },
+ { 0, 0, 0, 0, 0, RtemsTimerReqCancel_Post_Status_InvId,
+ RtemsTimerReqCancel_Post_Context_Nop, RtemsTimerReqCancel_Post_Clock_Nop,
+ RtemsTimerReqCancel_Post_State_Nop },
+ { 0, 0, 0, 0, 0, RtemsTimerReqCancel_Post_Status_Ok,
+ RtemsTimerReqCancel_Post_Context_Server,
+ RtemsTimerReqCancel_Post_Clock_Ticks,
+ RtemsTimerReqCancel_Post_State_Inactive },
+ { 0, 0, 0, 0, 0, RtemsTimerReqCancel_Post_Status_Ok,
+ RtemsTimerReqCancel_Post_Context_Server,
+ RtemsTimerReqCancel_Post_Clock_Realtime,
+ RtemsTimerReqCancel_Post_State_Inactive },
+ { 0, 0, 0, 0, 0, RtemsTimerReqCancel_Post_Status_Ok,
+ RtemsTimerReqCancel_Post_Context_Interrupt,
+ RtemsTimerReqCancel_Post_Clock_Ticks,
+ RtemsTimerReqCancel_Post_State_Inactive },
+ { 0, 0, 0, 0, 0, RtemsTimerReqCancel_Post_Status_Ok,
+ RtemsTimerReqCancel_Post_Context_Interrupt,
+ RtemsTimerReqCancel_Post_Clock_Realtime,
+ RtemsTimerReqCancel_Post_State_Inactive },
+ { 0, 0, 0, 0, 0, RtemsTimerReqCancel_Post_Status_Ok,
+ RtemsTimerReqCancel_Post_Context_None, RtemsTimerReqCancel_Post_Clock_None,
+ RtemsTimerReqCancel_Post_State_Inactive }
+};
+
+static const uint8_t
+RtemsTimerReqCancel_Map[] = {
+ 6, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 4, 4, 0, 5, 5, 0, 0, 0, 0, 2, 2, 2, 3, 3,
+ 3, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 0, 1, 1, 0, 0, 0, 0, 1, 1, 1, 1,
+ 1, 1
+};
+
+static size_t RtemsTimerReqCancel_Scope( void *arg, char *buf, size_t n )
+{
+ RtemsTimerReqCancel_Context *ctx;
+
+ ctx = arg;
+
+ if ( ctx->in_action_loop ) {
+ return T_get_scope( RtemsTimerReqCancel_PreDesc, buf, n, ctx->pcs );
+ }
+
+ return 0;
+}
+
+static T_fixture RtemsTimerReqCancel_Fixture = {
+ .setup = RtemsTimerReqCancel_Setup_Wrap,
+ .stop = NULL,
+ .teardown = RtemsTimerReqCancel_Teardown_Wrap,
+ .scope = RtemsTimerReqCancel_Scope,
+ .initial_context = &RtemsTimerReqCancel_Instance
+};
+
+static inline RtemsTimerReqCancel_Entry RtemsTimerReqCancel_GetEntry(
+ size_t index
+)
+{
+ return RtemsTimerReqCancel_Entries[
+ RtemsTimerReqCancel_Map[ index ]
+ ];
+}
+
+/**
+ * @fn void T_case_body_RtemsTimerReqCancel( void )
+ */
+T_TEST_CASE_FIXTURE( RtemsTimerReqCancel, &RtemsTimerReqCancel_Fixture )
+{
+ RtemsTimerReqCancel_Context *ctx;
+ size_t index;
+
+ ctx = T_fixture_context();
+ ctx->in_action_loop = true;
+ index = 0;
+
+ for (
+ ctx->pcs[ 0 ] = RtemsTimerReqCancel_Pre_Id_Valid;
+ ctx->pcs[ 0 ] < RtemsTimerReqCancel_Pre_Id_NA;
+ ++ctx->pcs[ 0 ]
+ ) {
+ for (
+ ctx->pcs[ 1 ] = RtemsTimerReqCancel_Pre_Context_None;
+ ctx->pcs[ 1 ] < RtemsTimerReqCancel_Pre_Context_NA;
+ ++ctx->pcs[ 1 ]
+ ) {
+ for (
+ ctx->pcs[ 2 ] = RtemsTimerReqCancel_Pre_Clock_None;
+ ctx->pcs[ 2 ] < RtemsTimerReqCancel_Pre_Clock_NA;
+ ++ctx->pcs[ 2 ]
+ ) {
+ for (
+ ctx->pcs[ 3 ] = RtemsTimerReqCancel_Pre_State_Inactive;
+ ctx->pcs[ 3 ] < RtemsTimerReqCancel_Pre_State_NA;
+ ++ctx->pcs[ 3 ]
+ ) {
+ RtemsTimerReqCancel_Entry entry;
+
+ entry = RtemsTimerReqCancel_GetEntry( index );
+ ++index;
+
+ if ( entry.Skip ) {
+ continue;
+ }
+
+ RtemsTimerReqCancel_Prepare( ctx );
+ RtemsTimerReqCancel_Pre_Id_Prepare( ctx, ctx->pcs[ 0 ] );
+ RtemsTimerReqCancel_Pre_Context_Prepare( ctx, ctx->pcs[ 1 ] );
+ RtemsTimerReqCancel_Pre_Clock_Prepare( ctx, ctx->pcs[ 2 ] );
+ RtemsTimerReqCancel_Pre_State_Prepare( ctx, ctx->pcs[ 3 ] );
+ RtemsTimerReqCancel_Action( ctx );
+ RtemsTimerReqCancel_Post_Status_Check( ctx, entry.Post_Status );
+ RtemsTimerReqCancel_Post_Context_Check( ctx, entry.Post_Context );
+ RtemsTimerReqCancel_Post_Clock_Check( ctx, entry.Post_Clock );
+ RtemsTimerReqCancel_Post_State_Check( ctx, entry.Post_State );
+ RtemsTimerReqCancel_Cleanup( ctx );
+ }
+ }
+ }
+ }
+}
+
+/** @} */
diff --git a/testsuites/validation/tc-timer-reset.c b/testsuites/validation/tc-timer-reset.c
new file mode 100644
index 0000000000..bec2b7bbfc
--- /dev/null
+++ b/testsuites/validation/tc-timer-reset.c
@@ -0,0 +1,1036 @@
+/* SPDX-License-Identifier: BSD-2-Clause */
+
+/**
+ * @file
+ *
+ * @ingroup RTEMSTestCaseRtemsTimerReqReset
+ */
+
+/*
+ * 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 <rtems.h>
+
+#include "tx-support.h"
+
+#include <rtems/test.h>
+
+/**
+ * @defgroup RTEMSTestCaseRtemsTimerReqReset spec:/rtems/timer/req/reset
+ *
+ * @ingroup RTEMSTestSuiteTestsuitesValidation2
+ *
+ * @{
+ */
+
+typedef enum {
+ RtemsTimerReqReset_Pre_Id_Valid,
+ RtemsTimerReqReset_Pre_Id_Invalid,
+ RtemsTimerReqReset_Pre_Id_NA
+} RtemsTimerReqReset_Pre_Id;
+
+typedef enum {
+ RtemsTimerReqReset_Pre_Context_None,
+ RtemsTimerReqReset_Pre_Context_Interrupt,
+ RtemsTimerReqReset_Pre_Context_Server,
+ RtemsTimerReqReset_Pre_Context_NA
+} RtemsTimerReqReset_Pre_Context;
+
+typedef enum {
+ RtemsTimerReqReset_Pre_Clock_None,
+ RtemsTimerReqReset_Pre_Clock_Ticks,
+ RtemsTimerReqReset_Pre_Clock_Realtime,
+ RtemsTimerReqReset_Pre_Clock_NA
+} RtemsTimerReqReset_Pre_Clock;
+
+typedef enum {
+ RtemsTimerReqReset_Pre_State_Inactive,
+ RtemsTimerReqReset_Pre_State_Scheduled,
+ RtemsTimerReqReset_Pre_State_Pending,
+ RtemsTimerReqReset_Pre_State_NA
+} RtemsTimerReqReset_Pre_State;
+
+typedef enum {
+ RtemsTimerReqReset_Post_Status_Ok,
+ RtemsTimerReqReset_Post_Status_InvId,
+ RtemsTimerReqReset_Post_Status_NotDef,
+ RtemsTimerReqReset_Post_Status_NA
+} RtemsTimerReqReset_Post_Status;
+
+typedef enum {
+ RtemsTimerReqReset_Post_Context_None,
+ RtemsTimerReqReset_Post_Context_Interrupt,
+ RtemsTimerReqReset_Post_Context_Server,
+ RtemsTimerReqReset_Post_Context_Nop,
+ RtemsTimerReqReset_Post_Context_NA
+} RtemsTimerReqReset_Post_Context;
+
+typedef enum {
+ RtemsTimerReqReset_Post_Clock_None,
+ RtemsTimerReqReset_Post_Clock_Ticks,
+ RtemsTimerReqReset_Post_Clock_Realtime,
+ RtemsTimerReqReset_Post_Clock_Nop,
+ RtemsTimerReqReset_Post_Clock_NA
+} RtemsTimerReqReset_Post_Clock;
+
+typedef enum {
+ RtemsTimerReqReset_Post_State_Scheduled,
+ RtemsTimerReqReset_Post_State_Nop,
+ RtemsTimerReqReset_Post_State_NA
+} RtemsTimerReqReset_Post_State;
+
+typedef enum {
+ RtemsTimerReqReset_Post_Interval_Last,
+ RtemsTimerReqReset_Post_Interval_Nop,
+ RtemsTimerReqReset_Post_Interval_NA
+} RtemsTimerReqReset_Post_Interval;
+
+typedef enum {
+ RtemsTimerReqReset_Post_Routine_Last,
+ RtemsTimerReqReset_Post_Routine_Nop,
+ RtemsTimerReqReset_Post_Routine_NA
+} RtemsTimerReqReset_Post_Routine;
+
+typedef enum {
+ RtemsTimerReqReset_Post_UserData_Last,
+ RtemsTimerReqReset_Post_UserData_Nop,
+ RtemsTimerReqReset_Post_UserData_NA
+} RtemsTimerReqReset_Post_UserData;
+
+typedef enum {
+ PRE_NONE = 0,
+ PRE_INTERRUPT = 1,
+ PRE_SERVER = 2
+} PreConditionContext;
+
+typedef enum {
+ SCHEDULE_NONE = 0,
+ SCHEDULE_SOON = 1,
+ SCHEDULE_LATER = 2,
+ SCHEDULE_MAX = 5
+} Scheduling_Ticks;
+
+/**
+ * @brief Test context for spec:/rtems/timer/req/reset test case.
+ */
+typedef struct {
+ /**
+ * @brief This member contains a valid id of a timer.
+ */
+ rtems_id timer_id;
+
+ /**
+ * @brief This member specifies the ``id`` parameter for the action.
+ */
+ rtems_id id_param;
+
+ /**
+ * @brief This member contains the returned status code of the action.
+ */
+ rtems_status_code status;
+
+ /**
+ * @brief This member contains the user data for Timer Service Routine "A".
+ */
+ void *data_a;
+
+ /**
+ * @brief This member contains the user data for Timer Service Routine "B".
+ */
+ void *data_b;
+
+ /**
+ * @brief This member contains the counter for invocations of Timer Service
+ * Routine "A".
+ */
+ int invocations_a;
+
+ /**
+ * @brief This member contains the counter for invocations of Timer Service
+ * Routine "B".
+ */
+ int invocations_b;
+
+ /**
+ * @brief This member contains the number of ticks needed to fire the Timer
+ * Service Routine.
+ */
+ Scheduling_Ticks ticks_till_fire;
+
+ /**
+ * @brief This member identifier the user data given to the Timer Service
+ * Routine when called. It either the address of member data_a or data_b.
+ */
+ void **routine_user_data;
+
+ /**
+ * @brief This member contains a reference to the user data to be used in the
+ * next call to the Timer Service Routine.
+ */
+ void **scheduled_user_data;;
+
+ /**
+ * @brief This member contains 1 if the Timer Service Routine "A" has been
+ * scheduled otherwise 0.
+ */
+ int scheduled_invocations_a;
+
+ /**
+ * @brief This member contains 1 if the Timer Service Routine "B" has been
+ * scheduled otherwise 0.
+ */
+ int scheduled_invocations_b;
+
+ /**
+ * @brief This member specifies the number of ticks till the scheduled Timer
+ * Service Routine should fire.
+ */
+ Scheduling_Ticks scheduled_ticks_till_fire;
+
+ /**
+ * @brief This member specifies which pre-condition context (none, interrupt
+ * context, server context) must be created before the rtems_timer_reset()
+ * action gets executed.
+ */
+ PreConditionContext pre_cond_contex;
+
+ /**
+ * @brief This member stores internal clock and context settings of the timer
+ * before the execution of the test action.
+ */
+ Timer_Classes pre_class;
+
+ /**
+ * @brief This member stores the state of the timer before the execution of
+ * the test action.
+ */
+ Timer_States pre_state;
+
+ /**
+ * @brief This member stores the state of the timer after the execution of
+ * the test action.
+ */
+ Timer_States post_state;
+
+ /**
+ * @brief This member stores the scheduling data of the timer before the
+ * execution of the test action.
+ */
+ Timer_Scheduling_Data pre_scheduling_data;
+
+ /**
+ * @brief This member stores the scheduling data of the timer after the
+ * execution of the test action.
+ */
+ Timer_Scheduling_Data post_scheduling_data;
+
+ /**
+ * @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;
+} RtemsTimerReqReset_Context;
+
+static RtemsTimerReqReset_Context
+ RtemsTimerReqReset_Instance;
+
+static const char * const RtemsTimerReqReset_PreDesc_Id[] = {
+ "Valid",
+ "Invalid",
+ "NA"
+};
+
+static const char * const RtemsTimerReqReset_PreDesc_Context[] = {
+ "None",
+ "Interrupt",
+ "Server",
+ "NA"
+};
+
+static const char * const RtemsTimerReqReset_PreDesc_Clock[] = {
+ "None",
+ "Ticks",
+ "Realtime",
+ "NA"
+};
+
+static const char * const RtemsTimerReqReset_PreDesc_State[] = {
+ "Inactive",
+ "Scheduled",
+ "Pending",
+ "NA"
+};
+
+static const char * const * const RtemsTimerReqReset_PreDesc[] = {
+ RtemsTimerReqReset_PreDesc_Id,
+ RtemsTimerReqReset_PreDesc_Context,
+ RtemsTimerReqReset_PreDesc_Clock,
+ RtemsTimerReqReset_PreDesc_State,
+ NULL
+};
+
+static const rtems_time_of_day tod_now = { 2000, 1, 1, 0, 0, 0, 0 };
+static const rtems_time_of_day tod_schedule = { 2000, 1, 1, 1, 0, 0, 0 };
+static const rtems_time_of_day tod_fire = { 2000, 1, 2, 0, 0, 0, 0 };
+
+static Scheduling_Ticks TriggerTimer( const RtemsTimerReqReset_Context *ctx )
+{
+ int ticks_fired = SCHEDULE_NONE;
+ int invocations_old = ctx->invocations_a + ctx->invocations_b;
+
+ /* Fire the timer service routine for ticks and realtime clock */
+ int i;
+ for ( i = 1; i <= SCHEDULE_MAX; ++i ) {
+ ClockTick();
+ if ( ctx->invocations_a + ctx->invocations_b > invocations_old ) {
+ ticks_fired = i;
+ break;
+ }
+ }
+
+ T_rsc_success( rtems_clock_set( &tod_fire ) );
+
+ return ticks_fired;
+}
+
+RTEMS_INLINE_ROUTINE void TimerServiceRoutineA(
+ rtems_id timer_id,
+ void *user_data
+)
+{
+ RtemsTimerReqReset_Context *ctx =
+ *(RtemsTimerReqReset_Context **) user_data;
+ ++( ctx->invocations_a );
+ ctx->routine_user_data = user_data;
+}
+
+RTEMS_INLINE_ROUTINE void TimerServiceRoutineB(
+ rtems_id timer_id,
+ void *user_data
+)
+{
+ RtemsTimerReqReset_Context *ctx =
+ *(RtemsTimerReqReset_Context **) user_data;
+ ++( ctx->invocations_b );
+ ctx->routine_user_data = user_data;
+}
+
+static void RtemsTimerReqReset_Pre_Id_Prepare(
+ RtemsTimerReqReset_Context *ctx,
+ RtemsTimerReqReset_Pre_Id state
+)
+{
+ switch ( state ) {
+ case RtemsTimerReqReset_Pre_Id_Valid: {
+ /*
+ * While the ``id`` parameter is valid.
+ */
+ ctx->id_param = ctx->timer_id;
+ break;
+ }
+
+ case RtemsTimerReqReset_Pre_Id_Invalid: {
+ /*
+ * While the ``id`` parameter is invalid.
+ */
+ ctx->id_param = RTEMS_ID_NONE;
+ break;
+ }
+
+ case RtemsTimerReqReset_Pre_Id_NA:
+ break;
+ }
+}
+
+static void RtemsTimerReqReset_Pre_Context_Prepare(
+ RtemsTimerReqReset_Context *ctx,
+ RtemsTimerReqReset_Pre_Context state
+)
+{
+ switch ( state ) {
+ case RtemsTimerReqReset_Pre_Context_None: {
+ /*
+ * While the Timer Service Routine has never been scheduled since
+ * creation of the timer. See also none.
+ */
+ ctx->pre_cond_contex = PRE_NONE;
+ break;
+ }
+
+ case RtemsTimerReqReset_Pre_Context_Interrupt: {
+ /*
+ * While the timer is in interrupt context.
+ */
+ ctx->pre_cond_contex = PRE_INTERRUPT;
+ break;
+ }
+
+ case RtemsTimerReqReset_Pre_Context_Server: {
+ /*
+ * While the timer is in server context.
+ */
+ ctx->pre_cond_contex = PRE_SERVER;
+ break;
+ }
+
+ case RtemsTimerReqReset_Pre_Context_NA:
+ break;
+ }
+}
+
+static void RtemsTimerReqReset_Pre_Clock_Prepare(
+ RtemsTimerReqReset_Context *ctx,
+ RtemsTimerReqReset_Pre_Clock state
+)
+{
+ switch ( state ) {
+ case RtemsTimerReqReset_Pre_Clock_None: {
+ /*
+ * While the timer has never been scheduled since creation of the timer.
+ */
+ T_eq_int( ctx->pre_cond_contex, PRE_NONE );
+ break;
+ }
+
+ case RtemsTimerReqReset_Pre_Clock_Ticks: {
+ /*
+ * While the clock used to determine when the timer will fire is the
+ * ticks based clock.
+ */
+ rtems_status_code status;
+
+ if ( ctx->pre_cond_contex == PRE_INTERRUPT ) {
+ ctx->scheduled_ticks_till_fire = SCHEDULE_SOON;
+ ctx->scheduled_invocations_a = 1;
+ ctx->scheduled_user_data = &ctx->data_a;
+ status = rtems_timer_fire_after(
+ ctx->timer_id,
+ ctx->scheduled_ticks_till_fire,
+ TimerServiceRoutineA,
+ ctx->scheduled_user_data
+ );
+ } else {
+ ctx->scheduled_ticks_till_fire = SCHEDULE_LATER;
+ ctx->scheduled_invocations_b = 1;
+ ctx->scheduled_user_data = &ctx->data_b;
+ status = rtems_timer_server_fire_after(
+ ctx->timer_id,
+ ctx->scheduled_ticks_till_fire,
+ TimerServiceRoutineB,
+ ctx->scheduled_user_data
+ );
+ }
+ T_rsc_success( status );
+ break;
+ }
+
+ case RtemsTimerReqReset_Pre_Clock_Realtime: {
+ /*
+ * While the clock used to determine when the timer will fire is the
+ * realtime clock.
+ */
+ rtems_status_code status;
+
+ if ( ctx->pre_cond_contex == PRE_INTERRUPT ) {
+ status = rtems_timer_fire_when(
+ ctx->timer_id,
+ &tod_schedule,
+ TimerServiceRoutineA,
+ &ctx->data_a
+ );
+ } else {
+ status = rtems_timer_server_fire_when(
+ ctx->timer_id,
+ &tod_schedule,
+ TimerServiceRoutineB,
+ &ctx->data_b
+ );
+ }
+ T_rsc_success( status );
+ break;
+ }
+
+ case RtemsTimerReqReset_Pre_Clock_NA:
+ break;
+ }
+}
+
+static void RtemsTimerReqReset_Pre_State_Prepare(
+ RtemsTimerReqReset_Context *ctx,
+ RtemsTimerReqReset_Pre_State state
+)
+{
+ switch ( state ) {
+ case RtemsTimerReqReset_Pre_State_Inactive: {
+ /*
+ * While the timer is in inactive state.
+ */
+ TriggerTimer( ctx );
+ T_eq_int(
+ ctx->invocations_a + ctx->invocations_b,
+ ( ctx->pre_cond_contex == PRE_NONE ) ? 0 : 1
+ );
+ ctx->invocations_a = 0;
+ ctx->invocations_b = 0;
+ ctx->pre_state = TIMER_INACTIVE;
+ break;
+ }
+
+ case RtemsTimerReqReset_Pre_State_Scheduled: {
+ /*
+ * While the timer is in scheduled state.
+ */
+ /* The timer was already scheduled in the "Clock" pre-conditions. */
+ ctx->pre_state = TIMER_SCHEDULED;
+ break;
+ }
+
+ case RtemsTimerReqReset_Pre_State_Pending: {
+ /*
+ * While the timer is in pending state.
+ */
+ T_rsc_success( rtems_task_suspend( GetTimerServerTaskId() ) );
+ TriggerTimer( ctx );
+ T_eq_int( ctx->invocations_a + ctx->invocations_b, 0 );
+ ctx->pre_state = TIMER_PENDING;
+ break;
+ }
+
+ case RtemsTimerReqReset_Pre_State_NA:
+ break;
+ }
+}
+
+static void RtemsTimerReqReset_Post_Status_Check(
+ RtemsTimerReqReset_Context *ctx,
+ RtemsTimerReqReset_Post_Status state
+)
+{
+ switch ( state ) {
+ case RtemsTimerReqReset_Post_Status_Ok: {
+ /*
+ * The return status of rtems_timer_reset() shall be RTEMS_SUCCESSFUL.
+ */
+ T_rsc_success( ctx->status );
+ break;
+ }
+
+ case RtemsTimerReqReset_Post_Status_InvId: {
+ /*
+ * The return status of rtems_timer_reset() shall be RTEMS_INVALID_ID.
+ */
+ T_rsc( ctx->status, RTEMS_INVALID_ID );
+ break;
+ }
+
+ case RtemsTimerReqReset_Post_Status_NotDef: {
+ /*
+ * The return status of rtems_timer_reset() shall be RTEMS_NOT_DEFINED
+ */
+ T_rsc( ctx->status, RTEMS_NOT_DEFINED );
+ break;
+ }
+
+ case RtemsTimerReqReset_Post_Status_NA:
+ break;
+ }
+}
+
+static void RtemsTimerReqReset_Post_Context_Check(
+ RtemsTimerReqReset_Context *ctx,
+ RtemsTimerReqReset_Post_Context state
+)
+{
+ Timer_Classes class;
+ class = GetTimerClass( ctx->timer_id );
+
+ switch ( state ) {
+ case RtemsTimerReqReset_Post_Context_None: {
+ /*
+ * The timer shall have never been scheduled. See also none.
+ */
+ T_eq_int( class, TIMER_DORMANT );
+ break;
+ }
+
+ case RtemsTimerReqReset_Post_Context_Interrupt: {
+ /*
+ * The timer shall be in interrupt context.
+ */
+ T_eq_int( class & TIMER_CLASS_BIT_ON_TASK, 0 );
+ break;
+ }
+
+ case RtemsTimerReqReset_Post_Context_Server: {
+ /*
+ * The timer shall be in server context.
+ */
+ T_eq_int( class & TIMER_CLASS_BIT_ON_TASK, TIMER_CLASS_BIT_ON_TASK );
+ break;
+ }
+
+ case RtemsTimerReqReset_Post_Context_Nop: {
+ /*
+ * Objects referenced by the ``id`` parameter in past call to
+ * rtems_timer_reset() shall not be accessed by the rtems_timer_reset()
+ * call. See also Nop.
+ */
+ T_eq_int( class, ctx->pre_class );
+ break;
+ }
+
+ case RtemsTimerReqReset_Post_Context_NA:
+ break;
+ }
+}
+
+static void RtemsTimerReqReset_Post_Clock_Check(
+ RtemsTimerReqReset_Context *ctx,
+ RtemsTimerReqReset_Post_Clock state
+)
+{
+ Timer_Classes class;
+ class = GetTimerClass( ctx->timer_id );
+
+ switch ( state ) {
+ case RtemsTimerReqReset_Post_Clock_None: {
+ /*
+ * The timer shall have never been scheduled.
+ */
+ T_eq_int( class, TIMER_DORMANT );
+ break;
+ }
+
+ case RtemsTimerReqReset_Post_Clock_Ticks: {
+ /*
+ * The timer shall use the ticks based clock.
+ */
+ T_eq_int( class & TIMER_CLASS_BIT_TIME_OF_DAY, 0 );
+ break;
+ }
+
+ case RtemsTimerReqReset_Post_Clock_Realtime: {
+ /*
+ * The timer shall use the realtime clock.
+ */
+ T_eq_int(
+ class & TIMER_CLASS_BIT_TIME_OF_DAY,
+ TIMER_CLASS_BIT_TIME_OF_DAY
+ );
+ break;
+ }
+
+ case RtemsTimerReqReset_Post_Clock_Nop: {
+ /*
+ * Objects referenced by the ``id`` parameter in past call to
+ * rtems_timer_reset() shall not be accessed by the rtems_timer_reset()
+ * call.
+ */
+ T_eq_int( class, ctx->pre_class );
+ break;
+ }
+
+ case RtemsTimerReqReset_Post_Clock_NA:
+ break;
+ }
+}
+
+static void RtemsTimerReqReset_Post_State_Check(
+ RtemsTimerReqReset_Context *ctx,
+ RtemsTimerReqReset_Post_State state
+)
+{
+ switch ( state ) {
+ case RtemsTimerReqReset_Post_State_Scheduled: {
+ /*
+ * The timer shall be in scheduled state.
+ */
+ ctx->ticks_till_fire = TriggerTimer( ctx );
+ T_eq_int( ctx->invocations_a + ctx->invocations_b, 1 );
+ break;
+ }
+
+ case RtemsTimerReqReset_Post_State_Nop: {
+ /*
+ * Objects referenced by the ``id`` parameter in past call to
+ * rtems_timer_reset() shall not be accessed by the rtems_timer_reset()
+ * call.
+ */
+ T_eq_int( ctx->post_state, ctx->pre_state );
+ break;
+ }
+
+ case RtemsTimerReqReset_Post_State_NA:
+ break;
+ }
+}
+
+static void RtemsTimerReqReset_Post_Interval_Check(
+ RtemsTimerReqReset_Context *ctx,
+ RtemsTimerReqReset_Post_Interval state
+)
+{
+ switch ( state ) {
+ case RtemsTimerReqReset_Post_Interval_Last: {
+ /*
+ * The Timer Service Routine shall be invoked the same number of ticks
+ * (see tick), as defined by the last scheduled interval, after a point
+ * in time during the execution of the rtems_timer_reset() call.
+ */
+ T_eq_int( ctx->ticks_till_fire, ctx->scheduled_ticks_till_fire );
+ break;
+ }
+
+ case RtemsTimerReqReset_Post_Interval_Nop: {
+ /*
+ * If and when the Timer Service Routine will be invoked shall not be
+ * changed by the past call to rtems_timer_reset().
+ */
+ /*
+ * Whether the timer is scheduled has already been tested by the
+ * "Nop" "State" post-condition above.
+ */
+ T_eq_u32(
+ ctx->post_scheduling_data.interval,
+ ctx->pre_scheduling_data.interval
+ );
+ break;
+ }
+
+ case RtemsTimerReqReset_Post_Interval_NA:
+ break;
+ }
+}
+
+static void RtemsTimerReqReset_Post_Routine_Check(
+ RtemsTimerReqReset_Context *ctx,
+ RtemsTimerReqReset_Post_Routine state
+)
+{
+ switch ( state ) {
+ case RtemsTimerReqReset_Post_Routine_Last: {
+ /*
+ * The function reference used to invoke the Timer Service Routine when
+ * the timer will fire shall be the same one as the last one scheduled.
+ */
+ T_eq_int( ctx->invocations_a, ctx->scheduled_invocations_a );
+ T_eq_int( ctx->invocations_b, ctx->scheduled_invocations_b );
+ break;
+ }
+
+ case RtemsTimerReqReset_Post_Routine_Nop: {
+ /*
+ * The function reference used for any invocation of the Timer Service
+ * Routine shall not be changed by the past call to rtems_timer_reset().
+ */
+ T_eq_ptr(
+ ctx->post_scheduling_data.routine,
+ ctx->pre_scheduling_data.routine
+ );
+ break;
+ }
+
+ case RtemsTimerReqReset_Post_Routine_NA:
+ break;
+ }
+}
+
+static void RtemsTimerReqReset_Post_UserData_Check(
+ RtemsTimerReqReset_Context *ctx,
+ RtemsTimerReqReset_Post_UserData state
+)
+{
+ switch ( state ) {
+ case RtemsTimerReqReset_Post_UserData_Last: {
+ /*
+ * The user data argument for invoking the Timer Service Routine when the
+ * timer will fire shall be the same as the last scheduled user data
+ * argument.
+ */
+ T_eq_ptr( ctx->routine_user_data, ctx->scheduled_user_data);
+ break;
+ }
+
+ case RtemsTimerReqReset_Post_UserData_Nop: {
+ /*
+ * The user data argument used for any invocation of the Timer Service
+ * Routine shall not be changed by the past call to rtems_timer_reset().
+ */
+ T_eq_ptr(
+ ctx->post_scheduling_data.user_data,
+ ctx->pre_scheduling_data.user_data
+ );
+ break;
+ }
+
+ case RtemsTimerReqReset_Post_UserData_NA:
+ break;
+ }
+}
+
+static void RtemsTimerReqReset_Setup( RtemsTimerReqReset_Context *ctx )
+{
+ rtems_status_code status;
+ status = rtems_timer_initiate_server(
+ RTEMS_TIMER_SERVER_DEFAULT_PRIORITY,
+ RTEMS_MINIMUM_STACK_SIZE,
+ RTEMS_DEFAULT_ATTRIBUTES
+ );
+ T_rsc_success( status );
+}
+
+static void RtemsTimerReqReset_Setup_Wrap( void *arg )
+{
+ RtemsTimerReqReset_Context *ctx;
+
+ ctx = arg;
+ ctx->in_action_loop = false;
+ RtemsTimerReqReset_Setup( ctx );
+}
+
+/**
+ * @brief Make sure the timer server is not running and the realtime clock is
+ * not set after this test.
+ */
+static void RtemsTimerReqReset_Teardown( RtemsTimerReqReset_Context *ctx )
+{
+ DeleteTimerServer();
+ UnsetClock();
+}
+
+static void RtemsTimerReqReset_Teardown_Wrap( void *arg )
+{
+ RtemsTimerReqReset_Context *ctx;
+
+ ctx = arg;
+ ctx->in_action_loop = false;
+ RtemsTimerReqReset_Teardown( ctx );
+}
+
+static void RtemsTimerReqReset_Prepare( RtemsTimerReqReset_Context *ctx )
+{
+ rtems_status_code status;
+ status = rtems_timer_create(
+ rtems_build_name( 'T', 'I', 'M', 'E' ),
+ &ctx->timer_id
+ );
+ T_rsc_success( status );
+
+ ctx->data_a = ctx;
+ ctx->data_b = ctx;
+ ctx->invocations_a = 0;
+ ctx->invocations_b = 0;
+ ctx->ticks_till_fire = SCHEDULE_NONE;
+ ctx->routine_user_data = NULL;
+ ctx->scheduled_invocations_a = 0;
+ ctx->scheduled_invocations_b = 0;
+ ctx->scheduled_ticks_till_fire = SCHEDULE_NONE;
+ T_rsc_success( rtems_clock_set( &tod_now ) );
+}
+
+static void RtemsTimerReqReset_Action( RtemsTimerReqReset_Context *ctx )
+{
+ GetTimerSchedulingData( ctx->timer_id, &ctx->pre_scheduling_data );
+ ctx->pre_class = GetTimerClass( ctx->timer_id );
+ ctx->status = rtems_timer_reset( ctx->id_param );
+ ctx->post_state = GetTimerState( ctx->timer_id );
+ GetTimerSchedulingData( ctx->timer_id, &ctx->post_scheduling_data );
+ /* Ignoring return status: the timer server task may be suspended or not. */
+ rtems_task_resume( GetTimerServerTaskId() );
+}
+
+static void RtemsTimerReqReset_Cleanup( RtemsTimerReqReset_Context *ctx )
+{
+ T_rsc_success( rtems_timer_delete( ctx->timer_id ) );
+}
+
+typedef struct {
+ uint32_t Skip : 1;
+ uint32_t Pre_Id_NA : 1;
+ uint32_t Pre_Context_NA : 1;
+ uint32_t Pre_Clock_NA : 1;
+ uint32_t Pre_State_NA : 1;
+ uint32_t Post_Status : 2;
+ uint32_t Post_Context : 3;
+ uint32_t Post_Clock : 3;
+ uint32_t Post_State : 2;
+ uint32_t Post_Interval : 2;
+ uint32_t Post_Routine : 2;
+ uint32_t Post_UserData : 2;
+} RtemsTimerReqReset_Entry;
+
+static const RtemsTimerReqReset_Entry
+RtemsTimerReqReset_Entries[] = {
+ { 1, 0, 0, 0, 0, RtemsTimerReqReset_Post_Status_NA,
+ RtemsTimerReqReset_Post_Context_NA, RtemsTimerReqReset_Post_Clock_NA,
+ RtemsTimerReqReset_Post_State_NA, RtemsTimerReqReset_Post_Interval_NA,
+ RtemsTimerReqReset_Post_Routine_NA, RtemsTimerReqReset_Post_UserData_NA },
+ { 0, 0, 0, 0, 0, RtemsTimerReqReset_Post_Status_InvId,
+ RtemsTimerReqReset_Post_Context_Nop, RtemsTimerReqReset_Post_Clock_Nop,
+ RtemsTimerReqReset_Post_State_Nop, RtemsTimerReqReset_Post_Interval_Nop,
+ RtemsTimerReqReset_Post_Routine_Nop, RtemsTimerReqReset_Post_UserData_Nop },
+ { 0, 0, 0, 0, 0, RtemsTimerReqReset_Post_Status_NotDef,
+ RtemsTimerReqReset_Post_Context_Nop, RtemsTimerReqReset_Post_Clock_Nop,
+ RtemsTimerReqReset_Post_State_Nop, RtemsTimerReqReset_Post_Interval_Nop,
+ RtemsTimerReqReset_Post_Routine_Nop, RtemsTimerReqReset_Post_UserData_Nop },
+ { 0, 0, 0, 0, 0, RtemsTimerReqReset_Post_Status_Ok,
+ RtemsTimerReqReset_Post_Context_Server,
+ RtemsTimerReqReset_Post_Clock_Ticks,
+ RtemsTimerReqReset_Post_State_Scheduled,
+ RtemsTimerReqReset_Post_Interval_Last,
+ RtemsTimerReqReset_Post_Routine_Last, RtemsTimerReqReset_Post_UserData_Last },
+ { 0, 0, 0, 0, 0, RtemsTimerReqReset_Post_Status_Ok,
+ RtemsTimerReqReset_Post_Context_Interrupt,
+ RtemsTimerReqReset_Post_Clock_Ticks,
+ RtemsTimerReqReset_Post_State_Scheduled,
+ RtemsTimerReqReset_Post_Interval_Last,
+ RtemsTimerReqReset_Post_Routine_Last, RtemsTimerReqReset_Post_UserData_Last }
+};
+
+static const uint8_t
+RtemsTimerReqReset_Map[] = {
+ 2, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 4, 4, 0, 2, 2, 0, 0, 0, 0, 3, 3, 3, 2, 2,
+ 2, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 0, 1, 1, 0, 0, 0, 0, 1, 1, 1, 1,
+ 1, 1
+};
+
+static size_t RtemsTimerReqReset_Scope( void *arg, char *buf, size_t n )
+{
+ RtemsTimerReqReset_Context *ctx;
+
+ ctx = arg;
+
+ if ( ctx->in_action_loop ) {
+ return T_get_scope( RtemsTimerReqReset_PreDesc, buf, n, ctx->pcs );
+ }
+
+ return 0;
+}
+
+static T_fixture RtemsTimerReqReset_Fixture = {
+ .setup = RtemsTimerReqReset_Setup_Wrap,
+ .stop = NULL,
+ .teardown = RtemsTimerReqReset_Teardown_Wrap,
+ .scope = RtemsTimerReqReset_Scope,
+ .initial_context = &RtemsTimerReqReset_Instance
+};
+
+static inline RtemsTimerReqReset_Entry RtemsTimerReqReset_GetEntry(
+ size_t index
+)
+{
+ return RtemsTimerReqReset_Entries[
+ RtemsTimerReqReset_Map[ index ]
+ ];
+}
+
+/**
+ * @fn void T_case_body_RtemsTimerReqReset( void )
+ */
+T_TEST_CASE_FIXTURE( RtemsTimerReqReset, &RtemsTimerReqReset_Fixture )
+{
+ RtemsTimerReqReset_Context *ctx;
+ size_t index;
+
+ ctx = T_fixture_context();
+ ctx->in_action_loop = true;
+ index = 0;
+
+ for (
+ ctx->pcs[ 0 ] = RtemsTimerReqReset_Pre_Id_Valid;
+ ctx->pcs[ 0 ] < RtemsTimerReqReset_Pre_Id_NA;
+ ++ctx->pcs[ 0 ]
+ ) {
+ for (
+ ctx->pcs[ 1 ] = RtemsTimerReqReset_Pre_Context_None;
+ ctx->pcs[ 1 ] < RtemsTimerReqReset_Pre_Context_NA;
+ ++ctx->pcs[ 1 ]
+ ) {
+ for (
+ ctx->pcs[ 2 ] = RtemsTimerReqReset_Pre_Clock_None;
+ ctx->pcs[ 2 ] < RtemsTimerReqReset_Pre_Clock_NA;
+ ++ctx->pcs[ 2 ]
+ ) {
+ for (
+ ctx->pcs[ 3 ] = RtemsTimerReqReset_Pre_State_Inactive;
+ ctx->pcs[ 3 ] < RtemsTimerReqReset_Pre_State_NA;
+ ++ctx->pcs[ 3 ]
+ ) {
+ RtemsTimerReqReset_Entry entry;
+
+ entry = RtemsTimerReqReset_GetEntry( index );
+ ++index;
+
+ if ( entry.Skip ) {
+ continue;
+ }
+
+ RtemsTimerReqReset_Prepare( ctx );
+ RtemsTimerReqReset_Pre_Id_Prepare( ctx, ctx->pcs[ 0 ] );
+ RtemsTimerReqReset_Pre_Context_Prepare( ctx, ctx->pcs[ 1 ] );
+ RtemsTimerReqReset_Pre_Clock_Prepare( ctx, ctx->pcs[ 2 ] );
+ RtemsTimerReqReset_Pre_State_Prepare( ctx, ctx->pcs[ 3 ] );
+ RtemsTimerReqReset_Action( ctx );
+ RtemsTimerReqReset_Post_Status_Check( ctx, entry.Post_Status );
+ RtemsTimerReqReset_Post_Context_Check( ctx, entry.Post_Context );
+ RtemsTimerReqReset_Post_Clock_Check( ctx, entry.Post_Clock );
+ RtemsTimerReqReset_Post_State_Check( ctx, entry.Post_State );
+ RtemsTimerReqReset_Post_Interval_Check( ctx, entry.Post_Interval );
+ RtemsTimerReqReset_Post_Routine_Check( ctx, entry.Post_Routine );
+ RtemsTimerReqReset_Post_UserData_Check( ctx, entry.Post_UserData );
+ RtemsTimerReqReset_Cleanup( ctx );
+ }
+ }
+ }
+ }
+}
+
+/** @} */