/*
 *  TOPPERS/JSP Kernel
 *      Toyohashi Open Platform for Embedded Real-Time Systems/
 *      Just Standard Profile Kernel
 * 
 *  Copyright (C) 2000-2003 by Embedded and Real-Time Systems Laboratory
 *                              Toyohashi Univ. of Technology, JAPAN
 * 
 *  忋婰挊嶌尃幰偼丆埲壓偺 (1)乣(4) 偺忦審偐丆Free Software Foundation 
 *  偵傛偭偰岞昞偝傟偰偄傞 GNU General Public License 偺 Version 2 偵婰
 *  弎偝傟偰偄傞忦審傪枮偨偡応崌偵尷傝丆杮僜僼僩僂僃傾乮杮僜僼僩僂僃傾
 *  傪夵曄偟偨傕偺傪娷傓丏埲壓摨偠乯傪巊梡丒暋惢丒夵曄丒嵞攝晍乮埲壓丆
 *  棙梡偲屇傇乯偡傞偙偲傪柍彏偱嫋戻偡傞丏
 *  (1) 杮僜僼僩僂僃傾傪僜乕僗僐乕僪偺宍偱棙梡偡傞応崌偵偼丆忋婰偺挊嶌
 *      尃昞帵丆偙偺棙梡忦審偍傛傃壓婰偺柍曐徹婯掕偑丆偦偺傑傑偺宍偱僜乕
 *      僗僐乕僪拞偵娷傑傟偰偄傞偙偲丏
 *  (2) 杮僜僼僩僂僃傾傪丆儔僀僽儔儕宍幃側偳丆懠偺僜僼僩僂僃傾奐敪偵巊
 *      梡偱偒傞宍偱嵞攝晍偡傞応崌偵偼丆嵞攝晍偵敽偆僪僉儏儊儞僩乮棙梡
 *      幰儅僯儏傾儖側偳乯偵丆忋婰偺挊嶌尃昞帵丆偙偺棙梡忦審偍傛傃壓婰
 *      偺柍曐徹婯掕傪宖嵹偡傞偙偲丏
 *  (3) 杮僜僼僩僂僃傾傪丆婡婍偵慻傒崬傓側偳丆懠偺僜僼僩僂僃傾奐敪偵巊
 *      梡偱偒側偄宍偱嵞攝晍偡傞応崌偵偼丆師偺偄偢傟偐偺忦審傪枮偨偡偙
 *      偲丏
 *    (a) 嵞攝晍偵敽偆僪僉儏儊儞僩乮棙梡幰儅僯儏傾儖側偳乯偵丆忋婰偺挊
 *        嶌尃昞帵丆偙偺棙梡忦審偍傛傃壓婰偺柍曐徹婯掕傪宖嵹偡傞偙偲丏
 *    (b) 嵞攝晍偺宍懺傪丆暿偵掕傔傞曽朄偵傛偭偰丆TOPPERS僾儘僕僃僋僩偵
 *        曬崘偡傞偙偲丏
 *  (4) 杮僜僼僩僂僃傾偺棙梡偵傛傝捈愙揑傑偨偼娫愙揑偵惗偠傞偄偐側傞懝
 *      奞偐傜傕丆忋婰挊嶌尃幰偍傛傃TOPPERS僾儘僕僃僋僩傪柶愑偡傞偙偲丏
 * 
 *  杮僜僼僩僂僃傾偼丆柍曐徹偱採嫙偝傟偰偄傞傕偺偱偁傞丏忋婰挊嶌尃幰偍
 *  傛傃TOPPERS僾儘僕僃僋僩偼丆杮僜僼僩僂僃傾偵娭偟偰丆偦偺揔梡壜擻惈傕
 *  娷傔偰丆偄偐側傞曐徹傕峴傢側偄丏傑偨丆杮僜僼僩僂僃傾偺棙梡偵傛傝捈
 *  愙揑傑偨偼娫愙揑偵惗偠偨偄偐側傞懝奞偵娭偟偰傕丆偦偺愑擟傪晧傢側偄丏
 * 
 *  @(#) $Id: dataqueue.h,v 1.5 2003/06/04 01:46:16 hiro Exp $
 */

/*
 *	僨乕僞僉儏乕婡擻
 */

#ifndef _DATAQUEUE_H_
#define _DATAQUEUE_H_

#include "queue.h"

/*
 *  僨乕僞僉儏乕弶婜壔僽儘僢僋
 */
typedef struct dataqueue_initialization_block {
	ATR	dtqatr;		/* 僨乕僞僉儏乕懏惈 */
	UINT	dtqcnt;		/* 僨乕僞僉儏乕椞堟偺梕検 */
	VP	dtq;		/* 僨乕僞僉儏乕椞堟偺愭摢斣抧 */
} DTQINIB;

/*
 *  僨乕僞僉儏乕娗棟僽儘僢僋
 */
typedef struct dataqueue_control_block {
	QUEUE	swait_queue;	/* 僨乕僞僉儏乕憲怣懸偪僉儏乕 */
	const DTQINIB *dtqinib;	/* 僨乕僞僉儏乕弶婜壔僽儘僢僋傊偺億僀儞僞 */
	QUEUE	rwait_queue;	/* 僨乕僞僉儏乕庴怣懸偪僉儏乕 */
	UINT	count;		/* 僨乕僞僉儏乕拞偺僨乕僞偺悢 */
	UINT	head;		/* 嵟弶偺僨乕僞偺奿擺応強 */
	UINT	tail;		/* 嵟屻偺僨乕僞偺奿擺応強偺師 */
} DTQCB;

/*
 *  僨乕僞僉儏乕婡擻偺弶婜壔
 */
extern void	dataqueue_initialize(void);

/*
 *  僨乕僞僉儏乕椞堟偵僨乕僞傪奿擺
 */
extern BOOL	enqueue_data(DTQCB *dtqcb, VP_INT data);

/*
 *  僨乕僞僉儏乕椞堟偵僨乕僞傪嫮惂奿擺
 */
extern void	force_enqueue_data(DTQCB *dtqcb, VP_INT data);

/*
 *  僨乕僞僉儏乕椞堟偐傜僨乕僞傪庢弌偟
 */
extern BOOL	dequeue_data(DTQCB *dtqcb, VP_INT *p_data);

/*
 *  庴怣懸偪僉儏乕偺愭摢僞僗僋傊偺僨乕僞憲怣
 */
extern TCB	*send_data_rwait(DTQCB *dtqcb, VP_INT data);

/*
 *  憲怣懸偪僉儏乕偺愭摢僞僗僋偐傜偺僨乕僞庴怣
 */
extern TCB	*receive_data_swait(DTQCB *dtqcb, VP_INT *p_data);

#endif /* _DATAQUEUE_H_ */