DeviceTree - Revision history

Freedom at 05:43, 22 November 2018

2018-11-22T05:43:24Z

H3adsh0tzz: Added link to iPhone XS Max Device Tree.

2018-10-06T11:32:56Z

Added link to iPhone XS Max Device Tree.

OothecaPickle: woops

2018-04-11T06:21:50Z

woops

OothecaPickle: add updated version of imagine

2018-04-11T06:20:22Z

add updated version of imagine

Freedom: /* See Also */

2017-11-28T02:44:38Z

‎See Also

Freedom: update information of img4 non-encrypted device tree

2017-11-28T02:41:00Z

update information of img4 non-encrypted device tree

AS967 at 21:27, 31 July 2016

2016-07-31T21:27:40Z

AS967 at 20:04, 21 July 2016

2016-07-21T20:04:44Z

IAdam1n: Updating

2015-10-13T09:08:18Z

Updating

Awesomebing1: Add header

2015-05-10T19:50:16Z

Add header

← Older revision		Revision as of 05:43, 22 November 2018
Line 1:		Line 1:
	The '''device tree''' is a representation of hardware used by the boot loaders (iOS's [[iBoot (Bootloader)\|iBoot]] and OS X's <code>boot.efi</code>) 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 (<code>/devices</code>), and Linux's <code>/sys/devices</code> (see [https://en.wikipedia.org/wiki/Device_tree 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 [[kernelcache\|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 a representation of hardware used by the boot loaders (iOS's [[iBoot (Bootloader)\|iBoot]] and OS X's <code>boot.efi</code>) 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 (<code>/devices</code>), and Linux's <code>/sys/devices</code> (see [https://en.wikipedia.org/wiki/Device_tree 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 [[kernelcache\|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 File Format\|IMG3]] or [[IMG4 File Format\|IM4P]] file and is located in the [[IPSW File Format\|IPSW]] at <code>/Firmware/all_flash/all_flash.{BoardCode}.production/DeviceTree.{BoardCode}.RELEASE.img3/im4p</code> on production devices or <code>/Firmware/all_flash/all_flash.{BoardCode}.factoryfa/DeviceTree.{BoardCode}.DEVELOPMENT.img3/im4p</code> on development devices. They are the same for every firmware for the device they are for, however, the [[Firmware Keys\|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 something like <code>img4 -image DeviceTree.d211ap.im4p devicetree-d211ap.bin</code> to get device tree into <code>devicetree-d211ap.bin</code>. Then we can use <code> dtdump </code> to <code>dtdump devicetree-d211ap.bin</code>	+	The device tree is packaged as an [[IMG3 File Format\|IMG3]] or [[IMG4 File Format\|IM4P]] file and is located in the [[IPSW File Format\|IPSW]] at <code>/Firmware/all_flash/all_flash.{BoardCode}.production/DeviceTree.{BoardCode}.RELEASE.img3/im4p</code> on production devices or <code>/Firmware/all_flash/all_flash.{BoardCode}.factoryfa/DeviceTree.{BoardCode}.DEVELOPMENT.img3/im4p</code> on development devices. They are the same for every firmware for the device they are for, however, the [[Firmware Keys\|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 <code>img4 -image DeviceTree.d211ap.im4p devicetree-d211ap.bin</code> to get device tree into <code>devicetree-d211ap.bin</code>. Then we can use <code> dtdump </code> to <code>dtdump devicetree-d211ap.bin</code>

@@ Line 7: / Line 7: @@
 * [[N88AP|iPhone 3GS]]'s [[N88AP/Device Tree|Device Tree]]
 * [[D211AP|iPhone 8 Plus (D211AP)]]'s [[D211AP/Device Tree|Device Tree]]
 == External Links ==

@@ Line 9: / Line 9: @@
 == External Links ==
-* IMG3 display tool, with device tree parser ([http://www.newosxbook.com/src.jl?tree=listings&file=6-bonus.c source] and [http://www.newosxbook.com/src.jl?tree=listings&file=dt.h header] or [http://www.newosxbook.com/forum/viewtopic.php?f=3&t=16576#p17126])
+* IMG3 display tool, with device tree parser ([http://www.newosxbook.com/src.jl?tree=listings&file=6-bonus.c source] and [http://www.newosxbook.com/src.jl?tree=listings&file=dt.h header] or use the updated version from [http://www.newosxbook.com/forum/viewtopic.php?f=3&t=16576#p17126 here])
 * IMG4 tool [https://github.com/xerub/img4tool img4tool]
 * dtdump, a simple program to dump iOS device tree derived from the IMG3 display tool, [https://github.com/freedomtan/iOS-device-tree-dump dtdump]

@@ Line 9: / Line 9: @@
 == External Links ==
-* IMG3 display tool, with device tree parser ([http://www.newosxbook.com/src.jl?tree=listings&file=6-bonus.c source] and [http://www.newosxbook.com/src.jl?tree=listings&file=dt.h header])
+* IMG3 display tool, with device tree parser ([http://www.newosxbook.com/src.jl?tree=listings&file=6-bonus.c source] and [http://www.newosxbook.com/src.jl?tree=listings&file=dt.h header] or [http://www.newosxbook.com/forum/viewtopic.php?f=3&t=16576#p17126])
 * IMG4 tool [https://github.com/xerub/img4tool img4tool]
 * dtdump, a simple program to dump iOS device tree derived from the IMG3 display tool, [https://github.com/freedomtan/iOS-device-tree-dump dtdump]

@@ Line 6: / Line 6: @@
 == See Also ==
 * [[N88AP|iPhone 3GS]]'s [[N88AP/Device Tree|Device Tree]]
-* [[D211AP|D211AP]]'s [[D211AP/Device Tree|Device Tree]]
+* [[D211AP|iPhone 8 Plus (D211AP)]]'s [[D211AP/Device Tree|Device Tree]]
 == External Links ==

@@ Line 1: / Line 1: @@
 The '''device tree''' is a representation of hardware used by the boot loaders (iOS's [[iBoot (Bootloader)|iBoot]] and OS X's <code>boot.efi</code>) 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 (<code>/devices</code>), and Linux's <code>/sys/devices</code> (see [https://en.wikipedia.org/wiki/Device_tree 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 [[kernelcache|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 File Format|IMG3]] file and is located in the [[IPSW File Format|IPSW]] at <code>/Firmware/all_flash/all_flash.{BoardCode}.production/DeviceTree.{BoardCode}.RELEASE.img3/im4p</code> on production devices or <code>/Firmware/all_flash/all_flash.{BoardCode}.factoryfa/DeviceTree.{BoardCode}.DEVELOPMENT.img3/im4p</code> on development devices. They are the same for every firmware for the device they are for, however, the [[Firmware Keys|keys]] are different every build.
+The device tree is packaged as an [[IMG3 File Format|IMG3]] or [[IMG4 File Format|IM4P]] file and is located in the [[IPSW File Format|IPSW]] at <code>/Firmware/all_flash/all_flash.{BoardCode}.production/DeviceTree.{BoardCode}.RELEASE.img3/im4p</code> on production devices or <code>/Firmware/all_flash/all_flash.{BoardCode}.factoryfa/DeviceTree.{BoardCode}.DEVELOPMENT.img3/im4p</code> on development devices. They are the same for every firmware for the device they are for, however, the [[Firmware Keys|keys]] are different every build.
 == See Also ==

← Older revision		Revision as of 19:50, 10 May 2015
Line 7:		Line 7:

	== External Links ==		== External Links ==
−	* [http://www.newosxbook.com/src.jl?tree=listings&file=6-bonus.c ~~IMG3~~ ~~display tool, with device~~ tree ~~parser~~]	+	* IMG3 display tool, with device tree parser ([http://www.newosxbook.com/src.jl?tree=listings&file=6-bonus.c source] and [http://www.newosxbook.com/src.jl?tree=listings&file=dt.h header])