Repository navigation
Tell T2 Mac owners to save their Wi-Fi firmware before installing - #16427
omarchybot wants to merge 8 commits into
Conversation
The Mac support page said the installer sets up Apple's Broadcom Wi-Fi and Bluetooth firmware on T2 Macs. It cannot on the only supported install: fix-t2.sh installs apple-bcm-firmware-fetcher, which only reads the firmware off an on-disk macOS volume, and the single-OS install has already wiped it. The page now says so, and tells T2 owners to save the firmware with t2linux's tarball method before installing, or to use its recovery-image method afterwards. Co-Authored-By: Codex Medium <noreply@openai.com> Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
[Low impact] The PR changes guidance for T2 Mac owners preparing to install. The PR should not merge while the guide still promises a firmware backup that the installer does not perform. Findings
SummaryAdds a T2 firmware section to the Mac installation guide.
Reviews (5) · Last reviewed commit: "Say the T2 firmware comes from the insta..." · Reviewed by Greptile |
A USB volume name often has a space in it, which splits an unquoted path. The page also said the fetcher reads macOS "on the same drive it wipes", which is more than the code shows: it reads an on-disk macOS volume, and the install wipes it. Co-Authored-By: Codex Medium <noreply@openai.com> Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The page's list of T2 models leaves out several, among them the 2019 and 2020 MacBook Air and the 16-inch MacBook Pro, so an owner who looked their Mac up there could skip saving the firmware. Apple's System Information check covers every model. Co-Authored-By: Codex Medium <noreply@openai.com> Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
|
Reviewed as a documentation change: only Codex Medium reviewed it over three rounds, and three small fixes were pushed to this branch:
The last round, at 04fc239, found nothing open. Codex also noticed that the T1 list on this page has the port counts of A1706 and A1708 the wrong way round. That was there before this pull request, so it is left out of it. Codex read the same repository and sources, so its agreement is not guaranteed to be independent; the three fixes above are its own findings. CI is green. This still refers to #16287 rather than closing it, because the installer itself still fetches the firmware after macOS is gone. It now waits on the maintainer. |
The firmware may only be taken from macOS, which a single-boot install wipes before fix-t2.sh runs, so apple-bcm-firmware-fetcher always came up empty. The ISO is to save it before the disk is written, into the firmware stage it already carries into the target for Qualcomm; fix-t2.sh now installs whatever it finds under firmware-stage/apple-bcm into /lib/firmware/brcm and writes the fetcher's record of it, so removing the fetcher removes them as before. The manual drops the manual save for the installer doing it. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
omacom/omarchy-iso#356 saves the firmware from macOS before the disk is written and installs it into the target's /usr/lib/firmware/brcm, with the fetcher's installed-files record, before omarchy-apply-system runs. It never writes the firmware stage fix-t2.sh read, so that block and its test would only be dead code; fix-t2.sh goes back to quattro's. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
|
|
||
| #### Wi-Fi Firmware on T2 Macs | ||
|
|
||
| On a Mac with a T2 chip, the Wi-Fi and Bluetooth firmware can only be taken from macOS, so the installer saves it from macOS before it wipes the drive and puts it in place on the new system. Leave macOS installed until then. |
There was a problem hiding this comment.
Firmware backup does not happen
This paragraph promises that the installer saves T2 firmware before wiping macOS, but no such step exists. fix-t2.sh only installs apple-bcm-firmware-fetcher during target-side hardware setup. Its own comment says the fetch fails once macOS has been wiped.
Owners who follow this advice without saving the firmware can finish installing with no Wi-Fi or Bluetooth. Replace the automatic-backup claim with instructions to save the firmware to a second USB drive before installing and restore it afterwards, as the PR description proposes.
Knowledge Base Used: Hardware, devices, and power
Saving the firmware is best-effort in the ISO: when the macOS volume is gone or unreadable it logs a warning and installs anyway, so the recovery-image fallback applies then too. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Co-Authored-By: Codex Medium <noreply@openai.com>
|
The maintainer asked for a technical fix rather than a manual step before installing, so this pull request no longer asks T2 owners to save the firmware themselves. That fix lives in the installer, and it already exists: omacom/omarchy-iso#356 by @piotrsynowiec. Before the disk is cleaned, it runs What this pull request now changes is Codex Medium and muse-wonder (via pi, thinking high) reviewed it. Both found that an earlier wording promised the save unconditionally, while #356 is best-effort. The fallback now covers an install where macOS could not be read. That last one-line change has not been through another review round. Codex read the same sources, so its agreement elsewhere is not guaranteed to be independent. Nothing was run for this pull request, since it changes Markdown only. #356 itself has not yet been tested on a T2 Mac that still has macOS installed; its description says so. This should merge only once #356 is in an ISO people download. Until then the page describes behaviour the current installer does not have. It waits on the maintainer, and on #356. |
The page said the firmware can only be taken from macOS and then offered Apple's recovery image as a source, which reads as a contradiction. The installer reads the Mac's installed macOS; the recovery image is the fallback, and the iMac Pro has only the installed copy. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Co-Authored-By: Codex Medium <noreply@openai.com>
|
Pushed 2faf818, a wording fix to The rest of the section was checked against omacom/omarchy-iso#356 at 7ddaf50 and holds. Greptile's inline note, "Firmware backup does not happen", was made against 1570f8e. It is right about Two more things for the maintainer. The pull request description still describes the earlier manual-save version: this session has no checked command for editing it, so it is left as it is. And #16673 by @heymaaz rewrites the same T2 paragraphs on this page as part of documenting dual boot. The two will conflict, and #16673 still says a full-disk install may leave a T2 Mac without Wi-Fi. Codex Medium and muse-wonder (via pi, thinking high) reviewed the section at 8515f9e. muse-wonder found nothing open. Codex could not reach GitHub to read #356, and it raised the wording issue fixed above. Both found nothing open in the fix. Codex read the same sources, so its agreement is not guaranteed to be independent. Nothing was run, since the change is Markdown only. This still waits on #356 reaching a released ISO, and on the maintainer. |
The Mac support page tells T2 owners the installer sets up Apple's Broadcom Wi-Fi and Bluetooth firmware. On the only install the page supports, it cannot.
install/hardware/apple/fix-t2.shinstallsapple-bcm-firmware-fetcher, which takes the firmware from an on-disk macOS volume and nowhere else, and runs in the installed system after the single-OS install has wiped that volume. Its install hook reports the failure and carries on, so the Mac boots with no Wi-Fi interface, and a T2 MacBook has no Ethernet port to get the firmware with.This corrects the page: it drops the claim from the T2 section and from the general list of fixes, and adds a step before installing that has T2 owners save the firmware with t2linux's tarball method (Method 2) to a second USB drive, with the one command that puts it in place afterwards. For a Mac whose macOS is already gone, it points at t2linux's recovery-image download, which needs another connection and does not work on the iMac Pro. Only the English chapter changes; the translation sync picks it up, per
docs/i18n.md.It does not fix the installer. Fetching the firmware while macOS is still on the drive, then installing it into the target, has to happen in the ISO's installer before partitioning, which is the maintainer's call, so #16287 stays open for it.
Refs #16287
Reviewed by Codex Medium and muse-spark-1.3-contributor via pi, thinking high.
🤖 Generated by Opus 5.5 in Claude Code. Reviewed by Codex Medium and muse-spark-1.3-contributor High.