1个双核ARM Cortex-A9 32位处理器；ARM的local bus上的内存映射区域分布了2个串口（分别位于0x101F1000 和 0x101F2000）、GPIO控制器（位于0x101F3000）、SPI控制器（位于0x10170000）、中断控制器（位于0x10140000）和一个external bus桥；External bus桥上又连接了SMC SMC91111 Ethernet（位于0x10100000）、I2C控制器（位于0x10160000）、64MB NOR Flash（位于0x30000000）；External bus桥上连接的I2C控制器所对应的I2C总线上又连接了Maxim DS1338实时钟（I2C地址为0x58）。
其对应的.dts文件为： [plain] view plain copy / { compatible = "acme,coyotes-revenge"; #address-cells = <1>; #size-cells = <1>; interrupt-parent = <&intc>; cpus { #address-cells = <1>; #size-cells = <0>; cpu@0 { compatible = "arm,cortex-a9"; reg = <0>; }; cpu@1 { compatible = "arm,cortex-a9"; reg = <1>; }; }; serial@101f0000 { compatible = "arm,pl011"; reg = <0x101f0000 0x1000 >; interrupts = < 1 0 >; }; serial@101f2000 { compatible = "arm,pl011"; reg = <0x101f2000 0x1000 >; interrupts = < 2 0 >; }; gpio@101f3000 { compatible = "arm,pl061"; reg = <0x101f3000 0x1000 0x101f4000 0x0010>; interrupts = < 3 0 >; }; intc: interrupt-controller@10140000 { compatible = "arm,pl190"; reg = <0x10140000 0x1000 >; interrupt-controller; #interrupt-cells = <2>; }; spi@10115000 { compatible = "arm,pl022"; reg = <0x10115000 0x1000 >; interrupts = < 4 0 >; }; external-bus { #address-cells = <2> #size-cells = <1>; ranges = <0 0 0x10100000 0x10000 // Chipselect 1, Ethernet 1 0 0x10160000 0x10000 // Chipselect 2, i2c controller 2 0 0x30000000 0x1000000>; // Chipselect 3, NOR Flash ethernet@0,0 { compatible = "smc,smc91c111"; reg = <0 0 0x1000>; interrupts = < 5 2 >; }; i2c@1,0 { compatible = "acme,a1234-i2c-bus"; #address-cells = <1>; #size-cells = <0>; reg = <1 0 0x1000>; interrupts = < 6 2 >; rtc@58 { compatible = "maxim,ds1338"; reg = <58>; interrupts = < 7 3 >; }; }; flash@2,0 { compatible = "samsung,k8f1315ebm", "cfi-flash"; reg = <2 0 0x4000000>; }; }; }; 上述.dts文件中,root结点"/"的compatible 属性compatible = "acme,coyotes-revenge";定义了系统的名称，它的组织形式为：<manufacturer>,<model>。Linux内核透过root结点"/"的compatible 属性即可判断它启动的是什么machine。 在.dts文件的每个设备，都有一个compatible 属性，compatible属性用户驱动和设备的绑定。compatible 属性是一个字符串的列表，列表中的第一个字符串表征了结点代表的确切设备，形式为"<manufacturer>,<model>"，其后的字符串表征可兼容的其他设备。可以说前面的是特指，后面的则涵盖更广的范围。如在arch/arm/boot/dts/vexpress-v2m.dtsi中的Flash结点： [plain] view plain copy flash@0,00000000 { compatible = "arm,vexpress-flash", "cfi-flash"; reg = <0 0x00000000 0x04000000>, <1 0x00000000 0x04000000>; bank-width = <4>; }; compatible属性的第2个字符串"cfi-flash"明显比第1个字符串"arm,vexpress-flash"涵盖的范围更广。 再比如，Freescale MPC8349 SoC含一个串口设备，它实现了国家半导体（National Semiconductor）的ns16550 寄存器接口。则MPC8349串口设备的compatible属性为compatible = "fsl,mpc8349-uart", "ns16550"。其中，fsl,mpc8349-uart指代了确切的设备， ns16550代表该设备与National Semiconductor 的16550 UART保持了寄存器兼容。 接下来root结点"/"的cpus子结点下面又包含2个cpu子结点，描述了此machine上的2个CPU，并且二者的compatible 属性为"arm,cortex-a9"。 注意cpus和cpus的2个cpu子结点的命名，它们遵循的组织形式为：<name>[@<unit-address>]，<>中的内容是必选项，[]中的则为可选项。name是一个ASCII字符串，用于描述结点对应的设备类型，如3com Ethernet适配器对应的结点name宜为ethernet，而不是3com509。如果一个结点描述的设备有地址，则应该给出@unit-address。多个相同类型设备结点的name可以一样，只要unit-address不同即可，如本例中含有cpu@0、cpu@1以及serial@101f0000与serial@101f2000这样的同名结点。设备的unit-address地址也经常在其对应结点的reg属性中给出。ePAPR标准给出了结点命名的规范。 可寻址的设备使用如下信息来在Device Tree中编码地址信息： reg #address-cells #size-cells 其中reg的组织形式为reg = <address1 length1 [address2 length2] [address3 length3] ... >，其中的每一组address length表明了设备使用的一个地址范围。address为1个或多个32位的整型（即cell），而length则为cell的列表或者为空（若#size-cells = 0）。address 和 length 字段是可变长的，父结点的#address-cells和#size-cells分别决定了子结点的reg属性的address和length字段的长度。在本例中，root结点的#address-cells = <1>;和#size-cells = <1>;决定了serial、gpio、spi等结点的address和length字段的长度分别为1。cpus 结点的#address-cells = <1>;和#size-cells = <0>;决定了2个cpu子结点的address为1，而length为空，于是形成了2个cpu的reg = <0>;和reg = <1>;。external-bus结点的#address-cells = <2>和#size-cells = <1>;决定了其下的ethernet、i2c、flash的reg字段形如reg = <0 0 0x1000>;、reg = <1 0 0x1000>;和reg = <2 0 0x4000000>;。其中，address字段长度为0，开始的第一个cell（0、1、2）是对应的片选，第2个cell（0，0，0）是相对该片选的基地址，第3个cell（0x1000、0x1000、0x4000000）为length。特别要留意的是i2c结点中定义的 #address-cells = <1>;和#size-cells = <0>;又作用到了I2C总线上连接的RTC，它的address字段为0x58，是设备的I2C地址。 root结点的子结点描述的是CPU的视图，因此root子结点的address区域就直接位于CPU的memory区域。但是，经过总线桥后的address往往需要经过转换才能对应的CPU的memory映射。external-bus的ranges属性定义了经过external-bus桥后的地址范围如何映射到CPU的memory区域。 [plain] view plain copy ranges = <0 0 0x10100000 0x10000 // Chipselect 1, Ethernet 1 0 0x10160000 0x10000 // Chipselect 2, i2c controller 2 0 0x30000000 0x1000000>; // Chipselect 3, NOR Flash ranges是地址转换表，其中的每个项目是一个子地址、父地址以及在子地址空间的大小的映射。映射表中的子地址、父地址分别采用子地址空间的#address-cells和父地址空间的#address-cells大小。对于本例而言，子地址空间的#address-cells为2，父地址空间的#address-cells值为1，因此0 0 0x10100000 0x10000的前2个cell为external-bus后片选0上偏移0，第3个cell表示external-bus后片选0上偏移0的地址空间被映射到CPU的0x10100000位置，第4个cell表示映射的大小为0x10000。ranges的后面2个项目的含义可以类推。 Device Tree中还可以中断连接信息，对于中断控制器而言，它提供如下属性： interrupt-controller – 这个属性为空，中断控制器应该加上此属性表明自己的身份； #interrupt-cells – 与#address-cells 和 #size-cells相似，它表明连接此中断控制器的设备的interrupts属性的cell大小； 在整个Device Tree中，与中断相关的属性还包括： interrupt-parent – 设备结点透过它来指定它所依附的中断控制器的phandle，当结点没有指定interrupt-parent 时，则从父级结点继承。对于本例而言，root结点指定了interrupt-parent = <&intc>;其对应于intc: interrupt-controller@10140000，而root结点的子结点并未指定interrupt-parent，因此它们都继承了intc，即位于0x10140000的中断控制器。 interrupts – 用到了中断的设备结点透过它指定中断号、触发方法等，具体这个属性含有多少个cell，由它依附的中断控制器结点的#interrupt-cells属性决定。而具体每个cell又是什么含义，一般由驱动的实现决定，而且也会在Device Tree的binding文档中说明。譬如，对于ARM GIC中断控制器而言，#interrupt-cells为3，它3个cell的具体含义Documentation/devicetree/bindings/arm/gic.txt就有如下文字说明： [plain] view plain copy 01 The 1st cell is the interrupt type; 0 for SPI interrupts, 1 for PPI 02 interrupts. 03 04 The 2nd cell contains the interrupt number for the interrupt type. 05 SPI interrupts are in the range [0-987]. PPI interrupts are in the 06 range [0-15]. 07 08 The 3rd cell is the flags, encoded as follows: 09 bits[3:0] trigger type and level flags. 10 1 = low-to-high edge triggered 11 2 = high-to-low edge triggered 12 4 = active high level-sensitive 13 8 = active low level-sensitive 14 bits[15:8] PPI interrupt cpu mask. Each bit corresponds to each of 15 the 8 possible cpus attached to the GIC. A bit set to '1' indicated 16 the interrupt is wired to that CPU. Only valid for PPI interrupts. 另外，值得注意的是，一个设备还可能用到多个中断号。对于ARM GIC而言，若某设备使用了SPI的168、169号2个中断，而言都是高电平触发，则该设备结点的interrupts属性可定义为：interrupts = <0 168 4>, <0 169 4>; 除了中断以外，在ARM Linux中clock、GPIO、pinmux都可以透过.dts中的结点和属性进行描述。透过Device Tree后，形如
[cpp] view plain copy 90 static struct resource xxx_resources[] = { 91 [0] = { 92 .start = …, 93 .end = …, 94 .flags = IORESOURCE_MEM, 95 }, 96 [1] = { 97 .start = …, 98 .end = …, 99 .flags = IORESOURCE_IRQ, 100 }, 101 }; 102 103 static struct platform_device xxx_device = { 104 .name = "xxx", 105 .id = -1, 106 .dev = { 107 .platform_data = &xxx_data, 108 }, 109 .resource = xxx_resources, 110 .num_resources = ARRAY_SIZE(xxx_resources), 111 }; 之类的platform_device代码都不再需要，其中platform_device会由kernel自动展开。而这些resource实际来源于.dts中设备结点的reg、interrupts属性。典型地，大多数总线都与“simple_bus”兼容，而在SoC对应的machine的.init_machine成员函数中，调用of_platform_bus_probe(NULL, xxx_of_bus_ids, NULL);即可自动展开所有的platform_device。譬如，假设我们有个XXX SoC，则可在arch/arm/mach-xxx/的板文件中透过如下方式展开.dts中的设备结点对应的platform_device：
[cpp] view plain copy 18 static struct of_device_id xxx_of_bus_ids[] __initdata = { 19 { .compatible = "simple-bus", }, 20 {}, 21 }; 22 23 void __init xxx_mach_init(void) 24 { 25 of_platform_bus_probe(NULL, xxx_of_bus_ids, NULL); 26 } 32 33 #ifdef CONFIG_ARCH_XXX 38 39 DT_MACHINE_START(XXX_DT, "Generic XXX (Flattened Device Tree)") 41 … 45 .init_machine = xxx_mach_init, 46 … 49 MACHINE_END 50 #endif
2. 注册i2c_board_info，指定IRQ等板级信息。
形如
[cpp] view plain copy 145 static struct i2c_board_info __initdata afeb9260_i2c_devices[] = { 146 { 147 I2C_BOARD_INFO("tlv320aic23", 0x1a), 148 }, { 149 I2C_BOARD_INFO("fm3130", 0x68), 150 }, { 151 I2C_BOARD_INFO("24c64", 0x50), 152 }, 153 }; 之类的i2c_board_info代码，目前不再需要出现，现在只需要把tlv320aic23、fm3130、24c64这些设备结点填充作为相应的I2C controller结点的子结点即可，类似于前面的
[cpp] view plain copy i2c@1,0 { compatible = "acme,a1234-i2c-bus"; … rtc@58 { compatible = "maxim,ds1338"; reg = <58>; interrupts = < 7 3 >; }; }; Device Tree中的I2C client会透过I2C host驱动的probe()函数中调用of_i2c_register_devices(&i2c_dev->adapter);被自动展开。
3. 注册spi_board_info，指定IRQ等板级信息。
形如
[cpp] view plain copy 79 static struct spi_board_info afeb9260_spi_devices[] = { 80 { /* DataFlash chip */ 81 .modalias = "mtd_dataflash", 82 .chip_select = 1, 83 .max_speed_hz = 15 * 1000 * 1000, 84 .bus_num = 0, 85 }, 86 }; 之类的spi_board_info代码，目前不再需要出现，与I2C类似，现在只需要把mtd_dataflash之类的结点，作为SPI控制器的子结点即可，SPI host驱动的probe函数透过spi_register_master()注册master的时候，会自动展开依附于它的slave。
4. 多个针对不同电路板的machine，以及相关的callback。
过去，ARM Linux针对不同的电路板会建立由MACHINE_START和MACHINE_END包围起来的针对这个machine的一系列callback，譬如：
[cpp] view plain copy 373 MACHINE_START(VEXPRESS, "ARM-Versatile Express") 374 .atag_offset = 0x100, 375 .smp = smp_ops(vexpress_smp_ops), 376 .map_io = v2m_map_io, 377 .init_early = v2m_init_early, 378 .init_irq = v2m_init_irq, 379 .timer = &v2m_timer, 380 .handle_irq = gic_handle_irq, 381 .init_machine = v2m_init, 382 .restart = vexpress_restart, 383 MACHINE_END 这些不同的machine会有不同的MACHINE ID，Uboot在启动Linux内核时会将MACHINE ID存放在r1寄存器，Linux启动时会匹配Bootloader传递的MACHINE ID和MACHINE_START声明的MACHINE ID，然后执行相应machine的一系列初始化函数。
引入Device Tree之后，MACHINE_START变更为DT_MACHINE_START，其中含有一个.dt_compat成员，用于表明相关的machine与.dts中root结点的compatible属性兼容关系。如果Bootloader传递给内核的Device Tree中root结点的compatible属性出现在某machine的.dt_compat表中，相关的machine就与对应的Device Tree匹配，从而引发这一machine的一系列初始化函数被执行。
[cpp] view plain copy 489 static const char * const v2m_dt_match[] __initconst = { 490 "arm,vexpress", 491 "xen,xenvm", 492 NULL, 493 }; 495 DT_MACHINE_START(VEXPRESS_DT, "ARM-Versatile Express") 496 .dt_compat = v2m_dt_match, 497 .smp = smp_ops(vexpress_smp_ops), 498 .map_io = v2m_dt_map_io, 499 .init_early = v2m_dt_init_early, 500 .init_irq = v2m_dt_init_irq, 501 .timer = &v2m_dt_timer, 502 .init_machine = v2m_dt_init, 503 .handle_irq = gic_handle_irq, 504 .restart = vexpress_restart, 505 MACHINE_END Linux倡导针对多个SoC、多个电路板的通用DT machine，即一个DT machine的.dt_compat表含多个电路板.dts文件的root结点compatible属性字符串。之后，如果的电路板的初始化序列不一样，可以透过int of_machine_is_compatible(const char *compat) API判断具体的电路板是什么。
譬如arch/arm/mach-exynos/mach-exynos5-dt.c的EXYNOS5_DT machine同时兼容"samsung,exynos5250"和"samsung,exynos5440"：
[cpp] view plain copy 158 static char const *exynos5_dt_compat[] __initdata = { 159 "samsung,exynos5250", 160 "samsung,exynos5440", 161 NULL 162 }; 163 177 DT_MACHINE_START(EXYNOS5_DT, "SAMSUNG EXYNOS5 (Flattened Device Tree)") 178 /* Maintainer: Kukjin Kim <kgene.kim@samsung.com> */ 179 .init_irq = exynos5_init_irq, 180 .smp = smp_ops(exynos_smp_ops), 181 .map_io = exynos5_dt_map_io, 182 .handle_irq = gic_handle_irq, 183 .init_machine = exynos5_dt_machine_init, 184 .init_late = exynos_init_late, 185 .timer = &exynos4_timer, 186 .dt_compat = exynos5_dt_compat, 187 .restart = exynos5_restart, 188 .reserve = exynos5_reserve, 189 MACHINE_END
它的.init_machine成员函数就针对不同的machine进行了不同的分支处理：
[cpp] view plain copy 126 static void __init exynos5_dt_machine_init(void) 127 { 128 … 149 150 if (of_machine_is_compatible("samsung,exynos5250")) 151 of_platform_populate(NULL, of_default_bus_match_table, 152 exynos5250_auxdata_lookup, NULL); 153 else if (of_machine_is_compatible("samsung,exynos5440")) 154 of_platform_populate(NULL, of_default_bus_match_table, 155 exynos5440_auxdata_lookup, NULL); 156 }
使用Device Tree后，驱动需要与.dts中描述的设备结点进行匹配，从而引发驱动的probe()函数执行。对于platform_driver而言，需要添加一个OF匹配表，如前文的.dts文件的"acme,a1234-i2c-bus"兼容I2C控制器结点的OF匹配表可以是：
[cpp] view plain copy 436 static const struct of_device_id a1234_i2c_of_match[] = { 437 { .compatible = "acme,a1234-i2c-bus ", }, 438 {}, 439 }; 440 MODULE_DEVICE_TABLE(of, a1234_i2c_of_match); 441 442 static struct platform_driver i2c_a1234_driver = { 443 .driver = { 444 .name = "a1234-i2c-bus ", 445 .owner = THIS_MODULE, 449 .of_match_table = a1234_i2c_of_match, 450 }, 451 .probe = i2c_a1234_probe, 452 .remove = i2c_a1234_remove, 453 }; 454 module_platform_driver(i2c_a1234_driver);
对于I2C和SPI从设备而言，同样也可以透过of_match_table添加匹配的.dts中的相关结点的compatible属性，如sound/soc/codecs/wm8753.c中的：
[cpp] view plain copy 1533 static const struct of_device_id wm8753_of_match[] = { 1534 { .compatible = "wlf,wm8753", }, 1535 { } 1536 }; 1537 MODULE_DEVICE_TABLE(of, wm8753_of_match); 1587 static struct spi_driver wm8753_spi_driver = { 1588 .driver = { 1589 .name = "wm8753", 1590 .owner = THIS_MODULE, 1591 .of_match_table = wm8753_of_match, 1592 }, 1593 .probe = wm8753_spi_probe, 1594 .remove = wm8753_spi_remove, 1595 }; 1640 static struct i2c_driver wm8753_i2c_driver = { 1641 .driver = { 1642 .name = "wm8753", 1643 .owner = THIS_MODULE, 1644 .of_match_table = wm8753_of_match, 1645 }, 1646 .probe = wm8753_i2c_probe, 1647 .remove = wm8753_i2c_remove, 1648 .id_table = wm8753_i2c_id, 1649 }; 不过这边有一点需要提醒的是，I2C和SPI外设驱动和Device Tree中设备结点的compatible 属性还有一种弱式匹配方法，就是别名匹配。compatible 属性的组织形式为<manufacturer>,<model>，别名其实就是去掉compatible 属性中逗号前的manufacturer前缀。关于这一点，可查看drivers/spi/spi.c的源代码，函数spi_match_device()暴露了更多的细节，如果别名出现在设备spi_driver的id_table里面，或者别名与spi_driver的name字段相同，SPI设备和驱动都可以匹配上：
[cpp] view plain copy 90 static int spi_match_device(struct device *dev, struct device_driver *drv) 91 { 92 const struct spi_device *spi = to_spi_device(dev); 93 const struct spi_driver *sdrv = to_spi_driver(drv); 94 95 /* Attempt an OF style match */ 96 if (of_driver_match_device(dev, drv)) 97 return 1; 98 99 /* Then try ACPI */ 100 if (acpi_driver_match_device(dev, drv)) 101 return 1; 102 103 if (sdrv->id_table) 104 return !!spi_match_id(sdrv->id_table, spi); 105 106 return strcmp(spi->modalias, drv->name) == 0; 107 } 71 static const struct spi_device_id *spi_match_id(const struct spi_device_id *id, 72 const struct spi_device *sdev) 73 { 74 while (id->name[0]) { 75 if (!strcmp(sdev->modalias, id->name)) 76 return id; 77 id++; 78 } 79 return NULL; 80 }
