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

#ifndef TOPPERS_RENDEZVOUS_HPP_
#define TOPPERS_RENDEZVOUS_HPP_

#include <toppers/object.hpp>

namespace toppers
{

    template <class Diagnostics = TOPPERS_DEFAULT_DIAGNOSTICS,
              class Stub = TOPPERS_DEFAULT_STUB >
    class rendezvous : Diagnostics
    {
        RDVNO rdvno_;

    public:
        typedef t_rrdv reference;

        explicit rendezvous(RDVNO rdvno = 0) : rdvno_(rdvno) {}

        ER refer(reference* pk_robj) const
        {
            ER ercd = Stub::stub_ref_rdv(rdvno_, pk_robj);
            return handle_error(ercd);
        }

        ER reply(const void* msg, UINT rmsgsz)
        {
            ER ercd = Stub::stub_rpl_rdv(rdvno_, msg, rmsgsz);
            if (ercd == E_OK)
                rdvno_ = 0;
            return handle_error(ercd);
        }

        RDVNO no() const { return rdvno_; }
        void attach(RDVNO rdvno) { rdvno_ = rdvno; }
    };

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

    public:
        typedef t_cpor creation;
        typedef t_rpor reference;


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

        template <ID Id2, class Diagnostics2, class Stub2>
        rendezvousport(const rendezvousport<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 poratr = TA_TFIFO, UINT maxcmsz = 256, UINT maxrmsz = 256)
        {
            creation packet;
            packet.poratr  = poratr;
            packet.maxcmsz = maxcmsz;
            packet.maxrmsz = maxrmsz;
            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_UINT call(RDVPTN calptn, void* msg, UINT cmsgsz, forever_tag = forever) const
        {
            ER_UINT ercd = Stub::stub_cal_por(objid_.id(), calptn, msg, cmsgsz);
            return handle_error(ercd);
        }
        ER_UINT call(RDVPTN calptn, void* msg, UINT cmsgsz, TMO tmout) const
        {
            ER_UINT ercd = Stub::stub_tcal_por(objid_.id(), calptn, msg, cmsgsz, tmout);
            return handle_error(ercd);
        }

        template <class Diagnostics2, class Stub2>
        ER_UINT accept(RDVPTN acpptn, rendezvous<Diagnostics2, Stub2>& rdvobj, void* msg, forever_tag = forever) const
        {
            RDVNO rdvno;
            ER_UINT ercd = Stub::stub_acp_por(objid_.id(), acpptn, &rdvno, msg);
            rdvobj.attach(rdvno);
            return handle_error(ercd);
        }
        template <class Diagnostics2, class Stub2>
        ER_UINT accept(RDVPTN acpptn, rendezvous<Diagnostics2, Stub2>& rdvobj, void* msg, polling_tag) const
        {
            RDVNO rdvno;
            ER_UINT ercd = Stub::stub_pacp_por(objid_.id(), acpptn, &rdvno, msg);
            rdvobj.attach(rdvno);
            return handle_error(ercd);
        }
        template <class Diagnostics2, class Stub2>
        ER_UINT accept(RDVPTN acpptn, rendezvous<Diagnostics2, Stub2>& rdvobj, void* msg, TMO tmout) const
        {
            RDVNO rdvno;
            ER_UINT ercd = Stub::stub_tacp_por(objid_.id(), acpptn, &rdvno, msg, tmout);
            rdvobj.attach(rdvno);
            return handle_error(ercd);
        }

        template <class Diagnostics2, class Stub2>
        ER forward(RDVPTN calptn, const rendezvous<Diagnostics2, Stub2>& rdvobj, const void* msg, UINT cmsgsz) const
        {
            ER ercd = Stub::stub_fwd_por(objid_.id(), calptn, rdvobj.no(), msg, cmsgsz);
            return handle_error(ercd);
        }


        friend ID get_unsafe_id(const rendezvousport<Id, Diagnostics, Stub>& obj)
        {
            return obj.objid_.id();
        }
    private:
        //  誤ってポーリング指定で呼出すことを禁止する
        ER_UINT call(RDVPTN calptn, void* msg, UINT cmsgsz, polling_tag) const;
    };

}

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