tmi.c

test file nucleus source

/*************************************************************************/
/*                                                                       */
/*               Copyright Mentor Graphics Corporation 2002              */
/*                         All Rights Reserved.                          */
/*                                                                       */
/* THIS WORK CONTAINS TRADE SECRET AND PROPRIETARY INFORMATION WHICH IS  */
/* THE PROPERTY OF MENTOR GRAPHICS CORPORATION OR ITS LICENSORS AND IS   */
/* SUBJECT TO LICENSE TERMS.                                             */
/*                                                                       */
/*************************************************************************/

/*************************************************************************/
/*                                                                       */
/* FILE NAME                                               VERSION       */
/*                                                                       */
/*      tmi.c                                          Nucleus PLUS 1.14 */
/*                                                                       */
/* COMPONENT                                                             */
/*                                                                       */
/*      TM - Timer Management                                            */
/*                                                                       */
/* DESCRIPTION                                                           */
/*                                                                       */
/*      This file contains the initialization routine for the timer      */
/*      management component.                                            */
/*                                                                       */
/* DATA STRUCTURES                                                       */
/*                                                                       */
/*      None                                                             */
/*                                                                       */
/* FUNCTIONS                                                             */
/*                                                                       */
/*      TMI_Initialize                      Timer Management Initialize  */
/*                                                                       */
/* DEPENDENCIES                                                          */
/*                                                                       */
/*      tc_extr.h                           Task function interfaces     */
/*      er_extr.h                           Error handling function      */
/*      tm_defs.h                           Timer component constants    */
/*                                                                       */
/* HISTORY                                                               */
/*                                                                       */
/*         DATE                    REMARKS                               */
/*                                                                       */
/*      03-01-1993      Created initial version 1.0                      */
/*      04-19-1993      Verified version 1.0                             */
/*      08-09-1993      Removed timer task creation,                     */
/*                        cleared the ID of the HISR                     */
/*                        control block, and casted the                  */
/*                        HISR priority, resulting in                    */
/*                        version 1.0a                                   */
/*      08-09-1993      Verified version 1.0a                            */
/*      03-01-1994      Changed names of HISR create                     */
/*                        function, removed reference to                 */
/*                        timer list protect since it                    */
/*                        was deleted, resulting in                      */
/*                        version 1.1                                    */
/*                                                                       */
/*      03-18-1994      Verified version 1.1                             */
/*      04-17-1996      updated to version 1.2                           */
/*      03-24-1998      Released version 1.3                             */
/*      03-26-1999      Released 1.11m (new release                      */
/*                        numbering scheme)                              */
/*      04-17-2002      Released version 1.13m                           */
/*      11-07-2002      Released version 1.14                            */
/*************************************************************************/
#define         NU_SOURCE_FILE


#include        "tc_extr.h"                 /* Task control functions    */
#include        "er_extr.h"                 /* Error handling function   */
#include        "tm_defs.h"                 /* Timer constants           */
#include        "tm_extr.h"                 /* Timer interfaces          */


/* Define external inner-component global data references.  */

extern CS_NODE        *TMD_Created_Timers_List;
extern UNSIGNED        TMD_Total_Timers;
extern TM_TCB         *TMD_Active_Timers_List;
extern INT             TMD_Active_List_Busy;
extern TC_PROTECT      TMD_Created_List_Protect;
extern UNSIGNED        TMD_System_Clock;
extern UNSIGNED        TMD_Timer;
extern INT             TMD_Timer_State;
extern UNSIGNED        TMD_Time_Slice;
extern TC_TCB         *TMD_Time_Slice_Task;
extern INT             TMD_Time_Slice_State;
extern TC_HCB          TMD_HISR;
extern VOID           *TMD_HISR_Stack_Ptr;
extern UNSIGNED        TMD_HISR_Stack_Size;
extern INT             TMD_HISR_Priority;


/* Define inner-component function prototypes.  */

VOID    TMC_Timer_HISR(VOID);


/*************************************************************************/
/*                                                                       */
/* FUNCTION                                                              */
/*                                                                       */
/*      TMI_Initialize                                                   */
/*                                                                       */
/* DESCRIPTION                                                           */
/*                                                                       */
/*      This function initializes the data structures that control the   */
/*      operation of the timer component (TM).  There are no application */
/*      timers created initially.  This routine must be called from      */
/*      Supervisor mode in Supervisor/User mode switching kernels.       */
/*                                                                       */
/* CALLED BY                                                             */
/*                                                                       */
/*      INC_Initialize                      System initialization        */
/*                                                                       */
/* CALLS                                                                 */
/*                                                                       */
/*      ERC_System_Error                    System error handing function*/
/*      TCC_Create_HISR                     Create timer HISR            */
/*      TCCE_Create_HISR                    Create timer HISR (error chk)*/
/*                                                                       */
/* INPUTS                                                                */
/*                                                                       */
/*      (Indirect)                                                       */
/*      TMD_HISR_Stack_Ptr                  Pointer to HISR stack area   */
/*      TMD_HISR_Stack_Size                 Size of HISR stack           */
/*      TMD_HISR_Priority                   Priority of timer HISR       */
/*                                                                       */
/* OUTPUTS                                                               */
/*                                                                       */
/*      TMD_Created_Timers_List             Pointer to the linked-list   */
/*                                            of created application     */
/*                                            timers                     */
/*      TMD_Total_Timers                    Total number of created      */
/*                                            application timers         */
/*      TMD_Active_Timers_List              Pointer to the linked-list   */
/*                                            of active timers.          */
/*      TMD_Active_List_Busy                Flag indicating that the     */
/*                                            active timer list is in use*/
/*      TMD_Created_List_Protect            Created timer list protect   */
/*                                            structure                  */
/*      TMD_System_Clock                    System clock                 */
/*      TMD_Timer                           Timer count-down value       */
/*      TMD_Timer_State                     State of timer               */
/*      TMD_Time_Slice                      Time slice count-down value  */
/*      TMD_Time_Slice_Task                 Pointer to task to time-slice*/
/*      TMD_Time_Slice_State                State of time slice          */
/*      TMD_HISR                            Timer HISR control block     */
/*                                                                       */
/* HISTORY                                                               */
/*                                                                       */
/*         DATE                    REMARKS                               */
/*                                                                       */
/*      03-01-1993      Created initial version 1.0                      */
/*      04-19-1993      Verified version 1.0                             */
/*      08-09-1993      Removed timer task creation,                     */
/*                        cleared the ID of the HISR                     */
/*                        control block, and casted the                  */
/*                        HISR priority, resulting in                    */
/*                        version 1.0a                                   */
/*      08-09-1993      Verified version 1.0a                            */
/*      03-01-1994      Modified HISR create function                    */
/*                        interface, removed reference                   */
/*                        to timer list protect since it                 */
/*                        was deleted, resulting in                      */
/*                        version 1.1                                    */
/*                                                                       */
/*      03-18-1994      Verified version 1.1                             */
/*                                                                       */
/*************************************************************************/
VOID  TMI_Initialize(VOID)
{

STATUS          status;                     /* Return status of creates */


    /* Initialize the created application timer's list to NU_NULL.  */
    TMD_Created_Timers_List =  NU_NULL;

    /* Initialize the total number of created application timers to 0.  */
    TMD_Total_Timers =  0;

    /* Initialize the active timer's list to NU_NULL.  */
    TMD_Active_Timers_List =  NU_NULL;

    /* Clear the active timer list busy flag.  */
    TMD_Active_List_Busy =  NU_FALSE;

    /* Initialize the system clock to 0.  */
    TMD_System_Clock =  0;

    /* Initialize the timer to 0 and the timer state to "not active."  */
    TMD_Timer =        0;
    TMD_Timer_State =  TM_NOT_ACTIVE;

    /* Initialize the time-slice timer, task pointer, and the associated
       state variable.  */
    TMD_Time_Slice =        0;
    TMD_Time_Slice_Task =   NU_NULL;
    TMD_Time_Slice_State =  TM_NOT_ACTIVE;

    /* Initialize the list protection structures.  */
    TMD_Created_List_Protect.tc_tcb_pointer =      NU_NULL;

    /* Clear out the timer HISR control block.  */
    TMD_HISR.tc_id =  0;

    /* Create the timer HISR.  The timer HISR is responsible for performing
       the time slice function and activating the timer task if necessary.  */
#ifdef  NU_NO_ERROR_CHECKING

    status =  TCC_Create_HISR((NU_HISR *) &TMD_HISR, "SYSTEM H",
                    TMC_Timer_HISR, (OPTION) TMD_HISR_Priority,
                    TMD_HISR_Stack_Ptr, TMD_HISR_Stack_Size);
#else

    status =  TCCE_Create_HISR((NU_HISR *) &TMD_HISR, "SYSTEM H",
                    TMC_Timer_HISR, (OPTION) TMD_HISR_Priority,
                    TMD_HISR_Stack_Ptr, TMD_HISR_Stack_Size);

#endif

    /* Check for a system error creating the timer HISR.  */
    if (status != NU_SUCCESS)

        /* Call the system error handler.  */
        ERC_System_Error(NU_ERROR_CREATING_TIMER_HISR);
}