i.MX Linux® User's Guide - NXP

1 linux User's GuideNXP SemiconductorsDocument identifier: IMXLUGUser GuideRev. , 31 March 2022 ContentsChapter 1 Supported hardware SoCs and 2 3 Basic Terminal 4 Booting linux Software linux kernel image and device Root file Universal update Downloading Using Preparing an SD/MMC card to Preparing the Copying the full SD card Partitioning the SD/MMC Copying a bootloader Copying the kernel image and DTB Copying the root file system (rootfs).. Downloading images .. Downloading images using Flashing an Arm Cortex-M4 image on QuadSPI .. Downloading an image to Using Flashing U-Boot on SPI-NOR from Flashing U-Boot on Parallel NOR from Using an board as the host server to create a How to boot the Booting from an SD card in slot Booting from an SD card in slot Booting from an SD card in slot Booting from an SD card in slot Booting from Booting from Booting from Booting from Booting from EIM (Parallel) NOR.

2 Booting from QuadSPI or Serial download mode for the Manufacturing How to build U-Boot and Kernel in standalone How to build imx-boot image by using Flash memory linux User's Guide , Rev. , 31 March 2022 user Guide2 / MMC/SD/SATA memory NAND flash memory Parallel NOR flash memory SPI-NOR flash memory QuadSPI flash memory Running linux OS on the Running the image from NAND .. Running linux OS from Parallel Running the linux OS image from QuadSPI .. Running the Arm Cortex-M4 linux OS Running linux OS from Running the linux image from Arm Arm SystemReady-IR ACS compliance Capsule linux distro 5 Enabling Solo 6 Power Suspend and CPU frequency Bus frequency 7 multimedia Building limited access Multimedia use Playback use Audio-only Video-only Audio/Video file Multichannel audio Other methods for Video playback to multiple Audio Video Audio Video Audio/Video Camera Recording the TV-in Web HTTP HTTP live MPEG-DASH Real Time Streaming Protocol (RTSP) RTP/UDP MPEGTS RTSP streaming Video conversion.

3 65 NXP linux User's Guide , Rev. , 31 March 2022 user Guide3 / Video PulseAudio input/output Installing into 8 DSP HiFi 4 DSP Sound Open HDMI eARC 9 Qt 10 CAAM kernel Source Module Kernel How to test the Crypto algorithms CAAM Job Ring backend driver Verifying driver operation and Incrementing IRQs in / Verifying the 'self test' fields say 'passed' in / OpenSSL OpenSSL software OpenSSL's ENGINE NXP solution for OpenSSL hardware Deploying OpenSSL into Running OpenSSL benchmarking tests with cryptodev Running OpenSSL benchmarking tests for symmetric ciphering and Running OpenSSL benchmarking tests with AF_ALG Running OpenSSL benchmarking tests for symmetric ciphering and Disk encryption Enabling disk encryption support in user space tools for disk DM-Crypt using CAAM's tagged crypto_af_alg application Building the Kernel

4 Building a Cross compiling the user space Use case Kernel TLS linux User's Guide , Rev. , 31 March 2022 user Guide4 / Running Kernel TLS 11 Connectivity for Bluetooth wireless technology and Wi-Fi .. Connectivity for USB NXP Bluetooth/Wi-Fi WFA Bluetooth controller 12 DDR Performance Frequently used Showing supported Examples for monitoring Performance Showing supported Monitoring DDR Performance usage 13 One-Time Programmable Controller Driver Using NVMEM NVMEM provider NVMEM Examples to read/write the raw NVMEM file in user 14 NXP eIQ Machine 15 Revision A Murata Wi-Fi/Bluetooth linux User's Guide , Rev. , 31 March 2022 user Guide5 / 115 Chapter 1 OverviewThis document describes how to build and install the linux OS BSP, where BSP stands for Board Support Package, on the platform. It also covers special features and how to use document also provides the steps to run the platform, including board DIP switch settings, and instructions on configuring and using the U-Boot later chapters describe how to use some special features when running the linux OS covered in this Guide may be specific to particular boards or SoCs.

5 For the capabilities of a particular board or SoC, see the linux Release Notes (IMXLXRN). document is intended for software, hardware, and system engineers who are planning to use the product, and for anyone who wants to know more about the document uses the following conventions: Courier New font: This font is used to identify commands, explicit command parameters, code examples, expressions, data types, and hardware SoCs and boardsThese are the systems covered in this Guide : 6 Quad SABRE-SD board and platform 6 DualLite SABRE-SD platform 6 SoloX SABRE-SD platform 7 Dual SABRE-SD platform 6 QuadPlus SABRE-SD platform 6 UltraLite EVK platform 6 ULL EVK platform 6 ULZ EVK platform 7 ULP EVK platform 8 QuadMax MEK board 8 QuadXPlus MEK platform 8 DXL EVK Platform 8M Quad EVK platform 8M Mini EVK Board 8M Nano EVK Board 8M Plus EVK board 8 DualX MEK Board 8 ULP EVK BoardNXP linux User's Guide , Rev.

6 , 31 March 2022 user Guide6 / 115 Some abbreviations are used in places in this document. SABRE-SD refers to the 6 Quad SABRE-SD, 6 DualLite SABRE-SD, 6 QuadPlus SABRE-SD, and 7 Dual SABRE-SD boards. SoloX or SX refers to the 6 SoloX SABRE-SD boards. 6UL refers to the 6 UltraLite board. 6 ULL refers to the 6 ULL board. 6 ULZ refers to the 6 ULZ board. 7 ULP refers to the 7 Ultra Low Power platform. 8 QXP refers to the 8 QuadXPlus platform. 8QM refers to the 8 QuadMax platform. 8MQ refers to the 8M Quad platform. 8MM refers to the 8M Mini platform. 8MN refers to the 8M Nano platform. 8MP refers to the 8M Plus platform. 8 DXL refers to the 8 DualXLite platform. 8DX refers to the 8 DualX platform. 8 ULP refers to the 8 Ultra Low Power has multiple families supported in software. The following are the listed families and SoCs per family. The linux Release Notes describes which SoC is supported in the current release.

7 Some previously released SoCs might be buildable in the current release but not validated if they are at the previous validated level. 6 Family: 6 QuadPlus, 6 Quad, 6 DualLite, 6 SoloX, 6 SLL, 6 UltraLite, 6 ULL, 6 ULZ 7 Family: 7 Dual, 7 ULP 8 Family: 8 QuadMax, 8 ULP 8M Family: 8M Plus, 8M Quad, 8M Mini, 8M Nano 8X Family: 8 QuadXPlus, 8 DXL, 8 DualXThis release includes the following references and additional information. linux Release Notes (IMXLXRN) - Provides the release information. linux User's Guide (IMXLUG) - Provides the information on installing U-Boot and linux OS and using features. Yocto Project User's Guide (IMXLXYOCTOUG) - Describes the board support package for NXP development systems using Yocto Project to set up host, install tool chain, and build source code to create images. Machine Learning User's Guide (IMXMLUG) - Provides the machine learning information.

8 linux Reference Manual (IMXLXRM) - Provides the information on linux drivers for Graphics User's Guide (IMXGRAPHICUG) - Describes the graphics features. Porting Guide (IMXXBSPPG) - Provides the instructions on porting the BSP to a new board. VPU Application Programming Interface linux Reference Manual (IMXVPUAPI) - Provides the reference information on the VPU API on 6 VPU. Harpoon User's Guide (IMXHPUG) - Presents the Harpoon release for 8M device linux User's Guide , Rev. , 31 March 2022 user Guide7 / 115 Digital Cockpit Hardware Partitioning Enablement for 8 QuadMax (IMXDCHPE) - Provides the Digital Cockpit hardware solution for 8 QuadMax. DSP User's Guide (IMXDSPUG) - Provides the information on the DSP for 8. 8M Plus Camera and Display Guide (IMX8 MPCDUG) - Provides the information on the ISP Independent Sensor Interface API for the 8M quick start guides contain basic information on the board and setting it up.

9 They are on the NXP website. SABRE Platform Quick Start Guide (IMX6 QSDPQSG) SABRE Board Quick Start Guide (IMX6 QSDBQSG) 6 UltraLite EVK Quick Start Guide (IMX6 ULTRALITEQSG) 6 ULL EVK Quick Start Guide (IMX6 ULLQSG) SABRE Automotive Infotainment Quick Start Guide (IMX6 SABREINFOQSG) 7 Dual SABRE-SD Quick Start Guide (SABRESDBIMX7 DUALQSG) 8M Quad Evaluation Kit Quick Start Guide (IMX8 MQUADEVKQSG) 8M Mini Evaluation Kit Quick Start Guide (8 MMINIEVKQSG) 8M Nano Evaluation Kit Quick Start Guide (8 MNANOEVKQSG) 8 QuadXPlus Multisensory Enablement Kit Quick Start Guide (IMX8 QUADXPLUSQSG) 8 QuadMax Multisensory Enablement Kit Quick Start Guide (IMX8 QUADMAXQSG) 8M Plus Evaluation Kit Quick Start Guide (IMX8 MPLUSQSG)Documentation is available online at 6 information is at SABRE information is at 6 UltraLite information is at 6 ULL information is at 7 Dual information is at 7 ULP information is at 8 information is at 6 ULZ information is at linux User's Guide , Rev.

10 , 31 March 2022 user Guide8 / 115 Chapter 2 IntroductionThe linux BSP is a collection of binary files, source code, and support files that can be used to create a U-Boot bootloader, a linux kernel image, and a root file system for development systems. The Yocto Project is the framework of choice to build the images described in this document, although other methods can be the information on how to set up the linux OS host, how to run and configure a Yocto Project, generate an image, and generate a rootfs, are covered in the Yocto Project User's Guide (IMXLXYOCTOUG).When linux OS is running, this Guide provides information on how to use some special features that SoCs provide. The release notes provide the features that are supported on a particular linux User's Guide , Rev. , 31 March 2022 user Guide9 / 115 Chapter 3 Basic Terminal SetupThe boards can communicate with a host server (Windows OS or linux OS) using a serial cable.