はじめに

uITRON（FreeRTOSベース）Windowsシミュレータ - Qiita
https://qiita.com/imagou/items/42c687402e6e58fccddb

今回のお題は、何かあったことに加え、追加情報を伝えるメールボックスです。
（「何かあったこと」のみであれば、イベントフラグでOK）

本編

1. 環境

こちらの記事を参照ください。

2. 動かしてみる

こちらは初回記事を参照。

2-1. タスクでのメール送受信

改めて「2-2. 送信タスク・受信タスク」の動作を確認してください。

3. 解説

3-1. 概要

メールボックスとは、前述したように「何かが発生したことに加え、情報を伝える仕組み」です。
（「メール」って名称からお察しではありますが・・・）

メールの型（メッセージという呼び方をします）はユーザーで自由に決められます。
若干面倒なポイントは以下です：

ユーザーがメッセージ領域を確保する必要あり
メッセージの取得・解放もユーザーの責務

3-2. コードによる説明

以降は、プログラムコード - main.cを引用して説明します。

3-2-1. メッセージ定義・領域確保

メッセージの型と、領域（64個分）の確保箇所は以下です。

/*--- Message ---*/
typedef struct {
    T_MSG       msg;
    ID          id;
    uint32_t    params[1];
} MESSAGE_ENTITY;

#define MESSAGE_SIZE    (64)
static MESSAGE_ENTITY   g_Messages[MESSAGE_SIZE];
static uint16_t         g_MessageIndex = 0;

注意事項として、構造体先頭のT_MSG msg;は必ず含めてください。RTOSの予約領域です。

3-2-2. メッセージ取得・解放

以下を参照ください。

/* メッセージ取得 */
static MESSAGE_ENTITY* GetUserMessage(void) {
    uint16_t index = g_MessageIndex++;
    index %= MESSAGE_SIZE;
    return &(g_Messages[index]);
}
/* 解放はまだ用意していない */

GetUserMessage()は、リングバッファとして領域を扱い、返しているだけです。

解放は色々あって未実装ですが、メッセージを同時に64個以上送信することがなければ、なくてもいいかなーと思っています（面倒くさいわけではないですよ！笑）。

3-2-3. メールボックス生成

cre_mbx()で生成します。

    T_CMBX cmbx;
    cmbx.mbxatr = TA_TFIFO;
    cre_mbx(MAILBOX_ID(RECV), &cmbx);

cre_mbx()のパラメータは下表：

パラメータ番号	名称	説明
第1パラメータ	メールボックスID	単なるID。以降はこのIDでもってメールボックス送信・受信を実施。
第2パラメータ	T_CMBX構造体変数	以下で説明

T_CMBXのメンバは下表：

名称	指定可能な値	説明
mbxatr	TA_TFIFO \| TA_TPRI	メールボックス属性。それぞれ、待ちキューの順序をFIFO順とするか、優先度順とするか。

※なお、mbxatrはこれ以外の値も指定可能（だが、上記のみで必要十分と考える）。

3-2-4. メールボックスへの送信

snd_mbx()を使います。
idにはイベントを数値に変換したもの、params[0]にはカウンタを渡して送信しています。

        MESSAGE_ENTITY* ent;
        ent = GetUserMessage();
        /* Numeric Event */
        /* メッセージIDはイベントを（数値に戻して）設定 */
        /* パラメータにカウンタを渡す */
        int32_t num = 0;
        for (num = 0; !((flgptn >> num) & 1) ; num++) ;
        ent->id = (ID)num;
        ent->params[0] = ++count;

        snd_mbx(MAILBOX_ID(RECV), (T_MSG *)ent);

3-2-5. メールボックスからの受信

rcv_mbx()を使用します。

        T_MSG *msg;
        rcv_mbx(MAILBOX_ID(RECV), &msg);
        MESSAGE_ENTITY* ent = (MESSAGE_ENTITY*)(msg);
        DEBUG_PRINT("[%s]: RECV MESSAGE (%d,%d)", __func__, ent->id, ent->params[0]);

3-3. TBD

TBD（今後追加していく予定）

おわりに

メールボックスは、メッセージ領域の確保が若干面倒なので、
イベントフラグ＋外部変数
という使い方をする方も多いように思います（やってることは変わりませんからね）。
が、一応解説してみました。笑

参考

Micro-ITRON4.0 Specification (in Japanese)
http://www.ertl.jp/ITRON/SPEC/mitron4-j.html

Windowsシミュレータで学ぶuITRON (3) - メールボックス