toppers/mailbox.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: mailbox.hpp,v 1.1.1.1 2004/04/14 09:30:29 takagi-n Exp $
 */

#ifndef TOPPERS_MAILBOX_HPP_
#define TOPPERS_MAILBOX_HPP_

#include <toppers/object.hpp>

namespace toppers
{

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

    public:
        typedef t_cmbx creation;
        typedef t_rmbx reference;


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

        template <ID Id2, class Diagnostics2, class Stub2>
        mailbox(const mailbox<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 mbxatr = TA_TFIFO | TA_MFIFO, PRI maxmpri = TMAX_MPRI, VP mprihd = 0)
        {
            creation packet;
            packet.mbxatr  = mbxatr;
            packet.maxmpri = maxmpri;
            packet.mprihd  = mprihd;
            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 send(t_msg* pk_msg) const
        {
            ER ercd = Stub::stub_snd_mbx(objid_.id(), pk_msg);
            return handle_error(ercd);
        }

        ER receive(t_msg** ppk_msg, forever_tag = forever) const
        {
            ER ercd = Stub::stub_rcv_mbx(objid_.id(), ppk_msg);
            return handle_error(ercd);
        }
        ER receive(t_msg** ppk_msg, polling_tag) const
        {
            ER ercd = Stub::stub_prcv_mbx(objid_.id(), ppk_msg);
            return handle_error(ercd);
        }
        ER receive(t_msg** ppk_msg, TMO tmout) const
        {
            ER ercd = Stub::stub_trcv_mbx(objid_.id(), ppk_msg, tmout);
            return handle_error(ercd);
        }


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

}

#endif  // ! TOPPERS_MAILBOX_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"の略称です。
• 本ページ中の商品名は，各社の商標または登録商標です。