android MSM8974 上DeviceTree简介

简介

主要功能是不在代码中硬编码设备信息，而是用专门的文件来描述。整个系统的设备节点会形成一个树，设备节点里可以设置属性。官网在http://www.devicetree.org 。入门指南请参考http://www.devicetree.org/Device_Tree_Usage 。Linux上一些状况请参考"kernel/Document/devicetree/"，其中"bindings"子目录描述各种设备的devicetree的描述方法，各厂商的各类设备的描述方法都可能不同。

 MSM8974 上DeviceTree简介 

设备描述源文件放在"kernel/arch/arm/boot/dts/"下后缀是".dts"或".dtsi"，一般".dtsi"是被其它文件包含的，只用dtc编译".dts"文件。Build时会用"dtc"命令把需要的设备描述文件编译成".dtb"文件，并放到到bootimage的某个地方。对设备描述的解析处理实现主要在"kernel/drivers/of/"目录中，需要配置"CONFIG_OF"。启动过程中，bootloader(默认是bootable/bootloader/lk)会根据机器硬件信息选择合适的devicetree装入内存，把地址等相关信息传给kernel。kernel中，会根据传入的信息创建设备。

版本声明和包含其它文件

一般".dts"文件会先进行版本申明，如下面的第一行。".dts"或".dtsi"文件也可能包含其它".dtsi"文件，如下面的3/4行。

/dts-v1/;

/include/ "msm8974-v2.2.dtsi"
/include/ "msm8974-mtp.dtsi"

关于取地址符号的使用

如经常碰到类似下面的写法。没找到相关文档说明(看源码来理解也很费劲)。作用应该是对之前定义过的设备(例子中是"soc")进行补充描述。

&soc {
	android_usb@fe8050c8 {
		compatible = "qcom,android-usb";
		reg = <0xfe8050c8 0xc8>;
		qcom,android-usb-swfi-latency = <1>;
	};

......
};

哪些文件被编入二进制映像

有两种方式使用DT。第一种可包含多个dtb，编入dt.img，放入boot.img。第二种只包含一个dtb，直接追加到kernelimage后面，放入boot.img。
dtc编译在kernel/AndroidKernel.mk中定义。先用定义"DTS_NAMES"变量，它的每个entry(记为"DTS_NAME"变量，下面的$$arch)中可能有arch和rev两部分，和.config中相关配置有关，用下面方法找出。

while (<>) {
$$a = $$1 if /CONFIG_ARCH_((?:MSM|QSD|MPQ)[a-zA-Z0-9]+)=y/;
$$r = $$1 if /CONFIG_MSM_SOC_REV_(?!NONE)(\w+)=y/;
$$arch = $$arch.lc("$$a$$r ") if /CONFIG_ARCH_((?:MSM|QSD|MPQ)[a-zA-Z0-9]+)=y/
} print $$arch;

得到上述"DTS_NAMES"变量，用"$(DTS_NAME)*.dts"方式去"kernel/arch/arm/boot/dts/"下匹配。见下面的定义，其中"cat"命令就是生成带DT的kernelimage。

define append-dtb
mkdir -p $(KERNEL_OUT)/arch/arm/boot;\
$(foreach DTS_NAME, $(DTS_NAMES), \
   $(foreach d, $(DTS_FILES), \
      $(DTC) -p 1024 -O dtb -o $(call DTB_FILE,$(d)) $(d); \
      cat $(KERNEL_ZIMG) $(call DTB_FILE,$(d)) > $(call ZIMG_FILE,$(d));))
endef

如，msm8974的MR2的ES1版中，"DTS_NAMES"变量的值为"msm8974 msmsamarium"，会编入的文件有。

msm8974pro-ab-cdp.dts     msm8974pro-ac-mtp.dts  msm8974-v1-mtp.dts      msm8974-v2.0-1-fluid.dts   msm8974-v2.2-fluid.dts   msmsamarium-sim.dts
msm8974pro-ab-fluid.dts   msm8974-v1-cdp.dts     msm8974-v1-rumi.dts     msm8974-v2.0-1-liquid.dts  msm8974-v2.2-liquid.dts
msm8974pro-ab-liquid.dts  msm8974-v1-fluid.dts   msm8974-v1-sim.dts      msm8974-v2.0-1-mtp.dts     msm8974-v2.2-mtp.dts
msm8974pro-ab-mtp.dts     msm8974-v1-liquid.dts  msm8974-v2.0-1-cdp.dts  msm8974-v2.2-cdp.dts       msmsamarium-rumi.dts

第二种方式没看到后续如何放入boot.img。对于第一种方式，会用"device/qcom/common/generate_extra_images.mk"中定义的下面规则编出"dt.img"，

$(INSTALLED_DTIMAGE_TARGET): $(DTBTOOL) $(INSTALLED_KERNEL_TARGET)
	$(build-dtimage-target)

在"build/core/Makefile"中用下面语句使它被编入boot.img。

ifeq ($(strip $(BOARD_KERNEL_SEPARATED_DT)),true)
  INTERNAL_BOOTIMAGE_ARGS += --dt $(INSTALLED_DTIMAGE_TARGET)
  BOOTIMAGE_EXTRA_DEPS    := $(INSTALLED_DTIMAGE_TARGET)
endif

lk中的处理

8974目前实际用的应该是方式1。在下面boot_linux_from_mmc()中，调用dev_tree_get_entry_info()，里面会根据硬件(chipset和platform的id，系统实际跑时的信息在系统boot的更早阶段由N侧设置并传来，而DT中的信息由根节点的"qcom,msm-id"属性定义)来选择合适的DT，后面会把该DT装入内存，把地址等信息传给kernel(据说是通过CPU寄存器)。

	qcom,msm-id = <126 8 0x20002>,
		      <185 8 0x20002>,
		      <186 8 0x20002>;

kmain()
  |bootstrap2()
     |arch_init()
     |platform_init()
     |target_init()
     |apps_init()//call init() of APPs defined using APP_START macro
        |aboot_init()
           |boot_linux_from_mmc()
              |//for device tree approach 1
                 |dev_tree_get_entry_info()
                    |__dev_tree_get_entry_info()
                 |memmove((void *)hdr->tags_addr, (char *)dt_table_offset + dt_entry.offset, dt_entry.size);
              |//for device tree approach 2
                 |dev_tree_appended()
              |boot_linux()
                 |update_device_tree()
                 |entry(0, machtype, (unsigned*)tags_phys);//pass control to kernel

kernel中的处理

在下面的setup_machine_fdt()中，会通过用各机器描述(machine description)的"dt_compat"属性和传入DT的根节点的"compatible"属性进行匹配来选择适当的machine description。会在下面board_dt_populate()处理中，会根据devicetree信息创建设备。

start_kernel()
  |setup_arch()
     |setup_machine_fdt()//select machine description according to DT info

customize_machine()//called because it is an arch_initcall
  |msm8974_init()
     |board_dt_populate()
        |of_platform_bus_create()
           |of_platform_device_create_pdata()
              |of_device_alloc()
                 |dev->dev.of_node = of_node_get(np);//pointer to data of struct device_node, that is device node in DT
           |of_platform_bus_create()//call it recursively to walk through the DT

上面of_device_alloc()时会在dev->dev.of_node中保存对DT中设备节点的引用。在驱动中，一般会增加下面用于设备和驱动匹配的".of_match_table"信息。

static struct of_device_id msm_otg_dt_match[] = {
	{	.compatible = "qcom,hsusb-otg",
	},
	{}
};

static struct platform_driver msm_otg_driver = {
	.remove = __devexit_p(msm_otg_remove),
	.driver = {
......
		.of_match_table = msm_otg_dt_match,
	},
};

在kernel/drivers/base/platform.c的platform_match()中会调用下面处理来进行设备和驱动的匹配。of_driver_match_device()中，一般会根据"compatible"属性来匹配(如果设了name或type，则先根据name/type匹配)。

	if (of_driver_match_device(dev, drv))
		return 1;

下面是设备节点操作(一般是读取)的一些API。

of_property_read_string()
of_find_property()
of_get_next_child()
of_get_parent()