KrzysztofChojnowski at 13:06, 12 December 2025

2025-12-12T13:06:33Z

← Older revision		Revision as of 13:06, 12 December 2025
Line 76:		Line 76:
	* spacesom-8mplus-cb - SpaceCB-8Mplus board with SpaceSOM-8Mplus module		* spacesom-8mplus-cb - SpaceCB-8Mplus board with SpaceSOM-8Mplus module
	* somlabs-iot-box-6ull - SL-IoT-BOX-6ULL module		* somlabs-iot-box-6ull - SL-IoT-BOX-6ULL module
			* visionsom-imx91 - VisionCB-iMX91-STD board family with VisionSOM-iMX91 modules
			* visionsom-imx93 - VisionCB-iMX93-STD board family with VisionSOM-iMX93 modules

	The following system distributions were tested on SoMLabs modules:		The following system distributions were tested on SoMLabs modules:

KrzysztofChojnowski at 13:51, 30 October 2025

2025-10-30T13:51:29Z

← Older revision		Revision as of 13:51, 30 October 2025
Line 41:		Line 41:
	== Building the system image ==		== Building the system image ==

	The general description of the building process is described in the iMX Yocto Project User's Guide document for version 6.6.~~52_2~~.2.0:		The general description of the building process is described in the iMX Yocto Project User's Guide document for version 6.12.34_2.1.0:

	https://www.nxp.com/design/software/embedded-software/i-mx-software/embedded-linux-for-i-mx-applications-processors:IMXLINUX		https://www.nxp.com/design/software/embedded-software/i-mx-software/embedded-linux-for-i-mx-applications-processors:IMXLINUX

KrzysztofChojnowski: Created page with "{{PageHeader|VisionSOM imx-meta-somlabs layer for iMX Yocto Walnascar}} toc This tutorial explains how to build the Yocto Walnascar system for the SoMLabs modules. The Yocto system uses the following kernel and u-boot repositories: * kernel (6.12.34): https://github.com/SoMLabs/somlabs-linux-imx/tree/somlabs_imx_6.12.34-2.1.0 * u-boot (2024.04): https://github.com/SoMLabs/somlabs-uboot-imx/tree/somlabs-imx_v2024.04_6.6.52-2.2.0 == Introduction == Meta-somlabs is..."

2025-10-30T13:50:47Z

Created page with "{{PageHeader|VisionSOM imx-meta-somlabs layer for iMX Yocto Walnascar}} __toc__ This tutorial explains how to build the Yocto Walnascar system for the SoMLabs modules. The Yocto system uses the following kernel and u-boot repositories: * kernel (6.12.34): https://github.com/SoMLabs/somlabs-linux-imx/tree/somlabs_imx_6.12.34-2.1.0 * u-boot (2024.04): https://github.com/SoMLabs/somlabs-uboot-imx/tree/somlabs-imx_v2024.04_6.6.52-2.2.0 == Introduction == Meta-somlabs is..."

New page

{{PageHeader|VisionSOM imx-meta-somlabs layer for iMX Yocto Walnascar}} __toc__

This tutorial explains how to build the Yocto Walnascar system for the SoMLabs modules. The Yocto system uses the following kernel and u-boot repositories:

* kernel (6.12.34): https://github.com/SoMLabs/somlabs-linux-imx/tree/somlabs_imx_6.12.34-2.1.0
* u-boot (2024.04): https://github.com/SoMLabs/somlabs-uboot-imx/tree/somlabs-imx_v2024.04_6.6.52-2.2.0

== Introduction ==

Meta-somlabs is a layer providing the SoMLabs modules and carrier boards hardware support for Yocto-based NXP Linux system. It may be used on top of the meta-imx layer provided by NXP or directly with meta-freescale maintained by the community.

== Host system prerequisites ==

This tutorial was prepared for the Ubuntu 20.04 host operating system. All of the files required for system image compilation may require up to 120 GB of the disk space.

The following packages need to be installed before the building process:

<pre>
sudo apt-get install gawk wget git diffstat unzip texinfo gcc build-essential chrpath socat cpio python3 python3-pip python3-pexpect xz-utils debianutils iputils-ping python3-git python3-jinja2 libegl1-mesa libsdl1.2-dev python3-subunit mesa-common-dev zstd liblz4-tool file locales
</pre>

The source code will be obtained using git, so it needs to be configured by setting the user name and email with correctly set values:

<pre>
git config --global user.email "you@example.com"
git config --global user.name "Your Name"
</pre>

A new repo tool version is also required. It may be downloaded directly from the project site. The repo binary needs to be available in the system PATH variable and have the execution privilege:

<pre>
wget https://storage.googleapis.com/git-repo-downloads/repo
sudo mv repo /usr/bin/repo
sudo chmod a+x /usr/bin/repo
</pre>

== System image ==

This layer should be used in order to build the system image. It adds a new example image called somlabs-image and two distros: somlabs-fb and somlabs-xwayland. It also includes the SoMLabs demo application using the GTK and GStreamer libraries.

== Building the system image ==

The general description of the building process is described in the iMX Yocto Project User's Guide document for version 6.6.52_2.2.0:

https://www.nxp.com/design/software/embedded-software/i-mx-software/embedded-linux-for-i-mx-applications-processors:IMXLINUX

'''NOTE: Since imx-somlabs-6.6.52-2.2.0 version gstreamer with wayland sink is no longer supported on iMX6ULL platforms. In order to use this feature the imx-somlabs-6.6.23-2.0.0 version shall be used configured using respective repo xml files.'''

The summary of required steps including the meta-somlabs layer is shown below:

* with meta-imx usage
<pre>
mkdir imx-yocto-bsp
cd imx-yocto-bsp
repo init -u https://github.com/SoMLabs/imx-meta-somlabs -b walnascar -m imx-somlabs-6.12.34-2.1.0.xml
repo sync
</pre>

* with meta-freescale (without meta-imx support)
<pre>
mkdir imx-yocto-bsp
cd imx-yocto-bsp
repo init -u https://github.com/SoMLabs/imx-meta-somlabs -b walnascar -m fsl-somlabs-6.12.34-2.1.0.xml
repo sync
</pre>

System building may be configured for one of the available machine configurations:

* visioncb-6ull-std - VisionCB-6ULL-STD board with VisionSOM-6ULL modules
* visionsom-8mm-cb - VisionCB-8M board family with VisionSOM-8Mmini modules
* titansbc-8mmini - TitanSBC-8Mmini board
* starsom-cb-6ull - StarCB-6ULL board with StarSOM-6ULL modules
* starsbc-6ull - StarSBC-6ULL board with or without the COMM shield
* spacesom-8mplus-cb - SpaceCB-8Mplus board with SpaceSOM-8Mplus module
* somlabs-iot-box-6ull - SL-IoT-BOX-6ULL module

The following system distributions were tested on SoMLabs modules:

* somlabs-fb - distribution without graphical environment
* somlabs-xwayland - distribution with wayland and x11 enabled

'''NOTE: Since 6.1.x kernel uptade the GPU drivers on iMX8MPlus require modules with at least 2GB RAM available. For 1GB RAM spacesom-8mplus-cb machine use somlabs-fb distro only.'''

System building may be started by the following commands:

* with meta-imx usage
<pre>
DISTRO=<SELECTED_DISTRIBUTION> MACHINE=<SELECTED_MACHINE> source imx-somlabs-setup-release.sh -b <BUILD_DIRECTORY>
bitbake somlabs-image
</pre>

* with meta-freescale (without meta-imx support)
<pre>
DISTRO=<SELECTED_DISTRIBUTION> MACHINE=<SELECTED_MACHINE> source fsl-somlabs-setup-environment.sh <BUILD_DIRECTORY>
bitbake somlabs-image
</pre>

The system image is located in the somlabs-image-<SELECTED_MACHINE>.rootfs.wic.zst or somlabs-image-<SELECTED_MACHINE>.rootfs.wic.gz file in the tmp/deploy/images/<SELECTED_MACHINE> directory. It should be extracted with one of the commands:

<pre>
unzstd somlabs-image-<SELECTED_MACHINE>.rootfs.wic.zst
gunzip somlabs-image-<SELECTED_MACHINE>.rootfs.wic.gz
</pre>

The instruction for the eMMC memory image installation may be found on the wiki page for corresponding module:

* https://wiki.somlabs.com/index.php/Main_Page

== Weston configuration on VisionSOM-8MM boards ==

Weston graphical environment is configured by /etc/xdg/weston/weston.ini file. On VisionSOM-8MM boards this file is a link created by systemd service somlabs-weston-init.service during system boot. This service uses somlabs-weston-init.sh script to check which display is in use and to create weston.ini link to normal or rotated display configuration. This script removes the existing link during each boot bo verify currently connected display.

<pre>
#!/bin/sh

WESON_INI_FILE="/etc/xdg/weston/weston.ini"

if [ -L "$WESON_INI_FILE" ]; then
rm $WESON_INI_FILE
elif [ -f "$WESON_INI_FILE" ]; then
exit 0
fi

CMDLINE="`cat /proc/device-tree/model`"

case "$CMDLINE" in
*MIPI7-POWERTIP*)
ln -s /etc/xdg/weston/weston_8m_rotated.ini $WESON_INI_FILE
;;
*)
ln -s /etc/xdg/weston/weston_8m.ini $WESON_INI_FILE
;;
esac

exit 0
</pre>

In order to disable this functionality the service may be disabled using systemd:

<pre>
systemctl disable somlabs-weston-init.service
</pre>

VisionSOM imx-meta-somlabs-walnascar - Revision history

KrzysztofChojnowski at 13:06, 12 December 2025

KrzysztofChojnowski at 13:51, 30 October 2025