tmtests/tm23/tmtest.ads

0001 -- SPDX-License-Identifier: BSD-2-Clause
0002
0003 --
0004 --  TMTEST / SPECIFICATION
0005 --
0006 --  DESCRIPTION:
0007 --
0008 --  This package is the specification for Test 23 of the RTEMS
0009 --  Timing Test Suite.
0010 --
0011 --  DEPENDENCIES:
0012 --
0013 --
0014 --
0015 --  COPYRIGHT (c) 1989-2011.
0016 --  On-Line Applications Research Corporation (OAR).
0017 --
0018 --  Redistribution and use in source and binary forms, with or without
0019 --  modification, are permitted provided that the following conditions
0020 --  are met:
0021 --  1. Redistributions of source code must retain the above copyright
0022 --     notice, this list of conditions and the following disclaimer.
0023 --  2. Redistributions in binary form must reproduce the above copyright
0024 --     notice, this list of conditions and the following disclaimer in the
0025 --     documentation and/or other materials provided with the distribution.
0026 --
0027 --  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
0028 --  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
0029 --  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
0030 --  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
0031 --  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
0032 --  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
0033 --  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
0034 --  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
0035 --  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
0036 --  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
0037 --  POSSIBILITY OF SUCH DAMAGE.
0038 --
0039
0040 with TIME_TEST_SUPPORT;
0041 with RTEMS;
0042 with RTEMS.TASKS;
0043
0044 package TMTEST is
0045
0046 --
0047 --  This array contains the IDs of all RTEMS timers created by this test.
0048 --
0049
0050    TIMER_ID   : array ( RTEMS.UNSIGNED32
0051       range 1 .. TIME_TEST_SUPPORT.OPERATION_COUNT ) of RTEMS.ID;
0052
0053 --
0054 --  This data item contains a time of day used by all of the
0055 --  "WHEN" directives timed in this test.
0056 --
0057
0058    TIME_OF_DAY      : RTEMS.TIME_OF_DAY;
0059
0060 --
0061 --  The following variable is set to the execution time returned
0062 --  by the timer.
0063 --
0064
0065    END_TIME  : RTEMS.UNSIGNED32;
0066
0067 --
0068 --  INIT
0069 --
0070 --  DESCRIPTION:
0071 --
0072 --  This RTEMS task initializes the application.
0073 --
0074
0075    procedure INIT (
0076       ARGUMENT : in     RTEMS.TASKS.ARGUMENT
0077    );
0078    pragma Convention (C, INIT);
0079
0080 --
0081 --  NULL_DELAY
0082 --
0083 --  DESCRIPTION:
0084 --
0085 --  This subprogram is a timer service routine.  It performs
0086 --  no actions.
0087 --
0088
0089    procedure NULL_DELAY (
0090       IGNORED_ID      : in     RTEMS.ID;
0091       IGNORED_ADDRESS : in     RTEMS.ADDRESS
0092    );
0093    pragma Convention (C, NULL_DELAY);
0094
0095 --
0096 --  HIGH_TASK
0097 --
0098 --  DESCRIPTION:
0099 --
0100 --  This RTEMS task is responsible for measuring and reporting
0101 --  the following directive execution times:
0102 --
0103 --    + TIMER_CREATE
0104 --    + TIMER_FIRE_AFTER with an inactive timer
0105 --    + TIMER_FIRE_AFTER with an active timer
0106 --    + TIMER_CANCEL of an active timer
0107 --    + TIMER_CANCEL of an inactive timer
0108 --    + TIMER_RESET of an active timer
0109 --    + TIMER_RESET of an inactive timer
0110 --    + TIMER_FIRE_WHEN of an inactive timer
0111 --    + TIMER_FIRE_WHEN of an active timer
0112 --    + TIMER_DELETE of an active timer
0113 --    + TIMER_DELETE of an inactive timer
0114 --
0115 --  After measuring and reporting the above times, this task starts
0116 --  the timer and executes the TASK_WAKE_WHEN directive.
0117 --
0118
0119    procedure HIGH_TASK (
0120       ARGUMENT : in     RTEMS.TASKS.ARGUMENT
0121    );
0122    pragma Convention (C, HIGH_TASK);
0123
0124 --
0125 --  MIDDLE_TASKS
0126 --
0127 --  DESCRIPTION:
0128 --
0129 --  These RTEMS tasks executes the TASK_WAKE_WHEN directive.
0130 --
0131
0132    procedure MIDDLE_TASKS (
0133       ARGUMENT : in     RTEMS.TASKS.ARGUMENT
0134    );
0135    pragma Convention (C, MIDDLE_TASKS);
0136
0137 --
0138 --  LOW_TASK
0139 --
0140 --  DESCRIPTION:
0141 --
0142 --  This RTEMS task stops the timer and reports the execution time for
0143 --  the TASK_WAKE_WHEN directive.
0144 --
0145
0146    procedure LOW_TASK (
0147       ARGUMENT : in     RTEMS.TASKS.ARGUMENT
0148    );
0149    pragma Convention (C, LOW_TASK);
0150
0151 end TMTEST;