toppers/semaphore.hpp

解説を見る。

/*
 *  TOPPERS/C++ API Template Library
 *      Toyohashi Open Platform for Embedded Real-Time Systems/
 *      C++ API Template Library
 *
 *  Copyright (C) 2004 by TAKAGI Nobuhisa
 *
 *  上記著作権者は，以下の (1)〜(4) の条件か，Free Software Foundation
 *  によって公表されている GNU General Public License の Version 2 に記
 *  述されている条件を満たす場合に限り，本ソフトウェア（本ソフトウェア
 *  を改変したものを含む．以下同じ）を使用・複製・改変・再配布（以下，
 *  利用と呼ぶ）することを無償で許諾する．
 *  (1) 本ソフトウェアをソースコードの形で利用する場合には，上記の著作
 *      権表示，この利用条件および下記の無保証規定が，そのままの形でソー
 *      スコード中に含まれていること．
 *  (2) 本ソフトウェアを，ライブラリ形式など，他のソフトウェア開発に使
 *      用できる形で再配布する場合には，再配布に伴うドキュメント（利用
 *      者マニュアルなど）に，上記の著作権表示，この利用条件および下記
 *      の無保証規定を掲載すること．
 *  (3) 本ソフトウェアを，機器に組み込むなど，他のソフトウェア開発に使
 *      用できない形で再配布する場合には，次のいずれかの条件を満たすこ
 *      と．
 *    (a) 再配布に伴うドキュメント（利用者マニュアルなど）に，上記の著
 *        作権表示，この利用条件および下記の無保証規定を掲載すること．
 *    (b) 再配布の形態を，別に定める方法によって，TOPPERSプロジェクトに
 *        報告すること．
 *  (4) 本ソフトウェアの利用により直接的または間接的に生じるいかなる損
 *      害からも，上記著作権者およびTOPPERSプロジェクトを免責すること．
 *
 *  本ソフトウェアは，無保証で提供されているものである．上記著作権者お
 *  よびTOPPERSプロジェクトは，本ソフトウェアに関して，その適用可能性も
 *  含めて，いかなる保証も行わない．また，本ソフトウェアの利用により直
 *  接的または間接的に生じたいかなる損害に関しても，その責任を負わない．
 *
 *  @(#) $Id: semaphore.hpp,v 1.1.1.1 2004/04/14 09:30:30 takagi-n Exp $
 */

#ifndef TOPPERS_SEMAPHORE_HPP_
#define TOPPERS_SEMAPHORE_HPP_

#include <toppers/object.hpp>

namespace toppers
{

    template <ID Id = 0,
              class Diagnostics = TOPPERS_DEFAULT_DIAGNOSTICS,
              class Stub = TOPPERS_DEFAULT_STUB >
    class semaphore : Diagnostics
    {
        typedef object_controller<Id, obj_semaphore, Stub> controller;
        object_id<Id> objid_;

    public:
        typedef t_csem creation;
        typedef t_rsem reference;


        semaphore() {}
        explicit semaphore(ID id) : objid_(id) {}

        template <ID Id2, class Diagnostics2, class Stub2>
        semaphore(const semaphore<Id2, Diagnostics2, Stub2>& other)
            : objid_(get_unsafe_id(other))
        {
            TOPPERS_STATIC_ASSERT(Id == 0);
        }



        //  互換性のための多重定義
        ER create(creation* pk_cobj)
        {
            ER ercd = controller::create(objid_, pk_cobj);
            return handle_error(ercd);
        }
        ER create(const creation* pk_cobj)
        {
            ER ercd = controller::create(objid_, pk_cobj);
            return handle_error(ercd);
        }
        ER create(ATR sematr = TA_TFIFO, UINT isemcnt = 1, UINT maxsem = 1)
        {
            creation packet;
            packet.sematr  = sematr;
            packet.isemcnt = isemcnt;
            packet.maxsem  = maxsem;
            return create(&packet);
        }
        ER destroy()
        {
            ER ercd = controller::destroy(objid_);
            return handle_error(ercd);
        }



        ER refer(reference* pk_robj) const
        {
            ER ercd = controller::refer(objid_, pk_robj);
            return handle_error(ercd);
        }



        ER signal(task_context_tag = task_context) const
        {
            ER ercd = Stub::stub_sig_sem(objid_.id());
            return handle_error(ercd);
        }
        ER signal(non_task_context_tag) const
        {
            ER ercd = Stub::stub_isig_sem(objid_.id());
            return handle_error(ercd);
        }
        ER signal(context_independent_tag) const
        {
            ER ercd;
            if (Stub::stub_sns_ctx())
                ercd = Stub::stub_isig_sem(objid_.id());
            else
                ercd = Stub::stub_sig_sem(objid_.id());
            return handle_error(ercd);
        }

        ER wait(forever_tag = forever) const
        {
            ER ercd = Stub::stub_wai_sem(objid_.id());
            return handle_error(ercd);
        }
        ER wait(polling_tag) const
        {
            ER ercd = Stub::stub_pol_sem(objid_.id());
            return handle_error(ercd);
        }
        ER wait(TMO tmout) const
        {
            ER ercd = Stub::stub_twai_sem(objid_.id(), tmout);
            return handle_error(ercd);
        }


        friend ID get_unsafe_id(const semaphore<Id, Diagnostics, Stub>& obj)
        {
            return obj.objid_.id();
        }
    };

    namespace detail
    {

        template <bool SenseKernel, class LockObj> class lock_helper;

        template <bool SenseKernel, ID Id, class Diagnostics, class Stub>
        class lock_helper<SenseKernel, semaphore<Id, Diagnostics, Stub> >
        {
        public:
            typedef semaphore<Id, Diagnostics, Stub> sync_type;

            static ER lock(const sync_type& sync)
            {
                return sense_kernel<SenseKernel>() ? E_OK : sync.wait();
            }
            static ER unlock(const sync_type& sync)
            {
                return sense_kernel<SenseKernel>() ? E_OK : sync.signal();
            }
        };

    }

}

#endif  // ! TOPPERS_SEMAPHORE_HPP_

---

• Copyright © 2004 by TAKAGI Nobuhisa
• 本ソフトウェアはTOPPERSライセンスに基づいて配布されています。
• TRONは"The Real-time Operating system Nucleus"の略称です。
• ITRONは"Industrial TRON"の略称です。
• μITRONは"Micro Industrial TRON"の略称です。
• TRON、ITRON、およびμITRONは、特定の商品ないしは商品群を指す名称ではありません。
• TOPPERSは"Toyohashi OPen Platform for Embedded Real-time Systems"の略称、JSPは"Just Standard Profile"の略称です。
• 本ページ中の商品名は，各社の商標または登録商標です。