source: asp3_wo_tecs/trunk/extension/messagebuf/kernel/messagebuf.h@ 306

Last change on this file since 306 was 306, checked in by ertl-honda, 7 years ago

3.1.0を反映
File size: 6.8 KB
Line 
1/*
2 * TOPPERS/ASP Kernel
3 * Toyohashi Open Platform for Embedded Real-Time Systems/
4 * Advanced Standard Profile Kernel
5 *
6 * Copyright (C) 2000-2003 by Embedded and Real-Time Systems Laboratory
7 * Toyohashi Univ. of Technology, JAPAN
8 * Copyright (C) 2005-2014 by Embedded and Real-Time Systems Laboratory
9 * Graduate School of Information Science, Nagoya Univ., JAPAN
10 *
11 * 上記著作権者
12は，以下の(1)〜(4)の条件を満たす場合に限り，本ソフトウェ
13 * ア（本ソフトウェアを改変したものを含む．以下同じ）を使用・複製・改
14 * 変・再é…
15å¸ƒï¼ˆä»¥ä¸‹ï¼Œåˆ©ç”¨ã¨å‘¼ã¶ï¼‰ã™ã‚‹ã“とを無償で許諾する．
16 * (1) 本ソフトウェアをソースコードの形で利用する場合には，上記の著作
17 * 権表示，この利用条件および下記の無保証規定が，そのままの形でソー
18 * スコード中に含まれていること．
19 * (2) 本ソフトウェアを，ライブラリ形式など，他のソフトウェア開発に使
20 * 用できる形で再é…
21å¸ƒã™ã‚‹å ´åˆã«ã¯ï¼Œå†é…
22å¸ƒã«ä¼´ã†ãƒ‰ã‚­ãƒ¥ãƒ¡ãƒ³ãƒˆï¼ˆåˆ©ç”¨
23 * 者
24マニュアルなど）に，上記の著作権表示，この利用条件および下記
25 * の無保証規定を掲載すること．
26 * (3) 本ソフトウェアを，機器に組み込むなど，他のソフトウェア開発に使
27 * 用できない形で再é…
28å¸ƒã™ã‚‹å ´åˆã«ã¯ï¼Œæ¬¡ã®ã„ずれかの条件を満たすこ
29 * と．
30 * (a) 再é…
31å¸ƒã«ä¼´ã†ãƒ‰ã‚­ãƒ¥ãƒ¡ãƒ³ãƒˆï¼ˆåˆ©ç”¨è€…
32マニュアルなど）に，上記の著
33 * 作権表示，この利用条件および下記の無保証規定を掲載すること．
34 * (b) 再é…
35å¸ƒã®å½¢æ…
36‹ã‚’，別に定める方法によって，TOPPERSプロジェクトに
37 * 報告すること．
38 * (4) 本ソフトウェアの利用により直接的または間接的に生じるいかなる損
39 * 害からも，上記著作権者
40およびTOPPERSプロジェクトをå…
41è²¬ã™ã‚‹ã“と．
42 * また，本ソフトウェアのユーザまたはエンドユーザからのいかなる理
43 * 由に基づく請求からも，上記著作権者
44およびTOPPERSプロジェクトを
45 * å…
46è²¬ã™ã‚‹ã“と．
47 *
48 * 本ソフトウェアは，無保証で提供されているものである．上記著作権者
49お
50 * よびTOPPERSプロジェクトは，本ソフトウェアに関して，特定の使用目的
51 * に対する適合性も含めて，いかなる保証も行わない．また，本ソフトウェ
52 * アの利用により直接的または間接的に生じたいかなる損害に関しても，そ
53 * の責任を負わない．
54 *
55 * $Id: messagebuf.h 244 2014-09-30 18:08:03Z ertl-hiro $
56 */
57
58/*
59 * メッセージバッファ機能
60 */
61
62#ifndef TOPPERS_MESSAGEBUF_H
63#define TOPPERS_MESSAGEBUF_H
64
65#include "kernel_impl.h"
66#include <queue.h>
67#include "wait.h"
68
69/*
70 * メッセージバッファ初期化ブロック
71 *
72 * この構造体は，同期・通信オブジェクトの初期化ブロックのå…
73±é€šéƒ¨åˆ†
74 * （WOBJINIB）を拡張（オブジェクト指向言語の継承に相当）したもので，
75 * 最初のフィールドがå…
76±é€šã«ãªã£ã¦ã„る．
77 */
78typedef struct messagebuf_initialization_block {
79 ATR mbfatr; /* メッセージバッファ属性 */
80 uint_t maxmsz; /* メッセージの最大長 */
81 size_t mbfsz; /* メッセージバッファ管理領域のサイズ */
82 void *mbfmb; /* メッセージバッファ管理領域のå…
83ˆé ­ç•ªåœ° */
84} MBFINIB;
85
86/*
87 * メッセージバッファ管理ブロック
88 *
89 * この構造体は，同期・通信オブジェクトの管理ブロックのå…
90±é€šéƒ¨åˆ†ï¼ˆWOBJCB）
91 * を拡張（オブジェクト指向言語の継承に相当）したもので，最初の2つの
92 * フィールドがå…
93±é€šã«ãªã£ã¦ã„る．
94 */
95typedef struct messagebuf_control_block {
96 QUEUE swait_queue; /* メッセージバッファ送信待
97ちキュー */
98 const MBFINIB *p_mbfinib; /* 初期化ブロックへのポインタ */
99 QUEUE rwait_queue; /* メッセージバッファ受信待
100ちキュー */
101 size_t fmbfsz; /* 空き領域のサイズ */
102 size_t head; /* 最初のメッセージの格納場所 */
103 size_t tail; /* 最後のメッセージの格納場所の次 */
104 uint_t smbfcnt; /* 管理領域に格納されているメッセージの数 */
105} MBFCB;
106
107/*
108 * メッセージバッファ待
109ち情
110報ブロックの定義
111 *
112 * この構造体は，同期・通信オブジェクトの待
113ち情
114報ブロックのå…
115±é€šéƒ¨åˆ†
116 * （WINFO_WOBJ）を拡張（オブジェクト指向言語の継承に相当）したもので，
117 * 最初の2つのフィールドがå…
118±é€šã«ãªã£ã¦ã„る．
119 */
120typedef struct messagebuf_send_waiting_information {
121 WINFO winfo; /* 標準の待
122ち情
123報ブロック */
124 MBFCB *p_mbfcb; /* 待
125っているメッセージバッファの管理ブロック */
126 const void *msg; /* 送信メッセージ */
127 uint_t msgsz; /* 送信メッセージサイズ */
128} WINFO_SMBF;
129
130typedef struct messagebuf_receive_waiting_information {
131 WINFO winfo; /* 標準の待
132ち情
133報ブロック */
134 MBFCB *p_mbfcb; /* 待
135っているメッセージバッファの管理ブロック */
136 void *msg; /* 受信メッセージの格納場所 */
137} WINFO_RMBF;
138
139/*
140 * メッセージバッファIDの最大値（kernel_cfg.c）
141 */
142extern const ID tmax_mbfid;
143
144/*
145 * メッセージバッファ初期化ブロックのエリア（kernel_cfg.c）
146 */
147extern const MBFINIB mbfinib_table[];
148
149/*
150 * メッセージバッファ管理ブロックのエリア（kernel_cfg.c）
151 */
152extern MBFCB mbfcb_table[];
153
154/*
155 * メッセージバッファ管理ブロックからメッセージバッファIDを取り出すた
156 * めのマクロ
157 */
158#define MBFID(p_mbfcb) ((ID)(((p_mbfcb) - mbfcb_table) + TMIN_MBFID))
159
160/*
161 * メッセージバッファ機能の初期化
162 */
163extern void initialize_messagebuf(void);
164
165/*
166 * メッセージバッファ管理領域へのメッセージの格納
167 */
168extern bool_t enqueue_message(MBFCB *p_mbfcb, const void *msg, uint_t msgsz);
169
170/*
171 * メッセージバッファ管理領域からのメッセージの取出し
172 */
173extern uint_t dequeue_message(MBFCB *p_mbfcb, void *msg);
174
175/*
176 * メッセージバッファへのメッセージ送信
177 */
178extern bool_t send_message(MBFCB *p_mbfcb, const void *msg, uint_t msgsz);
179
180/*
181 * メッセージバッファ送信待
182ちタスクのチェック
183 */
184extern void messagebuf_signal(MBFCB *p_mbfcb);
185
186/*
187 * メッセージバッファからのメッセージ受信
188 */
189extern uint_t receive_message(MBFCB *p_mbfcb, void *msg);
190
191/*
192 * メッセージバッファ送信待
193ちタスクの待
194ち解除時処理
195 */
196extern void messagebuf_dequeue_wobj(TCB *p_tcb);
197
198#endif /* TOPPERS_MESSAGEBUF_H */
Note: See TracBrowser for help on using the repository browser.