You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 0112cda
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: ROADMAP-AMD.md
+17-11Lines changed: 17 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -64,12 +64,14 @@ Fait sous Linux (Ubuntu 24.04, noyau 6.14, Mesa 25.2.8) :
64
64
65
65
- J3 : les compilateurs de Stela sont construits avec la cible AMD et le frontal AIR (LLVM 23). La suite Metal tourne sur un Mac (M3 Pro, macOS 27.2.1) : 14 146 cas réussis, aucun échec. Les shaders de WindowServer, de CoreAnimation et de l'assistant de configuration compilent tous vers NIR pour gfx1201. Sur tout macOS, aucun refus n'est propre à AMD (`docs/amd/shaders.md`).
66
66
67
+
- J4 : le vrai périphérique Metal de Stela tourne sur la 9070 XT, sous Linux, sur un RADV construit à partir du Mesa de Stela avec le compilateur Metal (`libstela_radv.so`). Le premier calcul et le premier rendu sont vérifiés (`docs/amd/device.md`). Les corrections d'outillage de J3 sont proposées à upstream ([tylertms/Stela#160](https://github.com/tylertms/Stela/pull/160)).
68
+
67
69
À faire ensuite, dans cet ordre :
68
70
69
-
1.J2 : suivre la revue de la PR upstream sur la topologie ([tylertms/Stela#158](https://github.com/tylertms/Stela/pull/158)).
70
-
2.Proposer à upstream les corrections d'outillage trouvées en J3 : `offline` et `stela_metal_corpus`, les archives minces, `libdl.a`, `libm.a`. Puis ouvrir des tickets pour les familles de refus du frontal AIR.
71
-
3.J4 : ouvrir le vrai périphérique Metal sur RADV (`stela-amd-host --device`). C'est là que le NIR de J3 descendra jusqu'au code machine gfx1201.
72
-
4. J1, dernier point : le Ryzen 5 5600X n'a pas de puce graphique, et la 9070 XT est la seule sortie d'affichage. Avant le premier essai en VM, il faut ajouter une petite carte graphique pour l'écran de Linux, ou lancer l'essai par SSH et suivre la VM par VNC. Avec `--stop-desktop`, le bureau Linux s'arrête pendant l'essai. Noter ensuite combien d'essais d'affilée passent sans redémarrer l'hôte.
71
+
1.Suivre la revue des PR upstream [tylertms/Stela#158](https://github.com/tylertms/Stela/pull/158) (topologie, maintenant vérifiée sur le matériel) et [tylertms/Stela#160](https://github.com/tylertms/Stela/pull/160) (outillage).
72
+
2.J4 : écrire un exécuteur Linux du plan de la suite Metal (`metal-suite plan`), qui traduise chaque cas en appels au `Device`, et comparer ses résultats à ceux du Mac (14 146 cas). Mesurer au passage les alignements des surfaces linéaires.
73
+
3.J3 : ouvrir à upstream des tickets pour les familles de refus du frontal AIR.
74
+
4. J1, dernier point : le Ryzen 5 5600X n'a pas de puce graphique, et la 9070 XT est la seule sortie d'affichage. Avant le premier essai en VM, il faut ajouter une petite carte graphique pour l'écran de Linux, ou lancer l'essai par SSH et suivre la VM par VNC. L'utilisateur est maintenant dans le groupe `kvm`.
73
75
74
76
## Jalons
75
77
@@ -111,17 +113,21 @@ Sans GPU nécessaire. Mesure et commandes dans `docs/amd/shaders.md`.
111
113
-[x] Extraire les bibliothèques Metal de WindowServer (SkyLight), CoreAnimation (QuartzCore) et de l'assistant de configuration : `metal-suite coverage` les copie depuis un Mac sous macOS 27.2.1.
112
114
-[x] Les compiler toutes pour gfx1201 (`xtask/scripts/amd-macos-shaders.py`). Le corpus du démarrage passe en entier, sauf le constructeur BVH du ray tracing et une archive de CoreImage assemblée à l'exécution. Sur tout macOS, aucun refus n'est propre à AMD : gfx1201 et NVIDIA refusent les mêmes 13 319 points d'entrée sur 57 401.
113
115
-[ ] Ouvrir à upstream un ticket par famille de refus du frontal AIR commun (`air.signature`, bfloat, accès volatils, budget de métadonnées…).
114
-
-[ ] Descendre jusqu'à ACO : compiler ce NIR en code machine gfx1201, et étendre `coverage` à ce que le chemin ACO ne sait pas encore traduire. C'est à faire avec RADV, en J4.
116
+
-[ ] Descendre jusqu'à ACO pour tout le corpus : RADV compile désormais le NIR de Stela en code machine gfx1201 (J4). Reste à le faire pour tous les shaders de macOS et à étendre `coverage` à ce qu'ACO refuse.
115
117
116
118
**Terminé quand** tous les shaders de ce corpus compilent pour gfx1201, jusqu'au code machine. Le niveau NIR est atteint pour le corpus du démarrage.
117
119
118
-
### J4 : La couche Metal de Stela tourne sur RADV sous Linux
120
+
### J4 : La couche Metal de Stela tourne sur RADV sous Linux 🟡
121
+
122
+
Détails et commandes dans `docs/amd/device.md`.
119
123
120
-
-[ ] Construire les compilateurs de Stela avec la cible AMD (`cargo xtask gpu fetch`, Mesa et ses patches, option `compilers=amd`).
121
-
-[ ] Mode `--device` de `stela-amd-host` : ouvrir le vrai périphérique Metal (`NativeBackend` + `AirCompiler`) sur RADV, avec des noyaux internes compilés pour gfx1201.
122
-
-[ ] Premier calcul : addition de deux buffers, résultat vérifié.
123
-
-[ ] Premier rendu : un triangle dans une texture, comparé à une image de référence.
124
-
-[ ] Faire tourner la suite `metal-suite` directement contre le service, sans macOS invité.
124
+
-[x] Construire les compilateurs de Stela avec la cible AMD (`cargo xtask gpu fetch`, Mesa et ses patches, option `compilers=amd`).
125
+
-[x] Construire RADV à partir du Mesa de Stela, avec le compilateur Metal lié dans la même bibliothèque : `libstela_radv.so` (option Meson `radv-host`). Correctif RADV `third_party/patches/mesa/9001-radv-take-nir-stages.patch`, pour que RADV prenne le NIR d'un étage comme le fait NVK.
126
+
-[x] Mode `--device` de `stela-amd-host` (fonctionnalité Cargo `radv-host`) : le vrai périphérique Metal (`NativeBackend` + `AirCompiler`) s'ouvre sur RADV, et la mémoire partagée passe par `/dev/udmabuf`.
127
+
-[x] Premier calcul : 65 536 additions de flottants sur le GPU, résultat vérifié.
128
+
-[x] Premier rendu : un triangle dans une texture RGBA8, vérifié par son aire et la couleur de ses coins. Une bande de lignes, dessinée par le même pipeline sans classe de topologie, vérifie la PR #158 sur le matériel.
129
+
-[ ] Faire tourner la suite `metal-suite` directement contre le service, sans macOS invité. Il faut un exécuteur du plan côté Linux.
130
+
-[ ] Mesurer les vrais alignements des surfaces linéaires sur RADV.
125
131
126
132
**Terminé quand** la suite Metal passe sur la 9070 XT avec la même tolérance que sur NVIDIA.
# Le périphérique Metal de Stela sur la RX 9070 XT, sous Linux (J4)
2
+
3
+
Le 16 novembre 2026, le vrai périphérique Metal de Stela a tourné pour la première fois sur la Radeon. C'est le même code que celui qui servira macOS : `Device` sur `NativeBackend` et `AirCompiler`. Il tournait ici sous Linux, sur RADV.
4
+
5
+
```text
6
+
Metal device on 0000:07:00.0:
7
+
Metal device: open on RADV, with the AIR compiler for GFX12
8
+
buffer sum: 65536 floats added on the GPU and checked (628.81µs)
9
+
triangle: drawn into a 256x256 texture and checked, 18432 pixels covered (964.96µs)
10
+
line strip: the same unspecified-class pipeline drew 383 pixels (336.62µs)
11
+
RESULT: Stela's Metal device ran its work on the GPU.
12
+
```
13
+
14
+
-**Calcul** : un noyau Metal additionne deux buffers de 65 536 flottants, et le CPU vérifie chaque valeur.
15
+
-**Rendu** : un triangle aux sommets rouge, vert et bleu est dessiné dans une texture RGBA8, puis recopié dans un buffer partagé. Il couvre exactement l'aire attendue (18 432 pixels), et chaque coin a la couleur de son sommet.
16
+
-**Topologie** : le même pipeline, sans classe de topologie, dessine une bande de lignes. Sur RADV, qui ne fournit pas `dynamicPrimitiveTopologyUnrestricted`, ce dessin passe par la variante « lignes » du correctif de [tylertms/Stela#158](https://github.com/tylertms/Stela/pull/158). Le correctif est donc vérifié sur le matériel.
17
+
18
+
Les shaders sont dans `crates/stela-amd-host/metal/first.metal`, compilés en metallib sur un Mac.
19
+
20
+
## Comment ça s'assemble
21
+
22
+
Stela ne passe pas ses shaders au pilote en SPIR-V. Il lui remet directement son NIR, par la structure interne de Mesa `VkPipelineShaderStageNirCreateInfoMESA`. Le compilateur et le pilote doivent donc être le même Mesa, dans la même bibliothèque : le NIR pointe vers les tables de types GLSL de la bibliothèque qui l'a construit. Sur NVIDIA, NVK et le compilateur sont liés ensemble dans `stela.efi`. Sous Linux, l'équivalent AMD est `libstela_radv.so` :
23
+
24
+
- RADV, construit à partir du Mesa de Stela (26.2.5, avec sa série de correctifs) ;
25
+
- le compilateur Metal de Stela (`stela_metal_*`) ;
26
+
-`stela_radv_nir_options`, l'équivalent de `stela_nvk_nir_options` (`crates/stela-driver-gpu/src/amd/radv_host/`).
27
+
28
+
Il a fallu un correctif dans RADV, `third_party/patches/mesa/9001-radv-take-nir-stages.patch`. RADV initialise ses étages de pipeline lui-même et ignorait un étage sans module qui porte cette structure NIR. NVK, lui, passe par le chemin commun de Mesa, qui la lit. Le correctif est numéroté `9001` pour passer après la série d'upstream. `cargo xtask gpu export` le renumérote : il faut alors lui redonner son nom à la main.
29
+
30
+
La mémoire partagée Metal est celle de l'invité, exportée en dma-buf. Ici, l'invité est le processus lui-même : chaque buffer partagé est un memfd transformé en dma-buf par `/dev/udmabuf`, ce qui demande le groupe `kvm`.
31
+
32
+
## Refaire l'essai
33
+
34
+
Prérequis Ubuntu 24.04 : `glslang-tools libdrm-dev libudev-dev libelf-dev bison flex`, LLVM 23, et l'utilisateur dans le groupe `kvm`.
35
+
36
+
```sh
37
+
cargo xtask gpu fetch
38
+
# libdrm 2.4.133, que RADV demande (Ubuntu fournit la 2.4.125), depuis le commit épinglé
39
+
C=$(git ls-tree HEAD third_party/libdrm | awk '{print $3}')
`-Db_ndebug=true` coupe une assertion de la couche Vulkan commune de Mesa. Elle exige que le NIR reçu porte exactement les options NIR de l'étage selon RADV, alors que le compilateur Metal prend un seul jeu d'options par périphérique : celui de l'étage de calcul. Les deux jeux ne diffèrent que par une préférence sur les multiplications-additions des étages de géométrie.
61
+
62
+
Pour vérifier que ce RADV admet toujours la carte, sans `--device` :
63
+
64
+
```sh
65
+
VK_DRIVER_FILES=<un fichier ICD JSON pointant sur libstela_radv.so> ./target/release/stela-amd-host
66
+
```
67
+
68
+
## Ce qui reste pour J4
69
+
70
+
- Faire tourner la suite Metal contre ce périphérique, sans macOS invité. Il faut pour cela un exécuteur du plan de la suite (`metal-suite plan`) côté Linux, qui traduise chaque cas en appels au `Device`.
71
+
- Mesurer les alignements réels (lignes et décalages des surfaces linéaires) sur des images linéaires de RADV, pour remplacer les 256 octets estimés de `metal/amd.rs`.
0 commit comments