/*
; 单片机内置USB调试固件程序 V1.0
; 用于连接CH372或者CH375的单片机进行简单的调试功能
; 可以用include直接包含到应用系统的主程序中,或者添加到工程项目中
;
; Website: http://winchiphead.com
; Email: [email protected]
; @2004.08
;****************************************************************************
*/
/* MCS-51单片机C语言, KC7.0 */
/* 用于其它类型单片机或者硬件资源不同时, 该程序应该根据需要进行局部修改 */
#include <reg52.h>
#include "CH375INC.H"
#ifdef __CX51__
#ifndef __C51__
#define __C51__ 1
#endif
#endif
typedef unsigned char UINT8;
typedef unsigned short UINT16;
typedef unsigned long UINT32;
#ifdef __C51__
typedef unsigned char idata *PUINT8;
#else
typedef unsigned char *PUINT8;
#endif
#ifdef __C51__
typedef unsigned char xdata *PUINT8X;
#else
typedef unsigned char *PUINT8X;
#endif
#ifdef __C51__
typedef unsigned char code *PUINT8C;
#else
typedef unsigned char *PUINT8C;
#endif
#ifdef __C51__
#pragma NOAREGS
#endif
#ifndef MAX_DATA_SIZE
#define MAX_DATA_SIZE 16 /* 单次命令处理的最大数据长度,有效值是1到56 */
#endif
typedef struct _USB_DOWN_PACKET { /* 下传的数据包结构,用于命令/写数据 */
UINT8 mCommand; /* 命令码,见下面的定义 */
UINT8 mCommandNot; /* 命令码的反码,用于校验下传数据包 */
union {
UINT8 mByte[4]; /* 通用参数 */
UINT16 mWord[2]; /* 通用参数,低字节在前,Little-Endian */
UINT32 mDword; /* 通用参数,低字节在前,Little-Endian */
void *mAddress; /* 读写操作的起始地址,低字节在前,Little-Endian */
} u;
UINT8 mLength; /* 下面的缓冲区的长度,读写操作的字节数 */
UINT8 mBuffer[ MAX_DATA_SIZE ]; /* 数据缓冲区 */
} USB_DOWN_PKT;
typedef struct _USB_UP_PACKET { /* 上传的数据包结构,用于状态/读数据 */
UINT8 mStatus; /* 状态码,见下面的定义 */
UINT8 mCommandNot; /* 命令码的反码,用于校验上传数据包 */
UINT8 mReserved[4];
UINT8 mLength; /* 下面的缓冲区的长度,读操作的字节数 */
UINT8 mBuffer[ MAX_DATA_SIZE ]; /* 数据缓冲区 */
} USB_UP_PKT;
typedef union _USB_DATA_PACKET { /* USB上传或者下传数据缓冲区 */
USB_DOWN_PKT down;
USB_UP_PKT up;
} USB_DATA_PKT;
/* 命令码定义,按位说明
位7为命令类型: 0=实现特定功能, 1=存储器和SFR读写
对于"实现特定功能"命令类型:
位6-位0为定义的具体命令码, 命令码为00H-7FH, 其中: 00H-3FH为通用标准命令, 40H-7FH为与应用系统有关的特定命令
目前版本定义了以下通用标准命令:
00H: 获取调试固件程序的版本,并取消未完成的上传数据块
10H: 获取当前应用系统的版本和说明字符串
对于"存储器和SFR读写"命令类型:
位6为数据传输方向: 0=读操作/上传, 1=写操作/下传
位5-位4为数据读写宽度: 00=以字节为单位/8位, 01=以字为单位/16位, 10=以双字为单位/32位, 11=以位为单位/1位
位1-位0为存储器空间: 00=存取SFR, 01=存取内部RAM, 10=存取外部RAM, 11=存取程序ROM
例如: 命令码80H为读SFR, 命令码83H为读程序ROM, 命令码C1H为写内部RAM, 命令码C2H为写外部RAM
状态码定义: 00H为操作成功, 080H为命令不支持, 0FFH为未定义的错误 */
#define USB_CMD_GET_FW_INFO 0x00
#define USB_CMD_GET_APP_INFO 0x10
#define USB_CMD_MEM_ACCESS 0x80
#define USB_CMD_MEM_DIR_WR 0x40
#define USB_CMD_MEM_WIDTH 0x0C
#define USB_CMD_MEM_W_BYTE 0x00
#define USB_CMD_MEM_W_WORD 0x04
#define USB_CMD_MEM_W_DWORD 0x08
#define USB_CMD_MEM_W_BIT 0x0C
#define USB_CMD_MEM_SPACE 0x03
#define USB_CMD_MEM_S_SFR 0x00
#define USB_CMD_MEM_S_IRAM 0x01
#define USB_CMD_MEM_S_XRAM 0x02
#define USB_CMD_MEM_S_ROM 0x03
#define ERR_SUCCESS 0x00
#define ERR_PARAMETER 0x10
#define ERR_UNSUPPORT 0x80
#define ERR_UNDEFINED 0xFF
#define THIS_FIRMWARE_VER 0x10
#define THIS_APP_SYS_VER 0x09
#define THIS_APP_SYS_STR "Example for USB DEBUG MCS51"
#define DELAY_START_VALUE 1 /* 根据单片机的时钟选择初值,20MHz以下为0,30MHz以上为2 */
/*#define TEST_CH375_FIRST 1*/
/*#define MY_USB_VENDOR_ID 0x4348*/
/*#define MY_USB_PRODUCT_ID 0x5537*/
unsigned char volatile xdata CH375_CMD_PORT _at_ 0xBDF1; /* CH375命令端口的I/O地址 */
unsigned char volatile xdata CH375_DAT_PORT _at_ 0xBCF0; /* CH375数据端口的I/O地址 */
/* 延时1微秒,不精确,需要根据硬件实际情况调整 */
void Delay1us( )
{
#if DELAY_START_VALUE != 0
UINT8 i;
for ( i=DELAY_START_VALUE; i!=0; i-- );
#endif
}
/* 延时2微秒,不精确,需要根据硬件实际情况调整 */
void Delay2us( )
{
UINT8 i;
for ( i=DELAY_START_VALUE*2+1; i!=0; i-- );
}
/* 与CH372/CH375有关的基本I/O操作 */
void CH375_WR_CMD_PORT( UINT8 cmd ) { /* 向CH375的命令端口写入命令,周期不小于4uS,如果单片机较快则延时 */
Delay2us();
CH375_CMD_PORT=cmd;
Delay2us();
}
void CH375_WR_DAT_PORT( UINT8 dat ) { /* 向CH375的数据端口写入数据,周期不小于1.5uS,如果单片机较快则延时 */
CH375_DAT_PORT=dat;
Delay1us(); /* 如果是MCS51单片机,因其较慢,所以实际上无需延时 */
}
UINT8 CH375_RD_DAT_PORT( void ) { /* 从CH375的数据端口读出数据,周期不小于1.5uS,如果单片机较快则延时 */
Delay1us(); /* 如果是MCS51单片机,因其较慢,所以实际上无需延时 */
return( CH375_DAT_PORT );
}
/* CH375初始化子程序 */
void CH375_Init( void ) {
UINT8 i;
#ifdef TEST_CH375_FIRST
/* 测试CH375与单片机的物理连接是否正常以及是否正常工作,可选操作,通常不需要 */
UINT8 j;
CH375_WR_CMD_PORT( CMD_CHECK_EXIST ); /* 测试CH375是否正常工作 */
CH375_WR_DAT_PORT( 0x55 ); /* 写入测试数据,任意数据 */
i = ~ 0x55; /* 返回数据应该是测试数据取反 */
if ( CH375_RD_DAT_PORT( ) != i ) { /* CH375不正常 */
for ( i=80; i!=0; i-- ) {
CH375_WR_CMD_PORT( CMD_RESET_ALL ); /* 多次重复发命令,执行硬件复位 */
CH375_RD_DAT_PORT( );
}
CH375_WR_CMD_PORT( 0 );
for ( i=250; i!=0; i-- ) for( j=100; j!=0; j-- ) Delay2us( ); /* 延时50mS */
}
#endif
#ifdef MY_USB_VENDOR_ID
#ifdef MY_USB_PRODUCT_ID
/* 设置外部自定义的USB设备VID和PID,可选操作,不执行该命令则使用默认的VID和PID,
如果设置使用自定义的ID,那么计算机端驱动程序INF安装文件中的"USB\VID_4348&PID_5537"需要进行类似修改 */
CH375_WR_CMD_PORT( CMD_SET_USB_ID ); /* 设置外部自定义的USB设备VID和PID,可选操作 */
CH375_WR_DAT_PORT( (UINT8)MY_USB_VENDOR_ID ); /* 写入厂商ID的低字节 */
CH375_WR_DAT_PORT( (UINT8)(MY_USB_VENDOR_ID>>8) ); /* 写入厂商ID的高字节 */
CH375_WR_DAT_PORT( (UINT8)MY_USB_PRODUCT_ID ); /* 写入产品ID的低字节 */
CH375_WR_DAT_PORT( (UINT8)(MY_USB_PRODUCT_ID>>8) ); /* 写入产品ID的高字节 */
#endif
#endif
/* 设置USB工作模式, 必要操作 */
CH375_WR_CMD_PORT( CMD_SET_USB_MODE );
CH375_WR_DAT_PORT( 2 ); /* 设置为使用内置固件的USB设备方式 */
for ( i=100; i!=0; i-- ) if ( CH375_RD_DAT_PORT( ) == CMD_RET_SUCCESS ) break; /* 等待操作成功,通常需要等待10uS-20uS */
/* if ( i == 0 ) { CH372/CH375芯片内部或者物理连接存在硬件错误 }; */
/* 下面启用USB中断,CH375的INT#引脚可以连接到单片机的中断引脚,中断为低电平有效或者下降沿有效,
如果不使用中断,那么也可以用查询方式,由单片机程序查询CH375的INT#引脚为低电平 */
IT0 = 0; /* 置外部信号为低电平触发 */
IE0 = 0; /* 清中断标志 */
EX0 = 1; /* 允许CH375中断,假定CH375的INT#引脚连接到单片机的INT0 */
}
/* CH375中断服务程序,假定CH375的INT#引脚连接到单片机的INT0,使用寄存器组1 */
void mCH375Interrupt( void ) interrupt 0 using 1 {
UINT8 cnt;
UINT8 dat;
PUINT8 buf;
PUINT8C str;
USB_DATA_PKT udp;
#define IntStatus dat /* 节约一个变量存储单元 */
CH375_WR_CMD_PORT( CMD_GET_STATUS ); /* 获取中断状态并取消中断请求 */
IntStatus = CH375_RD_DAT_PORT( ); /* 获取中断状态 */
/* IE0 = 0; 清中断标志,与单片机硬件有关,对应于INT0中断 */
if ( IntStatus == USB_INT_EP2_OUT ) { /* 批量端点下传成功,接收到命令包 */
CH375_WR_CMD_PORT( CMD_RD_USB_DATA ); /* 从当前USB中断的端点缓冲区读取数据块,并释放缓冲区 */
cnt = CH375_RD_DAT_PORT( ); /* 首先读取后续数据长度 */
if ( cnt == 0 ) { /* 长度为0,没有数据,在某些应用中也可以将长度0定义为一种特殊命令 */
CH375_WR_CMD_PORT( CMD_SET_ENDP7 ); /* 设置USB端点2的IN,也就是批量上传端点 */
CH375_WR_DAT_PORT( 0x0E ); /* 同步触发位不变,设置USB端点2的I