Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
docs:guide-developer:defining-firmware-partitions [2019/02/20 19:43] – [Device Tree Usage in OpenWrt] jeffdocs:guide-developer:defining-firmware-partitions [2020/04/20 16:25] (current) – you still need mtd splitting, just not the original one karlp
Line 1: Line 1:
-===== Device Tree Usage in OpenWrt (DTS) =====+====== Device Tree Usage in OpenWrt (DTS) ======
  
 Current development (2019) uses kernel based on Device Tree (DT) files (.dts, .dtsi, .dtb) rather than the older "mach" files. Current development (2019) uses kernel based on Device Tree (DT) files (.dts, .dtsi, .dtb) rather than the older "mach" files.
Line 5: Line 5:
 This page tries to pull together some of the knowledge about DT usage and conventions used by the OpenWrt project. This page tries to pull together some of the knowledge about DT usage and conventions used by the OpenWrt project.
  
-==== References ====+===== References =====
  
   * https://elinux.org/Device_Tree_Reference   * https://elinux.org/Device_Tree_Reference
Line 17: Line 17:
   * https://github.com/devicetree-org/devicetree-specification/blob/master/source/source-language.rst   * https://github.com/devicetree-org/devicetree-specification/blob/master/source/source-language.rst
  
-==== General ====+===== General =====
  
 Use c-style ''#include'' instead of DT-specific ''/include/'' Use c-style ''#include'' instead of DT-specific ''/include/''
Line 28: Line 28:
  
  
- +===== Defining software partitions in all DTS targets =====
-==== Defining software partitions in all DTS targets ====+
  
 Partition nodes should be named ''partition@<start address>'' Partition nodes should be named ''partition@<start address>''
Line 37: Line 36:
 The MTD labels of "firmware" and "ubi" have special meaning to the OpenWrt kernel. The MTD labels of "firmware" and "ubi" have special meaning to the OpenWrt kernel.
  
-See below on supplying the proper "compatible" label so that the OpenWrt kernel can properly "split" the partition and ''CONFIG_MTD_SPLIT_FIRMWARE'' is not needed.+See below on supplying the proper "compatible" label so that the OpenWrt kernel can properly "split" the partition and ''CONFIG_MTD_SPLIT_FIRMWARE'' is not needed. (note that ''CONFIG_MTD_SPLIT_UIMAGE_FW'' is still required!)
  
 <WRAP center round info 80%> <WRAP center round info 80%>
Line 50: Line 49:
  
 I'd like all DTS supported devices to use that "compatible" and disable CONFIG_MTD_SPLIT_FIRMWARE eventually. I'd like all DTS supported devices to use that "compatible" and disable CONFIG_MTD_SPLIT_FIRMWARE eventually.
 +
 +//Wiki note: This objective may be a challenge for dual-firmware units as the partition to be split will be different depending on which was selected by the boot loader.//
  
 1) Default uimage\\ 1) Default uimage\\
  • Last modified: 2019/02/20 19:43
  • by jeff