Apple Models

Various information about Apple hardware (current database status).

Improving database

To add a new hardware board, please create a file in DataBase directory, and then run ./update_generated.py. It should not output anything and return zero code.

To install PyYAML on macOS use the following commands:

sudo -H python3 -m pip install pyyaml

Unpacking firmware

To update the database you can either get the information from firmware images or from running hardware. There currently are two places for firmware images: FirmwareUpdate.pkg for generic models and BridgeOSUpdateCustomer.pkg for T2 models (the entire restore list is available at mesu.apple.com) To use them do as follows:

1. Visit suitable update catalogue by filling the OS versions (e.g. this one for macOS 14 beta).
   Note: This catalogue does not include FirmwareUpdate.pkg for macOS 11+. You can extract firmware images for generic models from Install macOS Big Sur.app (or newer).
2. Download most recent FirmwareUpdate.pkg and BridgeOSUpdateCustomer.pkg.
3. Extract scap and fd files from FirmwareUpdate.pkg and use them as is.
4. Extract /usr/standalone/firmware/bridgeOSCustomer.bundle/Contents/Resources/UpdateBundle.zip file from BridgeOSUpdateCustomer.pkg and unpack it.
5. After unpacking UpdateBundle.zip go to boot/Firmware/MacEFI directory and unpack im4p files. You can use img4, img4tool, or our dedicated MacEfiUnpack. For example, for i in *.im4p ; do ./MacEfiUnpack.py "$i" ; done