【连载】【FPGA黑金开发板】NIOSII那些事儿--USB设备模式（十九）

声明：本文为原创作品，版权归本博文作者所有，如需转载，请注明出处http://www.cnblogs.com/kingst/

简介

这一节，我们来讲讲黑金开发板USB部分的内容。黑金开发板上使用的USB芯片是南京沁恒公司的CH376，它支持USB 设备（DEVICE）方式和USB(HOST) 主机方式，并且内置了USB 通讯协议的基本固件，内置了处理Mass-Storage海量存储设备的专用通讯协议的固件，内置了SD 卡的通讯接口固件，内置了FAT16和FAT32 以及FAT12 文件系统的管理固件，支持常用的USB 存储设备（包括U 盘/USB 硬盘/USB 闪存盘/USB 读卡器）和SD 卡（包括标准容量SD 卡和高容量HC-SD 卡以及协议兼容的MMC 卡和TF 卡）。

由于芯片内部集成了USB通讯协议的基本固件,因此，免去了我们自己编写USB通讯协议的麻烦了。不仅如此，它还集成了文件系统的管理固件,那么，我们不就可以直接读取U盘中的内容了？事实就是这样的，真的方便了很多哦。下面我们就来看看这款芯片到底有多好用吧。

硬件开发

首先，我们看看这部分电路，如下图所示，我们采用的是8位总线模式，电路结构非常简单，与FPGA相连的一共有12根线，其中8根数据线，1根中断线，3根控制线。

下面，我们就在软核中添加USB部分的模块，其实都是通过PIO模块控制的。添加后如下图所示，其中USB_DB为8位输出PIO；USB_WR，USB_RD，USB_A0都是1位输出PIO。

而USB_nINT为输入PIO，而且电平中断，如下图设置，

都设置好以后，自动分配地址，中断，接下来就可以编译了。

编译好以后，回到Quartus界面，整理好以后，如下图所示，要记得USB_DB数据线是双向的，因此，一定要用分配bidir双向引脚，而不要用output。

下面是中断引脚部分，由于我们是低电平中断，而NIOS电平中断只支持高电平中断，所以我们需要加一个非门，如下图示所示

都设置好以后，我们就可以分配引脚了，TCL脚本有关USB部分的代码如下

#------------------------USB---------------------------------------#
set_location_assignment	PIN_117	-to	USB_DB[0]
set_location_assignment	PIN_118	-to	USB_DB[1]
set_location_assignment	PIN_127	-to	USB_DB[2]
set_location_assignment	PIN_128	-to	USB_DB[3]
set_location_assignment	PIN_133	-to	USB_DB[4]
set_location_assignment	PIN_134	-to	USB_DB[5]
set_location_assignment	PIN_135	-to	USB_DB[6]
set_location_assignment	PIN_137	-to	USB_DB[7]

set_location_assignment	PIN_113	-to	USB_A0
set_location_assignment	PIN_115	-to	USB_WR
set_location_assignment	PIN_116	-to	USB_nINT
set_location_assignment	PIN_114	-to	USB_RD

分配好引脚以后，大家就可以编译了。

软件开发

USB分主机模式和设备模式，这两种模式硬件部分是相同的，只是在软件编程方面有些不同。这一节，我们来讲设备模式，也就是开发板通过USB接口与主机（电脑）相连，实现开发板与电脑的数据通信。

我们首先打开NIOS II 9.0 IDE软件，还是老过程，首先编译一遍，Ctril+b。编译成功以后，我们在system.h中会看到USB部分的代码，如下表所示

#define USB_DB_NAME "/dev/USB_DB"
#define USB_DB_TYPE "altera_avalon_pio"
#define USB_DB_BASE 0x00001840
......
#define USB_NINT_NAME "/dev/USB_nINT"
#define USB_NINT_TYPE "altera_avalon_pio"
#define USB_NINT_BASE 0x00001850
......
#define USB_WR_NAME "/dev/USB_WR"
#define USB_WR_TYPE "altera_avalon_pio"
#define USB_WR_BASE 0x00001860
......
#define USB_RD_NAME "/dev/USB_RD"
#define USB_RD_TYPE "altera_avalon_pio"
#define USB_RD_BASE 0x00001870
......	
#define USB_A0_NAME "/dev/USB_A0"
#define USB_A0_TYPE "altera_avalon_pio"
#define USB_A0_BASE 0x00001880
......

下面，我们来添加USB部分的代码。

首先，我们建立一个在inc下面建立一个usb.h文件，内容如下

#ifndef __usb_h__
#define __usb_h__
//-----------------Include files-------------------------//
#include "system.h"
//----------------- CH375 DEFINE-------------------------//
//下面部分是USB寄存器地址，这部分定义可以看CH376的芯片手册
#define USB_HOST    0X06
#define USB_DEVICE  0x02
#define USB_DISABLE 0X00

#define RESET_ALL   0X05
#define CHECK_EXIST 0X06
#define SET_USB_ID  0X12
#define SET_USB_MODE    0X15
#define GET_STATUS  0X22
#define UNLOCK_USB  0X23
#define RD_USB_DATA 0X28
#define WR_USB_DATA5    0X2A
#define WR_USB_DATA7    0X2B
#define GET_IC_VER  0X01
#define ENTER_SLEEP 0X03
#define CHK_SUSPEND 0X0B
#define RD_USB_DATA0    0X27

#define RET_SUCCESS 0X51
#define RET_ABORT   0X5B

#define INT_EP2_OUT 0x02
#define INT_EP2_IN  0x0a

//host
#define DISK_READ   0X54
#define DISK_RD_GO  0X55
#define DISK_READY  0X59
#define DISK_INIT   0X51
//status
#define USB_INT_CONNECT 0x15
#define USB_INT_DISCONNECT 0X16
#define USB_INT_SUCCESS 0X14
#define USB_INT_DISK_READ   0X1D
//-----------------bus define----------------------------//
/*下面是USB的接口部分定义，这次我没有像以往那样定义结构体，是为了让大家感受一下各种形式的编程。大家要注意PIO_USB_DB_DIR的定义，通过以前的讲解，不知道大家是否理解，它是USB数据线的方向控制寄存器的定义，知道为什么要+4么，大家自己考虑吧，不明白就看看附录中的有关PIO问题解析部分内容吧*/
#define PIO_USB_DB      *(volatile unsigned long int *)USB_DB_BASE
#define PIO_USB_WR      *(volatile unsigned long int *)USB_WR_BASE
#define PIO_USB_RD      *(volatile unsigned long int *)USB_RD_BASE
#define PIO_USB_A0      *(volatile unsigned long int *)USB_A0_BASE
#define PIO_USB_INT     *(volatile unsigned long int *)USB_INT_BASE
#define PIO_USB_DB_DIR  *(volatile unsigned long int *)(USB_DB_BASE+4)

#define VID 0X0FFE
#define PID 0X1000

typedef struct{
	char receive_buffer[200];
    int send_ok_flag;
	int receive_ok_flag;
}USB_T;
//-----------------Extern function------------------------//

extern USB_T usb;
extern int initialize_usb(void);
extern int set_usb_mode(unsigned char);
extern int send_string_to_usb(char *str,int str_len);
extern void write_command_to_usb(unsigned char command);
extern void write_data_to_usb(unsigned char data);

#endif //__usb_h__

接下来，我们看看CH376的时序图，如下图所示

我们就根据上面的时序图编写驱动部分，在driver中建立一个usb.c文件，内容如下表所示

/*
 * ==================================================================
 *       Filename:  usb.c
 *   Description:  
 *        Version:  1.0.0
 *        Created:  2010.4.16
 *       Revision:  none
 *       Compiler:  Nios II 9.0 IDE
 *         Author:  马瑞 (AVIC)
 *			Email:  avic633@gmail.com  
 * =================================================================
 */
//-----------------Include files-------------------------//
#include "../inc/usb.h"
#include "altera_avalon_pio_regs.h"
#include "sys/alt_irq.h"
#include <unistd.h>
#include <stdio.h>
//-----------------Function Prototype--------------------//
void write_command_to_usb(unsigned char command);
void write_data_to_usb(unsigned char data);
unsigned char read_data_from_usb(void);
void delay(void);
//-----------------Variable------------------------------//

USB_T usb;
//-----------------Function------------------------------//

/* 
 * ===  FUNCTION  ===================================================
 *          Name:  irq_usb
 * Description:   中断函数
 * =================================================================
 */
void irq_usb(void)
{
	unsigned int i;
	unsigned char interrupt_status,data_len;
	//  static int times=0;

	write_command_to_usb(GET_STATUS);

	interrupt_status=read_data_from_usb();

	switch(interrupt_status){
		//Device
		case INT_EP2_OUT:

			write_command_to_usb(RD_USB_DATA);
			data_len=read_data_from_usb();

			for(i=0;i<data_len;i++)
                            usb.receive_buffer[i]=read_data_from_usb();
			usb.receive_buffer[i]='\0';

			usb.receive_ok_flag=1;

			break;

		case INT_EP2_IN:
			write_command_to_usb(UNLOCK_USB);
			usb.send_ok_flag=1;
			break;

		default :break;

	}

	IOWR_ALTERA_AVALON_PIO_EDGE_CAP(USB_NINT_BASE,0x00);
}

/* 
 * ===  FUNCTION  ===================================================
 *          Name:  send_string_to_usb
 *  Description:  发送字符串
 * =================================================================
 */
int send_string_to_usb(char *str,int str_len)
{
	int i;

	write_command_to_usb(WR_USB_DATA7);
	write_data_to_usb(str_len);

	for(i=0;i<str_len;i++)write_data_to_usb(str[i]);

	return 0;
}
/* 
 * ===  FUNCTION  ===================================================
 *          Name:  initialize_usb
 *  Description:  初始化USB
 * =================================================================
 */
int initialize_usb(void)
{
	PIO_USB_RD=1;
	PIO_USB_WR=1;
	PIO_USB_A0=1;
	usb.receive_ok_flag=0;

	// enable the io interrupt
	IOWR_ALTERA_AVALON_PIO_IRQ_MASK(USB_NINT_BASE,1);
	IOWR_ALTERA_AVALON_PIO_EDGE_CAP(USB_NINT_BASE,0);

	alt_irq_register(USB_NINT_IRQ,NULL,irq_usb);

	set_usb_mode(USB_DEVICE);

	return 0;
}
/* 
 * ===  FUNCTION  ===================================================
 *           Name:  usb_usb_mode
 *  Description:  设置USB模式
 * =================================================================
 */
int set_usb_mode(unsigned char type)
{
	write_command_to_usb(SET_USB_MODE);
	write_data_to_usb(type);
	read_data_from_usb();

	if((read_data_from_usb())==0x51)return 0;
	else return -1;

}
/* 
 * ===  FUNCTION  ===================================================
 *          Name:   write_command_to_usb
 *  Description:   写命令
 * =================================================================
 */
void write_command_to_usb(unsigned char command)
{
	//A0
	PIO_USB_A0=1;

	//DB DIR output
	PIO_USB_DB_DIR=0xff;

	PIO_USB_DB=command;

	PIO_USB_WR=0;
	PIO_USB_WR=1;
}
/* 
 * ===  FUNCTION  ===================================================
 *          Name:  delay
 *  Description:  延时
 * =================================================================
 */
void delay(void)
{
	int i;
	for(i=0;i<1000;i++);
}
/* 
 * ===  FUNCTION  ===================================================
 *           Name:  write_data_to_usb
 *  Description:  写数据
 * =================================================================
 */
void write_data_to_usb(unsigned char data)
{
	//A0
	PIO_USB_A0=0;

	//DB DIR output
	PIO_USB_DB_DIR=0xff;

	PIO_USB_DB=data;

	usleep(20);
	PIO_USB_WR=0;
	delay();
	usleep(20);
	PIO_USB_WR=1
}
/* 
 * ===  FUNCTION  ===================================================
 *          Name:  read_data_from_usb
 *  Description:  读数据
 * =================================================================
 */

unsigned char read_data_from_usb(void)
{
	unsigned char data=0;

	//A0
	PIO_USB_A0=0;

	//DB DIR output
	PIO_USB_DB_DIR=0;

	PIO_USB_RD=0;
	delay();
	data=PIO_USB_DB;
	PIO_USB_RD=1;

	return data;
}

编写好驱动以后，我们需要编写主函数测试代码

#include <stdio.h>
#include <unistd.h>
#include "../inc/usb.h"

int main()
{
    unsigned char tmp[] = "Hello USB!\n";

    initialize_usb();

    while(1){ 
        if(usb.receive_ok_flag){
            printf("%s\n",usb.receive_buffer);
            usb.receive_ok_flag = 0;
        }

        send_string_to_usb(tmp,sizeof(tmp));
        usleep(100000);
    }
    return 0;
}

程序都写完了，但工作还没有结束，如果要想调试，我们首先还需要在你的电脑上安装CH376的驱动。

首先，去南京沁恒的网站下载驱动，下载地址是：http://www.wch.cn/download/list.asp?id=66，CH376的驱动跟CH372,CH375是一样的。

双击CH372DRV.EXE，开始安装驱动，如下图所示，点击INSTALL，直接安装就可以了。