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
Now that Tyr is upstream, the process for contributing has changed.
Update the documentation about the development process to help
new contributors.
Also, while here, update progress in the downstream driver.
Signed-off-by: Deborah Brouwer <deborah.brouwer@collabora.com>
The initial skeleton of the Tyr driver is now upstream. Submissions against the upstream Tyr driver should go to the [rust-for-linux](https://lore.kernel.org/rust-for-linux/) mailing list. If the submission is larger and/or needs to be pre-reviewed, open a merge request against the [tyr-for-upstream](https://gitlab.freedesktop.org/panfrost/linux/-/tree/tyr-for-upstream) branch in the [panfrost/linux](https://gitlab.freedesktop.org/panfrost/linux) repository.
23
+
24
+
25
+
### Downstream
26
+
A more complete implementation of the Tyr driver is also available in the [tyr-dev](https://gitlab.freedesktop.org/panfrost/linux/-/tree/tyr-dev) branch. Make submissions against the downstream Tyr driver by opening a merge request against `tyr-dev`. It's expected that `tyr-dev` will be significantly refactored before upstreaming.
23
27
24
28
This split is unfortunately necessary as we do not have the required
25
29
infrastructure in upstream yet, although our plan is to eventually migrate to
@@ -41,20 +45,15 @@ functional driver with the abstractions that are currently being proposed.
41
45
42
46
## What is the current status of the driver?
43
47
44
-
The current upstream submission can power up the GPU and probe the device on an
48
+
The current upstream driver can power up the GPU and probe the device on an
45
49
RK3588 system-on-chip. This lets us read a few sections of ROM in the GPU,
46
50
which in turn lets us provide this information to userspace by means of a
47
51
`DRM_IOCTL_PANTHOR_DEV_QUERY` call.
48
52
49
53
This is all that can be done for now in upstream code, at least until the Micro
50
54
Controller Unit can be made to work.
51
55
52
-
Our downstream branch (`tyr-next`) can submit small parcels of work to the GPU,
53
-
and we will soon be able to submit more elaborate workflows. We hope to see
54
-
[VkCube](https://github.com/KhronosGroup/Vulkan-Tools) running on Tyr soon.
55
-
56
-
In any case, there is no power management and little error recovery. We will be
57
-
working on that in the coming months.
56
+
Our downstream branch (`tyr-dev`) provides a full, working prototype that can run GNOME, Weston, and full-screen 3D games like SuperTuxKart: see [Racing karts on a Rust GPU kernel driver](https://www.collabora.com/news-and-blog/news-and-events/racing-karts-on-a-rust-gpu-kernel-driver.html).
58
57
59
58
## Can I try it out?
60
59
@@ -65,7 +64,7 @@ replacing Panthor yet. A good candidate device is Radxa's
0 commit comments