FW:ADT

When Apple firmware boots a kernel, it passes a device tree in a binary format. This format is very similar to, but different from, the Open Firmware standard expected by Linux.

Like Linux devicetrees, the Apple device tree (ADT) encodes a number of untyped byte arrays (properties) in a hierarchy of nodes. These describe the available hardware, or provide other information that Apple thinks the firmware might need to tell the kernel about. This includes identifying and secret information like serial numbers and WiFi keys.

The main difference between ADTs and Linux DTs is byte order; since properties are untyped, we can’t automatically correct for that.

Given hardware, you can access your ADT in a number of ways.

The easiest way is probably using m1n1 via adt.py

cd m1n1/proxyclient ; python -m m1n1.adt --retrieve dt.bin

This will write a file called “dt.bin” containing the raw (binary) ADT and print the decoded ADT.

Get a copy of xerub’s img4lib

git clone https://github.com/xerub/img4lib
cd img4lib
make -C lzfse
make
make install

Get a copy of tihmstar’s img4tool (you will also need his libgeneral as well as autoconf, automate, libtool, pkg-config, openssl and libelist-2.0).

git clone https://github.com/tihmstar/libgeneral.git
git clone https://github.com/tihmstar/img4tool.git

then for each

./autogen.sh
make
make install

copy the im4p file from the below directory. See Devices for Machine ‘j’ model details.

/System/Volumes/Preboot/[UUID]/restore/Firmware/all_flash/DeviceTree.{model}.im4p

If the dir doesn’t exist try disabling csrutil in recovery mode, going to settings and enabling terminal to acces all files, or start from Volumes/Macintosh HD/ because it may be symlinked. If it’s still not accessible, try good ol sudo find . -type f -name '*.im4p'.

then use img4tool to extract the im4p file into a .bin file e.g.

img4tool -e DeviceTree.j274ap.im4p -o j274.bin

To do the same with img4lib, do

img4 -i DeviceTree.j274ap.im4p -o j274.bin

You can get a textual representation of the ADT directly from macOS by running:

ioreg -p IODeviceTree -l

While this does not require decoding, it outputs much less information than using m1n1 (see below). Also it cuts off long lines with a dollar sign e.g.

"ranges" = <000000000000000000000000020000000000000001000000000000800300000000000080030000000000008001000000000000000500000000000000050000000000008001000000000000000400000000000000$

after m1n1 installation (see repo page)

cd m1n1/proxyclient

get construct python library (not a construct.py file, it’s a library)

pip install construct

copy obtained j{*}.bin file into proxyclient dir && extract by:

python -m m1n1.adt j{*}.bin

You can also get a memory map with the -a option:

python -m m1n1.adt -a j{*}.bin

Other ways?