#ifndef CYGONCE_COMPAT_UITRON_UIT_FUNC_H
#define CYGONCE_COMPAT_UITRON_UIT_FUNC_H
//===========================================================================
//
//      uit_func.h
//
//      uITRON compatibility functions
//
//===========================================================================
//####COPYRIGHTBEGIN####
//
// -------------------------------------------
// The contents of this file are subject to the Cygnus eCos Public License
// Version 1.0 (the "License"); you may not use this file except in
// compliance with the License.  You may obtain a copy of the License at
// http://sourceware.cygnus.com/ecos
// 
// Software distributed under the License is distributed on an "AS IS"
// basis, WITHOUT WARRANTY OF ANY KIND, either express or implied.  See the
// License for the specific language governing rights and limitations under
// the License.
// 
// The Original Code is eCos - Embedded Cygnus Operating System, released
// September 30, 1998.
// 
// The Initial Developer of the Original Code is Cygnus.  Portions created
// by Cygnus are Copyright (C) 1998,1999 Cygnus Solutions.  All Rights Reserved.
// -------------------------------------------
//
//####COPYRIGHTEND####
//===========================================================================
//#####DESCRIPTIONBEGIN####
//
// Author(s):   hmt
// Contributors:        hmt
// Date:        1998-03-13
// Purpose:     uITRON compatibility functions
// Description: 
//
//####DESCRIPTIONEND####
//
//===========================================================================

// ------------------------------------------------------------------------
// Source Code Organization
//
// First, see pkgconf/uitron.h for details of applicable configuration
// options.
//
// This file uit_func.h provides prototypes for the uITRON API.  All the
// uITRON functions are listed here.  The prototypes are configurable
// either to have C or C++ linkage, and if being compiled in a C++
// environment, to be inline.
//
// The function prototypes are all in terms of uITRON type definitions from
// uit_type.h, which is included at the head of uit_func.h.
//
// The implementations of the uITRON functions are in uit_func.inl, which
// is either included at the end of uit_func.h (if functions are inline) or
// in uit_func.cxx (if outline).
// 
// uit_func.cxx provides some startup functions plus, if the uITRON
// functions are out of line, uit_func.inl is included to instantiate those
// functions.
// 
// uITRON system objects (tasks, semaphores...) are described in
// uit_obj.hxx.  This is a C++ file and is used by the implementation of
// the uITRON functions.
// 
// The uITRON system objects are instantiated in uit_obj.cxx, which uses
// uit_obj.hxx to define the objects, and the configuration file
// pkgconf/uitron.h to construct them as required.
//
// The include graph from an application, which should only include
// uit_func.h, is similar to the following:
//
// 
// [inline uITRON functions:]
//
//    <your_app.c>
//    .       uit_func.h                       ; prototypes for funcs
//    .       .       pkgconf/uitron.h         ; configuration info
//    .       .       uit_type.h               ; typedefs for func args
//    .       (function prototypes)
//    .       .       uit_func.inl             ; full function bodies
//    .       .       .       uit_objs.hxx     ; defs of uITRON data
//    .       .       (function implementations)
//    
//
// [out-of-line uITRON functions:]
//
//    <your_app.c>
//    .       uit_func.h                       ; prototypes for funcs
//    .       .       pkgconf/uitron.h         ; configuration info
//    .       .       uit_type.h               ; typedefs for func args
//    .       (function prototypes)
//    
//
// [other uITRON compilation units:]
//
//    uit_func.cxx                             ; out-of-line functions
//    .       pkgconf/uitron.h                 ; configuration info
//    .       uit_func.h                       ; prototypes for funcs
//    .       .       uit_type.h               ; typedefs for func args
//    .       (function prototypes)
//    .       .       uit_func.inl             ; full function bodies
//    .       .       .       uit_objs.hxx     ; defs of uITRON data
//    .       .       (function implementations)
// 
//
//    uit_objs.cxx                             ; static uITRON data objects
//    .       pkgconf/uitron.h                 ; configuration info
//    .       uit_objs.hxx                     ; defs of uITRON data
//    (static uITRON system objects)
//
// 
// The various include files are protected against multiple inclusion and
// so may be safely re-included as convenient.
// 
// ------------------------------------------------------------------------

#include <pkgconf/uitron.h>             // uITRON setup CYGNUM_UITRON_SEMAS
                                        // CYGPKG_UITRON et al

#ifdef CYGPKG_UITRON

#include <cyg/infra/cyg_type.h>         // types; cyg_int32, CYG_ADDRWORD

#include <cyg/compat/uitron/uit_type.h> // uITRON types; ER ID TMO T_MSG

// ------------------------------------------------------------------------
// Object operations:
//
// The functions can be inlined in C compiled by C++, or C++ of course,
// and also outlined in extern "C" functions, eg. for taking the address
// of, or for use by a pure C program, or of course outlined in C++ for
// Code size reasons.
//
//
// Summary:
//
// IF compiling in C
// THEN functions must be C linkage and out of line:
//      do NOT specify CYGIMP_UITRON_INLINE_FUNCS nor
//                     CYGIMP_UITRON_CPP_OUTLINE_FUNCS.
// IF compiling in C++
// THEN functions can be inline: specify CYGIMP_UITRON_INLINE_FUNCS
//   OR by default, functions are out of line:
//       outline functions can have C++ linkage:
//                 specify CYGIMP_UITRON_CPP_OUTLINE_FUNCS
//       OR by default, outline functions have C linkage.


#ifdef __cplusplus
// C++ environment; functions can be inline or not as we please.
// If not inline they might as well be "C" linkage for sharing with
// any pure "C" code present.

#ifdef CYGIMP_UITRON_INLINE_FUNCS

#define CYG_UIT_FUNC_EXTERN_BEGIN
#define CYG_UIT_FUNC_EXTERN_END
#define CYG_UIT_FUNC_INLINE             inline
#ifndef CYGPRI_UITRON_FUNCS_HERE_AND_NOW
#define CYGPRI_UITRON_FUNCS_HERE_AND_NOW
#endif

#else

#ifdef CYGIMP_UITRON_CPP_OUTLINE_FUNCS
#define CYG_UIT_FUNC_EXTERN_BEGIN       extern "C++" {
#define CYG_UIT_FUNC_EXTERN_END         }
#else
#define CYG_UIT_FUNC_EXTERN_BEGIN       extern "C" {
#define CYG_UIT_FUNC_EXTERN_END         }
#endif

#define CYG_UIT_FUNC_INLINE
#endif

#else // !__cplusplus
// Vanilla "C" environment; external "C" linkage, no inline functions

#ifdef CYGIMP_UITRON_INLINE_FUNCS
#error "Cannot inline uITRON functions in pure C environment"
#endif
#ifdef CYGIMP_UITRON_CPP_OUTLINE_FUNCS
#error "Cannot use C++ linkage of outline fns in pure C environment"
#endif

#define CYG_UIT_FUNC_EXTERN_BEGIN
#define CYG_UIT_FUNC_EXTERN_END
#define CYG_UIT_FUNC_INLINE             

#endif // !__cplusplus

// ========================================================================
//         u I T R O N   F U N C T I O N S
// The function declarations themselves:

CYG_UIT_FUNC_EXTERN_BEGIN

// this routine is outside the uITRON specification; call it from main() to
// start the uITRON tasks and scheduler.  It does not return.

#ifdef CYGNUM_UITRON_START_TASKS
void cyg_uitron_start( void );
#endif

// ******************************************************
// ***    6.5 C Language Interfaces                   ***
// ******************************************************

// - Task Management Functions

ER      cre_tsk ( ID tskid, T_CTSK *pk_ctsk );
ER      del_tsk ( ID tskid );
ER      sta_tsk ( ID tskid, INT stacd );
void    ext_tsk ( void );
void    exd_tsk ( void );
ER      ter_tsk ( ID tskid );

ER      dis_dsp ( void );
ER      ena_dsp ( void );
ER      chg_pri ( ID tskid, PRI tskpri );
ER      rot_rdq ( PRI tskpri );
ER      rel_wai ( ID tskid );
ER      get_tid ( ID *p_tskid );
ER      ref_tsk ( T_RTSK *pk_rtsk, ID tskid );
        
// - Task-Dependent Synchronization Functions
        
ER      sus_tsk ( ID tskid );
ER      rsm_tsk ( ID tskid );
ER      frsm_tsk ( ID tskid );
ER      slp_tsk ( void );
ER      tslp_tsk ( TMO tmout );
ER      wup_tsk ( ID tskid );
ER      can_wup ( INT *p_wupcnt, ID tskid );
        
// - Synchronization and Communication Functions
        
ER      cre_sem ( ID semid, T_CSEM *pk_csem );
ER      del_sem ( ID semid );
ER      sig_sem ( ID semid );
ER      wai_sem ( ID semid );
ER      preq_sem ( ID semid );
ER      twai_sem ( ID semid, TMO tmout );
ER      ref_sem ( T_RSEM *pk_rsem, ID semid );

ER      cre_flg ( ID flgid, T_CFLG *pk_cflg );
ER      del_flg ( ID flgid );
ER      set_flg ( ID flgid, UINT setptn );
ER      clr_flg ( ID flgid, UINT clrptn );
ER      wai_flg ( UINT *p_flgptn, ID flgid, UINT waiptn, UINT wfmode );
ER      pol_flg ( UINT *p_flgptn, ID flgid, UINT waiptn, UINT wfmode );
ER      twai_flg ( UINT *p_flgptn, ID flgid, UINT waiptn, UINT wfmode,
              TMO tmout );
ER      ref_flg ( T_RFLG *pk_rflg, ID flgid );

ER      cre_mbx ( ID mbxid, T_CMBX* pk_cmbx );
ER      del_mbx ( ID mbxid );
ER      snd_msg ( ID mbxid, T_MSG *pk_msg );
ER      rcv_msg ( T_MSG **ppk_msg, ID mbxid );
ER      prcv_msg ( T_MSG **ppk_msg, ID mbxid );
ER      trcv_msg ( T_MSG **ppk_msg, ID mbxid, TMO tmout );
ER      ref_mbx ( T_RMBX *pk_rmbx, ID mbxid );
        
// - Extended Synchronization and Communication Functions
        
#if 0 // NOT SUPPORTED
ER      cre_mbf ( ID mbfid, T_CMBF *pk_cmbf );
ER      del_mbf ( ID mbfid );
ER      snd_mbf ( ID mbfid, VP msg, INT msgsz );
ER      psnd_mbf ( ID mbfid, VP msg, INT msgsz );
ER      tsnd_mbf ( ID mbfid, VP msg, INT msgsz, TMO tmout );
ER      rcv_mbf ( VP msg, INT *p_msgsz, ID mbfid );
ER      prcv_mbf ( VP msg, INT *p_msgsz, ID mbfid );
ER      trcv_mbf ( VP msg, INT *p_msgsz, ID mbfid, TMO tmout );
ER      ref_mbf ( T_RMBF *pk_rmbf, ID mbfid );
ER      cre_por ( ID porid, T_CPOR *pk_cpor );
ER      del_por ( ID porid );
ER      cal_por ( VP msg, INT *p_rmsgsz, ID porid, UINT calptn, INT
              cmsgsz );
ER      pcal_por ( VP msg, INT *p_rmsgsz, ID porid, UINT calptn, INT
              cmsgsz );
ER      tcal_por ( VP msg, INT *p_rmsgsz, ID porid, UINT calptn, INT
              cmsgsz, TMO tmout );
ER      acp_por ( RNO *p_rdvno, VP msg, INT *p_cmsgsz, ID porid, UINT
              acpptn );
ER      pacp_por ( RNO *p_rdvno, VP msg, INT *p_cmsgsz, ID porid, UINT
              acpptn );
ER      tacp_por ( RNO *p_rdvno, VP msg, INT *p_cmsgsz, ID porid, UINT
              acpptn, TMO tmout );
ER      fwd_por ( ID porid, UINT calptn, RNO rdvno, VP msg, INT cmsgsz
              );
ER      rpl_rdv ( RNO rdvno, VP msg, INT rmsgsz );
ER      ref_por ( T_RPOR *pk_rpor, ID porid );
#endif
        
// - Interrupt Management Functions
        
#if 0 // NOT SUPPORTED
ER      def_int ( UINT dintno, T_DINT *pk_dint );
void    ret_wup ( ID tskid );
#endif
#if 0
void    ret_int ( void );
#endif
#define ret_int() return
ER      loc_cpu ( void );
ER      unl_cpu ( void );
#if 0 // NOT SUPPORTED
ER      dis_int ( UINT eintno );
ER      ena_int ( UINT eintno );
ER      chg_iXX ( UINT iXXXX );
ER      ref_iXX ( UINT *p_iXXXX );
#endif
        
// - Memorypool Management Functions
        
ER      cre_mpl ( ID mplid, T_CMPL *pk_cmpl );
ER      del_mpl ( ID mplid );
ER      get_blk ( VP *p_blk, ID mplid, INT blksz );
ER      pget_blk ( VP *p_blk, ID mplid, INT blksz );
ER      tget_blk ( VP *p_blk, ID mplid, INT blksz, TMO tmout );
ER      rel_blk ( ID mplid, VP blk );
ER      ref_mpl ( T_RMPL *pk_rmpl, ID mplid );

ER      cre_mpf ( ID mpfid, T_CMPF *pk_cmpf );
ER      del_mpf ( ID mpfid );
ER      get_blf ( VP *p_blf, ID mpfid );
ER      pget_blf ( VP *p_blf, ID mpfid );
ER      tget_blf ( VP *p_blf, ID mpfid, TMO tmout );
ER      rel_blf ( ID mpfid, VP blf );
ER      ref_mpf ( T_RMPF *pk_rmpf, ID mpfid );
        
// - Time Management Functions
        
ER      set_tim ( SYSTIME *pk_tim );
ER      get_tim ( SYSTIME *pk_tim );
ER      dly_tsk ( DLYTIME dlytim );
ER      def_cyc ( HNO cycno, T_DCYC *pk_dcyc );
ER      act_cyc ( HNO cycno, UINT cycact );
ER      ref_cyc ( T_RCYC *pk_rcyc, HNO cycno );
ER      def_alm ( HNO almno, T_DALM *pk_dalm );
ER      ref_alm ( T_RALM *pk_ralm, HNO almno );
#if 0
void    ret_tmr ( void );
#endif
#define ret_tmr() return
        
// - System Management Functions
        
ER      get_ver ( T_VER *pk_ver );
ER      ref_sys ( T_RSYS *pk_rsys );
ER      ref_cfg ( T_RCFG *pk_rcfg );
#if 0 // NOT SUPPORTED
ER      def_svc ( FN s_fncd, T_DSVC *pk_dsvc );
ER      def_exc ( UINT exckind, T_DEXC *pk_dexc );
#endif
        
// - Network Support Functions
        
#if 0 // NOT SUPPORTED
ER      nrea_dat ( INT *p_reasz, VP dstadr, NODE srcnode, VP srcadr,
               INT datsz );
ER      nwri_dat ( INT *p_wrisz, NODE dstnode, VP dstadr, VP srcadr,
               INT datsz );
ER      nget_nod ( NODE *p_node );
ER      nget_ver ( T_VER *pk_ver, NODE node );
#endif

CYG_UIT_FUNC_EXTERN_END

// ========================================================================

#ifdef CYGPRI_UITRON_FUNCS_HERE_AND_NOW
// functions are inline OR we are in the outline implementation, so define
// the functions as inlines or plain functions depending on the value of
// CYG_UIT_FUNC_INLINE from above.
#include <cyg/compat/uitron/uit_func.inl>
#endif // CYGPRI_UITRON_FUNCS_HERE_AND_NOW

// ------------------------------------------------------------------------
#endif // CYGPKG_UITRON

#endif // CYGONCE_COMPAT_UITRON_UIT_FUNC_H
// EOF uit_func.h
