iMX93 Industrial Mender - Revision history

Voipac-sw: /* Flashing instructions */

2025-02-04T16:37:18Z

Flashing instructions

Voipac-sw: /* Flashing instructions */

2025-02-04T16:36:53Z

Flashing instructions

Voipac-sw: /* Flashing instructions */

2025-02-04T16:35:53Z

Flashing instructions

Voipac-sw: /* Using the build output */

2025-02-04T16:34:07Z

Using the build output

Voipac-sw: /* Building the image */

2025-02-04T16:33:13Z

Building the image

Voipac-sw at 16:32, 4 February 2025

2025-02-04T16:32:09Z

Voipac-sw: /* Setup Yocto environment */

2025-02-04T16:31:37Z

Setup Yocto environment

Voipac-sw at 16:25, 4 February 2025

2025-02-04T16:25:22Z

Voipac-sw at 16:20, 4 February 2025

2025-02-04T16:20:57Z

Voipac-sw: Created page with "For building and installation instruction please follow [https://hub.mender.io/t/voipac-imx93-industrial-development-kit/7316 topic] how to build and flash mender OTA to iMX93..."

2025-01-29T08:01:01Z

Created page with "For building and installation instruction please follow [https://hub.mender.io/t/voipac-imx93-industrial-development-kit/7316 topic] how to build and flash mender OTA to iMX93..."

New page

For building and installation instruction please follow [https://hub.mender.io/t/voipac-imx93-industrial-development-kit/7316 topic] how to build and flash mender OTA to iMX93 industrial development kit.

@@ Line 72: / Line 72: @@
 Copy image + imx-boot to custom directory
 <syntaxhighlight lang="bash">
 cp yocto-imx-voipac/build/tmp/deploy/images/imx93-voipac/voipac-image-imx93-voipac.sdimg.zst yocto-imx-voipac/flashing
@@ Line 82: / Line 83: @@
 cp -f imx-boot imx-boot-flash-mender
 </syntaxhighlight>
 Prepare board to serial download mode
 Setup S1 pin to Serial download mode and connect imx93 board to you PC using USB-C cable.
-Run flashing script
+Run flashing script:
 <syntaxhighlight lang="bash">
 ./flash-mender.sh
-<\syntaxhighlight>
+</syntaxhighlight>
 After all is done you can unplugged USB-C and power on your board with mender integrated.

@@ Line 72: / Line 72: @@
 Copy image + imx-boot to custom directory
+<syntaxhighlight lang="bash">
 cp yocto-imx-voipac/build/tmp/deploy/images/imx93-voipac/voipac-image-imx93-voipac.sdimg.zst yocto-imx-voipac/flashing
 cp yocto-imx-voipac/build/tmp/deploy/images/imx93-voipac/imx-boot yocto-imx-voipac/flashing
 # make copy of mender imx-boot
 cd yocto-imx-voipac/flashing
 cp -f imx-boot imx-boot-flash-mender
 Prepare board to serial download mode
 Setup S1 pin to Serial download mode and connect imx93 board to you PC using USB-C cable.
 Run flashing script
 ./flash-mender.sh
 After all is done you can unplugged USB-C and power on your board with mender integrated.

← Older revision		Revision as of 16:35, 4 February 2025
Line 68:		Line 68:

	== Flashing instructions ==		== Flashing instructions ==
−	~~Follow the [[iMX8M Industrial Flashing Procedure\|flashing procedure]] instructions for image flashing.~~

		+	For flashing to eMMC we need to use uuu utility which must be installed on your host computer (mfgtools. Also due issue with emmc boot we split flashing to 2 parts. First we use imx-boot without mender integration and the we replace imx-boot in eMMC with one with mender integration. All is prepared in convenient script imx93 mender flashing

−	~~For building and installation instruction please follow [https:~~//~~hub~~.~~mender~~.io/t/voipac-~~imx93~~-~~industrial~~-~~development~~-~~kit~~/~~7316 topic] how~~ to ~~build~~ and flash mender ~~OTA to iMX93 industrial development kit~~.	+	Copy image + imx-boot to custom directory
		+
		+	cp yocto-imx-voipac/build/tmp/deploy/images/imx93-voipac/voipac-image-imx93-voipac.sdimg.zst yocto-imx-voipac/flashing
		+	cp yocto-imx-voipac/build/tmp/deploy/images/imx93-voipac/imx-boot yocto-imx-voipac/flashing
		+
		+	# make copy of mender imx-boot
		+	cd yocto-imx-voipac/flashing
		+	cp -f imx-boot imx-boot-flash-mender
		+	Prepare board to serial download mode
		+	Setup S1 pin to Serial download mode and connect imx93 board to you PC using USB-C cable.
		+
		+	Run flashing script
		+	./flash-mender.sh
		+	After all is done you can unplugged USB-C and power on your board with mender integrated.

@@ Line 61: / Line 61: @@
 == Using the build output ==
-After a successful build, the images and build artifacts are placed in ''tmp/deploy/images/imq8mq-voipac/'' directory.
+After a successful build, the images and build artifacts are placed in ''tmp/deploy/images/imx93-voipac/'' directory.
-The disk image (with ''.sdimg.bz2'' suffix) is used to provision the storage for devices without Mender already running. Please proceed to the [https://docs.mender.io/system-updates-yocto-project/provisioning-a-new-device?target=_blank official documentation on provisioning a new device] for steps to do so.
+The disk image (with ''.sdimg.zst'' suffix) is used to provision the storage for devices without Mender already running. Please proceed to the [https://docs.mender.io/system-updates-yocto-project/provisioning-a-new-device?target=_blank official documentation on provisioning a new device] for steps to do so.
 On the other hand, if Mender has already been running on the device and want to deploy a rootfs update using this build, the [https://docs.mender.io/overview/artifact?target=_blank Mender Artifact] files, with ''.mender'' suffix, can be used instead. This Artifact can either be deployed in managed mode with the Mender server (upload it under Releases in the server UI) or by using the Mender client [https://docs.mender.io/artifact-creation/standalone-deployment standalone mode].

@@ Line 50: / Line 50: @@
 == Building the image ==
-Everything was setup to proceed with building an image:
+You can now proceed with building an image:
 <syntaxhighlight lang="bash">
-MACHINE=imx8mq-voipac bitbake core-image-base
+build_image.sh
 </syntaxhighlight>
-Replace '''core-image-base''' with your desired image target.
+or if you want to use docker container for building run:
 == Using the build output ==

@@ Line 21: / Line 21: @@
 == Configuring the build ==
 === Setup Yocto environment ===
-Set the Yocto Project branch to build for:
+Clone repo:
 <syntaxhighlight lang="bash">
-export BRANCH="dunfell"
+git clone https://github.com/voipac/yocto-imx-voipac.git
 </syntaxhighlight>
-Create a directory for the mender-<TARGET> setup to work in and clone the meta information:
+Checkout mender branch:
 <syntaxhighlight lang="bash">
-mkdir mender-<TARGET> && cd mender-<TARGET>
+cd yocto-imx-voipac
-</syntaxhighlight>
+git checkout origin/imx93-mender
 </syntaxhighlight>

@@ Line 6: / Line 6: @@
 <div style="float:right">__TOC__</div>
-This Wiki page describes [https://hub.mender.io/t/voipac-imx8m-industrial-development-kit/5865 Mender OTA updater integration] into the Yocto Project for the iMX8M Industrial Development Kit. Mender is a secure, robust and industry leading software update system capable to handle a large number of devices.
+This Wiki page describes [https://hub.mender.io/t/voipac-imx93-industrial-development-kit/7316 Mender OTA updater integration] into the Yocto Project for the iMX93 Industrial Development Kit. Mender is a secure, robust and industry leading software update system capable to handle a large number of devices.
 Mender supports several extensions enabling features like Remote Terminal, Port Forward, File Transfer, and Device Configuration, together with the ability to monitor and alert.
@@ Line 13: / Line 13: @@
 == Prerequisites ==
-In-depth information about the machine requirements can be found in the [https://docs.yoctoproject.org/3.1/mega-manual/mega-manual.html Yocto mega manual], a forum thread concerning [https://hub.mender.io/t/google-repo/58 repo usage for Mender] integration can provide additional insight as well.
+In-depth information about the machine requirements can be found in the [https://docs.yoctoproject.org/5.0/mega-manual/mega-manual.html Yocto mega manual]
-Because the Mender utility will be integrated into the Yocto Project Release 3.1 (dunfell), the Mender layer share the same steps for host machine setup as the Yocto Project.
+Because the Mender utility will be integrated into the Yocto Project Release 5.0 (scarthgap), the Mender layer share the same steps for host machine setup as the Yocto Project.
-To prepare the machine, follow the [[iMX8M Industrial Yocto Prerequisites|Yocto Project Prerequisites]] Wiki page.
+To prepare the machine, follow the [[iMX93 Industrial Yocto Prerequisites|Yocto Project Prerequisites]] Wiki page.
 == Configuring the build ==

← Older revision		Revision as of 16:20, 4 February 2025
Line 1:		Line 1:
		+	[[Category:iMX93 Industrial]]
		+	[[Category:iMX93 Industrial Software]]
		+	[[Category:iMX93 Industrial Yocto]]
		+	[[Category:Yocto]]
		+	<!-- -->
		+	<div style="float:right">__TOC__</div>
		+
		+	This Wiki page describes [https://hub.mender.io/t/voipac-imx8m-industrial-development-kit/5865 Mender OTA updater integration] into the Yocto Project for the iMX8M Industrial Development Kit. Mender is a secure, robust and industry leading software update system capable to handle a large number of devices.
		+
		+	Mender supports several extensions enabling features like Remote Terminal, Port Forward, File Transfer, and Device Configuration, together with the ability to monitor and alert.
		+
		+	The steps described on this Wiki page are primarily focused on complying Mender updater into the Yocto Project. The well written [https://docs.mender.io/ official Mender documentation] covers all the other important aspects of this utility.
		+
		+	== Prerequisites ==
		+	In-depth information about the machine requirements can be found in the [https://docs.yoctoproject.org/3.1/mega-manual/mega-manual.html Yocto mega manual], a forum thread concerning [https://hub.mender.io/t/google-repo/58 repo usage for Mender] integration can provide additional insight as well.
		+
		+	Because the Mender utility will be integrated into the Yocto Project Release 3.1 (dunfell), the Mender layer share the same steps for host machine setup as the Yocto Project.
		+
		+	To prepare the machine, follow the [[iMX8M Industrial Yocto Prerequisites\|Yocto Project Prerequisites]] Wiki page.
		+
		+	== Configuring the build ==
		+	=== Setup Yocto environment ===
		+	Set the Yocto Project branch to build for:
		+	<syntaxhighlight lang="bash">
		+	export BRANCH="dunfell"
		+	</syntaxhighlight>
		+
		+	Create a directory for the mender-<TARGET> setup to work in and clone the meta information:
		+	<syntaxhighlight lang="bash">
		+	mkdir mender-<TARGET> && cd mender-<TARGET>
		+	</syntaxhighlight>
		+
		+	Initialize repo manifest:
		+	<syntaxhighlight lang="bash">
		+	repo init -u https://github.com/mendersoftware/meta-mender-community \
		+	-m meta-mender-<TARGET>/scripts/manifest-<TARGET>.xml \
		+	-b ${BRANCH}
		+	</syntaxhighlight>
		+
		+	Fetch layers in manifest:
		+	<syntaxhighlight lang="bash">
		+	repo sync
		+	</syntaxhighlight>
		+
		+	=== Setup build environment ===
		+	Initialize the build environment:
		+	<syntaxhighlight lang="bash">
		+	source setup-environment <TARGET>
		+	</syntaxhighlight>
		+
		+	'''''Note:''''' Accepting the Freescale EULA at ''…/sources/meta-freescale/EULA'' is required. Please read it and continue by accepting it in the ''local.conf'' file:
		+	<syntaxhighlight lang="bash">
		+	ACCEPT_FSL_EULA = "1"
		+	</syntaxhighlight>
		+
		+	== Configure Mender server URL (optional) ==
		+	This section is not required for a successful build but images that are generated by default are only suitable for usage with the Mender client in [https://docs.mender.io/artifact-creation/standalone-deployment?target=_blank Standalone deployments], due to lack of server configuration.
		+
		+	Edit the ''conf/local.conf'' file to provide the Mender server configuration, ensuring that the generated images and Mender Artifacts are connecting to the Mender server. There should already be a commented section in the generated ''conf/local.conf'' file. A simple uncommenting the relevant configuration and assigning appropriate values sets up the server sufficiently.
		+
		+	Build for Hosted Mender:
		+	<syntaxhighlight lang="bash">
		+	# To get your tenant token:
		+	# - log in to https://hosted.mender.io
		+	# - click your email at the top right and then "My organization"
		+	# - press the "COPY TO CLIPBOARD"
		+	# - assign content of clipboard to MENDER_TENANT_TOKEN
		+	#
		+	MENDER_SERVER_URL = "https://hosted.mender.io"
		+	MENDER_TENANT_TOKEN = "<copy token here>"
		+	</syntaxhighlight>
		+
		+	== Building the image ==
		+	Everything was setup to proceed with building an image:
		+	<syntaxhighlight lang="bash">
		+	MACHINE=imx8mq-voipac bitbake core-image-base
		+	</syntaxhighlight>
		+
		+	Replace '''core-image-base''' with your desired image target.
		+
		+	== Using the build output ==
		+	After a successful build, the images and build artifacts are placed in ''tmp/deploy/images/imq8mq-voipac/'' directory.
		+
		+	The disk image (with ''.sdimg.bz2'' suffix) is used to provision the storage for devices without Mender already running. Please proceed to the [https://docs.mender.io/system-updates-yocto-project/provisioning-a-new-device?target=_blank official documentation on provisioning a new device] for steps to do so.
		+
		+	On the other hand, if Mender has already been running on the device and want to deploy a rootfs update using this build, the [https://docs.mender.io/overview/artifact?target=_blank Mender Artifact] files, with ''.mender'' suffix, can be used instead. This Artifact can either be deployed in managed mode with the Mender server (upload it under Releases in the server UI) or by using the Mender client [https://docs.mender.io/artifact-creation/standalone-deployment standalone mode].
		+
		+	== Flashing instructions ==
		+	Follow the [[iMX8M Industrial Flashing Procedure\|flashing procedure]] instructions for image flashing.
		+
		+
	For building and installation instruction please follow [https://hub.mender.io/t/voipac-imx93-industrial-development-kit/7316 topic] how to build and flash mender OTA to iMX93 industrial development kit.		For building and installation instruction please follow [https://hub.mender.io/t/voipac-imx93-industrial-development-kit/7316 topic] how to build and flash mender OTA to iMX93 industrial development kit.