// 2003.09.08, 2003.12.28, 2004.10.15, 2004.12.05, 2004.12.10, 2005.01.20, 2005.02.23, 2005.07.15, 2005.08.17
//****************************************
//**  Copyright  (C)  W.ch  1999-2005   **
//**  Web:  http://www.winchiphead.com  **
//****************************************
//**  DLL for USB interface chip CH375  **
//**  C, VC5.0                          **
//****************************************
//
// USB總線接口芯片CH375的應(yīng)用層接口庫  V2.2
// 南京沁恒電子有限公司  作者: W.ch 2005.08
// CH375-DLL  V2.2 , Support: Ctrl/Bulk/Int
// 運行環(huán)境: Windows 98/ME, Windows 2000/XP
// support USB chip: CH372/CH375
//

#ifndef		_CH375_DLL_H
#define		_CH375_DLL_H

#ifdef __cplusplus
extern "C" {
#endif

#define		mOFFSET( s, m )			( (ULONG) & ( ( ( s * ) 0 ) -> m ) )	// 定義獲取結(jié)構(gòu)成員相對偏移地址的宏

#ifndef		max
#define		max( a, b )				( ( ( a ) > ( b ) ) ? ( a ) : ( b ) )	// 較大值
#endif

#ifndef		min
#define		min( a, b )				( ( ( a ) < ( b ) ) ? ( a ) : ( b ) )	// 較小值
#endif

#ifdef		ExAllocatePool
#undef		ExAllocatePool						// 刪除帶TAG的內(nèi)存分配
#endif

#ifndef		NTSTATUS
typedef		LONG	NTSTATUS;					// 返回狀態(tài)
#endif


typedef	struct	_USB_SETUP_PKT {				// USB控制傳輸?shù)慕㈦A段的數(shù)據(jù)請求包結(jié)構(gòu)
	UCHAR			mUspReqType;				// 00H 請求類型
	UCHAR			mUspRequest;				// 01H 請求代碼
	union	{
		struct	{
			UCHAR	mUspValueLow;				// 02H 值參數(shù)低字節(jié)
			UCHAR	mUspValueHigh;				// 03H 值參數(shù)高字節(jié)
		};
		USHORT		mUspValue;					// 02H-03H 值參數(shù)
	};
	union	{
		struct	{
			UCHAR	mUspIndexLow;				// 04H 索引參數(shù)低字節(jié)
			UCHAR	mUspIndexHigh;				// 05H 索引參數(shù)高字節(jié)
		};
		USHORT		mUspIndex;					// 04H-05H 索引參數(shù)
	};
	USHORT			mLength;					// 06H-07H 數(shù)據(jù)階段的數(shù)據(jù)長度
} mUSB_SETUP_PKT, *mPUSB_SETUP_PKT;


#define		mCH375_PACKET_LENGTH	64			// CH375支持的數(shù)據(jù)包的長度
#define		mCH375_PKT_LEN_SHORT	8			// CH375支持的短數(shù)據(jù)包的長度


typedef	struct	_WIN32_COMMAND {				// 定義WIN32命令接口結(jié)構(gòu)
	union	{
		ULONG		mFunction;					// 輸入時指定功能代碼或者管道號
		NTSTATUS	mStatus;					// 輸出時返回操作狀態(tài)
	};
	ULONG			mLength;					// 存取長度,返回后續(xù)數(shù)據(jù)的長度
	union	{
		mUSB_SETUP_PKT	mSetupPkt;				// USB控制傳輸?shù)慕㈦A段的數(shù)據(jù)請求
		UCHAR			mBuffer[ mCH375_PACKET_LENGTH ];	// 數(shù)據(jù)緩沖區(qū),長度為0至255B
	};
} mWIN32_COMMAND, *mPWIN32_COMMAND;


// WIN32應(yīng)用層接口命令
#define		IOCTL_CH375_COMMAND		( FILE_DEVICE_UNKNOWN << 16 | FILE_ANY_ACCESS << 14 | 0x0f37 << 2 | METHOD_BUFFERED )	// 專用接口

#define		mWIN32_COMMAND_HEAD		mOFFSET( mWIN32_COMMAND, mBuffer )	// WIN32命令接口的頭長度

#define		mCH375_MAX_NUMBER		16			// 最多同時連接的CH375數(shù)

#define		mMAX_BUFFER_LENGTH		0x1000		// 數(shù)據(jù)緩沖區(qū)最大長度4096

#define		mMAX_COMMAND_LENGTH		( mWIN32_COMMAND_HEAD + mMAX_BUFFER_LENGTH )	// 最大數(shù)據(jù)長度加上命令結(jié)構(gòu)頭的長度

#define		mDEFAULT_BUFFER_LEN		0x0400		// 數(shù)據(jù)緩沖區(qū)默認(rèn)長度1024

#define		mDEFAULT_COMMAND_LEN	( mWIN32_COMMAND_HEAD + mDEFAULT_BUFFER_LEN )	// 默認(rèn)數(shù)據(jù)長度加上命令結(jié)構(gòu)頭的長度


// CH375端點地址
#define		mCH375_ENDP_INTER_UP	0x81		// CH375的中斷數(shù)據(jù)上傳端點的地址
#define		mCH375_ENDP_AUX_DOWN	0x01		// CH375的輔助數(shù)據(jù)下傳端點的地址
#define		mCH375_ENDP_DATA_UP		0x82		// CH375的數(shù)據(jù)塊上傳端點的地址
#define		mCH375_ENDP_DATA_DOWN	0x02		// CH375的數(shù)據(jù)塊下傳端點的地址


// 設(shè)備層接口提供的管道操作命令
#define		mPipeDeviceCtrl			0x00000004	// CH375的綜合控制管道
#define		mPipeInterUp			0x00000005	// CH375的中斷數(shù)據(jù)上傳管道
#define		mPipeDataUp				0x00000006	// CH375的數(shù)據(jù)塊上傳管道
#define		mPipeDataDown			0x00000007	// CH375的數(shù)據(jù)塊下傳管道
#define		mPipeAuxDown			0x00000008	// CH375的輔助數(shù)據(jù)下傳管道

// 應(yīng)用層接口的功能代碼
#define		mFuncNoOperation		0x00000000	// 無操作
#define		mFuncGetVersion			0x00000001	// 獲取驅(qū)動程序版本號
#define		mFuncGetConfig			0x00000002	// 獲取USB設(shè)備配置描述符
#define		mFuncSetExclusive		0x0000000b	// 設(shè)置獨占使用
#define		mFuncResetDevice		0x0000000c	// 復(fù)位USB設(shè)備
#define		mFuncResetPipe			0x0000000d	// 復(fù)位USB管道
#define		mFuncAbortPipe			0x0000000e	// 取消USB管道的數(shù)據(jù)請求
#define		mFuncSetTimeout			0x0000000f	// 設(shè)置USB通訊超時
#define		mFuncBufferMode			0x00000010	// 設(shè)定緩沖上傳模式及查詢緩沖區(qū)中的數(shù)據(jù)長度
#define		mFuncBufferModeDn		0x00000011	// 設(shè)定緩沖下傳模式及查詢緩沖區(qū)中的數(shù)據(jù)長度


// USB設(shè)備標(biāo)準(zhǔn)請求代碼
#define		mUSB_CLR_FEATURE		0x01
#define		mUSB_SET_FEATURE		0x03
#define		mUSB_GET_STATUS			0x00
#define		mUSB_SET_ADDRESS		0x05
#define		mUSB_GET_DESCR			0x06
#define		mUSB_SET_DESCR			0x07
#define		mUSB_GET_CONFIG			0x08
#define		mUSB_SET_CONFIG			0x09
#define		mUSB_GET_INTERF			0x0a
#define		mUSB_SET_INTERF			0x0b
#define		mUSB_SYNC_FRAME			0x0c

// CH375控制傳輸?shù)膹S商專用請求類型
#define		mCH375_VENDOR_READ		0xc0		// 通過控制傳輸實現(xiàn)的CH375廠商專用讀操作
#define		mCH375_VENDOR_WRITE		0x40		// 通過控制傳輸實現(xiàn)的CH375廠商專用寫操作

// CH375控制傳輸?shù)膹S商專用請求代碼
#define		mCH375_SET_CONTROL		0x51		// 輸出控制信號
#define		mCH375_GET_STATUS		0x52		// 輸入狀態(tài)信號

// 寄存器的位定義
#define		mBitInputRxd			0x02		// 只讀,RXD#引腳輸入狀態(tài),1:高電平,0:低電平
#define		mBitInputReq			0x04		// 只讀,REQ#引腳輸入狀態(tài),1:高電平,0:低電平


// 直接輸入的狀態(tài)信號的位定義
#define		mStateRXD				0x00000200	// RXD#引腳輸入狀態(tài),1:高電平,0:低電平
#define		mStateREQ				0x00000400	// REQ#引腳輸入狀態(tài),1:高電平,0:低電平

#define		MAX_DEVICE_PATH_SIZE	128			// 設(shè)備名稱的最大字符數(shù)
#define		MAX_DEVICE_ID_SIZE		64			// 設(shè)備ID的最大字符數(shù)


typedef		VOID	( CALLBACK	* mPCH375_INT_ROUTINE ) (  // 中斷服務(wù)回調(diào)程序
	PUCHAR			iBuffer );  // 指向一個緩沖區(qū),提供當(dāng)前的中斷特征數(shù)據(jù)


HANDLE	WINAPI	CH375OpenDevice(  // 打開CH375設(shè)備,返回句柄,出錯則無效
	ULONG			iIndex );  // 指定CH375設(shè)備序號,0對應(yīng)第一個設(shè)備,-1則自動搜索一個可以被打開的設(shè)備并返回序號


VOID	WINAPI	CH375CloseDevice(  // 關(guān)閉CH375設(shè)備
	ULONG			iIndex );  // 指定CH375設(shè)備序號


ULONG	WINAPI	CH375GetVersion( );  // 獲得DLL版本號,返回版本號