1、 HPS GPIO原理
1、功能方块图
linux内核是通过Linux内核memory-mapped device驱动访问GPIO控制器的寄存器而控制HPS端用户的LED和KEY的。memory-mapped device驱动允许应用程序访问系统所有外设寄存器物理地址空间，包括GPIO控制器物理地址。GPIO 控制器的行为通过器寄存器来控制。应用程序通过内存映射设备驱动访问GPIO1控制器的寄存器。工程方块图如下：
2、GPIO接口图
HPS 提供了三个通用 I/O(GPIO)接口模块。 下图 是 GPIO 接口的方块图（图片截至DE1-SoC_v.3.1.3_HWrevC_revD_SystemCDUserManual）。GPIO[28..0]被 GPIO0 控制器控制;GPIO[57..29]被 GPIO1 控制器控制；GPIO[70..58]和input-onlyGPI[13..0]被 GPIO2 控制器控制。
3、GPIO寄存器组
I/O 组引脚的行为是由 GPIO 控制器中对应的寄存器组所控制(参考Cyclone V系列中文手册第三卷22通用IO接口）。在这个例程中，只使用了 GPIO 控制器的三种 32-bit 寄存器：
gpio_swporta_ddr: 配置 IO 引脚方向
gpio_swporta_dr: 写数据到输出引脚
gpio_ext_porta: 从输入引脚读数据
对于LED 控制，我们通过 gpio_swporta_ddr 寄存器配置 LED 引脚为输出引脚并且通过gpio_swporta_dr 寄存器控制其输出高低电平。在 gpio_swporta_ddr 寄存器中，32bitsdata 的第一位（影响最小的位，LSB） 控制相应 GPIO 控制器的第一个 I/O 引脚的方向，第二位控制相应 GPIO 控制器第 2 个 I/O 引脚的方向，以此类推。在寄存器 bit 设定“1”则相应 I/O 方向设定为输出，设定“0”则为输入。
gpio_swporta_dr 寄存器 data bit 和 I/O 的对应关系，和 gpio_swporta_ddr 一样，是最低位对应着 I/O 的最低位。在相应 bit 写入“1”对应 I/O 输出高电平，写入“0”对应 I/O 输出低电平。
用户 KEY 的状态可以通过读取 gpio_ext_porta 寄存器来查询。寄存器 data bit 和 I/O的对应关系，和 gpio_swporta_ddr 一样，是最低位对应着 I/O 的最低位。寄存器 bit读值"1"说明相应 IO 输入状态为高电平，读值"0"则是低电平。
4、 GPIO 寄存器地址映射
如图所示（图片截至Cyclone V系列中文手册），HPS 外设映射到 HPS 基地址 0xFC000000 上，共 64MB 的寻址空间。GPIO0控制器的寄存器映射到基地址 0xFF708000 共 4KB 寻址空间，GPIO2 控制器映射到基地址 0xFF70A000 共 4KB 寻址空间。
5、 软件API（软件程序可以直接从de1_soc_trainingde1_soc_traininglabSWde1_soc_sw_lab2中找到，但这里还是做一个简要介绍以及不同版本的一些问题）
用户需要通过如下API访问GPIO控制器的寄存器：
- open：打开内存映射设备驱动。
- mmap：映射物理地址到用户空间。
- alt_read_word:从指定寄存器读取一个值。
- alt_write_word:写一个值到指定寄存器。
- munmap：清除内存映射。
同样可以通过宏指令来访问寄存器：
- alt_setbits_word:设定指定寄存器的指定位为1.
- alt_clrbits_wod:设定指定寄存器的指定位位0.
包含以上API的头文件为：
#include <stdio.h> #include <unistd.h> #include <fcntl.h> #include <sys/mman.h> #include "hwlib.h" #include "socal/socal.h" #include "socal/hps.h" #include "socal/alt_gpio.h"
6、LED和KEY控制
可以在DE1-SoC_v.3.1.3_HWrevC_revD_SystemCDSchematic中查看开发板原理图知道，HPS_GPIO54和HPS_GPIO53分别连接的是HPS_KEY 和HPS_LED.如下图所示：
这两个引脚都是被 GPIO1 控制器控制，同样它还控制着HPS_GPIO29~HPS_GPIO57。
下图是gpio_swporta_ddr寄存器，bit-0 控制着 HPS_GPIO29 的方向。bit-24 控制着 HPS_GPIO53 的方向，这个引脚连接着 HPS_LED；bit-25 控制HPS_GPIO54 的方向，这个引脚连接 HPS_KEY。其它引脚以此类推。总言之，GPIO1 控制器的寄存器 gpio_swporta_ddr 的 bit-24,bit-25 控制 HPS_LED,HPS_KEY 的方向。相似的，HPS_LED 的输出状态是通过 GPIO1 控制器的 gpio_swporta_dr 的 bit-24 控制的。HPS_KEY 的状态则可以通过查询读取 GPIO1 控制器的 gpio_ext_porta 寄存器的 bit-25。
下面是相关寄存器定义和配置程序：
#define USER_IO_DIR (0x01000000) #define BIT_LED (0x01000000) #define BUTTON_MASK (0x02000000)
下列程序用来配置LED为输出引脚：
alt_setbits_word( ( virtual_base + ( ( uint32_t )( ALT_GPIO1_SWPORTA_DDR_ADDR ) & ( uint32_t )( HW_REGS_MASK ) ) ), USER_IO_DIR );
下列语句可以点亮LED
alt_setbits_word( ( virtual_base +( ( uint32_t )( ALT_GPIO1_SWPORTA_DR_ADDR ) &( uint32_t )( HW_REGS_MASK ) ) ), BIT_LED );
如下语句可以用来读取
alt_read_word( ( virtual_base + ( ( uint32_t )( ALT_GPIO1_EXT_PORTA_ADDR ) & ( uint32_t )( HW_REGS_MASK ) ) ) );
7、创建工程文件
整个main.c函数文本如下：
#include <stdio.h>
#include <unistd.h>
#include <fcntl.h>
#include <sys/mman.h>
#include "hwlib.h"
#include "socal/socal.h"
#include "socal/hps.h"
#include "socal/alt_gpio.h"
#define HW_REGS_BASE ( ALT_STM_OFST )
#define HW_REGS_SPAN ( 0x04000000 )
#define HW_REGS_MASK ( HW_REGS_SPAN - 1 )
#define USER_IO_DIR (0x01000000)
#define BIT_LED (0x01000000)
#define BUTTON_MASK (0x02000000)
int main(int argc, char **argv) {
void *virtual_base;
int fd;
uint32_t scan_input;
int i;
// map the address space for the LED registers into user space so we can interact with them.
// we'll actually map in the entire CSR span of the HPS since we want to access various registers within that span
if( ( fd = open( "/dev/mem", ( O_RDWR | O_SYNC ) ) ) == -1 ) {
printf( "ERROR: could not open "/dev/mem"...
" );
return( 1 );
}
virtual_base = mmap( NULL, HW_REGS_SPAN, ( PROT_READ | PROT_WRITE ), MAP_SHARED, fd, HW_REGS_BASE );
if( virtual_base == MAP_FAILED ) {
printf( "ERROR: mmap() failed...
" );
close( fd );
return( 1 );
}
// initialize the pio controller
// led: set the direction of the HPS GPIO1 bits attached to LEDs to output
alt_setbits_word( ( virtual_base + ( ( uint32_t )( ALT_GPIO1_SWPORTA_DDR_ADDR ) & ( uint32_t )( HW_REGS_MASK ) ) ), USER_IO_DIR );
printf("led test
");
printf("the led flash 2 times
");
for(i=0;i<2;i++)
{
alt_setbits_word( ( virtual_base + ( ( uint32_t )( ALT_GPIO1_SWPORTA_DR_ADDR ) & ( uint32_t )( HW_REGS_MASK ) ) ), BIT_LED );
usleep(500*1000);
alt_clrbits_word( ( virtual_base + ( ( uint32_t )( ALT_GPIO1_SWPORTA_DR_ADDR ) & ( uint32_t )( HW_REGS_MASK ) ) ), BIT_LED );
usleep(500*1000);
}
printf("user key test
");
printf("press key to control led
");
while(1){
scan_input = alt_read_word( ( virtual_base + ( ( uint32_t )( ALT_GPIO1_EXT_PORTA_ADDR ) & ( uint32_t )( HW_REGS_MASK ) ) ) );
//usleep(1000*1000);
if(~scan_input&BUTTON_MASK)
alt_setbits_word( ( virtual_base + ( ( uint32_t )( ALT_GPIO1_SWPORTA_DR_ADDR ) & ( uint32_t )( HW_REGS_MASK ) ) ), BIT_LED );
else alt_clrbits_word( ( virtual_base + ( ( uint32_t )( ALT_GPIO1_SWPORTA_DR_ADDR ) & ( uint32_t )( HW_REGS_MASK ) ) ), BIT_LED );
}
// clean up our memory mapping and exit
if( munmap( virtual_base, HW_REGS_SPAN ) != 0 ) {
printf( "ERROR: munmap() failed...
" );
close( fd );
return( 1 );
}
close( fd );
return( 0 );
}
8、创建Makefile文件
Makefile文件如下：
#
TARGET = hps_gpio
#
CROSS_COMPILE = arm-linux-gnueabihf-
CFLAGS = -g -Wall -I ${SOCEDS_DEST_ROOT}/ip/altera/hps/altera_hps/hwlib/include
LDFLAGS = -g -Wall
CC = $(CROSS_COMPILE)gcc
ARCH= arm
build: $(TARGET)
$(TARGET): main.o
$(CC) $(LDFLAGS) $^ -o $@
%.o : %.c
$(CC) $(CFLAGS) -c $< -o $@
.PHONY: clean
clean:
rm -f $(TARGET) *.a *.o *~
9、编译文件
定好编译规则后，打开Altera Embedded Command Shell 工具，cd到工程目录下：
编译过程中发现两个错误。这都是因为quartus版本不同而造成的。
错误1：
教材用的是13版本的quartus，这里我用到的是17.0的quartus II， make时提示在hwlib.h之前确认SOC—a10还是SOC—AV—cv？
解决方法：
在EDS的安装路径下，找到对应的hwlib.h，加上#define soc_cv_av（因为这里用到的是cyclone V).
增加定义后，修改再次make 会发现第一个错误已经解决了。
错误2：
为了解决错误2，这里又重新安装了一次13.0版本的EDS，对照后发现EDS可以顺利编译，到makefile路径下观察可以发现。
同样的，到达我安装的17.0版本下的路径观察却发现
果然，点进socal_cv_av可以发现原来一样的socal文件夹：
解决方法：
问题找到了，解决方法也就有了，最简单的方法是，将soc_cv_av以及socal下的所有文件复制到include界面下
并修改头文件为：
#include <stdio.h> #include <unistd.h> #include <fcntl.h> #include <sys/mman.h> #include "hwlib.h" #include "socal.h" #include "hps.h" #include "alt_gpio.h"
即可， 此时再重新编译即可得到可执行文件。
10、运行结果
通过SSH或者U盘将文件传送到FPGA后（嵌入式系统软件设计），再串口端修改文件可执行属性如下：
运行程序后，可以看到FPGA闪烁两次，然后熄灭，按下HPS_KEY按键，LED会点亮。ctrl+c终止程序后，现象消失。
