/*
*******************************************************************************
*                    Copyright (c) 2005, Comba Telecom System
*                             All Rights Reserved
*
* Purpose           : queue header file
* File Name         : queue.h

* Chip type         : LPC22XX(ARM7TDMI)
* IDE               : ADS1.2

* Revision history  :
    01a,2005/08/16,Lu jiangmin  -- Creation(written),re. zlgmcu Chen mingji

* Description       :
    
  
*******************************************************************************
*/

#ifndef NOT_OK
#define NOT_OK              0xff                        /* 參數錯誤                                     */
#endif

#define QUEUE_FULL          8                           /* 隊列滿                                       */
#define QUEUE_EMPTY         4                           /* 無數據                                       */
#define QUEUE_OK            1                           /* 操作成功                                     */

#define Q_WRITE_MODE        1                           /* 操作成功                                     */
#define Q_WRITE_FRONT_MODE  2                           /* 操作成功                                     */

#ifndef QUEUE_DATA_TYPE
#define QUEUE_DATA_TYPE     INT8U
#endif

typedef struct {
    QUEUE_DATA_TYPE     *Out;                   /* 指向數據輸出位置         */
    QUEUE_DATA_TYPE     *In;                    /* 指向數據輸入位置         */
    QUEUE_DATA_TYPE     *End;                   /* 指向Buf的結束位置        */
    INT16U              NData;                  /* 隊列中數據個數           */
    INT16U              MaxData;                /* 隊列中允許存儲的數據個數 */
    
    INT8U               (* ReadEmpty)();        /* 讀空處理函數             */
    INT8U               (* WriteFull)();        /* 寫滿處理函數             */
    QUEUE_DATA_TYPE     Buf[1];                 /* 存儲數據的空間           */
} DataQueue;


#ifndef IN_QUEUE
extern INT8U QueueCreate(void *Buf, INT32U SizeOfBuf, INT8U (* ReadEmpty)(), INT8U (* WriteFull)());        
extern INT8U QueueRead(QUEUE_DATA_TYPE *Ret, void *Buf);
extern INT8U QueueWrite(void *Buf, QUEUE_DATA_TYPE Data);
extern INT8U QueueWriteFront(void *Buf, QUEUE_DATA_TYPE Data);
extern INT16U QueueNData(void *Buf);
extern INT16U QueueSize(void *Buf);
extern void QueueFlush(void *Buf);
#endif