@@ -21,9 +29,8 @@ To build Tastitalia Android 12, use a computer running Linux OS.
We used Ubuntu 20.04 to build Android, other distributions may work but have not been tested.
Check whether all the necessary packages are installed for an Android build.
See “Establishing a Build Environment” on the [Android website](https://source.android.com/setup/build/initializing).
In addition to the packages requested on the Android website, the following packages are also needed:
Check whether all the necessary packages are installed for an Android build. See “Establishing a Build Environment” on the [Android website](https://source.android.com/setup/build/initializing). In addition to the packages requested on the Android website, the following packages are also needed:
| userdebug | This build mode is suitable for developers and testers. It includes debugging capabilities and additional logging. |
| user | This build mode is optimized for regular users. It excludes debugging features and reduces logging for better performance. |
| eng | This build mode, short for "engineering," includes advanced debugging and profiling tools. It is primarily for developers and platform engineers. |
...
...
@@ -106,12 +117,14 @@ Feel free to change userdebug mode to any other mode, according to Android docum
After that, you will be able to lunch the Android 12 build script:
Example:
```bash
$: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
```
After following these steps, Android will be built, and a **build-log.txt** file containing all the build information will be created.
Please refer to the next section for instructions on flashing the output files to your board.
...
...
@@ -119,6 +132,7 @@ Please refer to the next section for instructions on flashing the output files t
# 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:
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
After following the previous section, which helped you create the "Distro" directory with your machine-specific folder inside (e.g., `Distro/tasd8mp_2g_10/`), proceed with the following steps to flash the Android BSP onto the eMMC of your device.
1.**Enter the Distro Directory:**
Navigate to the "Distro" directory and enter your machine-specific folder using the following command:
```bash
$:cd Distro/tasd8mp_2g_10/
```
2.**Prepare for Flashing:**
- Ensure that your device is in "Serial Download" mode. <spandir="">Refer to your device's documentation or manufacturer's instructions for specific steps on how to </span>boot your board in Serial Download mode.
- Connect the OTG port on your device to the USB port on your PC.
- Use the `lsusb` command to verify that your device is recognized among the peripherals. It should appear as something like "NXP Semiconductor SE Blank XXX." Below is an example screenshot of the `lsusb` output:
Run the following command with sudo privileges to initiate the flashing process:
```bash
$:sudo ./uuu uuu.lst
```
This command will flash the Android BSP onto the eMMC of your device.
4.**Configure Boot Source:**
After successful flashing, configure your device to boot from eMMC. Refer to your device's documentation or manufacturer's instructions for specific steps on how to set the boot source to eMMC.
5.**Boot Your Device:**
Once the boot source is set to eMMC, power on your device. It should now boot from the newly flashed Android BSP.
**Note:** The first boot may take longer than usual as Android prepares all the necessary files for the file system. Subsequent boots should have normal boot times.
## Flash Android BSP on uSD (Not Recommended)
**Note:** It is not recommended to install Android on a uSD (microSD) card. Android is a resource-intensive operating system, and boot times, especially during the initial boot, can be significantly prolonged when running from a uSD card. For the best performance and user experience, we strongly advise flashing Android onto the eMMC of your device instead of a uSD card.
However, if you still wish to proceed with installing Android on a uSD card, for example for testing purposes, please follow the steps below:
1.**Enter the Distro Directory:**
Navigate to the "Distro" directory and enter your machine-specific folder using the following command:
```bash
$:cd Distro/tasd8mp_2g_10/
```
2.**Use the "imx-sdcard-partition.sh" Script:**
The "imx-sdcard-partition.sh" script is used to partition the uSD card for Android. You can display available parameters by running the following command:
```bash
$: ./imx-sdcard-partition.sh -h
```
Among the most important parameters are:
- "-f soc_name" to specify the processor (e.g., "imx8mm" for tasd8mm or "imx8mp" for tasd8mp boards).
- "-c card_size" to set the uSD card size (options: 7, 14, or 28).
Here is an example of how to use the script to flash a uSD card:
Replace "/dev/sdb" with the appropriate device path for your uSD card.
3.**Configure Boot Source:**
After partitioning the uSD card, set your device to boot from the uSD card. Refer to your device's documentation or manufacturer's instructions for specific steps on how to set the boot source to the uSD card.
4.**Insert the uSD Card and Power On:**
Once you have configured the boot source to uSD, insert the uSD card into your device and power it on.
**Note:** Expect extended boot times when using Android from a uSD card, especially during the first boot. It is strongly recommended to use the eMMC for improved performance and faster boot times.
# Tastitalia Naming Convention
We follow a specific naming convention for our board names. The board names are in the format **tasXYYY_Zg_W**, where:
