; Define for CH372 & CH375
; Website:  http://wch.cn    http://winchiphead.com
; Email:    tech@wch.cn      tech@winchiphead.com
; Author:   W.ch 2003.09
; V3.0 for CH372B, CH375B

; *********************************************************************************************************************
; 硬件特性

CH375_MAX_DATA_LEN	EQU     40H							;最大數據包的長度, 緩沖區的長度

; *********************************************************************************************************************
; 命令代碼

CMD_GET_IC_VER		EQU     01H							;獲取芯片及固件版本
; 輸出: 版本號( 位7為1, 位6為0, 位5~位0為版本號 )
;           CH375B返回版本號的值為0B7H即版本號為37H

CMD_ENTER_SLEEP		EQU     03H							;進入睡眠狀態

CMD_SET_USB_SPEED	EQU     04H							;設置USB總線速度, 在每次CMD_SET_USB_MODE設置USB工作模式時會自動恢復到12Mbps全速
; 輸入: 總線速度代碼
;           00H=12Mbps全速FullSpeed（默認值）, 01H=1.5Mbps（僅修改頻率）, 02H=1.5Mbps低速LowSpeed
CMD_SET_SYS_FREQ	EQU     CMD_SET_USB_SPEED

CMD_RESET_ALL		EQU     05H							;執行硬件復位

CMD_CHECK_EXIST		EQU     06H							;測試工作狀態
; 輸入: 任意數據
; 輸出: 輸入數據的按位取反

CMD_GET_TOGGLE		EQU     0AH							;獲取OUT事務的同步狀態
; 輸入: 數據1AH
; 輸出: 同步狀態
;           位4為1則OUT事務同步, 否則OUT事務不同步

CMD_CHK_SUSPEND		EQU     0BH							;設備方式: 設置檢查USB總線掛起狀態的方式
; 輸入: 數據10H, 檢查方式
;                    00H=不檢查USB掛起, 04H=以50mS為間隔檢查USB掛起, 05H=以10mS為間隔檢查USB掛起

CMD_DELAY_100US		EQU     0FH							;并口方式: 延時100uS
; 輸出: 延時期間輸出0, 延時結束輸出非0

CMD_SET_USB_ID		EQU     12H							;設備方式: 設置USB廠商VID和產品PID
; 輸入: 廠商ID低字節, 廠商ID高字節, 產品ID低字節, 產品ID高字節

CMD_SET_USB_ADDR	EQU     13H							;設置USB地址
; 輸入: 地址值

CMD_SET_USB_MODE	EQU     15H							;設置USB工作模式
; 輸入: 模式代碼
;       00H=未啟用的設備方式, 01H=已啟用的設備方式并且使用外部固件模式, 02H=已啟用的設備方式并且使用內置固件模式
;       04H=未啟用的主機方式, 05H=已啟用的主機方式, 06H=已啟用的主機方式并且自動產生SOF包, 07H=已啟用的主機方式并且復位USB總線
; 輸出: 操作狀態( CMD_RET_SUCCESS或CMD_RET_ABORT, 其它值說明操作未完成 )

CMD_SET_ENDP2		EQU     18H							;設備方式: 設置USB端點0的接收器
; 輸入: 工作方式
;           位7為1則位6為同步觸發位, 否則同步觸發位不變
;           位3~位0為事務響應方式:  0000-就緒ACK, 1110-正忙NAK, 1111-錯誤STALL

CMD_SET_ENDP3		EQU     19H							;設備方式: 設置USB端點0的發送器
; 輸入: 工作方式
;           位7為1則位6為同步觸發位, 否則同步觸發位不變
;           位3~位0為事務響應方式:  0000~1000-就緒ACK, 1110-正忙NAK, 1111-錯誤STALL

CMD_SET_ENDP4		EQU     1AH							;設備方式: 設置USB端點1的接收器
; 輸入: 工作方式
;           位7為1則位6為同步觸發位, 否則同步觸發位不變
;           位3~位0為事務響應方式:  0000-就緒ACK, 1110-正忙NAK, 1111-錯誤STALL

CMD_SET_ENDP5		EQU     1BH							;設備方式: 設置USB端點1的發送器
; 輸入: 工作方式
;           位7為1則位6為同步觸發位, 否則同步觸發位不變
;           位3~位0為事務響應方式:  0000~1000-就緒ACK, 1110-正忙NAK, 1111-錯誤STALL

CMD_SET_ENDP6		EQU     1CH							;設置USB端點2/主機端點的接收器
; 輸入: 工作方式
;           位7為1則位6為同步觸發位, 否則同步觸發位不變
;           位3~位0為事務響應方式:  0000-就緒ACK, 1101-就緒但不返回ACK, 1110-正忙NAK, 1111-錯誤STALL

CMD_SET_ENDP7		EQU     1DH							;設置USB端點2/主機端點的發送器
; 輸入: 工作方式
;           位7為1則位6為同步觸發位, 否則同步觸發位不變
;           位3~位0為事務響應方式:  0000-就緒ACK, 1101-就緒但無須應答, 1110-正忙NAK, 1111-錯誤STALL

CMD_GET_STATUS		EQU     22H							;獲取中斷狀態并取消中斷請求
; 輸出: 中斷狀態

CMD_UNLOCK_USB		EQU     23H							;設備方式: 釋放當前USB緩沖區

CMD_RD_USB_DATA0	EQU     27H							;從當前USB中斷的端點緩沖區讀取數據塊
; 輸出: 長度, 數據流

CMD_RD_USB_DATA		EQU     28H							;從當前USB中斷的端點緩沖區讀取數據塊, 并釋放緩沖區, 相當于 CMD_RD_USB_DATA0 + CMD_UNLOCK_USB
; 輸出: 長度, 數據流

CMD_WR_USB_DATA3	EQU     29H							;設備方式: 向USB端點0的發送緩沖區寫入數據塊
; 輸入: 長度, 數據流

CMD_WR_USB_DATA5	EQU     2AH							;設備方式: 向USB端點1的發送緩沖區寫入數據塊
; 輸入: 長度, 數據流

CMD_WR_USB_DATA7	EQU     2BH							;向USB端點2或者主機端點的發送緩沖區寫入數據塊
; 輸入: 長度, 數據流

; **************************************************************************
; 以下命令用于USB主機方式, 只有CH375支持

CMD_SET_BAUDRATE	EQU     02H							;主機方式 & 串口方式: 設置串口通訊波特率
; 輸入: 波特率分頻系數, 波特率分頻常數
; 輸出: 操作狀態( CMD_RET_SUCCESS或CMD_RET_ABORT, 其它值說明操作未完成 )

CMD_GET_DEV_RATE	EQU		0AH							;主機方式: 獲取當前連接的USB設備的數據速率類型
; 輸入: 數據07H
; 輸出: 數據速率類型
;                    位4為1則是1.5Mbps低速USB設備, 否則是12Mbps全速USB設備

CMD_GET_MAX_LUN		EQU		0AH							;主機方式: 獲取USB存儲器最大邏輯單元號
; 輸入: 數據38H
; 輸出: 最大邏輯單元號

CMD_SET_RETRY		EQU     0BH							;主機方式: 設置USB事務操作的重試次數
; 輸入: 數據25H, 重試次數
;                    位7為0則收到NAK時不重試, 位7為1位6為0則收到NAK時無限重試, 位7為1位6為1則收到NAK時最多重試2秒, 位5~位0為超時后的重試次數

CMD_SET_DISK_LUN	EQU     0BH							;主機方式: 設置USB存儲器的當前邏輯單元號
; 輸入: 數據34H, 新的當前邏輯單元號(00H-0FH)

CMD_SET_PKT_P_SEC	EQU     0BH							;主機方式: 設置USB存儲器的每扇區數據包總數
; 輸入: 數據39H, 新的每扇區數據包總數(08H,10H,20H,40H)

CMD_TEST_CONNECT	EQU     16H							;主機方式: 檢查USB設備連接狀態
; 輸出: 狀態( USB_INT_CONNECT或USB_INT_DISCONNECT或USB_INT_USB_READY, 其它值說明操作未完成 )

CMD_ABORT_NAK		EQU     17H							;主機方式: 放棄當前NAK的重試
;
CMD_CLR_STALL		EQU     41H							;主機方式: 控制傳輸-清除端點錯誤
; 輸入: 端點號
; 輸出中斷

CMD_SET_ADDRESS		EQU     45H							;主機方式: 控制傳輸-設置USB地址
; 輸入: 地址值
; 輸出中斷

CMD_GET_DESCR		EQU     46H							;主機方式: 控制傳輸-獲取描述符
; 輸入: 描述符類型
; 輸出中斷

CMD_SET_CONFIG		EQU     49H							;主機方式: 控制傳輸-設置USB配置
; 輸入: 配置值
; 輸出中斷

CMD_AUTO_SETUP		EQU     4DH							;主機方式: 自動配置USB設備
; 輸出中斷

CMD_ISSUE_TKN_X		EQU     4EH							;主機方式: 發出同步令牌, 執行事務, 該命令可代替 CMD_SET_ENDP6/CMD_SET_ENDP7 + CMD_ISSUE_TOKEN
; 輸入: 同步標志, 事務屬性
;           同步標志的位7為主機端點IN的同步觸發位, 位6為主機端點OUT的同步觸發位, 位5~位0必須為0
;           事務屬性的低4位是令牌, 高4位是端點號
; 輸出中斷

CMD_ISSUE_TOKEN		EQU     4FH							;主機方式: 發出令牌, 執行事務
; 輸入: 事務屬性
;           低4位是令牌, 高4位是端點號
; 輸出中斷

CMD_DISK_BOC_CMD	EQU     50H							;主機方式: 對USB存儲器執行BulkOnly傳輸協議的命令
; 輸出中斷

CMD_DISK_INIT		EQU     51H							;主機方式: 初始化USB存儲器
; 輸出中斷

CMD_DISK_RESET		EQU     52H							;主機方式: 控制傳輸-復位USB存儲器
; 輸出中斷

CMD_DISK_SIZE		EQU     53H							;主機方式: 獲取USB存儲器的容量
; 輸出中斷

CMD_DISK_READ		EQU     54H							;主機方式: 從USB存儲器讀數據塊(以扇區為單位)
; 輸入: LBA扇區地址(總長度32位, 低字節在前), 扇區數(01H~FFH)
; 輸出中斷

CMD_DISK_RD_GO		EQU     55H							;主機方式: 繼續執行USB存儲器的讀操作
; 輸出中斷

CMD_DISK_WRITE		EQU     56H							;主機方式: 向USB存儲器寫數據塊(以扇區為單位)
; 輸入: LBA扇區地址(總長度32位, 低字節在前), 扇區數(01H~FFH)
; 輸出中斷

CMD_DISK_WR_GO		EQU     57H							;主機方式: 繼續執行USB存儲器的寫操作
; 輸出中斷

CMD_DISK_INQUIRY	EQU     58H							;主機方式: 查詢USB存儲器特性
; 輸出中斷

CMD_DISK_READY		EQU     59H							;主機方式: 檢查USB存儲器就緒
; 輸出中斷

CMD_DISK_R_SENSE	EQU     5AH							;主機方式: 檢查USB存儲器錯誤
; 輸出中斷

CMD_DISK_MAX_LUN	EQU     5DH							;主機方式: 控制傳輸-獲取USB存儲器最大邏輯單元號
; 輸出中斷

; *********************************************************************************************************************
; 操作狀態

CMD_RET_SUCCESS		EQU     51H							;命令操作成功
CMD_RET_ABORT		EQU     5FH							;命令操作失敗

; *********************************************************************************************************************
; USB中斷狀態

; 以下狀態代碼為特殊事件中斷, 如果通過CMD_CHK_SUSPEND啟用USB總線掛起檢查, 那么必須處理USB總線掛起和睡眠喚醒的中斷狀態
USB_INT_USB_SUSPEND	EQU     05H							;USB總線掛起事件
USB_INT_WAKE_UP		EQU     06H							;從睡眠中被喚醒事件

; 以下狀態代碼0XH用于USB設備方式
;   內置固件模式下只需要處理: USB_INT_EP1_OUT, USB_INT_EP1_IN, USB_INT_EP2_OUT, USB_INT_EP2_IN
;   位7-位4為0000
;   位3-位2指示當前事務, 00=OUT, 10=IN, 11=SETUP
;   位1-位0指示當前端點, 00=端點0, 01=端點1, 10=端點2, 11=USB總線復位
USB_INT_EP0_SETUP	EQU     0CH							;USB端點0的SETUP
USB_INT_EP0_OUT		EQU     00H							;USB端點0的OUT
USB_INT_EP0_IN		EQU     08H							;USB端點0的IN
USB_INT_EP1_OUT		EQU     01H							;USB端點1的OUT
USB_INT_EP1_IN		EQU     09H							;USB端點1的IN
USB_INT_EP2_OUT		EQU     02H							;USB端點2的OUT
USB_INT_EP2_IN		EQU     0AH							;USB端點2的IN
;USB_INT_BUS_RESET	EQU     0000XX11B					;USB總線復位
USB_INT_BUS_RESET1	EQU     03H							;USB總線復位
USB_INT_BUS_RESET2	EQU     07H							;USB總線復位
USB_INT_BUS_RESET3	EQU     0BH							;USB總線復位
USB_INT_BUS_RESET4	EQU     0FH							;USB總線復位

; 以下狀態代碼2XH-3XH用于USB主機方式的通訊失敗代碼, 僅CH375支持
;   位7-位6為00
;   位5為1
;   位4指示當前接收的數據包是否同步
;   位3-位0指示導致通訊失敗時USB設備的應答: 0010=ACK, 1010=NAK, 1110=STALL, 0011=DATA0, 1011=DATA1, XX00=超時
;USB_INT_RET_ACK	EQU     001X0010B					;錯誤:對于IN事務返回ACK
;USB_INT_RET_NAK	EQU     001X1010B					;錯誤:返回NAK
;USB_INT_RET_STALL	EQU     001X1110B					;錯誤:返回STALL
;USB_INT_RET_DATA0	EQU     001X0011B					;錯誤:對于OUT/SETUP事務返回DATA0
;USB_INT_RET_DATA1	EQU     001X1011B					;錯誤:對于OUT/SETUP事務返回DATA1
;USB_INT_RET_TOUT	EQU     001XXX00B					;錯誤:返回超時
;USB_INT_RET_TOGX	EQU     0010X011B					;錯誤:對于IN事務返回數據不同步
;USB_INT_RET_PID	EQU     001XXXXXB					;錯誤:未定義

; 以下狀態代碼1XH用于USB主機方式的操作狀態代碼, 僅CH375支持

USB_INT_SUCCESS		EQU     14H							;USB事務或者傳輸操作成功
USB_INT_CONNECT		EQU     15H							;檢測到USB設備連接事件
USB_INT_DISCONNECT	EQU     16H							;檢測到USB設備斷開事件
USB_INT_BUF_OVER	EQU     17H							;USB控制傳輸的數據太多, 緩沖區溢出
USB_INT_USB_READY	EQU     18H							;USB設備已經被初始化（已分配USB地址）
USB_INT_DISK_READ	EQU     1DH							;USB存儲器讀數據塊, 請求數據讀出
USB_INT_DISK_WRITE	EQU     1EH							;USB存儲器寫數據塊, 請求數據寫入
USB_INT_DISK_ERR	EQU     1FH							;USB存儲器操作失敗

; *********************************************************************************************************************
; 常用USB定義

; USB的包標識PID, 主機方式可能用到
DEF_USB_PID_NULL	EQU     00H							;保留PID, 未定義
DEF_USB_PID_SOF		EQU     05H
DEF_USB_PID_SETUP	EQU     0DH
DEF_USB_PID_IN		EQU     09H
DEF_USB_PID_OUT		EQU     01H
DEF_USB_PID_ACK		EQU     02H
DEF_USB_PID_NAK		EQU     0AH
DEF_USB_PID_STALL	EQU     0EH
DEF_USB_PID_DATA0	EQU     03H
DEF_USB_PID_DATA1	EQU     0BH
DEF_USB_PID_PRE		EQU     0CH

; USB請求類型, 外置固件模式可能用到
DEF_USB_REQ_READ	EQU     80H							;控制讀操作
DEF_USB_REQ_WRITE	EQU     00H							;控制寫操作
DEF_USB_REQ_TYPE	EQU     60H							;控制請求類型
DEF_USB_REQ_STAND	EQU     00H							;標準請求
DEF_USB_REQ_CLASS	EQU     20H							;設備類請求
DEF_USB_REQ_VENDOR	EQU     40H							;廠商請求
DEF_USB_REQ_RESERVE	EQU     60H							;保留請求

; USB標準設備請求, RequestType的位6位5=00(Standard), 主機方式可能用到
DEF_USB_CLR_FEATURE	EQU     01H
DEF_USB_SET_FEATURE	EQU     03H
DEF_USB_GET_STATUS	EQU     00H
DEF_USB_SET_ADDRESS	EQU     05H
DEF_USB_GET_DESCR	EQU     06H
DEF_USB_SET_DESCR	EQU     07H
DEF_USB_GET_CONFIG	EQU     08H
DEF_USB_SET_CONFIG	EQU     09H
DEF_USB_GET_INTERF	EQU     0AH
DEF_USB_SET_INTERF	EQU     0BH
DEF_USB_SYNC_FRAME	EQU     0CH

; *********************************************************************************************************************