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-dtbmkdir -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.dtsmsm8974pro-ab-fluid.dts   msm8974-v1-cdp.dts     msm8974-v1-rumi.dts     msm8974-v2.0-1-liquid.dts  msm8974-v2.2-liquid.dtsmsm8974pro-ab-liquid.dts  msm8974-v1-fluid.dts   msm8974-v1-sim.dts      msm8974-v2.0-1-mtp.dts     msm8974-v2.2-mtp.dtsmsm8974pro-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 infocustomize_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()

来源：http://blog.csdn.net/dongwuming/article/details/12784213