README.KARO-FDT

   1                                  Managing the device tree data in U-Boot
   2                                  =======================================
   3
   4 The 'fdt' command can be used to manipulate the device tree (DT) data
   5 that is passed from U-Boot to Linux.
   6
   7 - 'fdt boardsetup' will trim out some device nodes according to
   8   environment settings:
   9
  10 Environment setting             removed nodes
  11 otg_mode=host                   usbh1
  12 otg_mode=device                 usbotg
  13 otg_mode=<UNSET>                <both of the above> + usbphy
  14
  15 touchpanel=edt-ft5x06           ti,tsc2007
  16 touchpanel=tsc2007              edt,edt-ft5x06
  17 touchpanel=<UNSET>              <both of the above>
  18
  19 Note: This command is automatically executed when booting Linux via
  20       the 'bootm_cmd' environment variable.
  21
  22 - 'fdt rm' and 'fdt add' can be used to remove/create additional nodes
  23
  24 The whole DT data can be saved to and reloaded from the 'dtb' (or any
  25 other) partition:
  26   nand erase.part dtb
  27   nand write.jffs2 ${fdtcontroladdr} dtb
  28
  29 Note: To prevent U-Boot from overwriting data in the succeeding
  30 partition when encountering bad blocks in the 'dtb' partition, it is
  31 wise to explicitly specify the write size according to 'totalsize'
  32 displayed by the command 'fdt header':
  33 TX53 U-Boot > fdt header
  34 magic:                  0xd00dfeed
  35 totalsize:              0x3f9e (16286)
  36 off_dt_struct:          0x78
  37 off_dt_strings:         0x2bb8
  38 off_mem_rsvmap:         0x28
  39 version:                17
  40 last_comp_version:      16
  41 boot_cpuid_phys:        0x0
  42 size_dt_strings:        0x3e6
  43 size_dt_struct:         0x2b40
  44 number mem_rsv:         0x0
  45 TX53 U-Boot > nand write.jffs2 ${fdtcontroladdr} dtb 3f9e
  46
  47 If a DT is loaded from flash which should not be further manipulated
  48 upon booting Linux, the string 'fdt boardsetup;' should be removed
  49 from the 'bootm_cmd' environment variable.
  50
  51 Loading the DT data:
  52   nand read ${fdtcontroladdr} dtb