source: asp3_wo_tecs/trunk/extension/dcre/kernel/eventflag.h@ 302

/*
 *  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-2014 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: eventflag.h 200 2014-09-05 19:18:00Z ertl-hiro $
 */

/*
 *              イベントフラグ機能
 */

#ifndef TOPPERS_EVENTFLAG_H
#define TOPPERS_EVENTFLAG_H

#include "kernel_impl.h"
#include <queue.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つのフィールドがå…
±é€šã«ãªã£ã¦ã„る．
 *
 *  waiptnには，待
ち状æ…
‹ã®é–“は待
ちパターンを，待
ち解除された後は待
ち解
 *  除時のパターンをå…
¥ã‚Œã‚‹ï¼ˆ1つのフィールドを2つの目的にå…
¼ç”¨ã—ている）．
 */
typedef struct eventflag_waiting_information {
        WINFO           winfo;                  /* 標準の待
ち情
å ±ãƒ–ãƒ­ãƒƒã‚¯ */
        FLGCB           *p_flgcb;               /* 待
っているイベントフラグの管理ブロック */
        FLGPTN          waiptn;                 /* 待
ちパターン／待
ち解除時のパターン */
        MODE            wfmode;                 /* 待
ちモード */
} WINFO_FLG;

/*
 *  使用していないイベントフラグ管理ブロックのリスト
 */
extern QUEUE    free_flgcb;

/*
 *  イベントフラグIDの最大値（kernel_cfg.c）
 */
extern const ID tmax_flgid;
extern const ID tmax_sflgid;

/*
 *  イベントフラグ初期化ブロックのエリア（kernel_cfg.c）
 */
extern const FLGINIB    flginib_table[];
extern FLGINIB                  aflginib_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 */