RNX-iMX93-SMARC Yocto Linux - Revision history

Ilko at 09:56, 2 July 2026

2026-07-02T09:56:04Z

← Older revision		Revision as of 11:56, 2 July 2026
Line 85:		Line 85:
	$ bitbake imx-image-core		$ bitbake imx-image-core

	''If the Ubuntu Terminal is crashed without any notification, see here: [[FAQ - Frequently Asked Questions]]''		{{Note\|
			If the Ubuntu Terminal is crashed without any notification, see here: [[FAQ - Frequently Asked Questions]]}}

	=== Build Results ===		=== Build Results ===
Line 110:		Line 111:
	$ uuu -b emmc_all imx-boot-{{#var:MACHINE_NAME}}-sd.bin-flash_singleboot imx-image-core-{{#var:MACHINE_NAME}}.wic.zst		$ uuu -b emmc_all imx-boot-{{#var:MACHINE_NAME}}-sd.bin-flash_singleboot imx-image-core-{{#var:MACHINE_NAME}}.wic.zst

	Note:		{{Note\|
	* If the programming freezes with last message "Failed to configure default pinctrl", then try with another USB cable or USP port on your PC.		If the programming freezes with last message "Failed to configure default pinctrl", then try with another USB cable or USP port on your PC.}}

	==== Boot Linux ====		==== Boot Linux ====

Ilko: Use tag in some commands

2026-03-23T08:19:58Z

Use tag <syntaxhighlight> in some commands

← Older revision		Revision as of 10:19, 23 March 2026
Line 41:		Line 41:

	Please make sure your host PC is running Ubuntu 20.04+ 64-bit and install the following packages:		Please make sure your host PC is running Ubuntu 20.04+ 64-bit and install the following packages:
	<~~pre~~>		<syntaxhighlight lang="console" copyable>
	$ sudo apt-get install gawk wget git diffstat unzip texinfo gcc-multilib \		$ sudo apt-get install gawk wget git diffstat unzip texinfo gcc-multilib \
	build-essential chrpath socat cpio python3 python3-pip python3-pexpect \		build-essential chrpath socat cpio python3 python3-pip python3-pexpect \
	xz-utils debianutils iputils-ping libsdl1.2-dev xterm python-is-python3 lz4		xz-utils debianutils iputils-ping libsdl1.2-dev xterm python-is-python3 lz4
			</syntaxhighlight>

			<syntaxhighlight lang="console" copyable>
	$ sudo apt-get install autoconf libtool libglib2.0-dev libarchive-dev python-git-doc \		$ sudo apt-get install autoconf libtool libglib2.0-dev libarchive-dev python-git-doc \
	sed cvs subversion coreutils texi2html docbook-utils \		sed cvs subversion coreutils texi2html docbook-utils \
Line 51:		Line 53:
	mercurial automake groff curl lzop asciidoc u-boot-tools dos2unix mtd-utils pv \		mercurial automake groff curl lzop asciidoc u-boot-tools dos2unix mtd-utils pv \
	libncurses5 libncurses5-dev libncursesw5-dev libelf-dev zlib1g-dev bmap-tools		libncurses5 libncurses5-dev libncursesw5-dev libelf-dev zlib1g-dev bmap-tools
	</~~pre~~>		</syntaxhighlight>

	More details about the Yocto Environment Setup can be found		More details about the Yocto Environment Setup can be found
Line 147:		Line 149:
	Connect an OV5640 camera (PCAM 5C) to J21 on the carrier board.<br>		Connect an OV5640 camera (PCAM 5C) to J21 on the carrier board.<br>
	List capture media devices:		List capture media devices:
			<syntaxhighlight lang="console" copyable>
	$ v4l2-ctl --list-devices		$ v4l2-ctl --list-devices
	FSL Capture Media Device (platform:42800000.bus:camera):		FSL Capture Media Device (platform:42800000.bus:camera):
Line 153:		Line 156:
	mxc-isi-cap (platform:4ae40000.isi:cap_devic):		mxc-isi-cap (platform:4ae40000.isi:cap_devic):
	/dev/video0		/dev/video0
			</syntaxhighlight>

	Take a single photo:		Take a single photo:
			<syntaxhighlight lang="console" copyable>
	$ gst-launch-1.0 v4l2src num-buffers=1 ! jpegenc ! filesink location=test.jpg		$ gst-launch-1.0 v4l2src num-buffers=1 ! jpegenc ! filesink location=test.jpg
	Setting pipeline to PAUSED ...		Setting pipeline to PAUSED ...
Line 172:		Line 177:
	[ 879.341902] dwc-mipi-csi2-host 4ae00000.csi: enter enable=0		[ 879.341902] dwc-mipi-csi2-host 4ae00000.csi: enter enable=0
	Freeing pipeline ...		Freeing pipeline ...
			</syntaxhighlight>

	== See also ==		== See also ==

Ilko: Add note about failed programming

2025-10-27T12:08:12Z

Add note about failed programming

← Older revision		Revision as of 14:08, 27 October 2025
Line 107:		Line 107:
	$ cd tmp/deploy/images/{{#var:MACHINE_NAME}}		$ cd tmp/deploy/images/{{#var:MACHINE_NAME}}
	$ uuu -b emmc_all imx-boot-{{#var:MACHINE_NAME}}-sd.bin-flash_singleboot imx-image-core-{{#var:MACHINE_NAME}}.wic.zst		$ uuu -b emmc_all imx-boot-{{#var:MACHINE_NAME}}-sd.bin-flash_singleboot imx-image-core-{{#var:MACHINE_NAME}}.wic.zst

			Note:
			* If the programming freezes with last message "Failed to configure default pinctrl", then try with another USB cable or USP port on your PC.

	==== Boot Linux ====		==== Boot Linux ====

Ilko: Make "close" bold

2025-10-27T10:34:16Z

Make "close" bold

← Older revision		Revision as of 12:34, 27 October 2025
Line 28:		Line 28:
	! BOOT !! J4:1-2 !! J4:3-4 !! J4:5-6 !! J4:7-8		! BOOT !! J4:1-2 !! J4:3-4 !! J4:5-6 !! J4:7-8
	\|-		\|-
	\| Cortex-A55 Serial Downloader \|\| close \|\| open \|\| open \|\| open		\| Cortex-A55 Serial Downloader \|\| '''close''' \|\| open \|\| open \|\| open
	\|-		\|-
	\| Cortex-A55, eMMC \|\| open \|\| close \|\| open \|\| open		\| Cortex-A55, eMMC \|\| open \|\| '''close''' \|\| open \|\| open
	\|}		\|}

Ilko: Fix USB console port

2025-03-25T10:34:55Z

Fix USB console port

← Older revision		Revision as of 12:34, 25 March 2025
Line 36:		Line 36:
	The carrier board connects the host PC using the micro-B USB connector (J3).<br>		The carrier board connects the host PC using the micro-B USB connector (J3).<br>
	Common serial communication programs such as Minicom, HyperTerminal, Tera Term, or PuTTY can be used.<br>		Common serial communication programs such as Minicom, HyperTerminal, Tera Term, or PuTTY can be used.<br>
	The {{#var:HARDWARE_NAME}} board uses the ~~second~~ port for the Arm Cortex-A cores console.		The {{#var:HARDWARE_NAME}} board uses the first port for the Arm Cortex-A cores console.

	== Installing required packages ==		== Installing required packages ==

Ilko: Fix a typo

2024-06-27T08:08:44Z

Fix a typo

← Older revision		Revision as of 10:08, 27 June 2024
Line 98:		Line 98:
	Download UUU version 1.5.21 or later from https://github.com/nxp-imx/mfgtools/releases		Download UUU version 1.5.21 or later from https://github.com/nxp-imx/mfgtools/releases

	===== Write WIC image ~~info~~ eMMC =====		===== Write the WIC image into eMMC =====
	Follow the instructions below:		Follow the instructions below:
	* Connect a USB cable from a computer to the J9, port USB-0 (Micro-AB) port on the carrier board for download link.		* Connect a USB cable from a computer to the J9, port USB-0 (Micro-AB) port on the carrier board for download link.

Ilko: Update aplay command

2024-03-14T13:23:07Z

Update aplay command

← Older revision		Revision as of 15:23, 14 March 2024
Line 133:		Line 133:

	Play a file:		Play a file:
	$ aplay ~~Test~~.wav		$ aplay -D "sysdefault:CARD=wm8962audio" test.wav

	List all sound controls:		List all sound controls:
Line 142:		Line 142:

	== Camera Test ==		== Camera Test ==
	Connect a OV5640 camera (PCAM 5C) to J21 on the carrier board.<br>		Connect an OV5640 camera (PCAM 5C) to J21 on the carrier board.<br>
	List capture media devices:		List capture media devices:
	$ v4l2-ctl --list-devices		$ v4l2-ctl --list-devices

Ilko: Initial creation

2024-03-11T13:46:59Z

Initial creation

New page

{{#vardefine:HARDWARE_NAME|RNX-iMX93-SMARC}}
{{#vardefine:MACHINE_NAME|rnx-imx93-smarc}}
{{#vardefine:YOCTO_NAME|micledore}}
{{#vardefine:KERNEL_VER|6.1.55}}
{{#vardefine:UBOOT_VER|v2023.04}}
[[File:RNX-iMX93-SMARC_top.webp|thumb]]

== Overview ==
The Yocto Project is an open source collaboration project that helps developers create custom Linux-based systems for embedded products, regardless of the hardware architecture. 
This article show how to build Yocto Image for {{#var:HARDWARE_NAME}} CPU module using: 
{| class="wikitable"
|-
!
! Linux Kernel
! U-BOOT
|-
| Yocto {{#var:YOCTO_NAME}}
| {{#var:KERNEL_VER}}
| {{#var:UBOOT_VER}}
|}

[https://www.yoctoproject.org/docs/ Learn more about Yocto]

== Setting Boot mode ==
{| class="wikitable"
|+ Boot mode setting on carrier board
|-
! BOOT !! J4:1-2 !! J4:3-4 !! J4:5-6 !! J4:7-8
|-
| Cortex-A55 Serial Downloader || close || open || open || open
|-
| Cortex-A55, eMMC || open || close || open || open
|}

== Terminal Setup ==
The carrier board connects the host PC using the micro-B USB connector (J3). 
Common serial communication programs such as Minicom, HyperTerminal, Tera Term, or PuTTY can be used. 
The {{#var:HARDWARE_NAME}} board uses the second port for the Arm Cortex-A cores console.

== Installing required packages ==

Please make sure your host PC is running Ubuntu 20.04+ 64-bit and install the following packages:
<pre>
$ 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 python-is-python3 lz4

$ sudo apt-get install autoconf libtool libglib2.0-dev libarchive-dev python-git-doc \
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 bmap-tools
</pre>

More details about the Yocto Environment Setup can be found
[https://docs.yoctoproject.org/brief-yoctoprojectqs/index.html on the Yocto official site]

== Download Yocto based on Freescale Community BSP ==

$ git config --global user.name "Your Name"
$ git config --global user.email "Your Email"

$ mkdir ~/bin
$ curl <nowiki>http://commondatastorage.googleapis.com/git-repo-downloads/repo > ~/bin/repo</nowiki>
$ chmod a+x ~/bin/repo
$ export PATH=~/bin:$PATH

$ mkdir ~/yocto-ronetix
$ cd ~/yocto-ronetix

* '''Download the Yocto repository''' 
$ repo init -u https://github.com/ronetix/imx-manifest -b imx-linux-mickledore -m imx-6.1.55-2.2.0.xml
$ repo sync

== Setup and build Yocto ==
* Setup first time:
$ MACHINE={{#var:MACHINE_NAME}} DISTRO=fsl-imx-xwayland source ./imx-setup-release.sh -b build-{{#var:MACHINE_NAME}}

* or setup if already configured:
$ source setup-environment build-{{#var:MACHINE_NAME}}

* Build:
$ bitbake imx-image-core

''If the Ubuntu Terminal is crashed without any notification, see here: [[FAQ - Frequently Asked Questions]]''

=== Build Results ===
The resulted images are located in tmp/deploy/images/{{#var:MACHINE_NAME}}.

=== Booting Linux ===
This section describes how to copy the images (U-Boot, Linux kernel, device tree, and
rootfs) to the eMMC device on the module.

==== Universal update utility ====
The Universal Update Utility (UUU) runs on a Windows or Linux OS host and is used to download images to devices on an i.MX board.

===== Downloading UUU =====
Download UUU version 1.5.21 or later from https://github.com/nxp-imx/mfgtools/releases

===== Write WIC image info eMMC =====
Follow the instructions below:
* Connect a USB cable from a computer to the J9, port USB-0 (Micro-AB) port on the carrier board for download link.
* Connect a USB cable from J3, port UART-DBG (Micro-AB) port to the computer for console output.
* Open a Terminal emulator program
* Set the boot mode to "Cortex-A55 Serial Downloader", see [[#Setting Boot mode]]

$ cd tmp/deploy/images/{{#var:MACHINE_NAME}}
$ uuu -b emmc_all imx-boot-{{#var:MACHINE_NAME}}-sd.bin-flash_singleboot imx-image-core-{{#var:MACHINE_NAME}}.wic.zst

==== Boot Linux ====
* set the boot mode to "Cortex-A55, eMMC", see [[#Setting Boot mode]]
* reset the board

== WiFi Setup ==
Scan for wireless networks:
$ ifconfig wlan0 up
$ iw dev wlan0 scan | grep SSID

Connecting to an Access Point:
$ wpa_passphrase <YourAP> <YourPassword> > /etc/wpa_supplicant.conf
$ wpa_supplicant -B -D nl80211 -i wlan0 -c /etc/wpa_supplicant.conf

wait for:
$ wlcore: Association completed.

Get an IP via DHCP:
$ udhcpc -i wlan0
$ ifconfig

== Audio Test ==
List all sound cards:
$ aplay -L

Play a file:
$ aplay Test.wav

List all sound controls:
$ amixer controls

Set Speaker Playback volume to max:
$ amixer cset numid=13 127

== Camera Test ==
Connect a OV5640 camera (PCAM 5C) to J21 on the carrier board. 
List capture media devices:
$ v4l2-ctl --list-devices
FSL Capture Media Device (platform:42800000.bus:camera):
/dev/media0

mxc-isi-cap (platform:4ae40000.isi:cap_devic):
/dev/video0

Take a single photo:
$ gst-launch-1.0 v4l2src num-buffers=1 ! jpegenc ! filesink location=test.jpg
Setting pipeline to PAUSED ...
Pipeline is live and does not need PREROLL ...
Pipeline is PREROLLED ...
Setting pipeline to PLAYING ...
New clock: GstSystemClock
[ 877.427496] mxc-mipi-csi2.0: format: 0x2008
[ 877.436706] bypass csc
[ 877.439078] input fmt YUV4
[ 877.441775] output fmt YUYV
[ 877.553965] dwc-mipi-csi2-host 4ae00000.csi: enter enable=1
Redistribute latency...
Got EOS from element "pipeline0".
Execution ended after 0:00:02.375455667
Setting pipeline to NULL ...
[ 879.341902] dwc-mipi-csi2-host 4ae00000.csi: enter enable=0
Freeing pipeline ...

== See also ==
* [[{{#var:HARDWARE_NAME}} Yocto Linux | Yocto Linux]]
* [[{{#var:HARDWARE_NAME}} Linux|Building Linux Kernel]]
* [[{{#var:HARDWARE_NAME}} U-Boot|Building U-Boot]]