-
Notifications
You must be signed in to change notification settings - Fork 8
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
27 changed files
with
606 additions
and
146 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,59 +1,136 @@ | ||
`Mesa <https://mesa3d.org>`_ - The 3D Graphics Library | ||
====================================================== | ||
|
||
Valhall v10 "CSF" support branch—for Mali G710/G610. | ||
|
||
Note that firmware is required for these GPUs, for RK3588 try | ||
downloading the file from the Rockchip `libmali | ||
<https://github.com/JeffyCN/rockchip_mirrors/tree/libmali/firmware/g610>`_ | ||
repo, and placing it in ``/lib/firmware/``. | ||
|
||
Windowing system support | ||
------------------------ | ||
|
||
Panfrost Wayland compositor (wlroots): | ||
|
||
#. Panfrost Wayland clients | ||
#. Panfrost X11 clients via Xwayland [1]_ | ||
#. Blob X11 clients via Xwayland + dri2to3 [2]_ | ||
|
||
Panfrost Wayland compositor (non-wlroots): | ||
|
||
#. Panfrost Wayland clients | ||
#. Panfrost X11 clients via Xwayland | ||
#. Blob Wayland clients | ||
#. Blob X11 clients via Xwayland + dri2to3 [2]_ | ||
|
||
Blob Wayland compositor: | ||
|
||
#. Panfrost Wayland clients | ||
#. Blob Wayland clients | ||
|
||
Panfrost Xorg server: [3]_ | ||
|
||
#. Panfrost X11 clients | ||
#. Blob X11 clients | ||
|
||
Blob Xorg server: | ||
|
||
#. Panfrost X11 clients | ||
#. Blob X11 clients | ||
|
||
Applications using KMS/DRM will also work. | ||
|
||
.. [1] Requires ``CONFIG_DRM_IGNORE_IOTCL_PERMIT`` to be disabled in | ||
the kernel configuration. The option is broken and should never | ||
be enabled anyway. | ||
.. [2] See https://gitlab.com/panfork/dri2to3 | ||
.. [3] For Radxa Debian/Ubuntu, the ``xserver-xorg-core`` version | ||
installed by default is not compatible with Panfrost. But note | ||
that upstream Xorg does not work will the blob, so Mesa must be | ||
installed so that it is used by default. (see the "Usage" | ||
section below). To switch between the upstream and Rockchip | ||
versions, run: | ||
.. code-block:: sh | ||
$ sudo apt install xserver-xorg-core="$(apt-cache show xserver-xorg-core | grep Version | grep -v "$(dpkg -s xserver-xorg-core | grep Version)" | cut -d" " -f2)" | ||
Broken combinations: | ||
|
||
#. Panfrost wlroots + Blob Wayland does not work because wlroots does | ||
not expose the ``mali_buffer_sharing`` protocol. This might be | ||
fixable. | ||
#. Blob Wayland compositor + Panfrost X11 does not work because the | ||
blob does not expose the required protocols for Xwayland | ||
acceleration to work | ||
|
||
Source | ||
------ | ||
|
||
This repository lives at https://gitlab.freedesktop.org/mesa/mesa. | ||
Other repositories are likely forks, and code found there is not supported. | ||
This repository lives at https://gitlab.com/panfork/mesa, and is a | ||
fork, so not supported by upstream. | ||
|
||
Upstream source is at https://gitlab.freedesktop.org/mesa/mesa. | ||
|
||
Build & install | ||
--------------- | ||
Depdendencies | ||
------------- | ||
|
||
You can find more information in our documentation (`docs/install.rst | ||
<https://mesa3d.org/install.html>`_), but the recommended way is to use | ||
Meson (`docs/meson.rst <https://mesa3d.org/meson.html>`_): | ||
For Debian-based distributions: | ||
|
||
.. code-block:: sh | ||
$ mkdir build | ||
$ cd build | ||
$ meson .. | ||
$ sudo apt install build-essential meson git python3-mako libexpat1-dev bison flex libwayland-egl-backend-dev libxext-dev libxfixes-dev libxcb-glx0-dev libxcb-shm0-dev libxcb-dri2-0-dev libxcb-dri3-dev libxcb-present-dev libxshmfence-dev libxxf86vm-dev libxrandr-dev | ||
Also needed is ``libdrm`` and ``wayland-protocols``, but those | ||
packages are too old in Debian Bullseye, and must be compiled from | ||
source: | ||
|
||
.. code-block:: sh | ||
$ git clone https://gitlab.freedesktop.org/mesa/drm | ||
$ mkdir drm/build | ||
$ cd drm/build | ||
$ meson | ||
$ sudo ninja install | ||
.. code-block:: sh | ||
$ git clone https://gitlab.freedesktop.org/wayland/wayland-protocols | ||
$ mkdir wayland-protocols/build | ||
$ cd wayland-protocols/build | ||
$ git checkout 1.24 | ||
$ meson | ||
$ sudo ninja install | ||
Build & install | ||
--------------- | ||
|
||
Support | ||
------- | ||
To install to ``/opt/panfrost``: | ||
|
||
Many Mesa devs hang on IRC; if you're not sure which channel is | ||
appropriate, you should ask your question on `OFTC's #dri-devel | ||
<irc://irc.oftc.net/dri-devel>`_, someone will redirect you if | ||
necessary. | ||
Remember that not everyone is in the same timezone as you, so it might | ||
take a while before someone qualified sees your question. | ||
To figure out who you're talking to, or which nick to ping for your | ||
question, check out `Who's Who on IRC | ||
<https://dri.freedesktop.org/wiki/WhosWho/>`_. | ||
.. code-block:: sh | ||
The next best option is to ask your question in an email to the | ||
mailing lists: `mesa-dev\@lists.freedesktop.org | ||
<https://lists.freedesktop.org/mailman/listinfo/mesa-dev>`_ | ||
$ mkdir build | ||
$ cd build | ||
$ meson -Dgallium-drivers=panfrost -Dvulkan-drivers= -Dllvm=disabled --prefix=/opt/panfrost | ||
$ sudo ninja install | ||
Usage | ||
----- | ||
|
||
Bug reports | ||
----------- | ||
To run an application with Panfrost (note the windowing system support | ||
section above): | ||
|
||
If you think something isn't working properly, please file a bug report | ||
(`docs/bugs.rst <https://mesa3d.org/bugs.html>`_). | ||
.. code-block:: sh | ||
$ LD_LIBRARY_PATH=/opt/panfrost/lib/aarch64-linux-gnu glmark2-es2-wayland | ||
Contributing | ||
------------ | ||
To use Panfrost by default, add the directory where you installed it | ||
to the library search path: | ||
|
||
Contributions are welcome, and step-by-step instructions can be found in our | ||
documentation (`docs/submittingpatches.rst | ||
<https://mesa3d.org/submittingpatches.html>`_). | ||
.. code-block:: sh | ||
Note that Mesa uses gitlab for patches submission, review and discussions. | ||
$ echo /opt/panfrost/lib/aarch64-linux-gnu | sudo tee /etc/ld.so.conf.d/0-panfrost.conf | ||
$ sudo ldconfig |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.