Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

doc: device tree: clarify stuff in usage-model.txt.

Fix one filename typo, and tweak a bit of documentation for clarity --
no functional changes.

Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca>
Signed-off-by: Jiri Kosina <jkosina@suse.cz>

authored by

Robert P. J. Day and committed by
Jiri Kosina
b6f4287c 4c7d6361

+6 -5
+6 -5
Documentation/devicetree/usage-model.txt
··· 106 106 kernel will instead select setup code based on the machine's core 107 107 CPU or SoC. On ARM for example, setup_arch() in 108 108 arch/arm/kernel/setup.c will call setup_machine_fdt() in 109 - arch/arm/kernel/devicetree.c which searches through the machine_desc 109 + arch/arm/kernel/devtree.c which searches through the machine_desc 110 110 table and selects the machine_desc which best matches the device tree 111 111 data. It determines the best match by looking at the 'compatible' 112 112 property in the root device tree node, and comparing it with the 113 - dt_compat list in struct machine_desc. 113 + dt_compat list in struct machine_desc (which is defined in 114 + arch/arm/include/asm/mach/arch.h if you're curious). 114 115 115 116 The 'compatible' property contains a sorted list of strings starting 116 117 with the exact name of the machine, followed by an optional list of 117 118 boards it is compatible with sorted from most compatible to least. For 118 119 example, the root compatible properties for the TI BeagleBoard and its 119 - successor, the BeagleBoard xM board might look like: 120 + successor, the BeagleBoard xM board might look like, respectively: 120 121 121 122 compatible = "ti,omap3-beagleboard", "ti,omap3450", "ti,omap3"; 122 123 compatible = "ti,omap3-beagleboard-xm", "ti,omap3450", "ti,omap3"; ··· 162 161 163 162 Instead, the compatible list allows a generic machine_desc to provide 164 163 support for a wide common set of boards by specifying "less 165 - compatible" value in the dt_compat list. In the example above, 164 + compatible" values in the dt_compat list. In the example above, 166 165 generic board support can claim compatibility with "ti,omap3" or 167 166 "ti,omap3450". If a bug was discovered on the original beagleboard 168 167 that required special workaround code during early boot, then a new ··· 378 377 device tree support code reflects that and makes the above example 379 378 simpler. The second argument to of_platform_populate() is an 380 379 of_device_id table, and any node that matches an entry in that table 381 - will also get its child nodes registered. In the tegra case, the code 380 + will also get its child nodes registered. In the Tegra case, the code 382 381 can look something like this: 383 382 384 383 static void __init harmony_init_machine(void)