The iPhone Wiki is no longer updated. Visit this article on The Apple Wiki for current information. |
DeviceTree
The device tree is a representation of hardware used by the boot loaders (iOS's iBoot and OS X's boot.efi
) to provide the kernel with a mapping of hardware. The tree is a hierarchical representation of devices by connection, somewhat similar to Solaris's device tree (/devices
), and Linux's /sys/devices
(see device tree on Wikipedia for more context). It is used extensively by the boot loader, as it populates the various entries of the tree, and then passes it to XNU (the kernel). XNU's platform expert then maps these addresses and uses them to communicate with the I/O buses and other low level hardware.
The device tree is packaged as an IMG3 or IM4P file and is located in the IPSW at /Firmware/all_flash/all_flash.{BoardCode}.production/DeviceTree.{BoardCode}.RELEASE.img3/im4p
on production devices or /Firmware/all_flash/all_flash.{BoardCode}.factoryfa/DeviceTree.{BoardCode}.DEVELOPMENT.img3/im4p
on development devices. They are the same for every firmware for the device they are for, however, the keys are different every build. After iOS 10, almost all the img4 images for 64-bit devices are not encrypted, so it's possible to extract device trees from im4p files and dump them. E.g., with img4tool, we can do something like img4 -image DeviceTree.d211ap.im4p devicetree-d211ap.bin
to get device tree into devicetree-d211ap.bin
. Then we can use dtdump
to dtdump devicetree-d211ap.bin