Linux 获取设备树源文件（DTS）里描述的资源

Linux 获取设备树源文件（DTS）里的资源

韩大卫@吉林师范大学

在linux使用platform_driver_register() 注册  platform_driver 时， 需要在 platform_driver 的probe() 里面知道设备的中断号， 内存地址等资源。

这些资源的描述信息存放在 resource 数据结构中， 相同的资源存放在一个树形树形数据结构中， 通过父节点， 兄弟节点， 子节点相连。 比如中断资源， IO端口资源， IO内存资源， DMA资源有不同资源树。 

Linux使用 struct resource 来描述一个resouce

struct resource {
    resource_size_t start;      ／／资源范围的开始
    resource_size_t end;        ／／资源范围的结束
    const char *name;   	//资源拥有者名
    unsigned long flags;	／／资源属性标识
    struct resource *parent, *sibling, *child;   ／／资源树的父节点， 兄弟节点， 字节点指针
};

resource_size_t 由系统决定 为uint32_t 或uint64_t 。
 

在platform机制里， 使用platform_get_resource（）来获取指定的资源类型。 


比如获取想获取中断号， 


    irq = platform_get_irq(pdev, 0);
 
int platform_get_irq(struct platform_device *dev, unsigned int num) 
{
    struct resource *r = platform_get_resource(dev, IORESOURCE_IRQ, num);
 
    return r ? r->start : -ENXIO;
}
EXPORT_SYMBOL_GPL(platform_get_irq);     
              

platform_get_irq（） 会返回一个start, 即可用的中断号。


之后便可使用request_irq（） 来注册中断服务函数。 


再比如想要获取IO内存资源：

struct resource *res_mem = platform_get_resource(pdev, IORESOURCE_MEM, 0);


即可得到一个IO内存资源节点指针， 包括了地址的开始，结束地址等, 该IO内存的长度可用 resource_size（） 来获取， 但这段资源只是一个描述， 想真正使用这段IO内存， 还要经过先申请， 再映射的过程。例如可使用devm_request_mem_region()申请出使用这段IO内存， 再使用ioremap（） 将其映射出来， 供用户空间使用。

devm_request_mem_region(&pdev->dev, res_mem->start, resource_size(res_mem),
                     res_mem->name))

addr_start = ioremap(res_mem->start, resource_size(res_mem));


ioremap() 的返回值即为该资源的虚拟地址。


IO内存的资源是在设备树源(Device Tree Source)文件（以.dts结尾）里给出的，.dts文件就是用来描述目标板硬件信息的， 在uboot启动后， 使用uboot提供的特定API将其获取出来， 如fdt_getprop()， fdt_path_offset()， 这些API包含在uboot 的头文件<libfdt.h> 里面。
 
uboot将.dts文件里的描述解析出来， 再对相应寄存器赋值， 在linux启动后， 使用  platform_get_resource（） 即可获取到这些给定的资源， 在驱动里使用。


例如一个在.dts文件中关于gpio资源的描述：

  gpio: gpio-controller@1070000000800 {
            #gpio-cells = <2>;
            compatible = "cavium,octeon-3860-gpio";
            reg = <0x10700 0x00000800 0x0 0x100>;

            gpio-controller;

…

根据其描述， 可知道gpio控制器的IO内存起始地址为：0x107900000800， 长度为0x100.

即从 0x107900000800 到 0x1079000008ff.

在目标板里使用  cat /proc/iomem  可以看到：


1070000000800-10700000008ff : /soc@0/gpio-controller@1070000000800


关于i2c 的描述：

        twsi0: i2c@1180000001000 {
            #address-cells = <1>;
            #size-cells = <0>;
            compatible = "cavium,octeon-3860-twsi";
            reg = <0x11800 0x00001000 0x0 0x200>;

            interrupts = <0 45>;
            clock-rate = <100000>;

IO内存起始地址为： 0x118000001000, 长度为0x200. 

从 0x118000001000 到 0x1180000011ff.

在目标板里使用  cat /proc/iomem  可以看到：


1180000001000-11800000011ff : /soc@0/i2c@1180000001000