1 # MESA Driver sponsored by NLnet
3 todo http://lists.libre-soc.org/pipermail/libre-soc-dev/2020-August/000246.html
5 # Build Instructions (by Cole from Vivek's comments on the mailing list)
7 This tutorial assumes, like the rest of the info on the wiki, that you are running Debian 10.4 either natively or in a virtualized setup.
9 The following is available as scripts in the libre-soc dev-env-setup repo, and can be easily used by running `sudo ./install-mesa-apt-reqs && ./lsoc-mesa-dev-env-setup`.
11 First, we need to install the necessary apt dependencies for building `drm` and `mesa`.
13 In order to install a `meson` version recent enough to configure `mesa`, add buster-backports to /etc/apt/sources.list by running the following as root:
15 echo "deb http://deb.debian.org/debian buster-backports main" | tee \
16 -a /etc/apt/sources.list
18 Install `meson` (version 52.0 or later):
21 apt-get install -y -t buster-backports meson
23 Then install the necessary packages by running the following commands as root:
27 apt-get install -y build-essential \
45 Then, still as root, run the following to get the necessary dependencies for building `drm` and `mesa`.
47 apt-get build-dep -y libdrm
48 apt-get build-dep -y mesa
50 Now we are going to build and install `drm` from source as the debian apt versions are not recent enough to build mesa. Run all of these command as a regular user, **DO NOT RUN AS ROOT** it is not necessary.
52 First, create our working directory `opt` in our user directory. In order to not mess with system `drm` and `mesa` libraries, also create a sub-directory `lsoc_mesa` to hold our header files and libraries. After creating the `opt` directory, cd into it to make it our active, current working directory.
54 mkdir -p ~/opt/lsoc_mesa
57 Now clone `drm` from mesa's gitlab. Change to the `drm` directory. Create a build directory and cd into it.
59 git clone https://gitlab.freedesktop.org/mesa/drm.git
61 mkdir build && cd build
63 In order to configure `drm` for building and installation run the following command. It is very important to specify `prefix=/home/$USER/opt/lsoc_mesa` because as mentioned above we need these files for development purposes, but we do not want to corrupt or interfere with our *system* `drm` libraries.
65 meson -Dbuildtype=release -Dprefix=/home/$USER/opt/lsoc_mesa ..
67 After configuration has completed, run ninja to build and install the `drm` libraries.
71 In order for meson to be able to find the up-to-date `drm` files we have just built, we need to specify their location with the environment variable `PKG_CONFIG_PATH`.
73 export PKG_CONFIG_PATH=~/opt/lsoc_mesa/lib/x86_64-linux-gnu/pkgconfig/
75 These following `vulkan`-specific environment variables are necessary to build our branch of mesa successfully:
77 export VK_ICD_FILENAMES=/home/$USER/opt/lsoc_mesa/share/vulkan/icd.d/libresoc_icd.x86_64.json
78 export VK_LOADER_DEBUG=warn
79 export LIBRESOC_TRACE=1
81 Now change back to the base `~/opt` directory and clone the `mesa` git repo from the `mesa` gitlab instance. Change to the `mesa` directory. Create a build directory and cd into it.
84 git clone https://git.libre-soc.org/git/mesa.git
85 git pull --rebase origin libresoc_dev
86 git checkout -b libresoc_dev
88 mkdir build && cd build
90 In order to configure `mesa` for building and installation run the following command. Again, it is *very* important to specify `prefix=/home/$USER/opt/lsoc_mesa` because as mentioned above we need these files for development purposes, but we do not want to corrupt or interfere with our *system* `mesa` libraries.
92 meson -Dbuildtype=debug -Dprefix=/home/$USER/opt/lsoc_mesa \
93 -Dvulkan-drivers=libre-soc ..
95 After configuration has completed, run ninja to build and install the `mesa` libraries.
99 # From here on is solely Vivek's instructions
101 To test the code I am sing simple tests built by
103 https://github.com/GameTechDev/IntroductionToVulkan
105 I am also using debug build for vulkan loader if any one interested in that
108 https://github.com/KhronosGroup/Vulkan-Loader/blob/master/BUILD.md
110 I have pushed code to the new branch
111 https://gitlab.freedesktop.org/vivekvpandya/mesa/-/tree/libresoc_dev
112 previously it was on master so it will cause me problems working on master
115 # Running vulkan intro tutorial
117 * <https://github.com/GameTechDev/IntroductionToVulkan/tree/master/Project/Tutorials/01>
118 * <http://lists.libre-soc.org/pipermail/libre-soc-dev/2020-August/000368.html>
120 # Demos with lavapipe
122 > It can be built with
123 > meson configure -Dvulkan-drivers=swrast -Dgallium-drivers=swrast
124 > set VK_ICD_FILENAMES to the lvp_icd.x86_64.json file and vulkaninfo should
127 > I tried running demos from
128 > https://software.intel.com/content/www/us/en/develop/articles/api-without-
129 > secrets-introduction-to-vulkan-part-1.html and all 7 runs fine with lavapipe.
131 * <https://bugs.libre-soc.org/show_bug.cgi?id=251#c58>