···56565757for the Device Tree Source Include files (.dtsi) included in testcases.dts.58585959-When the kernel is build with CONFIG_OF_UNITTEST enabled, then the following make5959+When the kernel is built with CONFIG_OF_UNITTEST enabled, then the following make6060rule::61616262 $(obj)/%.dtb: $(src)/%.dts FORCE···133133 __dtb_testcases_end - address marking the end of test data blob134134135135Secondly, it calls of_fdt_unflatten_tree() to unflatten the flattened136136-blob. And finally, if the machine's device tree (i.e live tree) is present,136136+blob. And finally, if the machine's device tree (i.e. live tree) is present,137137then it attaches the unflattened test data tree to the live tree, else it138138attaches itself as a live device tree.139139
+3-3
Documentation/devicetree/overlay-notes.rst
···1414A Devicetree's overlay purpose is to modify the kernel's live tree, and1515have the modification affecting the state of the kernel in a way that1616is reflecting the changes.1717-Since the kernel mainly deals with devices, any new device node that result1717+Since the kernel mainly deals with devices, any new device node that results1818in an active device should have it created while if the device node is either1919disabled or removed all together, the affected device should be deregistered.20202121-Lets take an example where we have a foo board with the following base tree::2121+Let's take an example where we have a foo board with the following base tree::22222323 ---- foo.dts ---------------------------------------------------------------2424 /* FOO platform */···1111111) Call of_overlay_fdt_apply() to create and apply an overlay changeset. The112112 return value is an error or a cookie identifying this overlay.113113114114-2) Call of_overlay_remove() to remove and cleanup the overlay changeset114114+2) Call of_overlay_remove() to remove and clean up the overlay changeset115115 previously created via the call to of_overlay_fdt_apply(). Removal of an116116 overlay changeset that is stacked by another will not be permitted.117117
+3-3
Documentation/devicetree/usage-model.rst
···4646communication method for passing data from Open Firmware to a client4747program (like to an operating system). An operating system used the4848Device Tree to discover the topology of the hardware at runtime, and4949-thereby support a majority of available hardware without hard coded4949+thereby supported a majority of available hardware without hard coded5050information (assuming drivers were available for all devices).51515252Since Open Firmware is commonly used on PowerPC and SPARC platforms,···128128 compatible = "ti,omap3-beagleboard-xm", "ti,omap3450", "ti,omap3";129129130130Where "ti,omap3-beagleboard-xm" specifies the exact model, it also131131-claims that it compatible with the OMAP 3450 SoC, and the omap3 family131131+claims that it is compatible with the OMAP 3450 SoC, and the omap3 family132132of SoCs in general. You'll notice that the list is sorted from most133133specific (exact board) to least specific (SoC family).134134···205205206206During early boot, the architecture setup code calls of_scan_flat_dt()207207several times with different helper callbacks to parse device tree208208-data before paging is setup. The of_scan_flat_dt() code scans through208208+data before paging is set up. The of_scan_flat_dt() code scans through209209the device tree and uses the helpers to extract information required210210during early boot. Typically the early_init_dt_scan_chosen() helper211211is used to parse the chosen node including kernel parameters,