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 с открытым исходным кодом, который обеспечивает нативное ускорение Metal на современных видеокартах AMD Radeon, которые macOS официально не поддерживает, начиная с RX 9070 XT (RDNA4, Navi 48).
Это приложение, которое я устанавливаю, или низкоуровневый код ядра?Это низкоуровневый продукт: драйвер ядра (IOKit kext), который запускает видеокарту и дисплеи, а также портированный драйвер Mesa RADV Vulkan и пакет Metal-поверх-Vulkan, работающий на его основе. Это не приложение для конечных пользователей.
Как мне запустить это на своем Mac прямо сейчас?Пока установить нельзя: установщика нет, и автор советует дождаться первого публичного релиза с пошаговым руководством на cobalt64.com. Запуск текущего исходного кода требует большого объема ручной настройки на отдельной установке macOS.
Какое оборудование нужно, чтобы вообще это попробовать?Видеокарта AMD Radeon RX 9070 XT (Navi 48, RDNA4) в хакинтоше на x86-64, загружаемом через OpenCore. Вся текущая разработка и тестирование велись на одной такой машине под управлением 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, используют во многом тот же стек, но для каждого поколения GPU нужна собственная настройка дисплеев и управления питанием, а также тестировщик, у которого есть это оборудование.
Что Cobalt64 на самом деле уже запускает на GPU?На тестовом стенде он выводит рабочий стол, композитируемый на GPU, на три дисплея (один DisplayPort и два HDMI) с Metal-композитором WindowServer. Через него уже работает растущий набор встроенных приложений: Карты, Просмотр, Фото, Системные настройки и Музыка.
Над чем еще работают?Вывод 4K по HDMI, более плавная смена кадров и более высокие частоты обновления, отрисовка на GPU для Safari и приложений на Chromium/Electron, режимы дисплея на основе EDID вместо фиксированных, а также аппаратное декодирование видео.
На каких других проектах основан Cobalt64?Он зависит от отдельных проектов, которые не включены в репозиторий: RDNA4FB и mac-amdgpu для запуска GPU, USBToolBox для сопоставления USB-портов, Mesa для драйвера RADV Vulkan, metal2vulkan для перевода AIR в SPIR-V, а также бинарные прошивки AMD из linux-firmware.
Какие есть похожие проекты?nvidia-macos-driver, solo, UniXNU, open-gpu-kernel-modules, MoltenVK, gpu-unlock, moxnox, bgfx
Автор
Almosst-DEV
Размер
7.4 MB
Звёзды
204
Обновлён
КоммитOct 15
Возраст
1 мес
Коммиты · 90 дней