C语言方式(mmap)

这里提供接近单片机寄存器操作的一种应用层GPIO操作方式，也封装成库给大家使用。

GPIO 寄存器介绍

在 V3S datasheet 第224页是GPIO控制器的相关介绍。

V3S从有PB/C/E/F/G五个GPIO端口，每个都是32位端口（实际引脚没有引出那么多）,也是32位寄存器。

每个端口由以下几个寄存器组成：

(n=1,2,4,5,6；寄存器基址为0x01C20800)

mmap简介

mmap简单来说就是把一片物理内存空间（或者文件）映射到应用的虚拟内存空间，这样，直接在应用层就能操作CPU的寄存器，类似于单片机的寄存器操作。我们只要封装好寄存器操作的库函数，就能在以后的程序里简单调用了~

详细的mmap介绍可以参考附录的链接。

为了操作寄存器，我们需要用到 /dev/mem 设备，这个设备是是物理内存的全映像，可以用来访问物理内存，一般用法是 open("/dev/mem",O_RDWR|O_SYNC)，然后mmap，接着就可以用mmap的地址来访问物理内存，这实际上就是实现用户空间驱动的一种方法。

#include <sys/mmap.h>
void *mmap(void *start, size_t length, int prot, int flags, int fd, off_t offset);
//start: 映射区的起始地址，0的话由接口自动返回
//length: 映射区的长度
//prot: 内存保护标志，不能与文件的打开模式冲突。以下值可以 或 组合。
    //PROT_EXEC  页内容可以被执行
    //PROT_READ  页内容可以被读取
    //PROT_WRITE  页可以被写入
    //PROT_NONE  页不可访问
//flag: 指定映射对象的类型，是否可以共享等。
//fd: 文件描述符
//oft: 被映射对象内容的起点偏移。映射物理内存的话，就是物理内存地址。**必须页对齐。**

int munmap(void *start, size_t length);
//start: 前面获得的地址
//length: 映射区的大小。

int msync ( void * addr , size_t len, int flags) 
//一般说来，进程在映射空间的对共享内容的改变并不直接写回到磁盘文件中，往往在调用munmap（）后才执行该操作。可以通过调用msync()实现磁盘上文件内容与共享内存区的内容一致。 
//但是对于映射物理内存来说是直接作用的。

代码片段：

#include <sys/mmap.h>

char dev_name[] = "/dev/mem"; 
GPIO_REGISTER  *gpio_base; 
fd  =  open(dev_name,O_RDWR); 
if(fd<0){ 
    printf("open %s is error\n",dev_name); 
    return -1 ; 
} 
gpio_base = (GPIO_REGISTER *)mmap( 0, 0x32, PROT_READ | PROT_WRITE, MAP_SHARED,fd, 0x40060000 );
if(gpio_base == NULL){ 
    printf("gpio base mmap is error\n"); 
    close(fd); 
    return -1; 
} 
//后面就是对寄存器操作了
//结束后解除映射
munmap(gpio_base, 0x32);

我基于mmap写了个应用层调试寄存器的小程序，reg-dbger,在github上可以下载使用。

使用方法为：

reg-dbger r reg_addr                        //读寄存器
reg-dbger rb reg_addr bit_oft bit_cnt       //读寄存器的bit_oft开始的bit_cnt位
reg-dbger w reg_addr value                  //写寄存器
reg-dbger wb reg_addr bit_oft bit_cnt value //写寄存器的bit_oft开始的bit_cnt位
reg-dbger dump reg_addr cnt                 //批量dump出cnt个寄存器值

比如操作gpio寄存器，点亮熄灭Zero上的绿色LED：

# PG0
# 配置寄存器 0x01C20800+6*0x24+0=1C208D8
# 数据寄存器 0x01C20800+6*0x24+0x10 = 1C208E8
reg-dbger r 1C208D8 
reg-dbger r 1C208E8
reg-dbger wb 1C208D8 0 3 1    #输出状态
reg-dbger wb 1C208E8 0 1 0     #输出0，点亮

同样基于mmap写了个应用层操作GPIO的小程序，lpi-gpio,在github上可以下载使用。

使用方法为：

lpi-gpio set PG0 out/in 0/1/2   //设置为输出的话,0低电平，1,2高电平；设置为输入，0下拉，1上拉，2浮空。
lpi-gpio r PG0 
lpi-gpio w PG0 0/1
lpi-gpio pwm PG0 100 200    //PG0 pwm输出，两个参数分别表示高低电平的微秒数（>60us）
lpi-gpio test PG0   //测试PG0用函数翻转IO的最大速率，结果为1.85MHz
lpi-gpio tfast PG0  //测试PG0用软件翻转IO的最大速率，结果为10MHz

为方便在C语言里调用，我生成了gpio操作的动态库 libgpio.so，大家可以在c程序中调用。

这里是一个简单的使用例程：

#include "lpi_gpio.h"
#define USLEEP_T 61

int main()
{
        lpi_gpio_initlib();
        lpi_gpio_init(6, 0, 1, 0);
        while(1)
        {   //generate 1KHz PWM
                lpi_gpio_w(6, 0, 1);
                usleep(500-USLEEP_T);
                lpi_gpio_w(6, 0, 0);
                usleep(500-USLEEP_T);
        }
        lpi_gpio_deinitlib();
        return;
}

//gcc -fPIC -shared -o libgpio.so lib_gpio.c    //编译生成动态库
gcc test_gpio.c -L. -lgpio -o test_gpio     //编译生成应用程序
LD_LIBRARY_PATH=. ./test_gpio   //运行应用程序，手工指定动态库位置
//or add libgpio.so to /etc/ld.so.conf, ldconfig    

附录

mmap参考资料：http://blog.chinaunix.net/uid-26669729-id-3077015.html

linux动态库：http://www.cnblogs.com/jiqingwu/p/linux_dynamic_lib_create.html

linux静态库：http://www.cnblogs.com/jiqingwu/p/4325382.html