Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/longjunyu2/mu_platforms_oneplus6t
Project Mu based OnePlus6T Platform Repo. For Building Project Mu firmware of the OnePlus6T Device.
https://github.com/longjunyu2/mu_platforms_oneplus6t
firmware oneplus6t projectmu uefi
Last synced: about 1 month ago
JSON representation
Project Mu based OnePlus6T Platform Repo. For Building Project Mu firmware of the OnePlus6T Device.
- Host: GitHub
- URL: https://github.com/longjunyu2/mu_platforms_oneplus6t
- Owner: longjunyu2
- License: other
- Created: 2021-06-25T08:56:22.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2021-07-08T07:36:47.000Z (over 3 years ago)
- Last Synced: 2024-01-05T05:24:27.484Z (about 1 year ago)
- Topics: firmware, oneplus6t, projectmu, uefi
- Language: ASL
- Homepage:
- Size: 1.29 MB
- Stars: 3
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Mu OnePlus6T Platform Repository
Project Mu based OnePlus6T Platform Repo. For Building Project Mu firmware of the OnePlus6T Device.
## Contents
- [Current Status & Schedule](#current-status--schedule)
- [Getting Started](#getting-started)
- [Acknowledgement](#acknowledgement)
- [License](#license)
## Current Status & Schedule
### Repository
- [x] Implement configuration of compilation environment with scripts.
- [x] Implement compilation with scripts.
- [ ] Use upstream master branch of the OnePlus6TPkg from sdm845Pkg instead of specific modified branches.
### OnePlus6TPkg
| | GCC | MSVC |
| ---- | ---- | ---- |
| Config | YES | YES |
| Compile | YES | NO |
| Bootable| LIMITED | NO |
## Getting Started
### Details
This repository is NOT a part of Project Mu, but it depends on some parts of Project Mu.
- [mu_plus](https://github.com/microsoft/mu_plus)
- [mu_basecore](https://github.com/microsoft/mu_basecore)
- [mu_oem_sample](https://github.com/microsoft/mu_oem_sample)
- [mu_tiano_plus](https://github.com/microsoft/mu_tiano_plus)
- [mu_silicon_arm_tiano](https://github.com/microsoft/mu_silicon_arm_tiano)
For more information about these repositories, see [Project Mu](https://microsoft.github.io/mu).
### Preparation (Ubuntu 20.04 x64)
#### Upgrade
1. Upgrade your system to the latest state before you begin installing the necessary packages.
``` shell
sudo apt-get update
sudo apt-get upgrade
```
#### Install Package
1. The packages we need to install include **Python-3**, **Git**, **abootimg** .
``` shell
sudo apt-get install python3 git abootimg python3-venv python3-pip
```
#### Cross Compiler Tool Chain
1. In order to avoid the differences caused by the tool chain, we will use the recommended tool chain to complete the compilation.
2. Download **gcc-linaro-7.4.1-x86_64_aarch64-linux-gnu**.
``` shell
wget http://releases.linaro.org/components/toolchain/binaries/7.4-2019.02/aarch64-linux-gnu/gcc-linaro-7.4.1-2019.02-x86_64_aarch64-linux-gnu.tar.xz
```
3. Decompress the package to somewhere you want.
``` shell
xz -d gcc-linaro-7.4.1-2019.02-x86_64_aarch64-linux-gnu.tar.xz
tar xvf gcc-linaro-7.4.1-2019.02-x86_64_aarch64-linux-gnu.tar
```
4. Add the toolchain to environment variable.
``` shell
export PATH="$PATH:/gcc-linaro-7.4.1-2019.02-x86_64_aarch64-linux-gnu/bin"
```
Or you can permanently add the toolchain to the system by modifying the ```/etc/ environment``` .
5. Switch default compiler to cross compiler.
Sometimes setting **CC** variable is invalid, so we have to change cross compiler to local compiler temporarily.
``` shell
sudo update-alternatives --install /usr/bin/gcc gcc /gcc-linaro-7.4.1-2019.02-x86_64_aarch64-linux-gnu/bin/aarch64-linux-gnu-gcc 70
sudo update-alternatives --install /usr/bin/gcc-ar gcc-ar /gcc-linaro-7.4.1-2019.02-x86_64_aarch64-linux-gnu/bin/aarch64-linux-gnu-gcc-ar 70
```
Don't forget to reset the local compiler after using the cross compiler.
#### Workspace & Virtual Environment
1. Create the workspace like this.
``` pre
/WorkspaceRoot (basic platform)
|-- src_of_project
|-- venv <-- Virtual environment for Project in workspace root
|
```
2. Run python cmd to create virtual environment.
``` shell
python3 -m venv
```
3. Activate it for your session.
``` shell
source /bin/activate
```
### Preparation (Windows10 x64)
#### Python
1. Download latest Python from
``` cmd
https://www.python.org/ftp/python/3.8.2/python-3.8.2-amd64.exe
```
2. It is recommended you use the following options when installing python:
- include pip support.
- include test support.
- include venv virtual environment support.
#### Git
1. Download latest Git For Windows from .
``` cmd
https://github.com/git-for-windows/git/releases/download/v2.25.1.windows.1/Git-2.25.1-64-bit.exe
```
2. It is recommended you use the following options:
- Checkout as is, commit as is.
- Native Channel support (this will help in corp environments).
- Check the box to "Enable Git Credential Manager".
#### Visual Studio 2019
1. Download latest version of VS build Tools to c:\TEMP.
``` cmd
https://aka.ms/vs/16/release/vs_buildtools.exe
```
2. Install from cmd line with required features (this set will change over time).
``` cmd
C:\TEMP\vs_buildtools.exe --quiet --wait --norestart --nocache --installPath C:\BuildTools \
--add Microsoft.VisualStudio.Component.VC.CoreBuildTools --add Microsoft.VisualStudio.Component.VC.Tools.x86.x64 \
--add Microsoft.VisualStudio.Component.Windows10SDK.17763 --add Microsoft.VisualStudio.Component.VC.Tools.ARM \
--add Microsoft.VisualStudio.Component.VC.Tools.ARM64
```
See component list here for more options.
#### NASM
1. Download lastest version of NASM (NetWide Assembler).
``` cmd
https://www.nasm.us/pub/nasm/releasebuilds/2.15.05/win64/nasm-2.15.05-installer-x64.exe
```
2. Add NASM to Widnows Environment variable.
```cmd
Variable Name: NASM_PREFIX
Variable Value: /
```
#### Workspace & Virtual Environment
1. Create the workspace like this.
``` pre
/WorkspaceRoot (basic platform)
|-- src_of_project
|-- venv <-- Virtual environment for Project in workspace root
|
```
2. Run python cmd to create virtual environment.
``` cmd
python -m venv
```
3. Activate it for your session.
``` cmd
/Scripts/activate.bat
```
### Compile
#### CI Build Process
1. Open cmd prompt at workspace root.
2. Activate your python virtual environment.
3. Install or update Python dependencies using pip.
```cmd
pip install --upgrade -r pip-requirements.txt
```
4. Run stuart_setup to download required submodules.
```cmd
stuart_setup -c .pytool/CISettings.py
```
5. Run stuart_ci_setup to download CI only dependencies.
```cmd
stuart_ci_setup -c .pytool/CISettings.py
```
6. Run stuart_update to download or update binary dependencies.
```cmd
stuart_update -c .pytool/CISettings.py
```
7. Run stuart_ci_build to build and test the packages.
```cmd
stuart_ci_build -c .pytool/CISettings.py
```
8. Open __TestResults.xml__ in the build output for results (usually in workspace/Build).
9. Open log files to debug any errors.
#### Platform Build Process
1. Open cmd prompt at workspace root.
2. Activate your python virtual environment.
3. Install or update Python dependencies using pip.
```cmd
pip install --upgrade -r pip-requirements.txt
```
4. Run stuart_setup to download required submodules.
```cmd
stuart_setup -c Platforms/OnePlus6TPkg/PlatformCI/PlatformBuild.py TOOL_CHAIN_TAG=VS2019
```
5. Run stuart_update to download or update binary dependencies.
```cmd
stuart_update -c Platforms/OnePlus6TPkg/PlatformCI/PlatformBuild.py TOOL_CHAIN_TAG=VS2019
```
6. Run stuart_build to build and test the packages.
```cmd
stuart_build -c Platforms/OnePlus6TPkg/PlatformCI/PlatformBuild.py TOOL_CHAIN_TAG=VS2019
```
7. Open the build output for log files to debug any errors (usually in workspace/Build).
#### Generation Bootable Image Process
1. Get the necessary documents.
``` shell
mkdir img
cp Build/OnePlus6TPkg/DEBUG_/FV/ONEPLUS6TPKG_UEFI.fd ./img
cp dtb/fajita.dtb ./img
echo > ./img/ramdisk
```
2. Using abootimg tool to generate image.
``` shell
cd img
gzip -c < ./ONEPLUS6TPKG_UEFI.fd > "./uefi-fajita.img.gz"
cat "./uefi-fajita.img.gz" "./fajita.dtb" > "./uefi-fajita.img.gz-dtb"
abootimg --create "./boot-fajita.img" -k "./uefi-fajita.img.gz-dtb" -r ramdisk
```
3. Use FastBoot to start.
``` shell
fastboot boot boot-fajita.img
```
## Acknowledgement
- [mu](https://microsoft.github.io/mu): Provids details of project mu.
- [mu_tiano_platforms](https://github.com/microsoft/mu_tiano_platforms): Provides a template for such firmware projects.
- [edk2-sdm845](https://github.com/edk2-porting/edk2-sdm845): Most of the code for OnePlus6TPkg comes from sdm845Pkg.
## License
The software is distributed under BSD 2-Clause License.