3. Foundational Components

• 3.1. U-Boot
  • 3.1.1. User’s Guide
    • 3.1.1.1. General Information
      • 3.1.1.1.1. Getting the U-Boot Source Code
      • 3.1.1.1.2. Build U-Boot
      • 3.1.1.1.3. Image Formats
      • 3.1.1.1.4. Boot Flow
      • 3.1.1.1.5. U-Boot Environment
      • 3.1.1.1.6. Available RAM for image download
      • 3.1.1.1.7. Device Trees
      • 3.1.1.1.8. SRAM memory Layout during R5 SPL bootloader stage
    • 3.1.1.2. USB Device Firmware Upgrade (DFU)
      • 3.1.1.2.1. USB Peripheral boot mode (SPL-DFU support)
    • 3.1.1.3. SD, eMMC and USB
      • 3.1.1.3.1. Partitioning eMMC from U-Boot
      • 3.1.1.3.2. Updating an SD card from a host PC
      • 3.1.1.3.3. Updating an SD card or eMMC using DFU
      • 3.1.1.3.4. Booting Linux from SD card or eMMC
      • 3.1.1.3.5. Booting tiboot3.bin, tispl.bin and u-boot.img from eMMC boot partition (For K3 class of SoCs)
      • 3.1.1.3.6. Booting to U-Boot prompt from USB storage
      • 3.1.1.3.7. Booting Linux from USB storage
      • 3.1.1.3.8. Steps for working around SD card issues
    • 3.1.1.4. SPI
      • 3.1.1.4.1. Writing to SPI from U-Boot
      • 3.1.1.4.2. Booting from SPI
    • 3.1.1.5. OSPI/QSPI
    • 3.1.1.6. UART
      • 3.1.1.6.1. Booting U-Boot from the console UART
    • 3.1.1.7. DDRSS ECC
      • 3.1.1.7.1. Overview
        • 3.1.1.7.1.1. DDRSS ECC handling
    • 3.1.1.8. RemoteProc
      • 3.1.1.8.1. Initialization
      • 3.1.1.8.2. Loading
      • 3.1.1.8.3. Starting
      • 3.1.1.8.4. Stop
      • 3.1.1.8.5. Lockstep and Split mode
      • 3.1.1.8.6. HS Devices
    • 3.1.1.9. U-Boot Splash Screen
      • 3.1.1.9.1. Features supported
        • 3.1.1.9.1.1. Enabling the splash screen on ti-u-boot
        • 3.1.1.9.1.2. Display custom logo as splash screen
        • 3.1.1.9.1.3. Enabling splash screen on custom board based on AM62Px SoC
        • 3.1.1.9.1.4. Display image using U-Boot command line
        • 3.1.1.9.1.5. Run splash screen using OSPI NOR
        • 3.1.1.9.1.6. Display RLE compressed image
        • 3.1.1.9.1.7. Flicker free display across boot stages and Linux Kernel
        • 3.1.1.9.1.8. Flicker free and persistent display until display server
  • 3.1.2. Troubleshooting
    • 3.1.2.1. Debugging SPL in CCS
      • 3.1.2.1.1. Step 1: Downloading CCS
      • 3.1.2.1.2. Step 2: Creating a Target Configuration File
      • 3.1.2.1.3. Step 3: Loading Symbol files
    • 3.1.2.2. Debugging SPL in OpenOCD
• 3.2. Kernel
  • 3.2.1. Users Guide
    • 3.2.1.1. Overview
    • 3.2.1.2. Getting the Kernel Source Code
    • 3.2.1.3. Preparing to Build
      • 3.2.1.3.1. Compiler
      • 3.2.1.3.2. Cleaning the Kernel Sources
    • 3.2.1.4. Configuring the Kernel
      • 3.2.1.4.1. Using Default Configurations
      • 3.2.1.4.2. Customizing the Configuration
    • 3.2.1.5. Compiling the Sources
      • 3.2.1.5.1. Compiling the Kernel
      • 3.2.1.5.2. Compiling the Device Tree Binaries
      • 3.2.1.5.3. Compiling the Kernel Modules
    • 3.2.1.6. Creating the kernel fitImage for high security device / GP devices
      • 3.2.1.6.1. Describing FIT source
      • 3.2.1.6.2. Generating the fitImage
      • 3.2.1.6.3. Build uboot again
    • 3.2.1.7. Installing the Kernel
      • 3.2.1.7.1. Installing the Kernel Image and Device Tree Binaries
      • 3.2.1.7.2. Installing the Kernel Modules
  • 3.2.2. Kernel Drivers
    • 3.2.2.1. Audio
      • 3.2.2.1.1. Introduction
      • 3.2.2.1.2. Software Architecture
      • 3.2.2.1.3. Generic commands and instructions
      • 3.2.2.1.4. Board-specific instructions
      • 3.2.2.1.5. Potential issues
      • 3.2.2.1.6. Additional Information
    • 3.2.2.2. CSI2RX
      • 3.2.2.2.1. Introduction
      • 3.2.2.2.2. Hardware Architecture
      • 3.2.2.2.3. Driver Architecture
        • 3.2.2.2.3.1. The Media Controller API
        • 3.2.2.2.3.2. Utilities to interact with the driver
        • 3.2.2.2.3.3. Building the driver
      • 3.2.2.2.4. Creating device tree nodes for sensor
      • 3.2.2.2.5. Enabling camera sensors
    • 3.2.2.3. Crypto
    • 3.2.2.4. MCAN
    • 3.2.2.5. MCRC64
    • 3.2.2.6. DSS
      • 3.2.2.6.1. Introduction
      • 3.2.2.6.2. Supported Devices
      • 3.2.2.6.3. Hardware Architecture
        • 3.2.2.6.3.1. Display Controller (DISPC)
        • 3.2.2.6.3.2. SoC Hardware Description
        • 3.2.2.6.3.3. Supported Features
      • 3.2.2.6.4. Driver Architecture
        • 3.2.2.6.4.1. Driver Features
      • 3.2.2.6.5. Driver Configuration
        • 3.2.2.6.5.1. Kernel Configuration Options
        • 3.2.2.6.5.2. Device Tree Node
      • 3.2.2.6.6. Driver Usage
        • 3.2.2.6.6.1. Loading tidss
        • 3.2.2.6.6.2. Using tidss
        • 3.2.2.6.6.3. Testing tidss
        • 3.2.2.6.6.4. tidss properties
        • 3.2.2.6.6.5. Buffers
        • 3.2.2.6.6.6. fbdev emulation (/dev/fb0)
    • 3.2.2.7. EQEP
    • 3.2.2.8. GPIO
    • 3.2.2.9. I2C
    • 3.2.2.10. CPSW Ethernet
      • 3.2.2.10.1. Introduction
      • 3.2.2.10.2. Instances of the CPSW Subsystem
      • 3.2.2.10.3. TSN Documentation and Testing
    • 3.2.2.11. NETCONF/YANG
      • 3.2.2.11.1. Introduction
      • 3.2.2.11.2. Installation on Remote Machine
      • 3.2.2.11.3. Generic Execution
      • 3.2.2.11.4. Installing new YANG models
        • 3.2.2.11.4.1. Setup
    • 3.2.2.12. PWM
    • 3.2.2.13. OSPI/QSPI NOR/NAND
    • 3.2.2.14. SPI
    • 3.2.2.15. NAND
    • 3.2.2.16. MMC/SD
      • 3.2.2.16.1. Introduction
      • 3.2.2.16.2. References
      • 3.2.2.16.3. Acronyms & Definitions
      • 3.2.2.16.4. Features
      • 3.2.2.16.5. Supported High Speed Modes
      • 3.2.2.16.6. Driver Configuration
      • 3.2.2.16.7. Steps for working around SD card issues
    • 3.2.2.17. UART
      • 3.2.2.17.1. Introduction
      • 3.2.2.17.2. Driver Features
      • 3.2.2.17.3. Basic External loopback testing
    • 3.2.2.18. USB
      • 3.2.2.18.1. Introduction
      • 3.2.2.18.2. TI SoC Integration
      • 3.2.2.18.3. Starter Kit (SK)
    • 3.2.2.19. Voltage & Thermal Management (VTM)
      • 3.2.2.19.1. Introduction
      • 3.2.2.19.2. Driver Features
      • 3.2.2.19.3. Finding More Information
    • 3.2.2.20. Watchdog
      • 3.2.2.20.1. Driver Configuration
        • 3.2.2.20.1.1. How to change timeout as kernel module parameter
        • 3.2.2.20.1.2. How to change timeout using DT property
      • 3.2.2.20.2. Kernel Configuration
      • 3.2.2.20.3. Driver Usage
  • 3.2.3. LTP-DDT Validation
  • 3.2.4. FAQs
• 3.3. Power Management
  • 3.3.1. Power Management Overview
  • 3.3.2. DFS
  • 3.3.3. CPUIdle
  • 3.3.4. Runtime PM
  • 3.3.5. Low Power Modes
    • 3.3.5.1. Overview
    • 3.3.5.2. Deep Sleep
    • 3.3.5.3. MCU Only
    • 3.3.5.4. Partial I/O
    • 3.3.5.5. Limitations
      • 3.3.5.5.1. Compatibility
  • 3.3.6. Wakeup Sources
    • 3.3.6.1. Real-Time Clock (RTC)
    • 3.3.6.2. MCU GPIO
    • 3.3.6.3. Main I/O Daisy Chain
      • 3.3.6.3.1. Main UART
      • 3.3.6.3.2. Main GPIO
    • 3.3.6.4. WKUP UART
    • 3.3.6.5. USB Wakeup methods
      • 3.3.6.5.1. Host Mode Wakeup Events
        • 3.3.6.5.1.1. Wakeup via a device connect event
        • 3.3.6.5.1.2. Wakeup via a device disconnect event
        • 3.3.6.5.1.3. Via Remote wakeup event
      • 3.3.6.5.2. Device Mode Wakeup Events
        • 3.3.6.5.2.1. Wakeup via connect event
    • 3.3.6.6. MCU IPC based Wakeup
    • 3.3.6.7. Confirming the Wakeup event type
  • 3.3.7. S/W Architecture of System Suspend
    • 3.3.7.1. Overview
    • 3.3.7.2. System diagram and components
      • 3.3.7.2.1. Deep Sleep Entry
      • 3.3.7.2.2. Deep Sleep Exit
    • 3.3.7.3. LPM constraints framework
      • 3.3.7.3.1. Types of Constraints
      • 3.3.7.3.2. How to set constraints
        • 3.3.7.3.2.1. Device Constraint
        • 3.3.7.3.2.2. Resume Latency Constraint
      • 3.3.7.3.3. Constraints and mode selection explained
    • 3.3.7.4. Learning Resources
  • 3.3.8. Debug Information
    • 3.3.8.1. Low Power Modes
      • 3.3.8.1.1. Decoding set constraint debug messages
• 3.4. Security
  • 3.4.1. GP to HS-FS Migration Guide
    • 3.4.1.1. Overview
    • 3.4.1.2. Device types
    • 3.4.1.3. Processor SDK
    • 3.4.1.4. K3-image-gen
    • 3.4.1.5. U-Boot
    • 3.4.1.6. Linux Kernel
• 3.5. Filesystem
• 3.6. Tools
  • 3.6.1. Development Tools
    • 3.6.1.1. Processor SDK Linux Top-Level Makefile
    • 3.6.1.2. Processor SDK Linux GCC Toolchain
    • 3.6.1.3. Creating SD Cards
    • 3.6.1.4. Processor SDK Linux Setup Script
  • 3.6.2. Pin Mux Tools
  • 3.6.3. Flash via USB Device Firmware Upgrade (DFU)
    • 3.6.3.1. Get Tool
      • 3.6.3.1.1. SDK installer
      • 3.6.3.1.2. Clone repository
    • 3.6.3.2. Important files
    • 3.6.3.3. Requirements
      • 3.6.3.3.1. For Ubuntu
      • 3.6.3.3.2. For Windows
    • 3.6.3.4. Flow of flashing
    • 3.6.3.5. Building bootloader binaries for flashing and DFU boot
    • 3.6.3.6. Connections
    • 3.6.3.7. Preparing the Flash Configuration file
    • 3.6.3.8. Flashing the files
      • 3.6.3.8.1. Flash to eMMC
      • 3.6.3.8.2. Flash to SPI NOR
      • 3.6.3.8.3. Flash to SPI NAND
      • 3.6.3.8.4. Flash to GPMC NAND
  • 3.6.4. Flash via Ethernet
    • 3.6.4.1. Get Tool
      • 3.6.4.1.1. SDK installer
      • 3.6.4.1.2. Clone repository
    • 3.6.4.2. Important files
    • 3.6.4.3. Requirements on host PC
    • 3.6.4.4. Building bootloader binaries for flashing and Ethernet Boot
    • 3.6.4.5. Getting ready to flash
    • 3.6.4.6. Environment variable text file for flashing
  • 3.6.5. Flash via UART
    • 3.6.5.1. Important files
    • 3.6.5.2. Requirements on Host PC
    • 3.6.5.3. Getting ready to flash
    • 3.6.5.4. Flash configuration file
    • 3.6.5.5. Flashing the files
    • 3.6.5.6. Flash tool options
  • 3.6.6. RPi 40-pin header programming
    • 3.6.6.1. 40-pin header default configuration
    • 3.6.6.2. Repositories
    • 3.6.6.3. Additional References
• 3.7. IPC for AM62Px
  • 3.7.1. Software Dependencies to Get Started
  • 3.7.2. Typical Boot Flow on AM62Px for ARM Linux users
  • 3.7.3. Getting Started with IPC Linux Examples
  • 3.7.4. Booting Remote Cores from Linux console/User space
  • 3.7.5. DMA memory Carveouts
  • 3.7.6. Changing the Memory Map
  • 3.7.7. RPMsg Char Driver
  • 3.7.8. ti-rpmsg-char library
  • 3.7.9. RPMsg examples:
• 3.8. Graphics and Display
  • 3.8.1. Introduction
    • 3.8.1.1. Software Architecture
    • 3.8.1.2. Graphics Demos
  • 3.8.2. Rogue Debug Info
  • 3.8.3. Rogue Power Management Info
    • 3.8.3.1. APM
    • 3.8.3.2. Suspend & Resume
  • 3.8.4. Display
    • 3.8.4.1. Finding Connector ID
    • 3.8.4.2. Finding Plane ID
    • 3.8.4.3. Using Connector ID and Plane ID
  • 3.8.5. OpenGL ES
  • 3.8.6. Vulkan
  • 3.8.7. QT Graphics Framework
    • 3.8.7.1. Demos
    • 3.8.7.2. QT QPA
    • 3.8.7.3. Running QT Applications with the Weston IVI shell
  • 3.8.8. GTK+ Graphics Framework
    • 3.8.8.1. Demos
  • 3.8.9. Weston
    • 3.8.9.1. Starting Weston with Systemd
    • 3.8.9.2. Starting Weston Manually
    • 3.8.9.3. Stopping Weston
    • 3.8.9.4. Running Weston clients
    • 3.8.9.5. Running multimedia with Wayland sink
    • 3.8.9.6. Using IVI shell feature
  • 3.8.10. PowerVR Tools
    • 3.8.10.1. PVRTune
    • 3.8.10.2. PVRCarbon
• 3.9. FFmpeg Plugins for Multimedia
  • 3.9.1. Useful Flags
    • 3.9.1.1. ffmpeg
      • 3.9.1.1.1. Help Flags
      • 3.9.1.1.2. Stream Specific Flags
    • 3.9.1.2. ffplay
    • 3.9.1.3. ffprobe
  • 3.9.2. Example Commands
• 3.10. MPV Plugins for Multimedia
  • 3.10.1. Useful Flags
  • 3.10.2. Example Commands
• 3.11. Multimedia Video Codec
  • 3.11.1. Introduction
  • 3.11.2. Software Architecture
    • 3.11.2.1. Software Stack of Accelerated Codec Encoding/Decoding
    • 3.11.2.2. Linux Kernel Drivers
    • 3.11.2.3. GStreamer Plugins for Multimedia
      • 3.11.2.3.1. V4L2 Video Encoder/Decoder
  • 3.11.3. Encoder and Decoder Capabilities
  • 3.11.4. GStreamer Pipelines
  • 3.11.5. Memory Requirement
  • 3.11.6. Performance metrics
  • 3.11.7. Calculation of Performance metrics using native driver API
  • 3.11.8. Calculation of Performance metrics using gstreamer
    • 3.11.8.1. Latency
    • 3.11.8.2. Performance
  • 3.11.9. DMA Buffer Import/Export
  • 3.11.10. Configuration of CMA Size
• 3.12. Hypervisor
  • 3.12.1. Jailhouse
    • 3.12.1.1. Overview
    • 3.12.1.2. Enabling hypervisor on AM62Px platform
    • 3.12.1.3. Building Jailhouse Image for AM62Px platform
      • 3.12.1.3.1. Building Jailhouse Image using Yocto
      • 3.12.1.3.2. Building Jailhouse using TI SDK Installer
    • 3.12.1.4. Generate SD Card Image for Jailhouse
    • 3.12.1.5. Booting the SD Card Image
    • 3.12.1.6. Pre-built components in Jailhouse Image
    • 3.12.1.7. Jailhouse Interface
    • 3.12.1.8. Running Jailhouse Demos on AM62Px
      • 3.12.1.8.1. Host Setup
      • 3.12.1.8.2. Running Linux Demo
      • 3.12.1.8.3. Run Crash Test To Detect Inmate Failure
      • 3.12.1.8.4. Adding custom demos or applications in Inmate Filesystem
      • 3.12.1.8.5. Running Shared Memory Demo
      • 3.12.1.8.6. Running Ethernet Demo
      • 3.12.1.8.7. Running Baremetal Demos
        • 3.12.1.8.7.1. Running UART Demo
        • 3.12.1.8.7.2. Running GIC Demo
    • 3.12.1.9. Memory Reservation
    • 3.12.1.10. Hardware Modules Reservation
    • 3.12.1.11. Root-cell configuration
    • 3.12.1.12. Performance
      • 3.12.1.12.1. Cache Benchmark
• 3.13. Virtualization
  • 3.13.1. Docker Linux Container Runtime
    • 3.13.1.1. Overview
    • 3.13.1.2. Exploring Docker In Processor SDK
      • 3.13.1.2.1. Booting the Docker Filesystem
      • 3.13.1.2.2. Configuring the Docker daemon
      • 3.13.1.2.3. Docker Hello World
    • 3.13.1.3. Docker References
• 3.14. Machine Learning
• 3.15. ARM Trusted Firmware-A
• 3.16. OP-TEE