Skip to content

Latest commit

 

History

History
93 lines (69 loc) · 2.86 KB

Building.md

File metadata and controls

93 lines (69 loc) · 2.86 KB

Building

Recommended Linux OS: Ubuntu 22.04.3 LTS Or use the docker method

If using docker method

Step 1:

First of you need the sourcecode to compile a UEFI Image.
Clone the Repo by using:

git clone https://github.com/Project-Silicium/Mu-Silicium.git --recursive
cd Mu-Silicium

You need to have git installed.

Step 2

After the clone is done, proceed to open a shell/powershell/terminal inside the clone location For Linux/MacOS/BSD users, run:

./docker-build.sh "-d <Codename> [-r <Build Mode>]"

You need the "double quotes"

For Windows users, run (not tested):

.\docker-build.cmd "-d <Codename> [-r <Build Mode>]"

You need the "double quotes".

When the Build is Done, You will Find one of these Files: .img, .tar or .bin.

If building natively

Step 1:

First of you need the sourcecode to compile a UEFI Image.
Clone the Repo by using:

git clone https://github.com/Project-Silicium/Mu-Silicium.git --recursive
cd Mu-Silicium

Step 2:

After Cloning the repo we can now continue on Setting up the Environment.
First we need to install the needed Packages:

./setup_env.sh -p <Package Manager>

Step 3:

So now we are able to begin the real UEFI build:

./build_uefi.sh -d <Codename> [-r <Build Mode>]

When the Build is Done, You will Find one of these Files: .img, .tar or .bin.

Troubleshooting:

Python Requirements:

  1. You may encounter an issue That the required package is not satisfied or something, If your Python Version is lower than 3.10 install Python 3.10 or newer
  2. After installing Python 3.10 Linux won't automatically chose Python 3.10 as default, To set it as default use these commands:
    sudo update-alternatives --install /usr/bin/python python /usr/bin/python3.10 1
    sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.10 1
    
  3. Now check the Python Version:
    python3 --version
    
    You should get this output:
    Python 3.10.*
    

Git Unknown Switch

  1. If you have an old Version of git you may come across this Issue, So you need to install the latest version of git.
  2. I prefer using apt to update git but if it tells you it is already newest version you should follow this Guide

Fedora No ARM Toolchain

  1. Newer Fedora Releases don't have gnueabihf ARM Toolchains, So we will use an external Repo to get that Package.
  2. Run this Command: sudo dnf copr enable lantw44/arm-linux-gnueabihf-toolchain to Enable the external Repo.
  3. If you are above Fedora 39, You will need libgnat-13.3.1-1 from here
  4. Then you can just Run the setup_env.sh Script again. (You might have to restart your Terminal)