source: extension/messagebuf/kernel/messagebuf.h

このファイルの最終更新内容7 で kominami が 2015/09/12 9:22:12 に更新しました

TOPPERS/ASP 1.9.1

ファイルサイズ: 5.4 KB
 
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 *  Ÿåµ­Ãøºîž¢ŒÔ€Ï¡€°Ê²Œ€Î(1)¡Á(4)€ÎŸò·ï€òËþ€¿€¹Ÿì¹ç€ËžÂ€ê¡€ËÜ¥œ¥Õ¥È¥Š¥§
12 *  ¥¢¡ÊËÜ¥œ¥Õ¥È¥Š¥§¥¢€ò²þÊÑ€·€¿€â€Î€òŽÞ€à¡¥°Ê²ŒÆ±€ž¡Ë€ò»ÈÍÑ¡ŠÊ£Àœ¡Š²þ
13 *  ÊÑ¡ŠºÆÇÛÉۡʰʲŒ¡€ÍøÍрȞƀ֡ˀ¹€ë€³€È€ò̵œþ€ÇµöÂú€¹€ë¡¥
14 *  (1) ËÜ¥œ¥Õ¥È¥Š¥§¥¢€ò¥œ¡Œ¥¹¥³¡Œ¥É€Î·Á€ÇÍøÍÑ€¹€ëŸì¹ç€Ë€Ï¡€Ÿåµ­€ÎÃøºî
15 *      ž¢ÉœŒš¡€€³€ÎÍøÍÑŸò·ï€ª€è€Ó²Œµ­€Î̵ÊÝŸÚµ¬Äꀬ¡€€œ€Î€Þ€Þ€Î·Á€Ç¥œ¡Œ
16 *      ¥¹¥³¡Œ¥ÉÃæ€ËŽÞ€Þ€ì€Æ€€€ë€³€È¡¥
17 *  (2) ËÜ¥œ¥Õ¥È¥Š¥§¥¢€ò¡€¥é¥€¥Ö¥é¥ê·ÁŒ°€Ê€É¡€ÂŸ€Î¥œ¥Õ¥È¥Š¥§¥¢³«È¯€Ë»È
18 *      Íрǀ­€ë·Á€ÇºÆÇÛÉÛ€¹€ëŸì¹ç€Ë€Ï¡€ºÆÇÛÉÛ€ËÈŒ€Š¥É¥­¥å¥á¥ó¥È¡ÊÍøÍÑ
19 *      ŒÔ¥Þ¥Ë¥å¥¢¥ë€Ê€É¡Ë€Ë¡€Ÿåµ­€ÎÃøºîž¢ÉœŒš¡€€³€ÎÍøÍÑŸò·ï€ª€è€Ó²Œµ­
20 *      €Î̵ÊÝŸÚµ¬Äê€ò·ÇºÜ€¹€ë€³€È¡¥
21 *  (3) ËÜ¥œ¥Õ¥È¥Š¥§¥¢€ò¡€µ¡Žï€ËÁȀ߹þ€à€Ê€É¡€ÂŸ€Î¥œ¥Õ¥È¥Š¥§¥¢³«È¯€Ë»È
22 *      Íрǀ­€Ê€€·Á€ÇºÆÇÛÉÛ€¹€ëŸì¹ç€Ë€Ï¡€Œ¡€Î€€€º€ì€«€ÎŸò·ï€òËþ€¿€¹€³
23 *      €È¡¥
24 *    (a) ºÆÇÛÉÛ€ËÈŒ€Š¥É¥­¥å¥á¥ó¥È¡ÊÍøÍьԥޥ˥奢¥ë€Ê€É¡Ë€Ë¡€Ÿåµ­€ÎÃø
25 *        ºîž¢ÉœŒš¡€€³€ÎÍøÍÑŸò·ï€ª€è€Ó²Œµ­€Î̵ÊÝŸÚµ¬Äê€ò·ÇºÜ€¹€ë€³€È¡¥
26 *    (b) ºÆÇÛÉۀηÁÂÖ€ò¡€ÊÌ€ËÄê€á€ëÊýË¡€Ë€è€Ã€Æ¡€TOPPERS¥×¥í¥ž¥§¥¯¥È€Ë
27 *        Êó¹ð€¹€ë€³€È¡¥
28 *  (4) ËÜ¥œ¥Õ¥È¥Š¥§¥¢€ÎÍøÍрˀè€êÄŸÀÜŪ€Þ€¿€ÏŽÖÀÜŪ€ËÀž€ž€ë€€€«€Ê€ë»
29 *      ³²€«€é€â¡€Ÿåµ­Ãøºîž¢ŒÔ€ª€è€ÓTOPPERS¥×¥í¥ž¥§¥¯¥È€òÌÈÀÕ€¹€ë€³€È¡¥
30 *      €Þ€¿¡€ËÜ¥œ¥Õ¥È¥Š¥§¥¢€Î¥æ¡Œ¥¶€Þ€¿€Ï¥š¥ó¥É¥æ¡Œ¥¶€«€é€Î€€€«€Ê€ëÍý
31 *      ͳ€ËŽð€Å€¯ÀÁµá€«€é€â¡€Ÿåµ­Ãøºîž¢ŒÔ€ª€è€ÓTOPPERS¥×¥í¥ž¥§¥¯¥È€ò
32 *      ÌÈÀÕ€¹€ë€³€È¡¥
33 *
34 *  ËÜ¥œ¥Õ¥È¥Š¥§¥¢€Ï¡€ÌµÊÝŸÚ€ÇÄó¶¡€µ€ì€Æ€€€ë€â€Î€Ç€¢€ë¡¥Ÿåµ­Ãøºîž¢ŒÔ€ª
35 *  €è€ÓTOPPERS¥×¥í¥ž¥§¥¯¥È€Ï¡€ËÜ¥œ¥Õ¥È¥Š¥§¥¢€ËŽØ€·€Æ¡€ÆÃÄê€Î»ÈÍÑÌÜŪ
36 *  €ËÂЀ¹€ëŬ¹çÀ­€âŽÞ€á€Æ¡€€€€«€Ê€ëÊÝŸÚ€â¹Ô€ï€Ê€€¡¥€Þ€¿¡€ËÜ¥œ¥Õ¥È¥Š¥§
37 *  ¥¢€ÎÍøÍрˀè€êÄŸÀÜŪ€Þ€¿€ÏŽÖÀÜŪ€ËÀž€ž€¿€€€«€Ê€ë»³²€ËŽØ€·€Æ€â¡€€œ
38 *  €ÎÀÕÇ€€òÉé€ï€Ê€€¡¥
39 *
40 *  $Id$
41 */
42
43/*
44 *              ¥á¥Ã¥»¡Œ¥ž¥Ð¥Ã¥Õ¥¡µ¡Çœ
45 */
46
47#ifndef TOPPERS_MESSAGEBUF_H
48#define TOPPERS_MESSAGEBUF_H
49
50#include "wait.h"
51
52/*
53 *  ¥á¥Ã¥»¡Œ¥ž¥Ð¥Ã¥Õ¥¡œéŽü²œ¥Ö¥í¥Ã¥¯
54 *
55 *  €³€Î¹œÂ€Â΀ϡ€Æ±Žü¡ŠÄÌ¿®¥ª¥Ö¥ž¥§¥¯¥È€ÎœéŽü²œ¥Ö¥í¥Ã¥¯€Î¶ŠÄÌÉôʬ
56 *  ¡ÊWOBJINIB¡Ë€ò³ÈÄ¥¡Ê¥ª¥Ö¥ž¥§¥¯¥È»ØžþžÀžì€Î·ÑŸµ€ËÁêÅö¡Ë€·€¿€â€Î€Ç¡€
57 *  ºÇœé€Î¥Õ¥£¡Œ¥ë¥É€¬¶ŠÄ̀ˀʀÀƀ€€ë¡¥
58 */
59typedef struct messagebuf_initialization_block {
60        ATR                     mbfatr;                 /* ¥á¥Ã¥»¡Œ¥ž¥Ð¥Ã¥Õ¥¡Â°À­ */
61        uint_t          maxmsz;                 /* ¥á¥Ã¥»¡Œ¥ž€ÎºÇÂçĹ */
62        SIZE            mbfsz;                  /* ¥á¥Ã¥»¡Œ¥ž¥Ð¥Ã¥Õ¥¡ŽÉÍýÎΰè€Î¥µ¥€¥º */
63        void            *mbfmb;                 /* ¥á¥Ã¥»¡Œ¥ž¥Ð¥Ã¥Õ¥¡ŽÉÍýÎΰè€ÎÀèÆ¬ÈÖÃÏ */
64} MBFINIB;
65
66/*
67 *  ¥á¥Ã¥»¡Œ¥ž¥Ð¥Ã¥Õ¥¡ŽÉÍý¥Ö¥í¥Ã¥¯
68 *
69 *  €³€Î¹œÂ€Â΀ϡ€Æ±Žü¡ŠÄÌ¿®¥ª¥Ö¥ž¥§¥¯¥È€ÎŽÉÍý¥Ö¥í¥Ã¥¯€Î¶ŠÄÌÉôʬ¡ÊWOBJCB¡Ë
70 *  €ò³ÈÄ¥¡Ê¥ª¥Ö¥ž¥§¥¯¥È»ØžþžÀžì€Î·ÑŸµ€ËÁêÅö¡Ë€·€¿€â€Î€Ç¡€ºÇœé€Î2€Ä€Î
71 *  ¥Õ¥£¡Œ¥ë¥É€¬¶ŠÄ̀ˀʀÀƀ€€ë¡¥
72 */
73typedef struct messagebuf_control_block {
74        QUEUE           swait_queue;    /* ¥á¥Ã¥»¡Œ¥ž¥Ð¥Ã¥Õ¥¡Á÷¿®ÂÔ€Á¥­¥å¡Œ */
75        const MBFINIB *p_mbfinib;       /* œéŽü²œ¥Ö¥í¥Ã¥¯€Ø€Î¥Ý¥€¥ó¥¿ */
76        QUEUE           rwait_queue;    /* ¥á¥Ã¥»¡Œ¥ž¥Ð¥Ã¥Õ¥¡Œõ¿®ÂÔ€Á¥­¥å¡Œ */
77        SIZE            fmbfsz;                 /* ¶õ€­Îΰè€Î¥µ¥€¥º */
78        SIZE            head;                   /* ºÇœé€Î¥á¥Ã¥»¡Œ¥ž€Î³ÊÇŒŸìœê */
79        SIZE            tail;                   /* ºÇžå€Î¥á¥Ã¥»¡Œ¥ž€Î³ÊÇŒŸìœê€ÎŒ¡ */
80        uint_t          smbfcnt;                /* ŽÉÍýÎΰè€Ë³ÊÇŒ€µ€ì€Æ€€€ë¥á¥Ã¥»¡Œ¥ž€Î¿ô */
81} MBFCB;
82
83/*
84 *  ¥á¥Ã¥»¡Œ¥ž¥Ð¥Ã¥Õ¥¡ÂÔ€ÁŸðÊó¥Ö¥í¥Ã¥¯€ÎÄêµÁ
85 *
86 *  €³€Î¹œÂ€Â΀ϡ€Æ±Žü¡ŠÄÌ¿®¥ª¥Ö¥ž¥§¥¯¥È€ÎÂÔ€ÁŸðÊó¥Ö¥í¥Ã¥¯€Î¶ŠÄÌÉôʬ
87 *  ¡ÊWINFO_WOBJ¡Ë€ò³ÈÄ¥¡Ê¥ª¥Ö¥ž¥§¥¯¥È»ØžþžÀžì€Î·ÑŸµ€ËÁêÅö¡Ë€·€¿€â€Î€Ç¡€
88 *  ºÇœé€Î2€Ä€Î¥Õ¥£¡Œ¥ë¥É€¬¶ŠÄ̀ˀʀÀƀ€€ë¡¥
89 *  ¥á¥Ã¥»¡Œ¥ž¥Ð¥Ã¥Õ¥¡€Ø€ÎÁ÷¿®ÂÔ€Á€È¥á¥Ã¥»¡Œ¥ž¥Ð¥Ã¥Õ¥¡€«€é€ÎŒõ¿®ÂÔ€Á€Ç¡€
90 *  Ʊ€žÂÔ€ÁŸðÊó¥Ö¥í¥Ã¥¯€ò»È€Š¡¥
91 */
92typedef struct messagebuf_waiting_information {
93        WINFO           winfo;                  /* Éžœà€ÎÂÔ€ÁŸðÊó¥Ö¥í¥Ã¥¯ */
94        MBFCB           *p_mbfcb;               /* ÂԀÀƀ€€ë¥á¥Ã¥»¡Œ¥ž¥Ð¥Ã¥Õ¥¡€ÎŽÉÍý¥Ö¥í¥Ã¥¯ */
95        void            *msg;                   /* Á÷Œõ¿®¥á¥Ã¥»¡Œ¥ž */
96        uint_t          msgsz;                  /* Á÷Œõ¿®¥á¥Ã¥»¡Œ¥ž¥µ¥€¥º */
97} WINFO_MBF;
98
99/*
100 *  ¥á¥Ã¥»¡Œ¥ž¥Ð¥Ã¥Õ¥¡ID€ÎºÇÂçÃÍ¡Êkernel_cfg.c¡Ë
101 */
102extern const ID tmax_mbfid;
103
104/*
105 *  ¥á¥Ã¥»¡Œ¥ž¥Ð¥Ã¥Õ¥¡œéŽü²œ¥Ö¥í¥Ã¥¯€Î¥š¥ê¥¢¡Êkernel_cfg.c¡Ë
106 */
107extern const MBFINIB    mbfinib_table[];
108
109/*
110 *  ¥á¥Ã¥»¡Œ¥ž¥Ð¥Ã¥Õ¥¡ŽÉÍý¥Ö¥í¥Ã¥¯€Î¥š¥ê¥¢¡Êkernel_cfg.c¡Ë
111 */
112extern MBFCB    mbfcb_table[];
113
114/*
115 *  ¥á¥Ã¥»¡Œ¥ž¥Ð¥Ã¥Õ¥¡ŽÉÍý¥Ö¥í¥Ã¥¯€«€é¥á¥Ã¥»¡Œ¥ž¥Ð¥Ã¥Õ¥¡ID€òŒè€êœÐ€¹€¿
116 *  €á€Î¥Þ¥¯¥í
117 */
118#define MBFID(p_mbfcb)  ((ID)(((p_mbfcb) - mbfcb_table) + TMIN_MBFID))
119
120/*
121 *  ¥á¥Ã¥»¡Œ¥ž¥Ð¥Ã¥Õ¥¡µ¡Çœ€ÎœéŽü²œ
122 */
123extern void     initialize_messagebuf(void);
124
125/*
126 *  ¥á¥Ã¥»¡Œ¥ž¥Ð¥Ã¥Õ¥¡ŽÉÍýÎ롏ۯ€Î¥á¥Ã¥»¡Œ¥ž€Î³ÊÇŒ
127 */
128extern bool_t   enqueue_message(MBFCB *p_mbfcb, const void *msg, uint_t msgsz);
129
130/*
131 *  ¥á¥Ã¥»¡Œ¥ž¥Ð¥Ã¥Õ¥¡ŽÉÍýÎΰ耫€é€Î¥á¥Ã¥»¡Œ¥ž€ÎŒèœÐ€·
132 */
133extern uint_t   dequeue_message(MBFCB *p_mbfcb, void *msg);
134
135/*
136 *  ¥á¥Ã¥»¡Œ¥ž¥Ð¥Ã¥Õ¥¡€Ø€Î¥á¥Ã¥»¡Œ¥žÁ÷¿®
137 */
138extern bool_t   send_message(MBFCB *p_mbfcb, const void *msg,
139                                                                                        uint_t msgsz, bool_t *p_dspreq);
140
141/*
142 *  ¥á¥Ã¥»¡Œ¥ž¥Ð¥Ã¥Õ¥¡Á÷¿®ÂÔ€Á¥¿¥¹¥¯€Î¥Á¥§¥Ã¥¯
143 */
144extern bool_t   messagebuf_signal(MBFCB *p_mbfcb);
145
146/*
147 *  ¥á¥Ã¥»¡Œ¥ž¥Ð¥Ã¥Õ¥¡€«€é€Î¥á¥Ã¥»¡Œ¥žŒõ¿®
148 */
149extern uint_t   receive_message(MBFCB *p_mbfcb, void *msg, bool_t *p_dspreq);
150
151/*
152 *  ¥á¥Ã¥»¡Œ¥ž¥Ð¥Ã¥Õ¥¡Á÷¿®ÂÔ€Á¥¿¥¹¥¯€ÎÂÔ€Á²òœü»þœèÍý
153 */
154extern bool_t   (*mbfhook_dequeue_wobj)(TCB *p_tcb);
155extern bool_t   messagebuf_dequeue_wobj(TCB *p_tcb);
156
157/*
158 *  ¥á¥Ã¥»¡Œ¥ž¥Ð¥Ã¥Õ¥¡Á÷¿®ÂÔ€Á¥¿¥¹¥¯€ÎÍ¥ÀèÅÙÊѹ¹»þœèÍý
159 */
160extern bool_t   (*mbfhook_change_priority)(WOBJCB *p_wobjcb);
161extern bool_t   messagebuf_change_priority(WOBJCB *p_wobjcb);
162
163#endif /* TOPPERS_MESSAGEBUF_H */
詳しい使い方は TracBrowser を参照してください。