mnt_defs.h
来自「澳洲人写的Cortex,包括uC_IP协议栈」· C头文件 代码 · 共 221 行
H
221 行
<HTML><HEAD><TITLE>/home/asysweb/public_html/cortex/kernel/src/mnt_defs.h</TITLE></HEAD><BODY><pre><font color="#6920ac">/*************************************************************************/</font><font color="#6920ac">/* */</font><font color="#6920ac">/* Copyright (c) 1997-1999 Australian Real Time Embedded Systems */</font><font color="#6920ac">/* */</font><font color="#6920ac">/* PROPRIETARY RIGHTS of Australian Real Time Embedded Systems */</font><font color="#6920ac">/* are involved in the subject matter of this material. All reproduction,*/</font><font color="#6920ac">/* manufacturing, use, and sales rights pertaining to this subject matter*/</font><font color="#6920ac">/* are governed by the license agreement. The recipient of this software */</font><font color="#6920ac">/* implicitly accepts the terms of the license. */</font><font color="#6920ac">/* */</font><font color="#6920ac">/*************************************************************************/</font><font color="#6920ac">/************************************************************************* * * FILE NAME * * mtr_defs.h * * SYSTEM COMPONENT * * Monitor Compenent (MNTR) * * DESCRIPTION * * This file contains data and constant definitions for monitors * * SCCS HISTORY * * @(#)mnt_defs.h 1.10, 12/22/99, 16:17:13 * * AUTHOR * * Vadim N. Azarovsky * * CREATED * * 27-Apr-1998 by Vadim N. Azarovsky * * REVISION HISTORY * * NAME DATE REMARKS * **************************************************************************/</font><b><font color='DarkGreen'>#ifndef</font></b><font color="maroon"> __MNT_DEFS__H</font><b><font color='DarkGreen'>#define</font></b> <font color="maroon"><a name="__MNT_DEFS__H">__MNT_DEFS__H</a></font><b><font color='DarkGreen'>#ifdef</font></b><font color="maroon"> __cplusplus</font><i>extern</i> <font color="DarkGreen">"C"</font> {<b><font color='DarkGreen'>#endif</font></b><font color="maroon"> <font color="#6920ac">/* __cplusplus */</font></font><b><font color='DarkGreen'>#include</font></b> <a href="crt_defs.h.FIND-INC"><font color="blue">"crt_defs.h"</font></a><b><font color='DarkGreen'>#include</font></b> <a href="rlq_defs.h.FIND-INC"><font color="blue">"rlq_defs.h"</font></a><b><font color='DarkGreen'>#include</font></b> <a href="tck_defs.h.FIND-INC"><font color="blue">"tck_defs.h"</font></a><b><font color='DarkGreen'>#include</font></b> <a href="tsk_defs.h.FIND-INC"><font color="blue">"tsk_defs.h"</font></a><font color="#6920ac">/*********************** * GLOBAL CONSTANSTS * ***********************/</font><b><font color='DarkGreen'>#define</font></b> <font color="maroon"><a name="MNTR_MONITOR_ID">MNTR_MONITOR_ID</a></font> 0x4D4E5452ul <font color="#6920ac">/* "MNTR" - monitor */</font><b><font color='DarkGreen'>#define</font></b> <font color="maroon"><a name="MNTR_SUSPEND_BLOCK_ID">MNTR_SUSPEND_BLOCK_ID</a></font> 0x4D4E5453UL <font color="#6920ac">/* "MNTS" - cond suspend blk */</font><b><font color='DarkGreen'>#define</font></b> <font color="maroon"><a name="MNTR_CONDITION_ID">MNTR_CONDITION_ID</a></font> 0x4D4E5443UL <font color="#6920ac">/* "MNTC" - cond cntr block */</font><font color="#6920ac">/* * Return Codes */</font><b><font color='DarkGreen'>#define</font></b> <font color="maroon"><a name="MNTR_SUCCESS">MNTR_SUCCESS</a></font> CRTX_SUCCESS <font color="#6920ac">/* successful completion */</font><b><font color='DarkGreen'>#define</font></b> <font color="maroon"><a name="MNTR_ERR_INVALID_MONITOR">MNTR_ERR_INVALID_MONITOR</a></font> -1 <font color="#6920ac">/* invalid monitor */</font><b><font color='DarkGreen'>#define</font></b> <font color="maroon"><a name="MNTR_ERR_INVALID_CONDITION">MNTR_ERR_INVALID_CONDITION</a></font> -2 <font color="#6920ac">/* invalid condition */</font><b><font color='DarkGreen'>#define</font></b> <font color="maroon"><a name="MNTR_ERROR">MNTR_ERROR</a></font> -3 <font color="#6920ac">/* other errors */</font><font color="#6920ac">/* * Monitor flags */</font><b><font color='DarkGreen'>#define</font></b> <font color="maroon"><a name="MNTR_FLAG_INIT">MNTR_FLAG_INIT</a></font> 0x00 <font color="#6920ac">/* initialisation flags */</font><b><font color='DarkGreen'>#define</font></b> <font color="maroon"><a name="MNTR_FLAG_MONITOR_ALLOC">MNTR_FLAG_MONITOR_ALLOC</a></font> 0x01 <font color="#6920ac">/* monitor control block is allocated*/</font><b><font color='DarkGreen'>#define</font></b> <font color="maroon"><a name="MNTR_FLAG_COND_ALLOC">MNTR_FLAG_COND_ALLOC</a></font> 0x01 <font color="#6920ac">/* cond control block is allocated*/</font><b><font color='DarkGreen'>#define</font></b> <font color="maroon"><a name="MNTR_FLAG_COND_SUSP_POLICY">MNTR_FLAG_COND_SUSP_POLICY</a></font> 0x02<font color="#6920ac">/***************** * GLOBAL MACROS * *****************/</font><b><font color='DarkGreen'>#if</font></b><font color="maroon"> ENVI_CRTX_ERR_CHECK_LEVEL == 0</font><b><font color='DarkGreen'># define</font></b> <font color="maroon"><a name="MNTR_SET_MONITOR_ID">MNTR_SET_MONITOR_ID</a></font>(_mntr) <b><font color='DarkGreen'># define</font></b> <font color="maroon"><a name="MNTR_CHECK_MONITOR_ID">MNTR_CHECK_MONITOR_ID</a></font>(_mntr) (CRTX_TRUE)<b><font color='DarkGreen'># define</font></b> <font color="maroon"><a name="MNTR_SET_CONDITION_ID">MNTR_SET_CONDITION_ID</a></font>(_cond) <b><font color='DarkGreen'># define</font></b> <font color="maroon"><a name="MNTR_CHECK_CONDITION_ID">MNTR_CHECK_CONDITION_ID</a></font>(_cond) (CRTX_TRUE)<b><font color='DarkGreen'>#else</font></b><font color="maroon"></font><b><font color='DarkGreen'># define</font></b> <font color="maroon"><a name="MNTR_SET_MONITOR_ID">MNTR_SET_MONITOR_ID</a></font>(_mntr) ((_mntr)->CheckID=MNTR_MONITOR_ID)<b><font color='DarkGreen'># define</font></b> <font color="maroon"><a name="MNTR_CHECK_MONITOR_ID">MNTR_CHECK_MONITOR_ID</a></font>(_mntr) ((_mntr)->CheckID==MNTR_MONITOR_ID)<b><font color='DarkGreen'># define</font></b> <font color="maroon"><a name="MNTR_SET_CONDITION_ID">MNTR_SET_CONDITION_ID</a></font>(_cond) ((_cond)->CheckID=MNTR_CONDITION_ID)<b><font color='DarkGreen'># define</font></b> <font color="maroon"><a name="MNTR_CHECK_CONDITION_ID">MNTR_CHECK_CONDITION_ID</a></font>(_cond) ((_cond)->CheckID==MNTR_CONDITION_ID)<b><font color='DarkGreen'>#endif</font></b><font color="maroon"> <font color="#6920ac">/* ENVI_CRTX_ERR_CHECK_LEVEL == 0 */</font></font><font color="#6920ac">/*********************** * GLOBAL DATA TYPES * ***********************/</font><font color="#6920ac">/* monitor creation attributes */</font><i><a name="mntr_Attr_t">typedef</a></i> <i>struct</i> { <i>crtx_Bool_t</i> DeviceFlag; <font color="#6920ac">/* device monitor flag */</font> <i>crtx_Mask_t</i> DisableMask; <font color="#6920ac">/* mask for software interrupts * to desable while within monitor * (for device monitor only) */</font> <i>crtx_SegNum_t</i> Segment; <font color="#6920ac">/* memory segment */</font>} <i><font color='DarkBlue'>mntr_Attr_t</font></i>;<font color="#6920ac">/* * condition attributes */</font><i><a name="mntr_CondAttr_t">typedef</a></i> <i>struct</i> { <i>crtx_SegNum_t</i> Segment; <font color="#6920ac">/* memory segment */</font> <i>task_SuspendPolicy_t</i> SuspendPolicy; <font color="#6920ac">/* suspend policy */</font>} <i><font color='DarkBlue'>mntr_CondAttr_t</font></i>;<font color="#6920ac">/* monitor control block */</font><i><a name="mntr_Monitor_t">typedef</a></i> <i>struct</i> mntr_Monitor_s { <i>crtx_Mask_t</i> DisableMask; <font color="#6920ac">/* software interrupt disable mask */</font> <i>crtx_Mask_t</i> EnableMask; <font color="#6920ac">/* software interrupt enable mask */</font> <i>crtx_SegNum_t</i> Segment; <font color="#6920ac">/* memory segment */</font> <i>crtx_Int_t</i> Flags; <font color="#6920ac">/* monitor flags */</font><b><font color='DarkGreen'>#if</font></b><font color="maroon"> ENVI_CRTX_ERR_CHECK_LEVEL > 0</font> <i>crtx_Int_t</i> EntryCntr; <font color="#6920ac">/* monitor entry counter (used for * device monitor only */</font> <i>crtx_Uint32_t</i> CheckID; <font color="#6920ac">/* object id (for error checking) */</font><b><font color='DarkGreen'>#endif</font></b><font color="maroon"> <font color="#6920ac">/* ENVI_CRTX_ERR_CHECK_LEVEL > 0 */</font></font>} <i><font color='DarkBlue'>mntr_Monitor_t</font></i>;<font color="#6920ac">/* monitor's condition key */</font><i><a name="mntr_Key_t">typedef</a></i> <i>crtx_Uint32_t</i> <i><font color='DarkBlue'>mntr_Key_t</font></i>;<font color="#6920ac">/* key compare function */</font><i><a name="mntr_KeyCompFunc_t">typedef</a></i> <i>crtx_Boolean_t</i> (*<i><font color='DarkBlue'>mntr_KeyCompFunc_t</font></i>)(<i>mntr_Key_t</i> WaitKey_a, <i>mntr_Key_t</i> ArgKey_a);<font color="#6920ac">/* * Condition control block */</font> <i><a name="mntr_Condition_t">typedef</a></i> <i>struct</i> mntr_Condition_s { <i>mntr_Monitor_t</i> *pMonitor; <font color="#6920ac">/* monitor */</font> <i>rque_Queue_t</i> WaitingList; <font color="#6920ac">/* condition waiting list */</font> <i>crtx_Int_t</i> Flags; <font color="#6920ac">/* flags */</font> <i>crtx_SegNum_t</i> Segment; <font color="#6920ac">/* memory segment */</font><b><font color='DarkGreen'>#if</font></b><font color="maroon"> ENVI_CRTX_ERR_CHECK_LEVEL > 0</font> <i>crtx_Uint32_t</i> CheckID; <font color="#6920ac">/* object id (for error checking) */</font><b><font color='DarkGreen'>#endif</font></b><font color="maroon"> <font color="#6920ac">/* ENVI_CRTX_ERR_CHECK_LEVEL > 0 */</font></font>} <i><font color='DarkBlue'>mntr_Condition_t</font></i>;<font color="#6920ac">/***************** * GLOBAL DATA * *****************/</font><font color="#6920ac">/* default attributes */</font><i>extern</i> <i>mntr_Attr_t</i> mntr_AttrDefault_g; <font color="#6920ac">/* monitor */</font><i>extern</i> <i>mntr_CondAttr_t</i> mntr_CondAttrDefault_g; <font color="#6920ac">/* condition */</font><font color="#6920ac">/* System-wide non-device monitor */</font><i>extern</i> <i>mntr_Monitor_t</i> mntr_Monitor_g;<font color="#6920ac">/*************************** * PROCEDURES PROTOTYPES * ***************************/</font><font color="#6920ac">/* create monitor */</font><font size="+1"><i>mntr_Monitor_t</i> *<a href="mntr_Create.FIND-FUNC">mntr_Create</a>(<i>mntr_Monitor_t</i> *pMonitor_a, <i>mntr_Attr_t</i> *pAttr_a);</font><font color="#6920ac">/* delete monitor */</font><font size="+1"><i>crtx_Void_t</i> <a href="mntr_Delete.FIND-FUNC">mntr_Delete</a>(<i>mntr_Monitor_t</i> *pMonitor_a);</font><font color="#6920ac">/* enter monitor */</font><font size="+1"><i>crtx_Void_t</i> <a href="mntr_Enter.FIND-FUNC">mntr_Enter</a>(<i>mntr_Monitor_t</i> *pMonitor_a);</font><font color="#6920ac">/* exit monitor */</font><font size="+1"><i>crtx_Void_t</i> <a href="mntr_Exit.FIND-FUNC">mntr_Exit</a>(<i>mntr_Monitor_t</i> *pMonitor_a);</font><font color="#6920ac">/* create/initialise condition object */</font><font size="+1"><i>mntr_Condition_t</i> *<a href="mntr_CondCreate.FIND-FUNC">mntr_CondCreate</a>(<i>mntr_Condition_t</i> *pCondition_a, <i>mntr_Monitor_t</i> *pMonitor_a, <i>mntr_CondAttr_t</i> *pAttr_a);</font><font color="#6920ac">/* destroy condition object */</font><font size="+1"><i>crtx_Status_t</i> <a href="mntr_CondDelete.FIND-FUNC">mntr_CondDelete</a>(<i>mntr_Condition_t</i> *pCondition_a);</font><font color="#6920ac">/* signal on condition (returns number signalled tasks) */</font><font size="+1"><i>crtx_Int_t</i> <a href="mntr_Signal.FIND-FUNC">mntr_Signal</a>(<i>mntr_Condition_t</i> *pCondition_a);</font><font color="#6920ac">/* signal on condition by key value (returns number signalled tasks) */</font><font size="+1"><i>crtx_Int_t</i> <a href="mntr_SignalByKey.FIND-FUNC">mntr_SignalByKey</a>(<i>mntr_Condition_t</i> *pCondition_a, <i>mntr_KeyCompFunc_t</i> CompFunc_a, <i>mntr_Key_t</i> Key_a);</font><font color="#6920ac">/* broadcast signal (returns number signalled tasks) */</font><font size="+1"><i>crtx_Int_t</i> <a href="mntr_Broadcast.FIND-FUNC">mntr_Broadcast</a>(<i>mntr_Condition_t</i> *pCondition_a);</font><font color="#6920ac">/* signal on condition by key value (returns number signalled tasks) */</font><font size="+1"><i>crtx_Int_t</i> <a href="mntr_BroadcastByKey.FIND-FUNC">mntr_BroadcastByKey</a>(<i>mntr_Condition_t</i> *pCondition_a, <i>mntr_KeyCompFunc_t</i> CompFunc_a, <i>mntr_Key_t</i> Key_a);</font><font color="#6920ac">/* wait for a signal */</font><font size="+1"><i>crtx_Boolean_t</i> <a href="mntr_Wait.FIND-FUNC">mntr_Wait</a>(<i>mntr_Condition_t</i> *pCondition_a, <i>tick_Timeout_t</i> *pTimeout_a, ... <font color="#6920ac">/* optional mntr_Key_t Key_a */</font>);</font><font color="#6920ac">/* ===== END OF THE DEFINITION FILE ===== */</font><b><font color='DarkGreen'>#ifdef</font></b><font color="maroon"> __cplusplus</font>}<b><font color='DarkGreen'>#endif</font></b><font color="maroon"> <font color="#6920ac">/* __cplusplus */</font></font><b><font color='DarkGreen'>#endif</font></b><font color="maroon"> <font color="#6920ac">/* __MNT_DEFS__H */</font></font></pre></BODY></HTML>⌨️ 快捷键说明
复制代码Ctrl + C
搜索代码Ctrl + F
全屏模式F11
增大字号Ctrl + =
减小字号Ctrl + -
显示快捷键?