/****************************************Copyright (c)**************************************************
**                               Guangzhou ZLG-MCU Development Co.,LTD.
**                                      graduate school
**                                 http://www.zlgmcu.com
**
**--------------File Info-------------------------------------------------------------------------------
** File name:			Chap_9.h
** Last modified Date:	2004-12-10
** Last Version:		V1.0
** Descriptions:		USB驅動程序軟件包: ISP1181B(D13) 設備端驅動程序 協議層
**						Soft Packet of USB Driver: the Driver of Device of ISP1181B(D13) 
**												   the Header Files of Protocol Layer
**------------------------------------------------------------------------------------------------------
** Created by:			
** Created date:		
** Version:				
** Descriptions:		
**
**------------------------------------------------------------------------------------------------------
** Modified by:			Ming Yuan Zheng
** Modified date:		2004-12-10
** Version:				V1.0
** Descriptions:		The original version
**
**------------------------------------------------------------------------------------------------------
** Modified by: 
** Modified date:
** Version:	
** Descriptions: 
**
********************************************************************************************************/

#ifndef __CHAP_9_H__
#define __CHAP_9_H__

#define MSB(x)    (((x) >> 8) & 0xFF)

#define MAX_ENDPOINTS      (INT8U)0xF			  //for ISP1181A/B

// 下面的值為 Get Status命令的返回值
#define USB_GETSTATUS_SELF_POWERED                0x01
#define USB_GETSTATUS_REMOTE_WAKEUP_ENABLED       0x02

/**************************** USB  狀態取值 *************************/ 
#define USB_IDLE           0				
#define USB_TRANSMIT       1
#define USB_RECEIVE        2


   //*************************************************************************
   // Chap_9.c 使用的結構體
   //*************************************************************************
   
/************ USB事件結構體 *********************/
/************ USB事件結構體 *********************/
typedef union _epp_flags
{
	struct _flags
	{
		unsigned  remote_wakeup		   	: 1;		//遠程喚醒標志							the flag of remove wakeup
		unsigned  control_state			: 2;		//控制端點處理狀態						control endpoint status
														//0: IDEL		  空閑狀態			0:  idle
														//1: TRANSMIT	  數據發送狀態		1:  transmit
														//2: RECEIVE	  數據接收狀態		2:  receive
		unsigned  configuration			: 1;		//USB配置完成標志(0: 未配置; 1: 已配置)
													//the flag of USB configurated(0: not finished; 1: finished) 	
		unsigned  command				: 1;		//未使用					reserved
		unsigned  bus_reset				: 1;		//總線復位標志			usb bus reset
		unsigned  suspend				: 1;		//設備掛起標志			usb device suspend flag
	} bits;
	INT16U value;
} EPPFLAGS;

extern EPPFLAGS bEPPflags;

typedef struct _device_request
{
	INT8U bmRequestType;
	INT8U bRequest;
	INT16U wValue;
	INT16U wIndex;
	INT16U wLength;
} DEVICE_REQUEST;


/*********** 控制傳輸結構體 ************/
#define MAX_CONTROLDATA_SIZE	8

typedef struct _control_xfer
{
	DEVICE_REQUEST DeviceRequest;
	INT16U wLength;
	INT16U wCount;
	INT8U * pData;
	INT8U dataBuffer[MAX_CONTROLDATA_SIZE];
} CONTROL_XFER;

extern CONTROL_XFER ControlData;
   //*************************************************************************
   // USB 標準設備請求函數
   //*************************************************************************

void get_status(void);
void clear_feature(void);
void set_feature(void);
void set_address(void);
void get_descriptor(void);
void get_configuration(void);
void set_configuration(void);
void get_interface(void);
void set_interface(void);
void reserved(void);
void stall_ep0(void);
void ep0_txdone(void);
void ep0_rxdone(void);

void init_unconfig(void);
void init_config(void);
void single_transmit(INT8U * pData, INT8U len);
void code_transmit(INT8U * pRomData, INT16U len);
void control_handler(void);

#endif