Back to home page

LXR

 
 

    


File indexing completed on 2025-05-11 08:24:53

0001 /* SPDX-License-Identifier: BSD-2-Clause */
0002 
0003 /**
0004  * @file
0005  *
0006  * @ingroup RtemsTimerValTimer
0007  */
0008 
0009 /*
0010  * Copyright (C) 2021 embedded brains GmbH & Co. KG
0011  *
0012  * Redistribution and use in source and binary forms, with or without
0013  * modification, are permitted provided that the following conditions
0014  * are met:
0015  * 1. Redistributions of source code must retain the above copyright
0016  *    notice, this list of conditions and the following disclaimer.
0017  * 2. Redistributions in binary form must reproduce the above copyright
0018  *    notice, this list of conditions and the following disclaimer in the
0019  *    documentation and/or other materials provided with the distribution.
0020  *
0021  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
0022  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
0023  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
0024  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
0025  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
0026  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
0027  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
0028  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
0029  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
0030  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
0031  * POSSIBILITY OF SUCH DAMAGE.
0032  */
0033 
0034 /*
0035  * This file is part of the RTEMS quality process and was automatically
0036  * generated.  If you find something that needs to be fixed or
0037  * worded better please post a report or patch to an RTEMS mailing list
0038  * or raise a bug report:
0039  *
0040  * https://www.rtems.org/bugs.html
0041  *
0042  * For information on updating and regenerating please refer to the How-To
0043  * section in the Software Requirements Engineering chapter of the
0044  * RTEMS Software Engineering manual.  The manual is provided as a part of
0045  * a release.  For development sources please refer to the online
0046  * documentation at:
0047  *
0048  * https://docs.rtems.org
0049  */
0050 
0051 #ifdef HAVE_CONFIG_H
0052 #include "config.h"
0053 #endif
0054 
0055 #include <rtems.h>
0056 #include <rtems/score/atomic.h>
0057 
0058 #include "ts-config.h"
0059 #include "tx-support.h"
0060 
0061 #include <rtems/test.h>
0062 
0063 /**
0064  * @defgroup RtemsTimerValTimer spec:/rtems/timer/val/timer
0065  *
0066  * @ingroup TestsuitesValidationNoClock0
0067  *
0068  * @brief Tests general timer behaviour.
0069  *
0070  * This test case performs the following actions:
0071  *
0072  * - Create a couple of timers.
0073  *
0074  *   - Schedule some timers at the same time point.
0075  *
0076  *   - Fire the timers and check that they fired in the expected order.
0077  *
0078  *   - Clean up all used resources.
0079  *
0080  * @{
0081  */
0082 
0083 /**
0084  * @brief Test context for spec:/rtems/timer/val/timer test case.
0085  */
0086 typedef struct {
0087   /**
0088    * @brief This member contains the timer identifiers.
0089    */
0090   rtems_id timer_ids[ TEST_MAXIMUM_TIMERS ];
0091 
0092   /**
0093    * @brief This member contains the counter.
0094    */
0095   Atomic_Uint counter;
0096 
0097   /**
0098    * @brief This member contains the timer counter snapshots.
0099    */
0100   unsigned int counter_snapshots[ TEST_MAXIMUM_TIMERS ];
0101 } RtemsTimerValTimer_Context;
0102 
0103 static RtemsTimerValTimer_Context
0104   RtemsTimerValTimer_Instance;
0105 
0106 typedef RtemsTimerValTimer_Context Context;
0107 
0108 static void Timer( rtems_id timer, void *arg )
0109 {
0110   Context      *ctx;
0111   unsigned int *counter;
0112 
0113   ctx = T_fixture_context();
0114   counter = arg;
0115   *counter = _Atomic_Fetch_add_uint(
0116     &ctx->counter,
0117     1,
0118     ATOMIC_ORDER_RELAXED
0119   ) + 1;
0120 }
0121 
0122 static void Fire( Context *ctx, size_t i, rtems_interval ticks )
0123 {
0124   rtems_status_code sc;
0125 
0126   ctx->counter_snapshots[ i ] = 0;
0127   sc = rtems_timer_fire_after(
0128     ctx->timer_ids[ i ],
0129     ticks,
0130     Timer,
0131     &ctx->counter_snapshots[ i ]
0132   );
0133   T_rsc_success( sc );
0134 }
0135 
0136 static T_fixture RtemsTimerValTimer_Fixture = {
0137   .setup = NULL,
0138   .stop = NULL,
0139   .teardown = NULL,
0140   .scope = NULL,
0141   .initial_context = &RtemsTimerValTimer_Instance
0142 };
0143 
0144 /**
0145  * @brief Create a couple of timers.
0146  */
0147 static void RtemsTimerValTimer_Action_0( RtemsTimerValTimer_Context *ctx )
0148 {
0149   rtems_status_code sc;
0150   size_t            i;
0151 
0152   T_assert_eq_sz( TEST_MAXIMUM_TIMERS, 10 );
0153 
0154   _Atomic_Init_uint( &ctx->counter, 0 );
0155 
0156   for ( i = 0; i < TEST_MAXIMUM_TIMERS ; ++i ) {
0157     sc = rtems_timer_create(
0158       rtems_build_name( 'T', 'E', 'S', 'T' ),
0159       &ctx->timer_ids[ i ]
0160     );
0161     T_rsc_success( sc );
0162   }
0163 
0164   /*
0165    * Schedule some timers at the same time point.
0166    */
0167   Fire( ctx, 3, 2 );
0168   Fire( ctx, 0, 1 );
0169   Fire( ctx, 7, 3 );
0170   Fire( ctx, 4, 2 );
0171   Fire( ctx, 5, 2 );
0172   Fire( ctx, 8, 3 );
0173   Fire( ctx, 9, 3 );
0174   Fire( ctx, 1, 1 );
0175   Fire( ctx, 2, 1 );
0176   Fire( ctx, 6, 2 );
0177 
0178   /*
0179    * Fire the timers and check that they fired in the expected order.
0180    */
0181   FinalClockTick();
0182 
0183   for ( i = 0; i < TEST_MAXIMUM_TIMERS ; ++i ) {
0184     T_eq_sz( ctx->counter_snapshots[ i ], i + 1 );
0185   }
0186 
0187   /*
0188    * Clean up all used resources.
0189    */
0190   for ( i = 0; i < TEST_MAXIMUM_TIMERS ; ++i ) {
0191     sc = rtems_timer_delete( ctx->timer_ids[ i ] );
0192     T_rsc_success( sc );
0193   }
0194 }
0195 
0196 /**
0197  * @fn void T_case_body_RtemsTimerValTimer( void )
0198  */
0199 T_TEST_CASE_FIXTURE( RtemsTimerValTimer, &RtemsTimerValTimer_Fixture )
0200 {
0201   RtemsTimerValTimer_Context *ctx;
0202 
0203   ctx = T_fixture_context();
0204 
0205   RtemsTimerValTimer_Action_0( ctx );
0206 }
0207 
0208 /** @} */