ioremap()函数解析

ioremap()函数解析

～～～为了使软件访问I/O内存,必须为设备分配虚拟地址～～～

几乎每一种外设都是通过被读写设备上的相关寄存器，去达到想要的功能和操作。

常见的三大寄存器：控制寄存器、状态寄存器、数据寄存器。

外设的寄存器通常被连续的编址，根据CPU体系结构不同，CPU对IO端口的编址方式有两种：

• x86: I/O 映射方式（I/O-mapped）
  X86处理器为外设专门实现了一个单独的地址空间，称为"I/O地址空间"或者"I/O端口空间"，CPU通过专门的I/O指令（如X86的IN和OUT指令）来访问这一空间中的地址单元。

• arm: 内存映射方式（Memory-mapped）

  RISC指令系统的CPU（如ARM、PowerPC等）通常只实现一个物理地址空间，外设I/O端口成为内存的一部分。此时，CPU可以象访问一个内存单元那样访问外设I/O端口，而不需要设立专门的外设I/O指令。
  但是，这两者在硬件实现上的差异对于软件来说是完全透明的，驱动程序开发人员可以将内存映射方式的I/O端口和外设内存统一看作是"I/O内存"资源。
  一般来说，在系统运行时，外设的I/O内存资源的物理地址是已知的，由硬件的设计决定。但是CPU通常并没有为这些已知的外设I/O内存资源的物理地址预定义虚拟地址范围，驱动程序并不能直接通过物理地址访问I/O内存资源，
  而必须将它们映射到核心虚地址空间内（通过页表），然后才能根据映射所得到的核心虚地址范围，通过访内指令访问这些I/O内存资源

1、ioremap函数

ioremap宏定义在asm/io.h内：

#define ioremap(cookie,size) __ioremap(cookie,size,0)

__ioremap函数原型为(arm/mm/ioremap.c)：

void iomem * ioremap(unsigned long phys_addr, size_t size, unsigned long flags);

参数：

phys_addr：要映射的起始的IO地址

size：要映射的空间的大小

flags：要映射的IO空间和权限有关的标志

该函数返回映射后的内核虚拟地址(3G-4G). 接着便可以通过读写该返回的内核虚拟地址，去访问之这段I/O内存资源。

2、iounmap函数

iounmap函数用于取消ioremap（）所做的映射，原型如下：

void iounmap(void * addr);

二、 ioremap() 相关函数解析

    在将I/O内存资源的物理地址映射成核心虚地址后，理论上讲我们就可以象读写RAM那样直接读写I/O内存资源了。为了保证驱动程序的跨平台的可移植性，我们应该使用Linux中特定的函数来访问I/O内存资源，而不应该通过指向核心虚地址的指针来访问。如在x86平台上，读写I/O的函数如下所示

读写I/O的函数如下所示：

a – writel()

writel()往内存映射的 I/O 空间上写数据，wirtel() I/O 上写入 32 位数据 (4字节)。

原型：void writel (unsigned char data , unsigned int addr )

b – readl()

readl() 从内存映射的 I/O 空间上读数据,readl 从 I/O 读取 32 位数据 ( 4 字节 )。

原型：unsigned char readl (unsigned int addr )

 1 #define readb __raw_readb
 2 #define readw(addr) __le16_to_cpu(__raw_readw(addr))
 3 #define readl(addr) __le32_to_cpu(__raw_readl(addr))
 4 #ifndef __raw_readb
 5 static inline u8 __raw_readb(const volatile void __iomem *addr)
 6 {
 7     return *(const volatile u8 __force *) addr;
 8 }
 9 #endif
10  
11 #ifndef __raw_readw
12 static inline u16 __raw_readw(const volatile void __iomem *addr)
13 {
14     return *(const volatile u16 __force *) addr;
15 }
16 #endif
17  
18 #ifndef __raw_readl
19 static inline u32 __raw_readl(const volatile void __iomem *addr)
20 {
21     return *(const volatile u32 __force *) addr;
22 }
23 #endif
24  
25 #define writeb __raw_writeb
26 #define writew(b,addr) __raw_writew(__cpu_to_le16(b),addr)
27 #define writel(b,addr) __raw_writel(__cpu_to_le32(b),addr)

最后，我们要特别强调驱动程序中mmap函数的实现方法。用mmap映射一个设备，意味着使用户空间的一段地址关联到设备内存上，这使得只要程序在分配的地址范围内进行读取或者写入，实际上就是对设备的访问。

笔者在Linux源代码中进行包含"ioremap"文本的搜索，发现真正出现的ioremap的地方相当少。所以笔者追根索源地寻找I/O操作的物理地址转换到虚拟地址的真实所在，发现Linux有替代ioremap的语句，但是这个转换过程却是不可或缺的。

譬如我们再次摘取S3C2410这个ARM芯片RTC（实时钟）驱动中的一小段：

static void get_rtc_time(int alm, struct rtc_time *rtc_tm)

{

spin_lock_irq(&rtc_lock);

if (alm == 1) {

rtc_tm->tm_year = (unsigned char)ALMYEAR & Msk_RTCYEAR;

rtc_tm->tm_mon = (unsigned char)ALMMON & Msk_RTCMON;

rtc_tm->tm_mday = (unsigned char)ALMDAY & Msk_RTCDAY;

rtc_tm->tm_hour = (unsigned char)ALMHOUR & Msk_RTCHOUR;

rtc_tm->tm_min = (unsigned char)ALMMIN & Msk_RTCMIN;

rtc_tm->tm_sec = (unsigned char)ALMSEC & Msk_RTCSEC;

}

else {

read_rtc_bcd_time:

rtc_tm->tm_year = (unsigned char)BCDYEAR & Msk_RTCYEAR;

rtc_tm->tm_mon = (unsigned char)BCDMON & Msk_RTCMON;

rtc_tm->tm_mday = (unsigned char)BCDDAY & Msk_RTCDAY;

rtc_tm->tm_hour = (unsigned char)BCDHOUR & Msk_RTCHOUR;

rtc_tm->tm_min = (unsigned char)BCDMIN & Msk_RTCMIN;

rtc_tm->tm_sec = (unsigned char)BCDSEC & Msk_RTCSEC;

if (rtc_tm->tm_sec == 0) {

/* Re-read all BCD registers in case of BCDSEC is 0.

See RTC section at the manual for more info. */

goto read_rtc_bcd_time;

}

}

spin_unlock_irq(&rtc_lock);

BCD_TO_BIN(rtc_tm->tm_year);

BCD_TO_BIN(rtc_tm->tm_mon);

BCD_TO_BIN(rtc_tm->tm_mday);

BCD_TO_BIN(rtc_tm->tm_hour);

BCD_TO_BIN(rtc_tm->tm_min);

BCD_TO_BIN(rtc_tm->tm_sec);

/* The epoch of tm_year is 1900 */

rtc_tm->tm_year += RTC_LEAP_YEAR - 1900;

/* tm_mon starts at 0, but rtc month starts at 1 */

rtc_tm->tm_mon–;

}

I/O操作似乎就是对ALMYEAR、ALMMON、ALMDAY定义的寄存器进行操作，那这些宏究竟定义为什么呢？

#define ALMDAY bRTC(0x60)

#define ALMMON bRTC(0x64)

#define ALMYEAR bRTC(0x68)

其中借助了宏bRTC，这个宏定义为：

#define bRTC(Nb) __REG(0x57000000 + (Nb))

其中又借助了宏REG，而REG又定义为：

define __REG(x) io_p2v(x)

最后的io_p2v才是真正"玩"虚拟地址和物理地址转换的地方：

#define io_p2v(x) ((x) | 0xa0000000)

与REG对应的有个PREG：

define __PREG(x) io_v2p(x)

与io_p2v对应的有个io_v2p：

#define io_v2p(x) ((x) & ~0xa0000000)

可见有没有出现ioremap是次要的，关键问题是有无虚拟地址和物理地址的转换！

下面的程序在启动的时候保留一段内存，然后使用ioremap将它映射到内核虚拟空间，同时又用remap_page_range映射到用户虚拟空间，这样一来，内核和用户都能访问。如果在内核虚拟地址将这段内存初始化串"abcd"，那么在用户虚拟地址能够读出来：

MODULE_PARM(mem_start, “i”);

MODULE_PARM(mem_size, “i”);

static int mem_start = 101, mem_size = 10;

static char *reserve_virt_addr;

static int major;

int mmapdrv_open(struct inode *inode, struct file *file);

int mmapdrv_release(struct inode *inode, struct file *file);

int mmapdrv_mmap(struct file *file, struct vm_area_struct *vma);

static struct file_operations mmapdrv_fops =

{

owner: THIS_MODULE, mmap: mmapdrv_mmap, open: mmapdrv_open, release:

mmapdrv_release,

};

int init_module(void)

{

if ((major = register_chrdev(0, “mmapdrv”, &mmapdrv_fops)) < 0)

{

printk(“mmapdrv: unable to register character device\n”);

return ( - EIO);

}

printk(“mmap device major = %d\n”, major);

printk(“high memory physical address 0x%ldM\n”, virt_to_phys(high_memory) /

1024 / 1024);

reserve_virt_addr = ioremap(mem_start *1024 * 1024, mem_size *1024 * 1024);

printk(“reserve_virt_addr = 0x%lx\n”, (unsigned long)reserve_virt_addr);

if (reserve_virt_addr)

{

int i;

for (i = 0; i < mem_size *1024 * 1024; i += 4)

{

reserve_virt_addr[i] = ‘a’;

reserve_virt_addr[i + 1] = ‘b’;

reserve_virt_addr[i + 2] = ‘c’;

reserve_virt_addr[i + 3] = ‘d’;

}

}

else

{

unregister_chrdev(major, “mmapdrv”);

return - ENODEV;

}

return 0;

}

/* remove the module */

void cleanup_module(void)

{

if (reserve_virt_addr)

iounmap(reserve_virt_addr);

unregister_chrdev(major, “mmapdrv”);

return ;

}

int mmapdrv_open(struct inode *inode, struct file *file)

{

MOD_INC_USE_COUNT;

return (0);

}

int mmapdrv_release(struct inode *inode, struct file *file)

{

MOD_DEC_USE_COUNT;

return (0);

}

int mmapdrv_mmap(struct file *file, struct vm_area_struct *vma)

{

unsigned long offset = vma->vm_pgoff << PAGE_SHIFT;

unsigned long size = vma->vm_end - vma->vm_start;

if (size > mem_size *1024 * 1024)

{

printk(“size too big\n”);

return ( - ENXIO);

}

offset = offset + mem_start * 1024 * 1024;

/* we do not want to have this area swapped out, lock it */

vma->vm_flags |= VM_LOCKED;

if (remap_page_range(vma, vma->vm_start, offset, size, PAGE_SHARED))

{

printk(“remap page range failed\n”);

return - ENXIO;

}

return (0);

}

remap_page_range函数的功能是构造用于映射一段物理地址的新页表，实现了内核空间与用户空间的映射，其原型如下：

int remap_page_range(vma_area_struct *vma, unsigned long from, unsigned long to, unsigned long size, pgprot_tprot);

使用mmap最典型的例子是显示卡的驱动，将显存空间直接从内核映射到用户空间将可提供显存的读写效率。

   （在内核驱动程序的初始化阶段，通过ioremap（）将物理地址映射到内核虚拟空间；在驱动程序的mmap系统调用中，使用remap_page_range()将该块ROM映射到用户虚拟空间。这样内核空间和用户空间都能访问这段被映射后的虚拟地址。）

i386 系列处理器中 , 内存和外部 IO 是独立编址独立寻址的 , 于是有一个地址空间叫做内存空间 , 另有一个地址空间叫做 I/O 空间 . 也就是说 , 从处理器的角度来说 ,i386 提供了一些单独的指令用来访问 I/O 空间 . 换言之 , 访问 I/O 空间和访问普通的内存得使用不同的指令 . 而在一些玩嵌入式的处理器中 , 比如 PowerPC, 他们家就只使用一个空间 , 那就是内存空间 , 那像这种情况 , 外设的 I/O 端口的物理地址就被映射到内存地址空间中 , 这就是传说中的 Memory-mapped, 内存映射 . 而我们家那种情况 , 外设的 I/O 端口的物理地址就被映射到 I/O 地址空间中 , 这就是传说中的 I/O-mapped, 即 I/O 映射 .

要使用 I/O 内存首先要申请 , 然后要映射 , 而要使用 I/O 端口首先要申请 , 或者叫请求 , 对于 I/O 端口的请求意思是让内核知道你要访问这个端口 , 这样内核知道了以后它就不会再让别人也访问这个端口了 . 毕竟这个世界僧多粥少啊 . 申请 I/O 端口的函数是 request_region, 这个函数来自 include/linux/ioport.h,

/* Convenience shorthand with allocation */

#define request_region(start,n,name) __request_region(&ioport_resource, (start), (n), (name))

#define request_mem_region(start,n,name) __request_region(&iomem_resource, (start), (n), (name))

#define rename_region(region, newname) do { (region)->name = (newname); } while (0)

extern struct resource * __request_region(struct resource *,

                                      resource_size_t start,

                                      resource_size_t n, const char *name);

这里我们看到的那个 request_mem_region 是申请 I/O 内存用的 . 申请了之后 , 还需要使用 ioremap 或者 ioremap_nocache 函数来映射 .对于 request_region, 三个参数 start,n,name 表示你想使用从 start 开始的 size 为 n 的 I/O port 资源 ,name 自然就是你的名字了 .

这两个函数在内核的驱动中几乎都会出现，例如ohci-at91.c里面的probe函数：

view plaincopy to clipboardprint?

hcd->rsrc_start = pdev->resource[0].start;

 hcd->rsrc_len = pdev->resource[0].end - pdev->resource[0].start + 1;   

 if (!request_mem_region(hcd->rsrc_start, hcd->rsrc_len, hcd_name)) {   

     pr_debug("request_mem_region failed\n");   

     retval = -EBUSY;   

     goto err1;   

 }   

 hcd->regs = ioremap(hcd->rsrc_start, hcd->rsrc_len);   

 if (!hcd->regs) {   

     pr_debug("ioremap failed\n");   

     retval = -EIO;   

     goto err2;   

 } 

hcd->rsrc_start = pdev->resource[0].start;

hcd->rsrc_len = pdev->resource[0].end - pdev->resource[0].start + 1;

if (!request_mem_region(hcd->rsrc_start, hcd->rsrc_len, hcd_name)) {

pr_debug("request_mem_region failed\n");

retval = -EBUSY;

goto err1;

}

hcd->regs = ioremap(hcd->rsrc_start, hcd->rsrc_len);

if (!hcd->regs) {

pr_debug("ioremap failed\n");

retval = -EIO;

goto err2;

}

这样的好处是寄存器访问方式比较好看，只要加个偏移地址就可以了。

不过我有时候又不太喜欢用。因为这两句话说到底是为了访问寄存器用的。相当于获得寄存器虚拟地址。但是我们在初始化的时候虚拟地址就已经映射过了，所以我喜欢直接操作寄存器的虚拟地址。

ioremap 与__ioremap的区别

void * __ioremap(unsigned long phys_addr, unsigned long size, unsigned long flags)

void *ioremap(unsigned long phys_addr, unsigned long size)

入口： phys_addr：要映射的起始的IO地址；

size：要映射的空间的大小；

flags：要映射的IO空间的和权限有关的标志；

phys_addr：是要映射的物理地址，

size：是要映射的长度，

S3C2410的long是32位而非你说的64位。

功能： 将一个IO地址空间映射到内核的虚拟地址空间上去，便于访问；

实现： 对要映射的IO地址空间进行判断，低PCI/ISA地址不需要重新映射，也不允许用户将IO地址空间映射到正在使用的RAM中，最后申请一个vm_area_struct结构，调用remap_area_pages填写页表，若填写过程不成功则释放申请的vm_area_struct空间；

ioremap 依靠 ioremap实现,它只是在ioremap中以第三个参数为0调用来实现.

ioremap是内核提供的用来映射外设寄存器到主存的函数，我们要映射的地址已经从pci_dev中读了出来（上一步），这样就水到渠成的成功映射了而不会和其他地址有冲突。映射完了有什么效果呢，我举个例子，比如某个网卡有100 个寄存器，他们都是连在一块的，位置是固定的，加入每个寄存器占4个字节，那么一共400个字节的空间被映射到内存成功后，ioaddr就是这段地址的开头（注意ioaddr是虚拟地址，而mmio_start是物理地址，它是BIOS得到的，肯定是物理地址，而保护模式下CPU不认物理地址，只认虚拟地址），ioaddr+0就是第一个寄存器的地址，ioaddr+4就是第二个寄存器地址（每个寄存器占4个字节），以此类推，我们就能够在内存中访问到所有的寄存器进而操控他们了。