tmtests/tm29/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 29 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 RTEMS;
0041 with RTEMS.TASKS;
0042
0043 package TMTEST is
0044
0045 --
0046 --  The following is the name used for all periods created by this test.
0047 --
0048
0049    PERIOD_NAME : RTEMS.NAME;
0050
0051 --
0052 --  The following is used to allow all tasks to create and start
0053 --  their period timers before the timer is started for timing
0054 --  the blocking case of RATE_MONOTONIC_PERIOD.
0055 --
0056
0057    TASK_COUNT  : RTEMS.UNSIGNED32;
0058
0059 --
0060 --  The following variable is set to the execution time returned
0061 --  by the timer.
0062 --
0063
0064    END_TIME    : RTEMS.UNSIGNED32;
0065
0066 --
0067 --  INIT
0068 --
0069 --  DESCRIPTION:
0070 --
0071 --  This RTEMS task initializes the application.  It also measures and
0072 --  reports the following directive execution times:
0073 --
0074 --    + RATE_MONOTONIC_CREATE
0075 --    + RATE_MONOTONIC_PERIOD the initial time
0076 --    + RATE_MONOTONIC_PERIOD for a period's status
0077 --    + RATE_MONOTONIC_CANCEL
0078 --    + RATE_MONOTONIC_DELETE of a cancelled period
0079 --    + RATE_MONOTONIC_DELETE of an active period
0080 --
0081
0082    procedure INIT (
0083       ARGUMENT : in     RTEMS.TASKS.ARGUMENT
0084    );
0085    pragma Convention (C, INIT);
0086
0087 --
0088 --  TASKS
0089 --
0090 --  DESCRIPTION:
0091 --
0092 --  The first of these RTEMS tasks starts the timer.  All of these
0093 --  tasks execute a blocking RATE_MONOTONIC_PERIOD.
0094 --
0095
0096    procedure TASKS (
0097       ARGUMENT : in     RTEMS.TASKS.ARGUMENT
0098    );
0099    pragma Convention (C, TASKS);
0100
0101 --
0102 --  LOW_TASK
0103 --
0104 --  DESCRIPTION:
0105 --
0106 --  This RTEMS task stops the timer and reports the execution
0107 --  time for a blocking RATE_MONOTONIC_PERIOD.
0108 --
0109
0110    procedure LOW_TASK (
0111       ARGUMENT : in     RTEMS.TASKS.ARGUMENT
0112    );
0113    pragma Convention (C, LOW_TASK);
0114
0115 end TMTEST;