Changeset 389 for azure_iot_hub/trunk/asp3_dcre/kernel/dataqueue.h

Timestamp:

May 22, 2019, 10:03:37 PM (5 years ago)

Author:

coas-nagasima

Message:

ビルドが通るよう更新

File:

• azure_iot_hub/trunk/asp3_dcre/kernel/dataqueue.h (modified) (5 diffs, 2 props)

azure_iot_hub/trunk/asp3_dcre/kernel/dataqueue.h

@@ -9 +9 @@
  *              Graduate School of Information Science, Nagoya Univ., JAPAN
  * 
- *  上記著作権è€
-は，以下の(1)～(4)ã®æ¡ä»¶ã‚’æº€ãŸã™å ´åˆã«é™ã‚Šï¼Œæœ¬ã‚½ãƒ•ãƒˆã‚¦ã‚§
- *  ア（本ソフトウェアを改変したものを含む．以下同じ）を使用・複製・改
- *  変・再é
-å¸ƒï¼ˆä»¥ä¸‹ï¼Œåˆ©ç”¨ã¨å‘¼ã¶ï¼‰ã™ã‚‹ã“とを無償で許諾する．
- *  (1) æœ¬ã‚½ãƒ•ãƒˆã‚¦ã‚§ã‚¢ã‚’ã‚½ãƒ¼ã‚¹ã‚³ãƒ¼ãƒ‰ã®å½¢ã§åˆ©ç”¨ã™ã‚‹å ´åˆã«ã¯ï¼Œä¸Šè¨˜ã®è‘—ä½œ
- *      権表示，この利用条件および下記の無保証規定が，そのままの形でソー
- *      スコード中に含まれていること．
- *  (2) 本ソフトウェアを，ライブラリ形式など，他のソフトウェア開発に使
- *      用できる形で再é
-å¸ƒã™ã‚‹å ´åˆã«ã¯ï¼Œå†é
-å¸ƒã«ä¼´ã†ãƒ‰ã‚­ãƒ¥ãƒ¡ãƒ³ãƒˆï¼ˆåˆ©ç”¨
- *      è€
-マニュアルなど）に，上記の著作権表示，この利用条件および下記
- *      の無保証規定を掲載すること．
- *  (3) 本ソフトウェアを，機器に組み込むなど，他のソフトウェア開発に使
- *      用できない形で再é
-å¸ƒã™ã‚‹å ´åˆã«ã¯ï¼Œæ¬¡ã®ã„ずれかの条件を満たすこ
- *      と．
- *    (a) 再é
-å¸ƒã«ä¼´ã†ãƒ‰ã‚­ãƒ¥ãƒ¡ãƒ³ãƒˆï¼ˆåˆ©ç”¨è€
-マニュアルなど）に，上記の著
- *        作権表示，この利用条件および下記の無保証規定を掲載すること．
- *    (b) 再é
-å¸ƒã®å½¢æ
-‹ã‚’，別に定める方法によって，TOPPERSプロジェクトに
- *        å ±å‘Šã™ã‚‹ã“ã¨ï¼Ž
- *  (4) 本ソフトウェアの利用により直接的または間接的に生じるいかなる損
- *      害からも，上記著作権è€
-およびTOPPERSプロジェクトをå
-è²¬ã™ã‚‹ã“と．
- *      また，本ソフトウェアのユーザまたはエンドユーザからのいかなる理
- *      由に基づく請求からも，上記著作権è€
-およびTOPPERSプロジェクトを
- *      å
-è²¬ã™ã‚‹ã“と．
+ *  上記著作権者は，以下の(1)～(4)の条件を満たす場合に限り，本ソフトウェ
+ *  ア（本ソフトウェアを改変したものを含む．以下同じ）を使用・複製・改
+ *  変・再配布（以下，利用と呼ぶ）することを無償で許諾する．
+ *  (1) 本ソフトウェアをソースコードの形で利用する場合には，上記の著作
+ *      権表示，この利用条件および下記の無保証規定が，そのままの形でソー
+ *      スコード中に含まれていること．
+ *  (2) 本ソフトウェアを，ライブラリ形式など，他のソフトウェア開発に使
+ *      用できる形で再配布する場合には，再配布に伴うドキュメント（利用
+ *      者マニュアルなど）に，上記の著作権表示，この利用条件および下記
+ *      の無保証規定を掲載すること．
+ *  (3) 本ソフトウェアを，機器に組み込むなど，他のソフトウェア開発に使
+ *      用できない形で再配布する場合には，次のいずれかの条件を満たすこ
+ *      と．
+ *    (a) 再配布に伴うドキュメント（利用者マニュアルなど）に，上記の著
+ *        作権表示，この利用条件および下記の無保証規定を掲載すること．
+ *    (b) 再配布の形態を，別に定める方法によって，TOPPERSプロジェクトに
+ *        報告すること．
+ *  (4) 本ソフトウェアの利用により直接的または間接的に生じるいかなる損
+ *      害からも，上記著作権者およびTOPPERSプロジェクトを免責すること．
+ *      また，本ソフトウェアのユーザまたはエンドユーザからのいかなる理
+ *      由に基づく請求からも，上記著作権者およびTOPPERSプロジェクトを
+ *      免責すること．
  * 
- *  本ソフトウェアは，無保証で提供されているものである．上記著作権è€
-お
- *  よびTOPPERSプロジェクトは，本ソフトウェアに関して，特定の使用目的
- *  に対する適合性も含めて，いかなる保証も行わない．また，本ソフトウェ
- *  アの利用により直接的または間接的に生じたいかなる損害に関しても，そ
- *  ã®è²¬ä»»ã‚’è² ã‚ãªã„ï¼Ž
+ *  本ソフトウェアは，無保証で提供されているものである．上記著作権者お
+ *  よびTOPPERSプロジェクトは，本ソフトウェアに関して，特定の使用目的
+ *  に対する適合性も含めて，いかなる保証も行わない．また，本ソフトウェ
+ *  アの利用により直接的または間接的に生じたいかなる損害に関しても，そ
+ *  の責任を負わない．
  * 
  *  $Id$
@@ -57 +42 @@
 
 /*
- *              データキュー機能
+ *              データキュー機能
  */
 
@@ -68 +53 @@
 
 /*
- *  データ管理ブロック
+ *  データ管理ブロック
  */
 typedef struct data_management_block {
-        intptr_t        data;                   /* データ本体 */
+        intptr_t        data;                   /* データ本体 */
 } DTQMB;
 
 /*
- *  データキュー初期化ブロック
+ *  データキュー初期化ブロック
  *
- *  ã“ã®æ§‹é€ ä½“ã¯ï¼ŒåŒæœŸãƒ»é€šä¿¡ã‚ªãƒ–ã‚¸ã‚§ã‚¯ãƒˆã®åˆæœŸåŒ–ãƒ–ãƒ­ãƒƒã‚¯ã®å
-±é€šéƒ¨åˆ†
- *  （WOBJINIB）を拡張（オブジェクト指向言語の継承に相当）したもので，
- *  最初のフィールドがå
-±é€šã«ãªã£ã¦ã„る．
+ *  この構造体は，同期・通信オブジェクトの初期化ブロックの共通部分
+ *  （WOBJINIB）を拡張（オブジェクト指向言語の継承に相当）したもので，
+ *  最初のフィールドが共通になっている．
  */
 typedef struct dataqueue_initialization_block {
-        ATR                     dtqatr;                 /* データキュー属性 */
-        uint_t          dtqcnt;                 /* データキューの容量 */
-        DTQMB           *p_dtqmb;               /* ãƒ‡ãƒ¼ã‚¿ã‚­ãƒ¥ãƒ¼ç®¡ç†é ˜åŸŸã®å
-ˆé ­ç•ªåœ° */
+        ATR                     dtqatr;                 /* データキュー属性 */
+        uint_t          dtqcnt;                 /* データキューの容量 */
+        DTQMB           *p_dtqmb;               /* データキュー管理領域の先頭番地 */
 } DTQINIB;
 
 /*
- *  データキュー管理ブロック
+ *  データキュー管理ブロック
  *
- *  ã“ã®æ§‹é€ ä½“ã¯ï¼ŒåŒæœŸãƒ»é€šä¿¡ã‚ªãƒ–ã‚¸ã‚§ã‚¯ãƒˆã®ç®¡ç†ãƒ–ãƒ­ãƒƒã‚¯ã®å
-±é€šéƒ¨åˆ†ï¼ˆWOBJCB）
- *  を拡張（オブジェクト指向言語の継承に相当）したもので，最初の2つの
- *  フィールドがå
-±é€šã«ãªã£ã¦ã„る．
+ *  この構造体は，同期・通信オブジェクトの管理ブロックの共通部分（WOBJCB）
+ *  を拡張（オブジェクト指向言語の継承に相当）したもので，最初の2つの
+ *  フィールドが共通になっている．
  */
 typedef struct dataqueue_control_block {
-        QUEUE           swait_queue;    /* データキュー送信å¾
-ちキュー */
-        const DTQINIB *p_dtqinib;       /* 初期化ブロックへのポインタ */
-        QUEUE           rwait_queue;    /* データキュー受信å¾
-ちキュー */
-        uint_t          count;                  /* データキュー中のデータの数 */
-        uint_t          head;                   /* æœ€åˆã®ãƒ‡ãƒ¼ã‚¿ã®æ ¼ç´å ´æ‰€ */
-        uint_t          tail;                   /* æœ€å¾Œã®ãƒ‡ãƒ¼ã‚¿ã®æ ¼ç´å ´æ‰€ã®æ¬¡ */
+        QUEUE           swait_queue;    /* データキュー送信待ちキュー */
+        const DTQINIB *p_dtqinib;       /* 初期化ブロックへのポインタ */
+        QUEUE           rwait_queue;    /* データキュー受信待ちキュー */
+        uint_t          count;                  /* データキュー中のデータの数 */
+        uint_t          head;                   /* 最初のデータの格納場所 */
+        uint_t          tail;                   /* 最後のデータの格納場所の次 */
 } DTQCB;
 
 /*
- *  データキューå¾
-ちæƒ
-å ±ãƒ–ãƒ­ãƒƒã‚¯ã®å®šç¾©
+ *  データキュー待ち情報ブロックの定義
  *
- *  ã“ã®æ§‹é€ ä½“ã¯ï¼ŒåŒæœŸãƒ»é€šä¿¡ã‚ªãƒ–ã‚¸ã‚§ã‚¯ãƒˆã®å¾
-ちæƒ
-å ±ãƒ–ãƒ­ãƒƒã‚¯ã®å
-±é€šéƒ¨åˆ†
- *  （WINFO_WOBJ）を拡張（オブジェクト指向言語の継承に相当）したもので，
- *  最初の2つのフィールドがå
-±é€šã«ãªã£ã¦ã„る．
+ *  この構造体は，同期・通信オブジェクトの待ち情報ブロックの共通部分
+ *  （WINFO_WOBJ）を拡張（オブジェクト指向言語の継承に相当）したもので，
+ *  最初の2つのフィールドが共通になっている．
  */
 typedef struct dataqueue_send_waiting_information {
-        WINFO           winfo;                  /* 標準のå¾
-ちæƒ
-å ±ãƒ–ãƒ­ãƒƒã‚¯ */
-        DTQCB           *p_dtqcb;               /* å¾
-っているデータキューの管理ブロック */
-        intptr_t        data;                   /* 送信データ */
+        WINFO           winfo;                  /* 標準の待ち情報ブロック */
+        DTQCB           *p_dtqcb;               /* 待っているデータキューの管理ブロック */
+        intptr_t        data;                   /* 送信データ */
 } WINFO_SDTQ;
 
 typedef struct dataqueue_receive_waiting_information {
-        WINFO           winfo;                  /* 標準のå¾
-ちæƒ
-å ±ãƒ–ãƒ­ãƒƒã‚¯ */
-        DTQCB           *p_dtqcb;               /* å¾
-っているデータキューの管理ブロック */
-        intptr_t        data;                   /* 受信データ */
+        WINFO           winfo;                  /* 標準の待ち情報ブロック */
+        DTQCB           *p_dtqcb;               /* 待っているデータキューの管理ブロック */
+        intptr_t        data;                   /* 受信データ */
 } WINFO_RDTQ;
 
 /*
- *  使用していないデータキュー管理ブロックのリスト
+ *  使用していないデータキュー管理ブロックのリスト
  */
 extern QUEUE    free_dtqcb;
 
 /*
- *  データキューIDの最大値（kernel_cfg.c）
+ *  データキューIDの最大値（kernel_cfg.c）
  */
 extern const ID tmax_dtqid;
@@ -153 +119 @@
 
 /*
- *  データキュー初期化ブロックのエリア（kernel_cfg.c）
+ *  データキュー初期化ブロックのエリア（kernel_cfg.c）
  */
 extern const DTQINIB    dtqinib_table[];
@@ -159 +125 @@
 
 /*
- *  データキュー管理ブロックのエリア（kernel_cfg.c）
+ *  データキュー管理ブロックのエリア（kernel_cfg.c）
  */
 extern DTQCB    dtqcb_table[];
 
 /*
- *  データキュー管理ブロックからデータキューIDを取り出すためのマクロ
+ *  データキュー管理ブロックからデータキューIDを取り出すためのマクロ
  */
 #define DTQID(p_dtqcb)  ((ID)(((p_dtqcb) - dtqcb_table) + TMIN_DTQID))
 
 /*
- *  データキュー機能の初期化
+ *  データキュー機能の初期化
  */
 extern void     initialize_dataqueue(void);
 
 /*
- *  ãƒ‡ãƒ¼ã‚¿ã‚­ãƒ¥ãƒ¼ç®¡ç†é ˜åŸŸã¸ã®ãƒ‡ãƒ¼ã‚¿ã®æ ¼ç´
+ *  データキュー管理領域へのデータの格納
  */
 extern void     enqueue_data(DTQCB *p_dtqcb, intptr_t data);
 
 /*
- *  ãƒ‡ãƒ¼ã‚¿ã‚­ãƒ¥ãƒ¼ç®¡ç†é ˜åŸŸã¸ã®ãƒ‡ãƒ¼ã‚¿ã®å¼·åˆ¶æ ¼ç´
+ *  データキュー管理領域へのデータの強制格納
  */
 extern void     force_enqueue_data(DTQCB *p_dtqcb, intptr_t data);
 
 /*
- *  ãƒ‡ãƒ¼ã‚¿ã‚­ãƒ¥ãƒ¼ç®¡ç†é ˜åŸŸã‹ã‚‰ã®ãƒ‡ãƒ¼ã‚¿ã®å–å‡ºã—
+ *  データキュー管理領域からのデータの取出し
  */
 extern void     dequeue_data(DTQCB *p_dtqcb, intptr_t *p_data);
 
 /*
- *  データキューへのデータ送信
+ *  データキューへのデータ送信
  */
 extern bool_t   send_data(DTQCB *p_dtqcb, intptr_t data);
 
 /*
- *  データキューへのデータ強制送信
+ *  データキューへのデータ強制送信
  */
 extern void     force_send_data(DTQCB *p_dtqcb, intptr_t data);
 
 /*
- *  データキューからのデータ受信
+ *  データキューからのデータ受信
  */
 extern bool_t   receive_data(DTQCB *p_dtqcb, intptr_t *p_data);