Difference between revisions of "iMX93 Industrial Debian"

Latest revision as of 08:58, 29 January 2025

This Wiki page guides through the process of downloading the Debian source files for release (bookworm) and building images for the iMX93 Industrial Development Kit.

All the source files for this customized Debian, together with the recent changes made, can be inspected and downloaded at the Voipac GitHub repository.

Cloning the project

Create a new directory for the project environment:

mkdir ~/voipac-debian
cd ~/voipac-debian

Clone the iMX9x Industrial Debian Project into the host machine:

git clone https://github.com/voipac/debian-imx-voipac

Prerequisites

For Debian image building it is necessary to install docker installation as whole procedure is done in virtualised environment.

Building the image

Voipac provides quick and simple-to-use option how to build an image by using build_debian_voipac.sh prepared script:

This script automatically create Debian image for iMX93:

MACHINE=imx93-voipac ./build_debian_voipac.sh

During the u-boot build user will be asked for RAM Size. For basic kit configuration select option (1), for lite select 1G (option 2) and for pro and max configurations choose 2G option (option 3) as shown in below image.

Locating output files

After the build process was completed, the freshly built output files are located in the root directory:

ls -la image.sdimg

Flashing the binaries

At this point everything was prepared to flash the binaries. Follow the flashing procedure instructions to start the development kit with the compiled images.

Login =

When image is flashed and board is booted default credentials can be either root/root or voipac/voipac.

@@ Line 6: / Line 6: @@
 <div style="float:right">__TOC__</div>
-This Wiki page guides through the process of downloading the Yocto Project source files for release 3.1 (dunfell), their synchronization and building images for the iMX8M Industrial Development Kit.
+This Wiki page guides through the process of downloading the Debian source files for release (bookworm) and building images for the iMX93 Industrial Development Kit.
-Before images can be built, [[iMX8M Industrial Yocto Prerequisites|necessary steps need to be performed]] to setup the host machine.
+All the source files for this customized Debian, together with the recent changes made, can be inspected and downloaded at the [https://github.com/voipac/debian-imx-voipac Voipac GitHub] repository.
-All the source files for this customized Yocto Project, together with the recent changes made, can be inspected and downloaded at the [https://github.com/voipac Voipac GitHub] repository.
 == Cloning the project ==
 Create a new directory for the project environment:
 <syntaxhighlight lang="bash">
-mkdir ~/voipac-yocto
+mkdir ~/voipac-debian
-cd ~/voipac-yocto
+cd ~/voipac-debian
 </syntaxhighlight>
-Clone the iMX8M Industrial Yocto Project into the host machine:
+Clone the iMX9x Industrial Debian Project into the host machine:
 <syntaxhighlight lang="bash">
-git clone https://github.com/voipac/yocto-imx8m-voipac.git
+git clone https://github.com/voipac/debian-imx-voipac
 </syntaxhighlight>
-== Building the image ==
+== Prerequisites  ==
-Voipac provides quick and simple-to-use option how to build an image by using [https://github.com/voipac/yocto-imx8m-voipac/blob/master/build_image.sh prepared script]:
-<syntaxhighlight lang="bash">
-#!/bin/bash
-set -e
+For Debian image building it is necessary to install docker [https://docs.docker.com/desktop/setup/install/linux/ubuntu/ installation] as whole procedure is done in virtualised environment.
-# Copy manifests helper function
+== Building the image ==
-copy_manifests() {
+Voipac provides quick and simple-to-use option how to build an image by using [https://github.com/voipac/debian-imx-voipac/blob/master/build_debian_voipac.sh build_debian_voipac.sh] prepared script:
-rm -rf .repo
-mkdir -p .repo/manifests
-cp scripts/voipac.xml .repo/manifests/
-}
-# Fetch the latest meta layers
+This script automatically create Debian image for iMX93:
-if ! diff -q .repo/manifests/voipac.xml scripts/voipac.xml >/dev/null 2>&1; then
-        copy_manifests
-        repo init -u "$(pwd)"/.repo/repo -b default -m voipac.xml
-fi
-repo sync --optimized-fetch
-MACHINE=imx8mq-voipac DISTRO=fslc-xwayland source ./setup-environment build-voipac
-bitbake -f voipac-image
-</syntaxhighlight>
-This script automatically updates the latest meta layers. These layers include manifest files describing where all the sources are located. Afterwards all the directories are synchronized.
-The second to last '' source'' command defines the machine for which the last command ''bitbake'' compiles and builds output binaries. Besides describing the specifics for iMX8M Industrial Development Kit, '''DISTRO''' provides several graphical interface options:
-* '''fsl-imx-wayland''': Wayland/Weston graphics
-* '''fsl-imx-xwayland''': Wayland graphics and X11
-* '''fsl-imx-fb''': framebuffer graphics (no Wayland or X11)
-The script can be run to fetch and build the Yocto images by simply calling its filename:
 <syntaxhighlight lang="bash">
-./build_image.sh
+MACHINE=imx93-voipac ./build_debian_voipac.sh
 </syntaxhighlight>
-'''''Note:''''' Make sure that the synchronization finished without errors displaying the successful fetching with the following massage:
+During the u-boot build user will be asked for RAM Size. For basic kit configuration select option (1), for lite select 1G (option 2) and for pro and max configurations choose 2G option (option 3) as shown in below image.<br /><br />
-<syntaxhighlight lang="bash">
-repo sync has finished successfully.
-</syntaxhighlight>
-'''''Note:''''' The first successful build can take several hours (depending on multiple factors affecting the host machine like CPU, internet bandwidth, allocated disk space, etc.).
+[[File:Screenshot from 2025-01-29 08-48-33.png|thumb]]<br /><br />
 == Locating output files ==
-After the compiling process was completed, the freshly built output files are located in the directory:
+After the build process was completed, the freshly built output files are located in the root directory:
-<syntaxhighlight lang="bash">
-cd ~/voipac-yocto/yocto-imx8m-voipac/build-voipac/tmp/deploy/images
-</syntaxhighlight>
-This directory also include binaries to be flashed into the development kit. To make them more accessible, the files can be copied and unpacked:
 <syntaxhighlight lang="bash">
-cp -prv imx-boot ~/
+ls -la image.sdimg
-cp -prv voipac-image-imx8mq-voipac-20230512212054.rootfs.wic.gz ~/voipac-image-imx8mq-voipac.wic.gz
-gzip -d ~/voipac-image-imx8mq-voipac.wic.gz
 </syntaxhighlight>
-'''''Note:''''' The number string (e.g. ''20230512212054'') in the filename differs between every build as it displays the timestamp of the compilation.
 == Flashing the binaries ==
 At this point everything was prepared to flash the binaries. Follow the [[iMX8M Industrial Flashing Procedure|flashing procedure]] instructions to start the development kit with the compiled images.
+== Login ===
+When image is flashed and board is booted default credentials can be either '''root/root''' or '''voipac/voipac'''.