EEPW论坛

为AM335x移植Linux内核主线代码

一、了解dts

问题一：以前的Linux Kernel如何描述硬件，现在又如何描述呢？

6）Barebox变量：bootm.image (?)

 uart0: serial@44e09000 {
                        compatible = "ti,omap3-uart";
                        ti,hwmods = "uart1";
                        clock-frequency =;
                        reg =;
                        interrupts =;
                        status = "disabled";
                };

                uart1: serial@48022000 {
                        compatible = "ti,omap3-uart";
                        ti,hwmods = "uart2";
                        clock-frequency =;
                        reg =;
                        interrupts =;
                        status = "disabled";
                };

对比图片中的注释，就能够知道对于uart0这个外设：
Node name: serial
Unit Address: 0x44e09000
compatible: 定义了设备的programming model，允许操作系统识别对应的程序驱动；
clock-frequency: 48000000，晶振频率为24MHz，这应该是PLL倍频后的输出（？）；
reg: 寄存器的地址和寄存器长度，uart0的地址起始为0x44e09000，长度为0x2000；
interrupts: 中断号；
status: 状态值，初始的时候为disabled，即禁用它；

=============================================
问题三：Device Tree的编写规则是怎样的？

1）Device Tree inclusion不一定要做成monolithic，它们可以分散在不同的文件中，互相包含；
2）.dtsi文件是被包含的，.dts文件才是最终的Device Trees；
3）.dts文件包含了板级信息；
4）including工作主要是将including file覆盖到included file上面；
5）inclusion使用DT操作符/include/，或者在某些少量的内核发布版中，由于DTS是使用了C preprocessor，因此推荐#include。

由这张图可见，如果included file中的某项，被including file文件定义了，则会使用后者的定义，也就是使用更上层更新的定义；如果没有被定义，则添加进入。

1）bindings是device tree里面可已包含的specific types and classes of devices。
2）compatible特征描述了节点编译的specific binding；
3）当为一个设备创建新的device tree时，应该创建a binding来描述设备的全部细节。

=============================================
问题四：在哪里可以找到Device Tree的文档呢？

1）所有可被内核识别的Device Tree bindings在文档Documentation/devicetree/bindings里面；
2）每个binding文档描述了哪些properties可以被接受，可以使用哪些值，哪些特征是必须的，哪些是可选的；
3）所有新的Device Tree bindings必须让代码维护者审核，提交到devicetree@vger.kernel.org上。这用来保证它们的正确性和一致性。

=============================================
问题五：Device Tree中的常见关键字含义是什么？

Device Tree organization: top-level nodes
在设备的最顶层节点上，一般可以发现如下这些：
cpus：描述了系统的CPU
memory：定义了RAM的地址和大小
chosen：定义了boot时被系统固件选择或定义的参数；可用来传递kernel command line；
aliases：定义了certain nodes的shotcuts；
一个或多个总线定义；
一个或多个板上设备定义；

下面是am33xx.dtsi中的定义：

/ {
        compatible = "ti,am33xx";
        interrupt-parent = <&intc>;

        aliases {
                i2c0 = &i2c0;
                i2c1 = &i2c1;
                i2c2 = &i2c2;
                serial0 = &uart0;
                serial1 = &uart1;
                serial2 = &uart2;
                serial3 = &uart3;
                serial4 = &uart4;
                serial5 = &uart5;
                d_can0 = &dcan0;
                d_can1 = &dcan1;
                usb0 = &usb0;
                usb1 = &usb1;
                phy0 = &usb0_phy;
                phy1 = &usb1_phy;
                ethernet0 = &cpsw_emac0;
                ethernet1 = &cpsw_emac1;
        };

        cpus {
                #address-cells =;
                #size-cells =;
                cpu@0 {
                        compatible = "arm,cortex-a8";
                        device_type = "cpu";
                        reg =;
                        
                        /*
                         * To consider voltage drop between PMIC and SoC,
                         * tolerance value is reduced to 2% from 4% and
                         * voltage value is increased as a precaution.
                         */
                        operating-points = <
                                /* kHz    uV */
                                720000  1285000
                                600000  1225000
                                500000  1125000
                                275000  1125000
                        >;
                        voltage-tolerance =; /* 2 percentage */

                        clocks = <&dpll_mpu_ck>;
                        clock-names = "cpu";
                        
                        clock-latency =; /* From omap-cpufreq driver */
                };
        };

        pmu {
                compatible = "arm,cortex-a8-pmu";
                interrupts =;
        };

        /*
         * The soc node represents the soc top level view. It is used for IPs
         * that are not memory mapped in the MPU view or for the MPU itself.
         */
        soc {
                compatible = "ti,omap-infra";
                mpu {
                        compatible = "ti,omap3-mpu";
                        ti,hwmods = "mpu";
                };
        };


    /* ...... */

};

从上面的代码里面可以找出四个compatible，分别是：
top: compatible = "ti,am33xx";
cpu0: compatible = "arm,cortex-a8";
pmu: compatible = "arm,cortex-a8-pmu";
soc: compatible = "ti,omap-infra";

怎样使用compatible呢？
方法一是用来匹配DT_MACHINE结构体中的dt_compat域，方法二是使用of_machine_is_compatible函数。

在总线中，一般要定义compatile、#address-cells、#size-cells、ranges，比如：

 i2c0: i2c@44e0b000 {
                compatible = "ti,omap4-i2c";
                #address-cells =;
                #size-cells =;
                ti,hwmods = "i2c1";
                reg =;
                interrupts =;
                status = "disabled";
        };

(文章转载自edn博客 作者：MariannaZhu )