====== Configure Flattened Device Tree ======

===== Synopsis =====

    fdt [--timeout <timeout>] <uri|image>


===== Examples =====

=== Boot a kernel with an initrd and device tree blob ===

    #!ipxe

    kernel /images/vmlinuz console=ttyAMA0
    initrd /images/initrd.img
    fdt /images/rk3566-radxa-zero-3e.dtb
    boot

===== Description =====

Downloads the specified image and configures it for use as a Flattened Device Tree (FDT).  A download progress timeout can be specified (in milliseconds) using the ''%%--timeout%%'' option.

The device tree will be passed automatically to any supported executable image.

===== Command status =====

^ Success   | The FDT was successfully downloaded                                  |
^ Failure   | The FDT was not successfully downloaded                              |

===== See also =====

  * ''[[:cmd:kernel]]''
  * [[:cmd|List of all iPXE commands]]

===== Notes =====

The terms "flattened device tree (FDT)" and "device tree blob (DTB)" are equivalent.

The downloaded device tree does not in any way affect the device tree used by iPXE itself.  It controls only the device tree that will be passed to the booted operating system.

If your firmware already provides a working device tree to iPXE, then you do not need to use this command.  iPXE will default to passing through the working device tree to the booted operating system.