Skip to content

Releases

Radeonized - v0.1.0

Choose a tag to compare

@FranciumOS-org FranciumOS-org released this 12 Nov 02:57

The first release of Radeonized. It brings graphics acceleration to the AMD Radeon 680M (Rembrandt) on macOS: Metal 3, the panel driven by the driver's own framebuffer, working brightness, and the board's video BIOS found by the driver itself.

Tested on an ASUS TUF A15. That is one machine, so treat this as a preview and keep a USB stick that boots OpenCore without the driver.

New

No VBIOS step. A release build carries no video BIOS, because the image belongs to the board vendor. Until now that meant dumping it by hand with a debug OpenCore build, injecting it into the kext and rebooting twice. The driver now reads the board's own image out of the machine's ACPI table, in the kernel, at boot. Nothing to prepare.

Acceleration. System Information lists AMD Radeon 680M with Metal 3. Metal output is bit-exact against the reference, the driver's framebuffer owns the panel while Apple's compositor draws to it, and USB runs on real interrupts.

WebGL and MSAA render. Multisampled surfaces used to fail to allocate, which left browser pages and WebGL games blank. They draw correctly now, around 100 fps.

Rescue without reinstalling. sudo nvram rbgpu-arm=0 turns the accelerator off next boot, -rbgpustock turns every default off, and -rbgpuoff leaves the driver loaded doing nothing. A boot that dies within a minute brings the next one up stock on its own, so a bad boot does not trap anyone. Recovery and the macOS installer always boot stock.

Not working

External displays. Type-C DP alt mode reaches the chip and the clock runs, but the display PHY stays held in reset and the stream never comes up. The whole record is in docs/JOURNAL.md under tags 300 to 310, including everything already ruled out, so nobody repeats it.

HDMI together with brightness. On this chassis HDMI is wired to the discrete GPU and the backlight follows whichever GPU owns the display, so the firmware has to be in iGPU-only mode. A wiring limit, not a driver one.

Testers

Reports from other Rembrandt machines are the most useful thing right now. After a boot, open an issue with the machine, the macOS version, and the output of:

ioreg -rl -c RembrandtGPUPeer | tr ',' '\n' | grep -E '"(armed|arm_why|vbios_src|acpivb[a-z_]*|hwlibs_gate[a-z_]*|yc_swapped)"'

armed 1 with arm_why 0 means the boot was armed; nothing else means anything if it was not. vbios_src 3 with acpivbios 0 means the VBIOS came from the machine's own ACPI table. Any other acpivbios value is a refusal code, and that is exactly the report worth sending.

Known issues

A first boot that hangs at the progress bar. On the reference machine, two
cold boots (from a full power-off, rather than a restart) wedged a few seconds
in, with the Apple logo's progress bar filling and never finishing, while warm
restarts kept working. The cause is not yet identified and is being
investigated. If this happens to you, your Mac is fine and your data is
fine:
hold the power button, boot again, and add -rbgpuoff to your
boot-args in OpenCore's config.plist. The driver then loads and does
nothing, and you get a normal desktop. Recovery also always boots without the
driver.

Please report it with the output of the diagnostics command above, your
machine, and whether the boot was cold or a restart. That is the single most
useful thing anyone can send right now.

Installing

Radeonized-0.1.0.zip holds both kexts. RembrandtGPU.kext goes in EFI/OC/Kexts, right after Lilu.kext; RBAMDFramebuffer.kext goes in /Library/Extensions, then the auxiliary kext collection is rebuilt. Needs OpenCore with Lilu loaded first and SIP relaxed enough for unsigned kexts. README-INSTALL.md inside the zip has the UUIDs to check, how to read whether a boot worked, and the rescue ladder.

Radeonize-0.1.0.dmg is the optional installer app. It finds the EFI partition, backs up what it replaces, installs both kexts, verifies them and rolls back if verification fails. Ad-hoc signed, so right-click and Open the first time.

The AMD microcode inside the kext is AMD's, redistributable in binary form only; its licence travels inside the bundle and the zip as LICENSE.amdgpu. No board's video BIOS is in either download or in the repository.

SHA-256:

Radeonized-0.1.0.zip: ed65e64d8415b5b2f20aef3d9a44fa6779898d2d7b02af81849bf37de02e41ab (also in Radeonized-0.1.0.zip.sha256, which the installer app checks the download against)

Radeonize-0.1.0.dmg: fb4f97d30c3dd8581beab086400e93c8d2bef3f877a1fe32364aed7623d7e443