Cobalt64 README

项目的 README,来自 github.com/Almosst-DEV/Cobalt64。合并为一个 markdown 文件:README.md。

Cobalt64 logo

Cobalt64

The first open-source GPU-accelerated graphics driver for macOS.
Native Metal acceleration for modern AMD Radeon GPUs that Apple does not support.

Website License: MIT Status: preview

macOS Tahoe 26.6.2 Bootloader: OpenCore

Visit cobalt64.com to check whether your graphics card is supported, read how Cobalt64 works and get the first public release when it ships.


About

Apple's own AMD drivers end with RDNA 2. Cobalt64 is an open-source graphics driver that brings modern Radeon GPUs to macOS: it brings up the GPU itself, runs Metal on top of a macOS port of Mesa's RADV Vulkan driver, and drives the displays natively.

The first supported family is RDNA 4, starting with the Radeon RX 9070 XT (Navi 48), where all development and testing happens today. Other families (for example RDNA 3 / RX 7000) are future work: much of the stack is shared, but each GPU generation needs its own display and power-management bring-up, and someone with that hardware to test it.

Status

Reached on one x86_64 test PC with an RX 9070 XT, macOS Tahoe 26.6.2, booted through OpenCore:

This is a preview: a lot is still rough, display modes are limited to what the test PC's monitors needed, and many pieces work around one specific macOS build.

In progress

Can I install this?

Not yet. Wait for the first public release; it will come with an installer and a step-by-step guide on cobalt64.com. This repository is the source code, and running it today needs a lot of manual setup on a separate macOS install.

What this repo contains

Path Contents
src/navi48-bringup Bring-up kext (IOKit): PCIe/BAR setup, IP discovery, PSP/SMU/GMC/GFX/SDMA/MES initialisation, display (DCN 4.1) mode-setting, a user client ("N48N") exposing buffers, command submission and scanout, and hooks into Apple's AMDRadeonX6000 accelerator.
src/dcn41 DCN 4.1 display-engine helpers and generated register headers (derived from Linux amdgpu, MIT).
src/xlat12 Command-stream translation from Apple's GFX10.3 PM4/register programming to gfx12.
src/g2capture Small capture tool for Apple shader-compiler records.
tools/native navi48metal (a Metal device bundle that runs Metal on top of the Vulkan driver), mtlprobe (API probe), autotranslate (AIR -> SPIR-V translation scripts) and navi48accel (aux kext).
tools/pc, tools/dcn41, tools/conductor PC-side test CLI and run scripts, display-register tooling, test suite runners and "planted break" mutation tests.
mesa-patches RADV (Mesa Vulkan) Darwin port as nine patches on a pinned Mesa commit; see mesa-patches/README.txt.

External projects and dependencies (not vendored; clone them yourself)

Project Where Notes
RDNA4FB https://github.com/somestupidgirl/RDNA4FB display-only RDNA4 kext, MacKernelSDK
mac-amdgpu https://github.com/lemonade-sdk/mac-amdgpu Navi 48 bring-up on macOS
USBToolBox https://github.com/USBToolBox/tool USB port mapping, optional
metal2vulkan https://github.com/steelbrain/metal2vulkan Metal AIR -> SPIR-V translator, LGPL-3.0-or-later; upstream is not included. Our changes and the n48xlate in-process wrapper are in third-party/metal2vulkan-n48/, LGPL-3.0, separate from the MIT code here; see its NOTICE
Mesa https://gitlab.freedesktop.org/mesa/mesa RADV, MIT; see mesa-patches/
linux-firmware AMD firmware blobs, own licence; see above

Credits

RDNA4FB (Sunneva N. Mariudottir), mac-amdgpu (lemonade-sdk / Geramy Loveless), the Mesa project (RADV and the register databases), the Linux amdgpu driver authors at AMD and the community (register definitions and documentation), and the metal2vulkan author (steelbrain).

Cobalt64 is an independent project and is not affiliated with or endorsed by AMD or Apple. AMD, Radeon and RDNA are trademarks of Advanced Micro Devices, Inc. Apple, Mac, macOS and Metal are trademarks of Apple Inc. Kernel extensions write directly to the hardware: use at your own risk.

Cobalt64 (Almosst-DEV/Cobalt64)

正在搜索数据库…

这是什么?Cobalt64 是一款开源 GPU 驱动,能为 macOS 官方不支持的新款 AMD Radeon 显卡带来原生 Metal 加速,首批支持 RX 9070 XT(RDNA4,Navi 48)。
这是我需要安装的应用,还是底层内核代码?它属于底层代码:一个内核驱动(IOKit kext)负责启动 GPU 和显示输出,另外还有移植过来的 Mesa RADV Vulkan 驱动,以及运行在其之上的 Metal-on-Vulkan 组件包,并不是面向普通用户的应用。
现在怎样才能在我的 Mac 上运行它?目前还无法安装:没有安装程序,作者建议等待首个公开发布版本,届时会在 cobalt64.com 提供分步指南。若现在要运行源代码,需要在另一台独立安装的 macOS 上做大量手动配置。
要尝试这个,我需要什么硬件?需要一块 AMD Radeon RX 9070 XT(Navi 48,RDNA4),并安装在通过 OpenCore 引导的 x86-64 黑苹果上。目前所有开发和测试都是在一台这样的机器上完成的,运行的是 macOS Tahoe 26.6.2。
它现在做到什么程度了?能日常使用吗?这还是早期预览版:显示模式仅限于测试显示器所需的范围,Safari 以及 Chromium/Electron 应用还无法在 GPU 上渲染,而且很多部分都只针对某一个特定的 macOS 版本。
所有代码都使用同一个 MIT 许可证吗?驱动和 kext 的大部分代码采用 MIT 许可证,但附带的 metal2vulkan 分支(将 Metal AIR 转换为 SPIR-V)采用 LGPL-3.0-or-later 许可证,并单独放在 third-party/ 目录中。
为什么目前只支持 RDNA4(RX 9070 XT)?所有现有的开发和测试都集中在 RDNA4 上。RDNA3/RX 7000 等其他系列与之共享大部分软件栈,但每一代显卡都需要各自的显示和电源管理适配,还需要有人持有对应的硬件来进行测试。
Cobalt64 目前实际能在 GPU 上跑起来的是什么?在测试环境中,它能驱动三台显示器(一台 DisplayPort、两台 HDMI)上由 GPU 合成的桌面,由 WindowServer 的 Metal 合成器负责合成。地图、预览、照片、系统设置和音乐等内置应用,也越来越多地通过它渲染。
目前还在开发哪些内容?HDMI 的 4K 输出、更流畅的帧节奏和更高的刷新率、Safari 以及 Chromium/Electron 应用的 GPU 渲染、基于 EDID 的显示模式(替代固定模式),以及硬件视频解码。
Cobalt64 还依赖哪些其他项目?它依赖一些独立的、未内置在仓库中的项目:用于 GPU 启动的 RDNA4FB 和 mac-amdgpu,用于 USB 端口映射的 USBToolBox,用于 RADV Vulkan 驱动的 Mesa,用于 AIR 到 SPIR-V 转换的 metal2vulkan,以及 AMD 的 linux-firmware 固件二进制文件。
大小
7.4 MB
星标
204
更新
提交Oct 15
时长
1个月
提交 · 90 天