Phytec L-1017e.A3 i.MX 8M Plus Manuale utente

A Product of PHYTEC Technology Holding Company

L-1017e.A3 i.MX 8M Plus BSP Manual



L-1017e.A3 i.MX 8M Plus BSP Manual

L-1017e.A3 i.MX 8M Plus BSP Manual

Document Title L-1017e.A3 i.MX 8M Plus BSP Manual

Document Type BSP Manual

Article Number L-1017e.A3

Yocto Manual L-813e.A12 Yocto Reference Manual (hardknott)

Release Date 09.12.2022

Is Branch of L-1017e.Ax i.MX 8M Plus BSP Manual Head

This BSP manual guides you through the installation and creation steps for the Board Support Package (BSP) and

describes how to handle the interfaces for thephyCORE-i.MX8M Plus Kit. Furthermore, this document describes

how to create BSP images from the source code. This is useful for those who need to change the default image and

need a way to implement these changes in a simple and reproducible way.

The table below shows the Compatible BSPs for this manual:

Compatible BSP'S BSP Release Type BSP Release Date BSP Status

BSP-Yocto-NXP-i.MX8MP-

PD22.1.0

Major 09.12.2022 Released

Note

This document contains code examples that describe the communication with the board over the serial

shell.The code examples lines begin with "host$", "target$" or "u-boot=>". This describes where the

commands are to be executed. Only after these keywords must the actual command be copied.



L-1017e.A3 i.MX 8M Plus BSP Manual

•

PHYTEC Documentation

PHYTEC provides a variety of hardware and software documentation for all of our products. This includes any or all

of the following:

QS Guide: A short guide on how to set up and boot a phyCORE board along with brief information on

building a BSP, the device tree, and accessing peripherals.

Hardware Manual: A detailed description of the System on Module and accompanying carrier board.

Yocto Guide: A comprehensive guide for the Yocto version the phyCORE uses. This guide contains an

overview of Yocto; introducing, installing, and customizing the PHYTEC BSP; how to work with programs like

Poky and Bitbake; and much more.

BSP Manual: A manual specific to the BSP version of the phyCORE. Information such as how to build the

BSP, booting, updating software, device tree, and accessing peripherals can be found here.

Development Environment Guide: This guide shows how to work with the Virtual Machine (VM) Host

PHYTEC has developed and prepared to run various Development Environments. There are detailed step-by-

step instructions for Eclipse and Qt Creator, which are included in the VM. There are instructions for running

demo projects for these programs on a phyCORE product as well. Information on how to build a Linux host

PC yourself is also a part of this guide.

Pin Muxing Table: phyCORE SOMs have an accompanying pin table (in Excel format). This table will show

the complete default signal path, from processor to carrier board. The default device tree muxing option will

also be included. This gives a developer all the information needed in one location to make muxing changes

and design options when developing a specialized carrier board or adapting a PHYTEC phyCORE SOM to an

application.

On top of these standard manuals and guides, PHYTEC will also provide Product Change Notifications, Application

Notes, and Technical Notes. These will be done on a case-by-case basis. Most of the documentation can be found in

the download page of our product: https://www.phytec.de/produkte/system-on-modules/phycore-imx-8m-plus/

#downloads/

L-1017e.A3 i.MX 8M Plus BSP Manual

Supported Hardware

The phyBOARD-Pollux with 2GB RAM is supported.

On our web page, you can see all supported Machines with the available Article Numbers forthis release:BSP-

Yocto-NXP-i.MX8MP-PD22.1.0 download.

If you choose a specificMachine Namein the sectionSupported Machines, you can see whichArticle

Numbersare available under this machine and also a short description of the hardware information.In case you

only have theArticle Numberof your hardware, you can leave theMachine Namedrop-down menu empty and

only choose yourArticle Number. Now it should show you the necessaryMachine Namefor your specific

hardware.

phyBOARD-Pollux Components

1 phyBOARD-Pollux Components (top)

2 phyBOARD-Pollux Components (bottom)

L-1017e.A3 i.MX 8M Plus BSP Manual

•

Getting Started

The phyBOARD-Pollux Kits are shipped with a pre-flashed SD-Card. It contains the phytec-qt5demo-image and can

be used directly as a boot source. The eMMC is programmed with only a U-boot as default. You can get all the

sources from our download server.This chapter explains how to flash a BSP image to SD Card and how to start the

board.

Get the Image

The *.sdcard image contains all BSP files in several, correctly pre-formatted partitions and can be copied to the SD

card easily using the single Linux command dd. It can be built byYyoctoor downloaded from our download server.

Get the*.sdcardfile from our download server:

host$ wget https://download.phytec.de/Software/Linux/BSP-Yocto-i.MX8MP/BSP-Yocto-NXP-

i.MX8MP-PD22.1.0/images/ampliphy-vendor-xwayland/phyboard-pollux-imx8mp-3/phytec-

qt5demo-image-phyboard-pollux-imx8mp-3.sdcard

Write the Image to the SD Card

To create your bootable SD card, you must first find out the correct device name of your SD card and possible

partitions. Then unmount the partitions before you start copying the image to the SD card.

In order to get the correct device name, first remove your SD card and executels /dev.

Now insert your SD card and executels /devagain.

Compare the two outputs to find the new device name(s) listed in the second output. These are the device

names of the SD card (device and partitions if the SD card is formatted).

In order to verify the device names found, execute the commanddmesg. Within the last lines of its output,

you should also find the device names, for example,sde(depending on your system).

Now that you have the device name/dev/<your_device>(e.g./dev/sde), you can see the partitions which must be

unmounted if the SD card is formatted. In this case, you will also find/dev/<your_device>with an appended number

(e.g./dev/sde1) in the output. These represent the partition(s) that need to be unmounted.

Unmount all partitions:

host$ umount /dev/<your_device><number>

After having unmounted all devices with an appended number (<your_device><number>), you can create

your bootable SD card:

Warning

To create your bootable SD card with theddcommand, you must have root privileges. Because of this, you

must be very careful when selecting the destination device for theddcommand! All files on the selected

destination device will be erased immediately without any further query! Consequently, having selected

the wrong device can also erase your hard drive!



L-1017e.A3 i.MX 8M Plus BSP Manual

•

host$ sudo dd if=<IMAGENAME>-<MACHINE>.sdcard of=/dev/<your_device> bs=1M conv=fsync

status=progress

Using the device name (<your_device>) without appended number (e.g.sde) which stands for the whole device.The

parameterconv=fsyncforces a sync operation on the device beforeddreturns. This ensures that all blocks are

written to the SD card and are not still in memory.The parameterstatus=progresswill print out information on how

much data is and still has to be copied until it is finished.

<BUILD-TIME>has the format:YYYYMMDDHHMMSS

example:

Date = 14.01.2022

Time = 10:42:11

<BUILD-TIME> = 20220114104211

First Start-up

To boot from an SD card, the bootmode switch (S3) needs to be set to the following position:

3 SD Card Bootmode

Insert the SD card

Connect the target and the host with micro USB on X1 debug USB

Power up the board

Note

The created file phytec-qt5demo-image-phyboard-pollux-imx8mp-3.sdcard is only a link to a file like phytec-

qt5demo-image-phyboard-pollux-imx8mp-3-<BUILD-TIME>.rootfs.sdcard.



L-1017e.A3 i.MX 8M Plus BSP Manual

•

Building the BSP

This section will guide you through the general build process of the i.MX 8M PlusBSP using Yocto and the phyLinux

script. For more information about our meta-layer or Yocto in general visit: L-813e.A12 Yocto Reference Manual

(hardknott).

Basic Set-Up

If you have never created a Phytec BSP with Yocto on your computer, you should take a closer look at the chapter

BSP Workspace Installation in the L-813e.A12 Yocto Reference Manual (hardknott).

Get the BSP

There are two ways to get the BSP sources. You can download the complete BSP sources from our download page:

BSP-Yocto-i.MX8MP; or you can build it yourself with Yocto. This is particularly useful if you want to make

customizations.

The phyLinux script is a basic management tool for PHYTEC Yocto BSP releases written in Python. It is mainly a

helper to get started with the BSP structure.

Create a fresh project folder, get phyLinux, and make the script executable:

host$ mkdir ~/yocto

host$ cd yocto/

host$ wget https://download.phytec.de/Software/Linux/Yocto/Tools/phyLinux

host$ chmod +x phyLinux

Run phyLinux

host$ ./phyLinux init

During the execution of theinitcommand, you need to choose your processor platform (SoC), PHYTEC's BSP

release number, and the hardware you are working on.

Warning

A clean folder is important because phyLinux will clean its working directory.Calling phyLinux from a

directory that isn't empty will result in awarning.



Note

On the first initialization, the phyLinux script will ask you to install theRepotool in your/usr/local/

bindirectory.



Note



L-1017e.A3 i.MX 8M Plus BSP Manual

•

It is also possible to pass this information directly using command line parameters:

host$ DISTRO=ampliphy-vendor-xwayland MACHINE=phyboard-pollux-imx8mp-3./phyLinux

init -p imx8mp -r PD-BSP-Yocto-NXP-i.MX8MP-PD22.1.0

After the execution of theinitcommand, phyLinux will print a few important notes as well as information for the

next steps in the build process.

Starting the Build Process

Set up the shell environment variables:

host$ source sources/poky/oe-init-build-env

The current working directory of the shell should change tobuild/.

Open the main configuration file and accept the GPU and VPU binary license agreements. You have to

uncomment the corresponding line.

host$ vim conf/local.conf

# Uncomment to accept NXP EULA

# EULA can be found under ../sources/meta-freescale/EULA

ACCEPT_FSL_EULA = "1"

Build your image:

host$ bitbake phytec-headless-image

BSP Images

All images generated byBitbakeare deployed to~/yocto_imx8mp/build/deploy/images/<machine>. The following

list shows for example all files generated for the i.MX 8M Plus phyboard-pollux-imx8mp-*machine:

If you cannot identify your board with the information given in the selector, have a look at the invoice for

the product. And have look at https://www.phytec.de/bsp-download/?bsp=BSP-Yocto-NXP-i.MX8MP-

PD22.1.0

Note

This needs to be done every time you open a new shell for starting builds.



Note

We suggest starting with our smaller non-graphical imagephytec-headless-imageto see if everything is

working correctly. The first compile process takes about 40 minutes on a modern Intel Core i7. All

subsequent builds will use the filled caches and should take about 3 minutes.



L-1017e.A3 i.MX 8M Plus BSP Manual

•

u-boot.bin: Binary compiled U-boot bootloader (U-Boot). Not the final Bootloader image!

oftree: Default kernel device tree

u-boot-spl.bin: Secondary program loader (SPL)

imx-boot-tools/bl31-imx8mp.bin: ARM Trusted Firmware binary

lpddr4_pmu_train_2d_dmem_202006.bin, lpddr4_pmu_train_2d_imem_202006.bin:DDR PHY firmware

images

imx-boot: Bootloader build by imx-mkimage which includes SPL, U-Boot, ARM Trusted Firmware and DDR

firmware. This is the final bootloader image which is bootable.

Image: Linux kernel image

Image.config: Kernel configuration

imx8mp-phyboard-pollux-rdk*.dtb: Kernel device tree file

imx8mp-phy*.dtbo: Kernel device tree overlay files

phytec-qt5demo-image*.tar.gz: Root file system

phytec-qt5demo-image*.sdcard: SD card image

L-1017e.A3 i.MX 8M Plus BSP Manual

Installing the OS

Bootmode Switch (S3)

The phyBOARD‑Pollux features a boot switch with four individually switchable ports to select the phyCORE-i.MX 8M

Plus default bootsource.

1 Boot Configuration Options (S3)

eMMC Internal Fuses

SPI NOR USB Serial Download

Tip

Hardware revision baseboard: 1552.2



Indice

Altri manuali Phytec Hardware per computer

Phytec

Phytec phyCORE-LPC3250 Manuale utente

Phytec

Phytec phyCORE-MPC5676/57 Series Manuale utente

Phytec

Phytec phyCORE-i.MX 8M Plus Manuale utente

Phytec

Phytec phyCORE-PXAG49 Manuale di programmazione

Phytec

Phytec phyCORE-i.MX RT1170 Manuale utente

Phytec

Phytec L-863e.A2 phyCORE-i.MX 8M Manuale utente

Phytec

Phytec L-808e.A4 Manuale utente

Phytec

Phytec PCAN-Dongle PK-001 Manuale di programmazione

Phytec

Phytec KEIL nanoMODUL-STM32F103 Manuale di programmazione

Phytec

Phytec L-1009e.A2 phyCORE-i.MX 8M Plus Manuale utente

Phytec

Phytec phyCORE-i.MX 8M Mini Manuale utente

Phytec

Phytec phyCORE-PXA270 Manuale di programmazione

Phytec

Phytec phyCORE-DS80C390 Manuale di programmazione

Phytec

Phytec Cosmic-AM335 Series Manuale utente

Phytec

Phytec phyCORE-i.MX 8M Mini Manuale utente

Phytec

Phytec IoT-Enablement-Kit 4 Manuale utente

Phytec

Phytec i.MX7 PEB-D-RPI Manuale utente

Phytec

Phytec phyCORE-LPC3180 Manuale di programmazione

Phytec

Phytec phyCORE-MPC5554 Manuale utente

Phytec

Phytec phyCORE MPC5676 Series Manuale utente

Phytec

Phytec microMODUL-8051 Manuale utente

Phytec

Phytec phyFLEX-i.MX 6 Manuale utente

Phytec

Phytec phyCORE-i.MX 8M Mini Manuale utente

Phytec

Phytec L-820e.A2 Manuale utente

Manuali Hardware per computer popolari di altre marche

EMC2

EMC2 VNX Series Manuale del proprietario

Panasonic

Panasonic DV0PM20105 Manuale utente

Mitsubishi Electric

Mitsubishi Electric Q81BD-J61BT11 Manuale utente

Gigabyte

Gigabyte B660M DS3H AX DDR4 Manuale utente

Raidon

Raidon iT2300 Manuale utente

National Instruments

National Instruments PXI-8186 Manuale utente

Hauppauge

Hauppauge WinTV-HVR-2250 Manuale utente

Kontron

Kontron CP6002 Manuale utente

Manhattan

Manhattan 702843 Manuale utente

Aphex

Aphex 230 Manuale utente

AMD

AMD Phenom II Manuale operativo

Intel

Intel NUC 12 Pro Manuale utente

dbx

dbx Zone Pro 1260 Manuale utente

Galaxy

Galaxy GHDX2-2430S-24F4D Manuale utente

Intel

Intel AXXRMFBU4 Manuale utente

Kontron

Kontron DIMM-PC/MD Manuale utente

ST X-NUCLEO-SAFEA1B Istruzioni operative

STEINWAY LYNGDORF

STEINWAY LYNGDORF SP-1 Manuale utente