|
|
# Tastitalia Android 12
|
|
|

|
|
|
|
|
|
# Table of Contents
|
|
|
|
|
|
# TASTITALIA BSP ANDROID
|
|
|
# Introduction
|
|
|
|
|
|
## Getting Started
|
|
|
Welcome to the comprehensive guide on how to download, compile, and flash Tastitalia's Android BSP. This guide will walk you through the entire process, from setting up your development environment to flashing the customized Android build onto your device.
|
|
|
|
|
|
This repository contains a manifest file to clone all the open-source repository needed for Android.
|
|
|
We'll guide you through the initial setup, downloading the necessary repositories using the repo command, and then walk you through the compilation and flashing process. By the end of this guide, you'll have a deep understanding of how to customize and deploy Tastitalia's Android BSP on your device.
|
|
|
|
|
|
In order to complete the build environment with the proprietary repositories, repo will also download a proprietary tar.gz file protected by a passphrase.
|
|
|
|
... | ... | @@ -13,9 +15,7 @@ Please contact Tastitalia to obtain the passphrase. |
|
|
|
|
|
Follow the steps below to download and build the Android 12 release.
|
|
|
|
|
|
## Download and Build Tastitalia Android 12 Release
|
|
|
|
|
|
### Setting up your PC
|
|
|
# Prepare your PC
|
|
|
|
|
|
To build Tastitalia Android 12, use a computer running Linux OS.
|
|
|
|
... | ... | @@ -48,14 +48,14 @@ Install gpg: |
|
|
$: sudo apt install -y gnupg
|
|
|
```
|
|
|
|
|
|
### Download and prepare Tastitalia Android 12
|
|
|
# Download and prepare Tastitalia Android 12
|
|
|
|
|
|
Follow these steps to download and prepare your environment with all the Android 12 source files:
|
|
|
|
|
|
```bash
|
|
|
$: mkdir android_build
|
|
|
$: cd android_build
|
|
|
$: repo init -u https://gitlab.tastitalia.local/tastitalia-mpu-arm/android/tastitalia-bsp-android.git -b imx-android-12 -m tastitalia-imx-android-12.0.0_1.0.0.xml
|
|
|
$: repo init -u https://gitlab.tastitalia.com/tastitalia-mpu-arm/android/tastitalia-bsp-android.git -b imx-android-12 -m tastitalia-imx-android-12.0.0_1.0.0.xml
|
|
|
$: repo sync -j32
|
|
|
#### Choose -j variable according to the number of cores in your PC
|
|
|
#### Take a coffee
|
... | ... | @@ -83,14 +83,18 @@ $: source tastitalia-imx-android-12.0.0_1.0.0/tastitalia-imx_android_setup.sh |
|
|
|
|
|
After these steps, all Android 12 source codes are downloaded and ready to be built.
|
|
|
|
|
|
### Set up and build Android 12
|
|
|
# Set up and build Android 12
|
|
|
|
|
|
To set up your build environment, Tastitalia prepared a script file for every board.
|
|
|
|
|
|
Find the appropriate setup file following our [Naming Convention](#tastitalia-naming-convention).
|
|
|
* Example: **setup_tasd8mp_2g_7.sh**.
|
|
|
* Example: **setup_tasd8mp_2g_10.sh**.
|
|
|
|
|
|
This script is needed to export arm64 cross compile GCC, set up android environment and prepare it for a userdebug build mode, executing the command:
|
|
|
|
|
|
This script is needed to export arm64 cross compile GCC, set up android environment and prepare it for a userdebug build mode.
|
|
|
```bash
|
|
|
$: source setup_tasXXXX_Xg_X.sh
|
|
|
```
|
|
|
Feel free to change userdebug mode to any other mode, according to Android documentation:
|
|
|
|
|
|
| Build Mode | Description |
|
... | ... | @@ -103,7 +107,7 @@ After that, you will be able to lunch the Android 12 build script: |
|
|
|
|
|
Example:
|
|
|
```bash
|
|
|
$: source setup_tasd8mm_2g_7.sh
|
|
|
$: source setup_tasd8mm_2g_10.sh
|
|
|
$: ./imx-make.sh -j32 2>&1 | tee build-log.txt
|
|
|
#### Choose -j variable according to the number of cores in your PC
|
|
|
#### Take a very long coffee
|
... | ... | @@ -112,9 +116,31 @@ After following these steps, Android will be built, and a **build-log.txt** file |
|
|
|
|
|
Please refer to the next section for instructions on flashing the output files to your board.
|
|
|
|
|
|
### Download and flash Android image
|
|
|
# Download and flash Android image
|
|
|
|
|
|
## Create Distro Folder
|
|
|
Tastitalia has developed a convenient script, `create_distro.sh`, to prepare the folder containing all the necessary files for flashing Android onto your device. You can execute the script using the following command:
|
|
|
|
|
|
```bash
|
|
|
$: ./create_distro.sh
|
|
|
```
|
|
|
|
|
|
This script will create a directory called "Distro" and populate it with the Android build files for each build it finds. If you don't specify any arguments when running the script, the "Distro" folder will be filled with folders containing the final Android files for each build.
|
|
|
|
|
|
Alternatively, if you want to focus on a specific machine (e.g. `tasd8mm_2g_10`), you can provide the machine's name as an argument to the script. In this case, the script will create a folder only for that machine within the "Distro" directory.
|
|
|
|
|
|
Here's an example of how to use the script for a specific machine:
|
|
|
|
|
|
```bash
|
|
|
$: ./create_distro.sh tasd8mm_2g_10
|
|
|
```
|
|
|
|
|
|
Running the script in this way will create a dedicated folder within "Distro" containing the Android files tailored to the specified machine.
|
|
|
|
|
|
## Flash Android BSP on eMMC
|
|
|
## Flash Android BSP on uSD (Not Recommended)
|
|
|
|
|
|
## Tastitalia Naming Convention
|
|
|
# Tastitalia Naming Convention
|
|
|
|
|
|
We follow a specific naming convention for our board names. The board names are in the format **tasXYYY_Zg_W**, where:
|
|
|
|
... | ... | |