Changes

Page history
Create home authored by Stefano Radaelli's avatar Stefano Radaelli
Show whitespace changes
Inline Side-by-side
home.md 0 → 100644
View page @ 6d42fe9a
![Tastitalia_logo](https://www.tastitalia.com/wp-content/uploads/2022/10/Tastitalia_logo_2x.png)
# TASTITALIA BSP RELEASE
- [Prepare your PC](#prepare-your-pc)
- [Download Tastitalia Yocto Kirkstone](#download-tastitalia-yocto-kirkstone)
- [Download BSP with QT6 support](#download-bsp-with-qt6-support)
- [Download BSP with QT5 support](#download-bsp-with-qt5-support)
- [Set enviroment variables](#set-environment-variables)
- [SODIMM](#sodimm)
- [SMARC](#smarc)
- [Compile and flash image](#compile-and-flash-image)
- [Supported Images](#supported-images)
- [Flash image on uSD card](#flash-image-on-usd-card)
- [Flash image on eMMC](#flash-image-on-emmc)
- [Tastitalia Naming Convention](#tastitalia-naming-convention)
## Prepare your PC
Here are the packages needed to build an image on a headless system with a supported Ubuntu or Debian Linux distribution:
```bash
$: sudo apt-get install gawk wget git diffstat unzip texinfo gcc-multilib \
build-essential chrpath socat cpio python3 python3-pip python3-pexpect \
xz-utils debianutils iputils-ping libsdl1.2-dev xterm libyaml-dev libssl-dev
$: sudo apt-get install autoconf libtool libglib2.0-dev libarchive-dev \
sed cvs subversion coreutils texi2html docbook-utils \
help2man make gcc g++ desktop-file-utils libgl1-mesa-dev libglu1-mesa-dev \
mercurial automake groff curl lzop asciidoc u-boot-tools dos2unix mtd-utils pv \
libncurses5 libncurses5-dev libncursesw5-dev libelf-dev zlib1g-dev bc rename \
zstd libgnutls28-dev gfortran lz4
```
For Ubuntu 20.04 and earlier, install python2:
```bash
$: sudo apt-get install python python-pysqlite2
```
We used Ubuntu 20.04 and Ubuntu 22.04 to build Yocto Kirkstone, other distributions may work but have not been tested.
## Download Tastitalia Yocto Kirkstone
To get the BSP you need to have repo installed and use it as:
Install the repo utility:
```bash
$: mkdir ~/bin
$: curl http://commondatastorage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
$: chmod a+x ~/bin/repo
```
Follow the next chapter to download BSP source, choosing between QT6 or QT5 support.
### Download BSP with QT6 support
Download the BSP source:
```bash
$: PATH=${PATH}:~/bin
$: mkdir -p ~/yocto/kirkstone-qt6
$: cd ~/yocto/kirkstone-qt6
$: repo init -u https://gitlab.tastitalia.com/tastitalia-mpu-arm/yocto/tastitalia-bsp-release.git -b kirkstone-nxp -m tastitalia-bsp-release.xml
$: repo sync -j20
#### Choose -j variable according to the number of cores in your PC
```
At the end of the commands you have every metadata you need to start work with.
### Download BSP with QT5 support
```bash
$: PATH=${PATH}:~/bin
$: mkdir -p ~/yocto/kirkstone-qt5
$: cd ~/yocto/kirkstone-qt5
$: repo init -u https://gitlab.tastitalia.com/tastitalia-mpu-arm/yocto/tastitalia-bsp-release.git -b kirkstone-nxp -m tastitalia-bsp-release-qt5.xml
$: repo sync -j20
#### Choose -j variable according to the number of cores in your PC
```
At the end of the commands you have every metadata you need to start work with.
## Set environment variables
Enter Yocto folder and launch the script setting enviroment variables:
```bash
$: DISTRO=<distro name> MACHINE=<machine name> source imx-setup-release.sh -b <build dir>
```
where ``<machine-name>`` corresponds to the module for which the operative system image will be compiled and ``<build-dir-name>`` is the bulding directory name chosen by the user, as in the following example:
```bash
$: DISTRO=fsl-imx-wayland MACHINE=tasd8mm-2g-10 source imx-setup-release.sh -b build
```
where a directory named ``build`` is created and enviroment variables are set to compile images for the module ``SODIMM MX8M Mini``.
If the build directory already exists due to previous compilations it will be required to set the enviroment variables only executing the command:
```bash
$: source setup-environment build
```
You can find the right machine name following our [Naming Convention](#tastitalia-naming-convention), or searching in the supported machines table below:
### SODIMM
| Machine | Description |
|-------------|-------------------------------------------------------------------------------------------------------------------------|
| **tasd8mm-1g-10** | ``Tastitalia Starter Kit``: **SODIMM i.MX8M Mini** module, 1GB of DDRAM and custom **10"** LVDS Display (1920x1200). |
| **tasd8mm-2g-10** | ``Tastitalia Starter Kit``: **SODIMM i.MX8M Mini** module, 2GB of DDRAM and custom **10"** LVDS display (1920x1200). |
| **tasd8mp-2g-10** | ``Tastitalia Starter Kit``: **SODIMM i.MX8M Plus** module, 2GB of DDRAM and custom **10"** LVDS display (1920x1200). |
| **tasd8mm-1g-7** | **SODIMM i.MX8M Mini** module, 1GB of DDRAM and custom **7"** LVDS Display (1280x800). |
| **tasd8mm-2g-7** | **SODIMM i.MX8M Mini** module, 2GB of DDRAM and custom **7"** LVDS display (1280x800). |
| **tasd8mp-2g-7** | **SODIMM i.MX8M Plus** module, 2GB of DDRAM and custom **7"** LVDS display (1280x800). |
| **tasd8mp-2g-4** | **SODIMM i.MX8M Plus** module, 2GB of DDRAM and custom **4.3"** LVDS display (800x480). |
### SMARC
| Machine | Description |
|-------------|-------------------------------------------------------------------------------------------------------------------------|
| **tasc8mp-2g-10** | ``Tastitalia Starter Kit``: **SMARC i.MX8M Plus** module, 2GB of DDRAM and custom **10"** LVDS display (1920x1200). |
| **tasc8mp-2g-7** | **SMARC i.MX8M Plus** module, 2GB of DDRAM and custom **7"** LVDS display (1280x800). |
| **tasc8mp-2g-12** | **SMARC i.MX8M Plus** module, 2GB of DDRAM and custom **12"** LVDS display (1280x800). |
## Compile and flash image
Compile the desired image with bitbake using the command (in this example we compile the recipe ``tastitalia-demo-image.bb`` for ``i.MX 8M Mini``):
```bash
$: bitbake tastitalia-demo-image
```
### Supported Images
| Image | Description |
|-------------|-------------------------------------------------------------------------------------------------------------------------|
| **tastitalia-base-image** | Weston minimal environment with Chromium |
| **tastitalia-demo-image** | Tastitalia-base-image with the addition of QT, machine learning libraries and NXP graphical demo examples |
Once the image is compiled it will be possible to find in the build directory a deploy folder with the image files. The relative path to this folder from the yocto directory will be ``tmp/deploy/images/<MACHINE>``
Example:
```bash
$: cd tmp/deploy/images/tasd8mm-2g-10
$: ls *wic.zst
```
### Flash image on uSD card
Here an example to flash an image to your uSD card from a Linux distribution:
```bash
$: cd tmp/deploy/images/tasd8mp-2g-10/
$: unzstd tastitalia-demo-image-tasd8mp-2g-10-20230713143133.rootfs.wic.zst
$: sudo dd if=tastitalia-demo-image-tasd8mp-2g-10-20230713143133.rootfs.wic of=/dev/sdb bs=1M conv=fsync status=progress
#### Change /dev/sdb with your current uSD device
```
### Flash image on eMMC
Tastitalia provides a script to install the operating system on the eMMC of the board.
To do this, boot the board from the uSD and, while the system is running, execute the following command from shell:
```bash
$: install_yocto.sh
```
The process will take a few minutes, and once it's finished, a message confirming the successful installation will be displayed.
Now you can boot the board from eMMC.
## Tastitalia Naming Convention
We follow a specific naming convention for our board names. The board names are in the format **tasXYYY_Zg_W**, where:
- "**X**" indicates the format of the System-on-Module (SOM):
- "d" represents SODIMM format
- "c" represents SMARC format.
- "**YYY**" indicates the processor type, such as "8mp" for NXP i.MX8M Plus processor
- "**Z**" indicates the amount of DDR RAM in GB.
- "**W**" indicates the display size in inches.
For example, a board name **tasd8mm_2g_10** would represent a board with a SODIMM format, an i.MX8M Mini processor, 2GB of DDR RAM, and a 10-inch display (Dev Kit).