source: kernel/eventflag.h

/*
 *  TOPPERS/ASP Kernel
 *      Toyohashi Open Platform for Embedded Real-Time Systems/
 *      Advanced Standard Profile Kernel
 * 
 *  Copyright (C) 2000-2003 by Embedded and Real-Time Systems Laboratory
 *                              Toyohashi Univ. of Technology, JAPAN
 *  Copyright (C) 2005-2011 by Embedded and Real-Time Systems Laboratory
 *              Graduate School of Information Science, Nagoya Univ., JAPAN
 * 
 *  Ÿåµ­Ãøºîž¢ŒÔ€Ï¡€°Ê²Œ€Î(1)¡Á(4)€ÎŸò·ï€òËþ€¿€¹Ÿì¹ç€ËžÂ€ê¡€ËÜ¥œ¥Õ¥È¥Š¥§
 *  ¥¢¡ÊËÜ¥œ¥Õ¥È¥Š¥§¥¢€ò²þÊÑ€·€¿€â€Î€òŽÞ€à¡¥°Ê²ŒÆ±€ž¡Ë€ò»ÈÍÑ¡ŠÊ£Àœ¡Š²þ
 *  ÊÑ¡ŠºÆÇÛÉۡʰʲŒ¡€ÍøÍрȞƀ֡ˀ¹€ë€³€È€ò̵œþ€ÇµöÂú€¹€ë¡¥
 *  (1) ËÜ¥œ¥Õ¥È¥Š¥§¥¢€ò¥œ¡Œ¥¹¥³¡Œ¥É€Î·Á€ÇÍøÍÑ€¹€ëŸì¹ç€Ë€Ï¡€Ÿåµ­€ÎÃøºî
 *      ž¢ÉœŒš¡€€³€ÎÍøÍÑŸò·ï€ª€è€Ó²Œµ­€Î̵ÊÝŸÚµ¬Äꀬ¡€€œ€Î€Þ€Þ€Î·Á€Ç¥œ¡Œ
 *      ¥¹¥³¡Œ¥ÉÃæ€ËŽÞ€Þ€ì€Æ€€€ë€³€È¡¥
 *  (2) ËÜ¥œ¥Õ¥È¥Š¥§¥¢€ò¡€¥é¥€¥Ö¥é¥ê·ÁŒ°€Ê€É¡€ÂŸ€Î¥œ¥Õ¥È¥Š¥§¥¢³«È¯€Ë»È
 *      Íрǀ­€ë·Á€ÇºÆÇÛÉÛ€¹€ëŸì¹ç€Ë€Ï¡€ºÆÇÛÉÛ€ËÈŒ€Š¥É¥­¥å¥á¥ó¥È¡ÊÍøÍÑ
 *      ŒÔ¥Þ¥Ë¥å¥¢¥ë€Ê€É¡Ë€Ë¡€Ÿåµ­€ÎÃøºîž¢ÉœŒš¡€€³€ÎÍøÍÑŸò·ï€ª€è€Ó²Œµ­
 *      €Î̵ÊÝŸÚµ¬Äê€ò·ÇºÜ€¹€ë€³€È¡¥
 *  (3) ËÜ¥œ¥Õ¥È¥Š¥§¥¢€ò¡€µ¡Žï€ËÁȀ߹þ€à€Ê€É¡€ÂŸ€Î¥œ¥Õ¥È¥Š¥§¥¢³«È¯€Ë»È
 *      Íрǀ­€Ê€€·Á€ÇºÆÇÛÉÛ€¹€ëŸì¹ç€Ë€Ï¡€Œ¡€Î€€€º€ì€«€ÎŸò·ï€òËþ€¿€¹€³
 *      €È¡¥
 *    (a) ºÆÇÛÉÛ€ËÈŒ€Š¥É¥­¥å¥á¥ó¥È¡ÊÍøÍьԥޥ˥奢¥ë€Ê€É¡Ë€Ë¡€Ÿåµ­€ÎÃø
 *        ºîž¢ÉœŒš¡€€³€ÎÍøÍÑŸò·ï€ª€è€Ó²Œµ­€Î̵ÊÝŸÚµ¬Äê€ò·ÇºÜ€¹€ë€³€È¡¥
 *    (b) ºÆÇÛÉۀηÁÂÖ€ò¡€ÊÌ€ËÄê€á€ëÊýË¡€Ë€è€Ã€Æ¡€TOPPERS¥×¥í¥ž¥§¥¯¥È€Ë
 *        Êó¹ð€¹€ë€³€È¡¥
 *  (4) ËÜ¥œ¥Õ¥È¥Š¥§¥¢€ÎÍøÍрˀè€êÄŸÀÜŪ€Þ€¿€ÏŽÖÀÜŪ€ËÀž€ž€ë€€€«€Ê€ë»
 *      ³²€«€é€â¡€Ÿåµ­Ãøºîž¢ŒÔ€ª€è€ÓTOPPERS¥×¥í¥ž¥§¥¯¥È€òÌÈÀÕ€¹€ë€³€È¡¥
 *      €Þ€¿¡€ËÜ¥œ¥Õ¥È¥Š¥§¥¢€Î¥æ¡Œ¥¶€Þ€¿€Ï¥š¥ó¥É¥æ¡Œ¥¶€«€é€Î€€€«€Ê€ëÍý
 *      ͳ€ËŽð€Å€¯ÀÁµá€«€é€â¡€Ÿåµ­Ãøºîž¢ŒÔ€ª€è€ÓTOPPERS¥×¥í¥ž¥§¥¯¥È€ò
 *      ÌÈÀÕ€¹€ë€³€È¡¥
 * 
 *  ËÜ¥œ¥Õ¥È¥Š¥§¥¢€Ï¡€ÌµÊÝŸÚ€ÇÄ󶡀µ€ì€Æ€€€ë€â€Î€Ç€¢€ë¡¥Ÿåµ­Ãøºîž¢ŒÔ€ª
 *  €è€ÓTOPPERS¥×¥í¥ž¥§¥¯¥È€Ï¡€ËÜ¥œ¥Õ¥È¥Š¥§¥¢€ËŽØ€·€Æ¡€ÆÃÄê€Î»ÈÍÑÌÜŪ
 *  €ËÂЀ¹€ëŬ¹çÀ­€âŽÞ€á€Æ¡€€€€«€Ê€ëÊÝŸÚ€â¹Ô€ï€Ê€€¡¥€Þ€¿¡€ËÜ¥œ¥Õ¥È¥Š¥§
 *  ¥¢€ÎÍøÍрˀè€êÄŸÀÜŪ€Þ€¿€ÏŽÖÀÜŪ€ËÀž€ž€¿€€€«€Ê€ë»³²€ËŽØ€·€Æ€â¡€€œ
 *  €ÎÀÕÇ€€òÉé€ï€Ê€€¡¥
 * 
 *  @(#) $Id$
 */

/*
 *              ¥€¥Ù¥ó¥È¥Õ¥é¥°µ¡Çœ
 */

#ifndef TOPPERS_EVENTFLAG_H
#define TOPPERS_EVENTFLAG_H

#include "wait.h"

/*
 *  ¥€¥Ù¥ó¥È¥Õ¥é¥°œéŽü²œ¥Ö¥í¥Ã¥¯
 *
 *  €³€Î¹œÂ€Â΀ϡ€Æ±Žü¡ŠÄÌ¿®¥ª¥Ö¥ž¥§¥¯¥È€ÎœéŽü²œ¥Ö¥í¥Ã¥¯€Î¶ŠÄÌÉôʬ
 *  ¡ÊWOBJINIB¡Ë€ò³ÈÄ¥¡Ê¥ª¥Ö¥ž¥§¥¯¥È»ØžþžÀžì€Î·ÑŸµ€ËÁêÅö¡Ë€·€¿€â€Î€Ç¡€
 *  ºÇœé€Î¥Õ¥£¡Œ¥ë¥É€¬¶ŠÄ̀ˀʀÀƀ€€ë¡¥
 */
typedef struct eventflag_initialization_block {
        ATR                     flgatr;                 /* ¥€¥Ù¥ó¥È¥Õ¥é¥°Â°À­ */
        FLGPTN          iflgptn;                /* ¥€¥Ù¥ó¥È¥Õ¥é¥°€Î¥Ó¥Ã¥È¥Ñ¥¿¡Œ¥ó€ÎœéŽüÃÍ */
} FLGINIB;

/*
 *  ¥€¥Ù¥ó¥È¥Õ¥é¥°ŽÉÍý¥Ö¥í¥Ã¥¯
 *
 *  €³€Î¹œÂ€Â΀ϡ€Æ±Žü¡ŠÄÌ¿®¥ª¥Ö¥ž¥§¥¯¥È€ÎŽÉÍý¥Ö¥í¥Ã¥¯€Î¶ŠÄÌÉôʬ¡ÊWOBJCB¡Ë
 *  €ò³ÈÄ¥¡Ê¥ª¥Ö¥ž¥§¥¯¥È»ØžþžÀžì€Î·ÑŸµ€ËÁêÅö¡Ë€·€¿€â€Î€Ç¡€ºÇœé€Î2€Ä€Î
 *  ¥Õ¥£¡Œ¥ë¥É€¬¶ŠÄ̀ˀʀÀƀ€€ë¡¥
 */
typedef struct eventflag_control_block {
        QUEUE           wait_queue;             /* ¥€¥Ù¥ó¥È¥Õ¥é¥°ÂÔ€Á¥­¥å¡Œ */
        const FLGINIB *p_flginib;       /* œéŽü²œ¥Ö¥í¥Ã¥¯€Ø€Î¥Ý¥€¥ó¥¿ */
        FLGPTN          flgptn;                 /* ¥€¥Ù¥ó¥È¥Õ¥é¥°žœºß¥Ñ¥¿¡Œ¥ó */
} FLGCB;

/*
 *  ¥€¥Ù¥ó¥È¥Õ¥é¥°ÂÔ€ÁŸðÊó¥Ö¥í¥Ã¥¯€ÎÄêµÁ
 *
 *  €³€Î¹œÂ€Â΀ϡ€Æ±Žü¡ŠÄÌ¿®¥ª¥Ö¥ž¥§¥¯¥È€ÎÂÔ€ÁŸðÊó¥Ö¥í¥Ã¥¯€Î¶ŠÄÌÉôʬ
 *  ¡ÊWINFO_WOBJ¡Ë€ò³ÈÄ¥¡Ê¥ª¥Ö¥ž¥§¥¯¥È»ØžþžÀžì€Î·ÑŸµ€ËÁêÅö¡Ë€·€¿€â€Î€Ç¡€
 *  ºÇœé€Î2€Ä€Î¥Õ¥£¡Œ¥ë¥É€¬¶ŠÄ̀ˀʀÀƀ€€ë¡¥
 *
 *  flgptn€Ï¡€waiptn€ª€è€Ówfmode€ÈƱ»þ€Ë»È€Š€³€È€Ï€Ê€€€¿€á¡€¶ŠÍÑÂ΀ò»È
 *  €š€Ð¥á¥â¥ê€òÀáÌ󀹀뀳€È€¬²ÄÇœ€Ç€¢€ë¡¥
 */
typedef struct eventflag_waiting_information {
        WINFO           winfo;                  /* Éžœà€ÎÂÔ€ÁŸðÊó¥Ö¥í¥Ã¥¯ */
        FLGCB           *p_flgcb;               /* ÂԀÀƀ€€ë¥€¥Ù¥ó¥È¥Õ¥é¥°€ÎŽÉÍý¥Ö¥í¥Ã¥¯ */
        FLGPTN          waiptn;                 /* ÂÔ€Á¥Ñ¥¿¡Œ¥ó */
        MODE            wfmode;                 /* ÂÔ€Á¥â¡Œ¥É */
        FLGPTN          flgptn;                 /* ÂÔ€Á²òœü»þ€Î¥Ñ¥¿¡Œ¥ó */
} WINFO_FLG;

/*
 *  ¥€¥Ù¥ó¥È¥Õ¥é¥°ID€ÎºÇÂçÃÍ¡Êkernel_cfg.c¡Ë
 */
extern const ID tmax_flgid;

/*
 *  ¥€¥Ù¥ó¥È¥Õ¥é¥°œéŽü²œ¥Ö¥í¥Ã¥¯€Î¥š¥ê¥¢¡Êkernel_cfg.c¡Ë
 */
extern const FLGINIB    flginib_table[];

/*
 *  ¥€¥Ù¥ó¥È¥Õ¥é¥°ŽÉÍý¥Ö¥í¥Ã¥¯€Î¥š¥ê¥¢¡Êkernel_cfg.c¡Ë
 */
extern FLGCB    flgcb_table[];

/*
 *  ¥€¥Ù¥ó¥È¥Õ¥é¥°ŽÉÍý¥Ö¥í¥Ã¥¯€«€é¥€¥Ù¥ó¥È¥Õ¥é¥°ID€òŒè€êœÐ€¹€¿€á€Î¥Þ¥¯¥í
 */
#define FLGID(p_flgcb)  ((ID)(((p_flgcb) - flgcb_table) + TMIN_FLGID))

/*
 *  ¥€¥Ù¥ó¥È¥Õ¥é¥°µ¡Çœ€ÎœéŽü²œ
 */
extern void     initialize_eventflag(void);

/*
 *  ¥€¥Ù¥ó¥È¥Õ¥é¥°ÂÔ€Á²òœüŸò·ï€Î¥Á¥§¥Ã¥¯
 */
extern bool_t   check_flg_cond(FLGCB *p_flgcb, FLGPTN waiptn,
                                                                MODE wfmode, FLGPTN *p_flgptn);

#endif /* TOPPERS_EVENTFLAG_H */