eventflag.c

説明を見る。

/*
 *  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-2008 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.c 748 2008-03-07 17:18:06Z hiro $
 */

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

#include "kernel_impl.h"
#include "check.h"
#include "task.h"
#include "wait.h"
#include "eventflag.h"

/*
 *  トレースログマクロのデフォルト定義
 */
#ifndef LOG_SET_FLG_ENTER
#define LOG_SET_FLG_ENTER(flgid, setptn)
#endif /* LOG_SET_FLG_ENTER */

#ifndef LOG_SET_FLG_LEAVE
#define LOG_SET_FLG_LEAVE(ercd)
#endif /* LOG_SET_FLG_LEAVE */

#ifndef LOG_ISET_FLG_ENTER
#define LOG_ISET_FLG_ENTER(flgid, setptn)
#endif /* LOG_ISET_FLG_ENTER */

#ifndef LOG_ISET_FLG_LEAVE
#define LOG_ISET_FLG_LEAVE(ercd)
#endif /* LOG_ISET_FLG_LEAVE */

#ifndef LOG_CLR_FLG_ENTER
#define LOG_CLR_FLG_ENTER(flgid, clrptn)
#endif /* LOG_CLR_FLG_ENTER */

#ifndef LOG_CLR_FLG_LEAVE
#define LOG_CLR_FLG_LEAVE(ercd)
#endif /* LOG_CLR_FLG_LEAVE */

#ifndef LOG_WAI_FLG_ENTER
#define LOG_WAI_FLG_ENTER(flgid, waiptn, wfmode, p_flgptn)
#endif /* LOG_WAI_FLG_ENTER */

#ifndef LOG_WAI_FLG_LEAVE
#define LOG_WAI_FLG_LEAVE(ercd, flgptn)
#endif /* LOG_WAI_FLG_LEAVE */

#ifndef LOG_POL_FLG_ENTER
#define LOG_POL_FLG_ENTER(flgid, waiptn, wfmode, p_flgptn)
#endif /* LOG_POL_FLG_ENTER */

#ifndef LOG_POL_FLG_LEAVE
#define LOG_POL_FLG_LEAVE(ercd, flgptn)
#endif /* LOG_POL_FLG_LEAVE */

#ifndef LOG_TWAI_FLG_ENTER
#define LOG_TWAI_FLG_ENTER(flgid, waiptn, wfmode, p_flgptn, tmout)
#endif /* LOG_TWAI_FLG_ENTER */

#ifndef LOG_TWAI_FLG_LEAVE
#define LOG_TWAI_FLG_LEAVE(ercd, flgptn)
#endif /* LOG_TWAI_FLG_LEAVE */

#ifndef LOG_INI_FLG_ENTER
#define LOG_INI_FLG_ENTER(flgid)
#endif /* LOG_INI_FLG_ENTER */

#ifndef LOG_INI_FLG_LEAVE
#define LOG_INI_FLG_LEAVE(ercd)
#endif /* LOG_INI_FLG_LEAVE */

#ifndef LOG_REF_FLG_ENTER
#define LOG_REF_FLG_ENTER(flgid, pk_rflg)
#endif /* LOG_REF_FLG_ENTER */

#ifndef LOG_REF_FLG_LEAVE
#define LOG_REF_FLG_LEAVE(ercd, pk_rflg)
#endif /* LOG_REF_FLG_LEAVE */

/*
 *  イベントフラグの数
 */
#define tnum_flg    ((uint_t)(tmax_flgid - TMIN_FLGID + 1))

/*
 *  イベントフラグIDからイベントフラグ管理ブロックを取り出すためのマクロ
 */
#define INDEX_FLG(flgid)    ((uint_t)((flgid) - TMIN_FLGID))
#define get_flgcb(flgid)    (&(flgcb_table[INDEX_FLG(flgid)]))

/*
 *  イベントフラグ機能の初期化
 */
#ifdef TOPPERS_flgini

void
initialize_eventflag(void)
{
    uint_t  i;
    FLGCB   *p_flgcb;

    for (p_flgcb = flgcb_table, i = 0; i < tnum_flg; p_flgcb++, i++) {
        queue_initialize(&(p_flgcb->wait_queue));
        p_flgcb->p_flginib = &(flginib_table[i]);
        p_flgcb->flgptn = p_flgcb->p_flginib->iflgptn;
    }
}

#endif /* TOPPERS_flgini */

/*
 *  イベントフラグ待ち解除条件のチェック
 */
#ifdef TOPPERS_flgcnd

bool_t
check_flg_cond(FLGCB *p_flgcb, FLGPTN waiptn, MODE wfmode, FLGPTN *p_flgptn)
{
    if ((wfmode & TWF_ORW) != 0U ? (p_flgcb->flgptn & waiptn) != 0U
                                    : (p_flgcb->flgptn & waiptn) == waiptn) {
        *p_flgptn = p_flgcb->flgptn;
        if ((p_flgcb->p_flginib->flgatr & TA_CLR) != 0U) {
            p_flgcb->flgptn = 0U;
        }
        return(true);
    }
    return(false);
}

#endif /* TOPPERS_flgcnd */

/*
 *  イベントフラグのセット
 */
#ifdef TOPPERS_set_flg

ER
set_flg(ID flgid, FLGPTN setptn)
{
    FLGCB   *p_flgcb;
    QUEUE   *p_queue;
    TCB     *p_tcb;
    WINFO_FLG *p_winfo_flg;
    bool_t  dspreq = false;
    ER      ercd;

    LOG_SET_FLG_ENTER(flgid, setptn);
    CHECK_TSKCTX_UNL();
    CHECK_FLGID(flgid);
    p_flgcb = get_flgcb(flgid);

    t_lock_cpu();
    p_flgcb->flgptn |= setptn;
    p_queue = p_flgcb->wait_queue.p_next;
    while (p_queue != &(p_flgcb->wait_queue)) {
        p_tcb = (TCB *) p_queue;
        p_queue = p_queue->p_next;
        p_winfo_flg = (WINFO_FLG *)(p_tcb->p_winfo);
        if (check_flg_cond(p_flgcb, p_winfo_flg->waiptn,
                            p_winfo_flg->wfmode, &(p_winfo_flg->flgptn))) {
            queue_delete(&(p_tcb->task_queue));
            if (wait_complete(p_tcb)) {
                dspreq = true;
            }
            if ((p_flgcb->p_flginib->flgatr & TA_CLR) != 0U) {
                break;
            }
        }
    }
    if (dspreq) {
        dispatch();
    }
    ercd = E_OK;
    t_unlock_cpu();

  error_exit:
    LOG_SET_FLG_LEAVE(ercd);
    return(ercd);
}

#endif /* TOPPERS_set_flg */

/*
 *  イベントフラグのセット（非タスクコンテキスト用）
 */
#ifdef TOPPERS_iset_flg

ER
iset_flg(ID flgid, FLGPTN setptn)
{
    FLGCB   *p_flgcb;
    QUEUE   *p_queue;
    TCB     *p_tcb;
    WINFO_FLG *p_winfo_flg;
    ER      ercd;

    LOG_ISET_FLG_ENTER(flgid, setptn);
    CHECK_INTCTX_UNL();
    CHECK_FLGID(flgid);
    p_flgcb = get_flgcb(flgid);

    i_lock_cpu();
    p_flgcb->flgptn |= setptn;
    p_queue = p_flgcb->wait_queue.p_next;
    while (p_queue != &(p_flgcb->wait_queue)) {
        p_tcb = (TCB *) p_queue;
        p_queue = p_queue->p_next;
        p_winfo_flg = (WINFO_FLG *)(p_tcb->p_winfo);
        if (check_flg_cond(p_flgcb, p_winfo_flg->waiptn,
                            p_winfo_flg->wfmode, &(p_winfo_flg->flgptn))) {
            queue_delete(&(p_tcb->task_queue));
            if (wait_complete(p_tcb)) {
                reqflg = true;
            }
            if ((p_flgcb->p_flginib->flgatr & TA_CLR) != 0U) {
                break;
            }
        }
    }
    ercd = E_OK;
    i_unlock_cpu();

  error_exit:
    LOG_ISET_FLG_LEAVE(ercd);
    return(ercd);
}

#endif /* TOPPERS_iset_flg */

/*
 *  イベントフラグのクリア
 */
#ifdef TOPPERS_clr_flg

ER
clr_flg(ID flgid, FLGPTN clrptn)
{
    FLGCB   *p_flgcb;
    ER      ercd;

    LOG_CLR_FLG_ENTER(flgid, clrptn);
    CHECK_TSKCTX_UNL();
    CHECK_FLGID(flgid);
    p_flgcb = get_flgcb(flgid);

    t_lock_cpu();
    p_flgcb->flgptn &= clrptn; 
    ercd = E_OK;
    t_unlock_cpu();

  error_exit:
    LOG_CLR_FLG_LEAVE(ercd);
    return(ercd);
}

#endif /* TOPPERS_clr_flg */

/*
 *  イベントフラグ待ち
 */
#ifdef TOPPERS_wai_flg

ER
wai_flg(ID flgid, FLGPTN waiptn, MODE wfmode, FLGPTN *p_flgptn)
{
    FLGCB   *p_flgcb;
    WINFO_FLG winfo_flg;
    ER      ercd;

    LOG_WAI_FLG_ENTER(flgid, waiptn, wfmode, p_flgptn);
    CHECK_DISPATCH();
    CHECK_FLGID(flgid);
    CHECK_PAR(waiptn != 0U);
    CHECK_PAR(wfmode == TWF_ORW || wfmode == TWF_ANDW);
    p_flgcb = get_flgcb(flgid);

    t_lock_cpu();
    if ((p_flgcb->p_flginib->flgatr & TA_WMUL) == 0U
                    && !queue_empty(&(p_flgcb->wait_queue))) {
        ercd = E_ILUSE;
    }
    else if (check_flg_cond(p_flgcb, waiptn, wfmode, p_flgptn)) {
        ercd = E_OK;
    }
    else {
        winfo_flg.waiptn = waiptn;
        winfo_flg.wfmode = wfmode;
        p_runtsk->tstat = (TS_WAITING | TS_WAIT_FLG);
        wobj_make_wait((WOBJCB *) p_flgcb, (WINFO_WOBJ *) &winfo_flg);
        dispatch();
        ercd = winfo_flg.winfo.wercd;
        if (ercd == E_OK) {
            *p_flgptn = winfo_flg.flgptn;
        }
    }
    t_unlock_cpu();

  error_exit:
    LOG_WAI_FLG_LEAVE(ercd, *p_flgptn);
    return(ercd);
}

#endif /* TOPPERS_wai_flg */

/*
 *  イベントフラグ待ち（ポーリング）
 */
#ifdef TOPPERS_pol_flg

ER
pol_flg(ID flgid, FLGPTN waiptn, MODE wfmode, FLGPTN *p_flgptn)
{
    FLGCB   *p_flgcb;
    ER      ercd;

    LOG_POL_FLG_ENTER(flgid, waiptn, wfmode, p_flgptn);
    CHECK_TSKCTX_UNL();
    CHECK_FLGID(flgid);
    CHECK_PAR(waiptn != 0U);
    CHECK_PAR(wfmode == TWF_ORW || wfmode == TWF_ANDW);
    p_flgcb = get_flgcb(flgid);

    t_lock_cpu();
    if ((p_flgcb->p_flginib->flgatr & TA_WMUL) == 0U
                    && !queue_empty(&(p_flgcb->wait_queue))) {
        ercd = E_ILUSE;
    }
    else if (check_flg_cond(p_flgcb, waiptn, wfmode, p_flgptn)) {
        ercd = E_OK;
    }
    else {
        ercd = E_TMOUT;
    }
    t_unlock_cpu();

  error_exit:
    LOG_POL_FLG_LEAVE(ercd, *p_flgptn);
    return(ercd);
}

#endif /* TOPPERS_pol_flg */

/*
 *  イベントフラグ待ち（タイムアウトあり）
 */
#ifdef TOPPERS_twai_flg

ER
twai_flg(ID flgid, FLGPTN waiptn, MODE wfmode, FLGPTN *p_flgptn, TMO tmout)
{
    FLGCB   *p_flgcb;
    WINFO_FLG winfo_flg;
    TMEVTB  tmevtb;
    ER      ercd;

    LOG_TWAI_FLG_ENTER(flgid, waiptn, wfmode, p_flgptn, tmout);
    CHECK_DISPATCH();
    CHECK_FLGID(flgid);
    CHECK_PAR(waiptn != 0U);
    CHECK_PAR(wfmode == TWF_ORW || wfmode == TWF_ANDW);
    CHECK_TMOUT(tmout);
    p_flgcb = get_flgcb(flgid);

    t_lock_cpu();
    if ((p_flgcb->p_flginib->flgatr & TA_WMUL) == 0U
                    && !queue_empty(&(p_flgcb->wait_queue))) {
        ercd = E_ILUSE;
    }
    else if (check_flg_cond(p_flgcb, waiptn, wfmode, p_flgptn)) {
        ercd = E_OK;
    }
    else if (tmout == TMO_POL) {
        ercd = E_TMOUT;
    }
    else {
        winfo_flg.waiptn = waiptn;
        winfo_flg.wfmode = wfmode;
        p_runtsk->tstat = (TS_WAITING | TS_WAIT_FLG);
        wobj_make_wait_tmout((WOBJCB *) p_flgcb, (WINFO_WOBJ *) &winfo_flg,
                                                        &tmevtb, tmout);
        dispatch();
        ercd = winfo_flg.winfo.wercd;
        if (ercd == E_OK) {
            *p_flgptn = winfo_flg.flgptn;
        }
    }
    t_unlock_cpu();

  error_exit:
    LOG_TWAI_FLG_LEAVE(ercd, *p_flgptn);
    return(ercd);
}

#endif /* TOPPERS_twai_flg */

/*
 *  イベントフラグの再初期化
 */
#ifdef TOPPERS_ini_flg

ER
ini_flg(ID flgid)
{
    FLGCB   *p_flgcb;
    bool_t  dspreq;
    ER      ercd;
    
    LOG_INI_FLG_ENTER(flgid);
    CHECK_TSKCTX_UNL();
    CHECK_FLGID(flgid);
    p_flgcb = get_flgcb(flgid);

    t_lock_cpu();
    dspreq = init_wait_queue(&(p_flgcb->wait_queue));
    p_flgcb->flgptn = p_flgcb->p_flginib->iflgptn;
    if (dspreq) {
        dispatch();
    }
    ercd = E_OK;
    t_unlock_cpu();

  error_exit:
    LOG_INI_FLG_LEAVE(ercd);
    return(ercd);
}

#endif /* TOPPERS_ini_flg */

/*
 *  イベントフラグの状態参照
 */
#ifdef TOPPERS_ref_flg

ER
ref_flg(ID flgid, T_RFLG *pk_rflg)
{
    FLGCB   *p_flgcb;
    ER      ercd;
    
    LOG_REF_FLG_ENTER(flgid, pk_rflg);
    CHECK_TSKCTX_UNL();
    CHECK_FLGID(flgid);
    p_flgcb = get_flgcb(flgid);

    t_lock_cpu();
    pk_rflg->wtskid = wait_tskid(&(p_flgcb->wait_queue));
    pk_rflg->flgptn = p_flgcb->flgptn;
    ercd = E_OK;
    t_unlock_cpu();

  error_exit:
    LOG_REF_FLG_LEAVE(ercd, pk_rflg);
    return(ercd);
}

#endif /* TOPPERS_ref_flg */

---

Copyright © 2008 by Kijineko Inc.

ホームページ制作