📄 ezusb.h
字号:
//-----------------------------------------------------------------------------
// File: ezusb.h
// Contents: EZ-USB constants, macros, datatypes, globals, and library
// function prototypes.
//
// Copyright (c) 1997 AnchorChips, Inc. All rights reserved
// Adapted for use with HIDs by Jan Axelson (jan@lvr.com)
//-----------------------------------------------------------------------------
#ifndef EZUSB_H //Header sentry
#define EZUSB_H
//#define CHIPREV_B // Indicate target chip revision
#define CHIPREV_C
#define GET_CHIP_REV() ((CPUCS >> 4) & 0x00FF) // EzUSB Chip Rev Field
//#define EZUSB_CHIPREV_B 0 // This Rev has been taken over by TNG
#define EZUSB_TNG_CHIPREV_A 0 // Rev 0 now means TNG RevA
#define EZUSB_CHIPREV_C 2
#define EZUSB_CHIPREV_D 3
#define EZUSB_CHIPREV_E 4
#define INTERNAL_DSCR_ADDR 0x0080 // Relocate Descriptors to 0x80
#define bmSTRETCH 0x07
#define FW_STRETCH_VALUE 0x0 // Set stretch to 0 in frameworks
// Note: a RevE eratta states that stretch must=0 to set OUTxBC
//-----------------------------------------------------------------------------
// Constants
//-----------------------------------------------------------------------------
#define TRUE 1
#define FALSE 0
#define bmBIT0 0x01
#define bmBIT1 0x02
#define bmBIT2 0x04
#define bmBIT3 0x08
#define bmBIT4 0x10
#define bmBIT5 0x20
#define bmBIT6 0x40
#define bmBIT7 0x80
#define DEVICE_DSCR 0x01 // Descriptor type: Device
#define CONFIG_DSCR 0x02 // Descriptor type: Configuration
#define STRING_DSCR 0x03 // Descriptor type: String
#define INTRFC_DSCR 0x04 // Descriptor type: Interface
#define ENDPNT_DSCR 0x05 // Descriptor type: End Point
#define bmBUSPWR bmBIT7 // Config. attribute: Bus powered
#define bmSELFPWR bmBIT6 // Config. attribute: Self powered
#define bmRWU bmBIT5 // Config. attribute: Remote Wakeup
#define bmEPOUT bmBIT7
#define bmEPIN 0x00
#define EP_CONTROL 0x00 // End Point type: Control
#define EP_ISO 0x01 // End Point type: Isochronous
#define EP_BULK 0x02 // End Point type: Bulk
#define EP_INT 0x03 // End Point type: Interrupt
#define SUD_SIZE 8 // Setup data packet size
#define SC_GET_STATUS 0x00 // Setup command: Get Status
#define SC_CLEAR_FEATURE 0x01 // Setup command: Clear Feature
#define SC_RESERVED 0x02 // Setup command: Reserved
#define SC_SET_FEATURE 0x03 // Setup command: Set Feature
#define SC_SET_ADDRESS 0x05 // Setup command: Set Address
#define SC_GET_DESCRIPTOR 0x06 // Setup command: Get Descriptor
#define SC_SET_DESCRIPTOR 0x07 // Setup command: Set Descriptor
#define SC_GET_CONFIGURATION 0x08 // Setup command: Get Configuration
#define SC_SET_CONFIGURATION 0x09 // Setup command: Set Configuration
#define SC_GET_INTERFACE 0x0a // Setup command: Get Interface
#define SC_SET_INTERFACE 0x0b // Setup command: Set Interface
#define SC_SYNC_FRAME 0x0c // Setup command: Sync Frame
#define SC_ANCHOR_LOAD 0xa0 // Setup command: Anchor load
#define GD_DEVICE 0x01 // Get device descriptor: Device
#define GD_CONFIGURATION 0x02 // Get device descriptor: Configuration
#define GD_STRING 0x03 // Get device descriptor: String
//HID code start
#define GD_REPORT 0x22 // Get HID report descriptor
//HID code end
#define GS_DEVICE 0x80 // Get Status: Device
#define GS_INTERFACE 0x81 // Get Status: Interface
#define GS_ENDPOINT 0x82 // Get Status: End Point
#define FT_DEVICE 0x00 // Feature: Device
#define FT_ENDPOINT 0x02 // Feature: End Point
#define I2C_IDLE 0 // I2C Status: Idle mode
#define I2C_SENDING 1 // I2C Status: I2C is sending data
#define I2C_RECEIVING 2 // I2C Status: I2C is receiving data
#define I2C_PRIME 3 // I2C Status: I2C is receiving the first byte of a string
#define I2C_STOP 5 // I2C Status: I2C waiting for stop completion
#define I2C_BERROR 6 // I2C Status: I2C error; Bit Error
#define I2C_NACK 7 // I2C Status: I2C error; No Acknowledge
#define I2C_OK 8 // I2C positive return code
#define I2C_WAITSTOP 9 // I2C Status: Wait for STOP complete
/*-----------------------------------------------------------------------------
Macros
-----------------------------------------------------------------------------*/
#define MSB(word) (BYTE)(((WORD)word >> 8) & 0xff)
#define LSB(word) (BYTE)((WORD)word & 0xff)
#define SWAP_ENDIAN(word) ((BYTE*)&word)[0] ^= ((BYTE*)&word)[1];\
((BYTE*)&word)[1] ^= ((BYTE*)&word)[0];\
((BYTE*)&word)[0] ^= ((BYTE*)&word)[1]
#define EZUSB_IRQ_ENABLE() EUSB = 1
#define EZUSB_IRQ_DISABLE() EUSB = 0
#ifndef CHIPREV_B
#define EZUSB_IRQ_CLEAR() EXIF &= ~0x10 // IE2_
#endif
#define EZUSB_STALL_EP0() EP0CS |= bmEPSTALL
#define EZUSB_STALL_EP(ep_id) EPIO[ep_id].cntrl = bmEPSTALL
#define EZUSB_UNSTALL_EP(ep_id) EPIO[ep_id].cntrl = 0
#define EZUSB_GET_EP_STATUS(ep_id) EPIO[ep_id].cntrl
#define EZUSB_SET_EP_BYTES(ep_id,count) EPIO[ep_id].bytes = count
// the WRITEDELAY macro compiles to the time equivalent of 3 NOPs.
// It is used in the frameworks to allow for write recovery time
// requirements of certain registers. This is only necessary for
// EZ-USB FX parts. See the EZ-USB FX TRM for
// more information on write recovery time issues.
#define WRITEDELAY() {char writedelaydummy = 0;}
// if this firmware will never run on an EZ-USB FX part replace
// with:
// #define WRITEDELAY()
#define EZUSB_RESET_DATA_TOGGLE(ep) TOGCTL = (((ep & 0x80) >> 3) + (ep & 0x07));\
WRITEDELAY();\
TOGCTL |= 0x20
#define EZUSB_ENABLE_RSMIRQ() (EICON |= 0x20) // Enable Resume Interrupt (EPFI_)
#define EZUSB_DISABLE_RSMIRQ() (EICON &= ~0x20) // Disable Resume Interrupt (EPFI_)
#define EZUSB_CLEAR_RSMIRQ() (EICON &= ~0x10) // Clear Resume Interrupt Flag (PFI_)
#define EZUSB_GETI2CSTATUS() (I2CPckt.status)
#define EZUSB_CLEARI2CSTATUS() if((I2CPckt.status == I2C_BERROR) || (I2CPckt.status == I2C_NACK))\
I2CPckt.status = I2C_IDLE;
#define EZUSB_ENABLEBP() (USBBAV |= bmBPEN)
#define EZUSB_DISABLEBP() (USBBAV &= ~bmBPEN)
#define EZUSB_CLEARBP() (USBBAV |= bmBREAK)
#define EZUSB_BP(addr) BPADDR = (WORD)addr
#define EZUSB_EXTWAKEUP() (USBCS & bmRWAKEUP)
//-----------------------------------------------------------------------------
// Datatypes
//-----------------------------------------------------------------------------
typedef unsigned char BYTE;
typedef unsigned short WORD;
typedef unsigned long DWORD;
typedef bit BOOL;
#define INT0_VECT 0
#define TMR0_VECT 1
#define INT1_VECT 2
#define TMR1_VECT 3
#define COM0_VECT 4
#define TMR2_VECT 5
#define WKUP_VECT 6
#define COM1_VECT 7
#define USB_VECT 8
#define I2C_VECT 9
#define INT4_VECT 10
#define INT5_VECT 11
#define INT6_VECT 12
#define SUDAV_USBVECT (0 << 2)
#define SOF_USBVECT (1 << 2)
#define SUTOK_USBVECT (2 << 2)
#define SUSP_USBVECT (3 << 2)
#define URES_USBVECT (4 << 2)
#define SPARE_USBVECT (5 << 2)
#define IN0BUF_USBVECT (6 << 2)
#define OUT0BUF_USBVECT (7 << 2)
#define IN1BUF_USBVECT (8 << 2)
#define OUT1BUF_USBVECT (9 << 2)
#define IN2BUF_USBVECT (10 << 2)
#define OUT2BUF_USBVECT (11 << 2)
#define IN3BUF_USBVECT (12 << 2)
#define OUT3BUF_USBVECT (13 << 2)
#define IN4BUF_USBVECT (14 << 2)
#define OUT4BUF_USBVECT (15 << 2)
#define IN5BUF_USBVECT (16 << 2)
#define OUT5BUF_USBVECT (17 << 2)
#define IN6BUF_USBVECT (18 << 2)
#define OUT6BUF_USBVECT (19 << 2)
#define IN7BUF_USBVECT (20 << 2)
#define OUT7BUF_USBVECT (21 << 2)
typedef struct
{
BYTE length;
BYTE type;
}DSCR;
typedef struct // Device Descriptor
{
BYTE length; // Descriptor length ( = sizeof(DEVICEDSCR) )
BYTE type; // Decriptor type (Device = 1)
BYTE spec_ver_minor; // Specification Version (BCD) minor
BYTE spec_ver_major; // Specification Version (BCD) major
BYTE dev_class; // Device class
BYTE sub_class; // Device sub-class
BYTE protocol; // Device sub-sub-class
BYTE max_packet; // Maximum packet size
WORD vendor_id; // Vendor ID
WORD product_id; // Product ID
WORD version_id; // Product version ID
BYTE mfg_str; // Manufacturer string index
BYTE prod_str; // Product string index
BYTE serialnum_str; // Serial number string index
BYTE configs; // Numder of configurations
}DEVICEDSCR;
typedef struct
{
BYTE length; // Configuration length ( = sizeof(CONFIGDSCR) )
BYTE type; // Descriptor type (Configuration = 2)
WORD config_len; // Configuration + End Points length
BYTE interfaces; // Number of interfaces
BYTE index; // Configuration number
BYTE config_str; // Configuration string
BYTE attrib; // Attributes (b7 - buspwr, b6 - selfpwr, b5 - rwu
BYTE power; // Power requirement (div 2 ma)
}CONFIGDSCR;
typedef struct
{
BYTE length; // Interface descriptor length ( - sizeof(INTRFCDSCR) )
BYTE type; // Descriptor type (Interface = 4)
BYTE index; // Zero-based index of this interface
BYTE alt_setting; // Alternate setting
BYTE ep_cnt; // Number of end points
BYTE class; // Interface class
BYTE sub_class; // Interface sub class
BYTE protocol; // Interface sub sub class
BYTE interface_str; // Interface descriptor string index
}INTRFCDSCR;
typedef struct
{
BYTE length; // End point descriptor length ( = sizeof(ENDPNTDSCR) )
BYTE type; // Descriptor type (End point = 5)
BYTE addr; // End point address
BYTE ep_type; // End point type
BYTE mp_L; // Maximum packet size
BYTE mp_H;
BYTE interval; // Interrupt polling interval
}ENDPNTDSCR;
typedef struct
{
BYTE length; // String descriptor length
BYTE type; // Descriptor type
}STRINGDSCR;
// HID code start
typedef struct
{
BYTE length; // HID descriptor length ( = sizeof(HIDDSCR) )
BYTE type; // Descriptor type (HID = 21h)
BYTE specl; // HID spec # low byte
BYTE spech; // HID spec # high byte
BYTE country; // Country localization (0 = none)
BYTE num_dscr; // Number of descriptors to follow
BYTE dscr_type; // Descriptor type to follow (22h = report)
BYTE reportlength; // Report descriptor length
}HIDDSCR;
typedef struct // HID Report Descriptor for this application
{
BYTE Usage_Page_Code1;
BYTE Usage_Page_LSB1;
BYTE Usage_Page_MSB1;
BYTE Usage_Code1;
BYTE Usage_Value1;
BYTE Collection_Code1;
BYTE Collection_Value1;
BYTE Usage_Code2;
BYTE Usage_Value2;
BYTE Collection_Code2;
BYTE Collection_Value2;
BYTE Usage_Page_Code2;
BYTE Usage_Page_LSB2;
BYTE Usage_Page_MSB2;
// Input report
BYTE Usage_Code3;
BYTE Usage_Value3;
BYTE Usage_Code4;
BYTE Usage_Value4;
BYTE Logical_Min_In_Code;
BYTE Logical_Min_In_Value;
BYTE Logical_Max_In_Code;
BYTE Logical_Max_In_Value;
BYTE Physical_Min_In_Code;
BYTE Physical_Min_In_Value;
BYTE Physical_Max_In_Code;
BYTE Physical_Max_In_Value;
BYTE Report_Size_In_Code;
BYTE Report_Size_In_Value;
BYTE Report_Count_In_Code;
BYTE Report_Count_In_Value;
BYTE Input_Code;
BYTE Input_Value;
// Output report
BYTE Usage_Code5;
BYTE Usage_Value5;
BYTE Usage_Code6;
BYTE Usage_Value6;
BYTE Logical_Min_Out_Code;
BYTE Logical_Min_Out_Value;
BYTE Logical_Max_Out_Code;
BYTE Logical_Max_Out_Value;
BYTE Physical_Min_Out_Code;
BYTE Physical_Min_Out_Value;
BYTE Physical_Max_Out_Code;
BYTE Physical_Max_Out_Value;
BYTE Report_Size_Out_Code;
BYTE Report_Size_Out_Value;
BYTE Report_Count_Out_Code;
BYTE Report_Count_Out_Value;
BYTE Output_Code;
BYTE Output_Value;
BYTE End_Collection1;
BYTE End_Collection2;
}REPORTDSCR;
// HID code end
typedef struct
{
BYTE cntrl; // End point control register
BYTE bytes; // End point buffer byte count
}EPIOC;
typedef struct
{
BYTE length;
BYTE *dat;
BYTE count;
BYTE status;
}I2CPCKT;
//-----------------------------------------------------------------------------
// Globals
//-----------------------------------------------------------------------------
extern code BYTE USB_AutoVector;
extern WORD pDeviceDscr;
extern WORD pConfigDscr;
extern WORD pStringDscr;
extern WORD pReportDscr;
extern code DEVICEDSCR DeviceDscr;
extern code CONFIGDSCR ConfigDscr;
extern code STRINGDSCR StringDscr;
extern code REPORTDSCR ReportDscr;
extern code DSCR UserDscr;
extern I2CPCKT I2CPckt;
//-----------------------------------------------------------------------------
// Function Prototypes
//-----------------------------------------------------------------------------
#ifdef CHIPREV_B
extern void EZUSB_IRQ_CLEAR(void);
#endif
extern void EZUSB_Renum(void);
extern void EZUSB_Discon(BOOL renum);
extern void EZUSB_Susp(void);
extern void EZUSB_Resume(void);
extern void EZUSB_Delay1ms(void);
extern void EZUSB_Delay(WORD ms);
extern CONFIGDSCR xdata* EZUSB_GetConfigDscr(BYTE ConfigIdx);
extern INTRFCDSCR xdata* EZUSB_GetIntrfcDscr(BYTE ConfigIdx, BYTE IntrfcIdx, BYTE AltSetting);
extern STRINGDSCR xdata* EZUSB_GetStringDscr(BYTE StrIdx);
extern DSCR xdata* EZUSB_GetDscr(BYTE index, DSCR* dscr, BYTE type);
extern void EZUSB_InitI2C(void);
extern BOOL EZUSB_WriteI2C_(BYTE addr, BYTE length, BYTE xdata *dat);
extern BOOL EZUSB_ReadI2C_(BYTE addr, BYTE length, BYTE xdata *dat);
extern BOOL EZUSB_WriteI2C(BYTE addr, BYTE length, BYTE xdata *dat);
extern BOOL EZUSB_ReadI2C(BYTE addr, BYTE length, BYTE xdata *dat);
extern void EZUSB_WaitForEEPROMWrite(BYTE addr);
#endif // EZUSB_H
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -