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. Boot Flow
      • 3.1.1.1.4. U-Boot Environment
      • 3.1.1.1.5. Available RAM for image download
      • 3.1.1.1.6. Device Trees
      • 3.1.1.1.7. 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. Network (Wired or USB Client)
      • 3.1.1.3.1. Booting U-Boot from the network
      • 3.1.1.3.2. Multiple Interfaces
      • 3.1.1.3.3. Network configuration via DHCP
      • 3.1.1.3.4. Manual network configuration
      • 3.1.1.3.5. Disabling Gigabit Phy Advertising
      • 3.1.1.3.6. Booting Linux from the network
      • 3.1.1.3.7. Sample Script for AM65 SR1
      • 3.1.1.3.8. Sample Script for AM65 SR2
    • 3.1.1.4. NAND
      • 3.1.1.4.1. Erasing, Reading and Writing to/from NAND partitions
      • 3.1.1.4.2. Writing to NAND via DFU
      • 3.1.1.4.3. NAND Boot
      • 3.1.1.4.4. Booting Kernel and Filesystem from NAND
      • 3.1.1.4.5. U-Boot Environment in NAND
    • 3.1.1.5. SD, eMMC and USB
      • 3.1.1.5.1. Partitioning eMMC from U-Boot
      • 3.1.1.5.2. Updating an SD card from a host PC
      • 3.1.1.5.3. Updating an SD card or eMMC using DFU
      • 3.1.1.5.4. Booting Linux from SD card or eMMC
      • 3.1.1.5.5. Booting tiboot3.bin, tispl.bin and u-boot.img from eMMC boot partition (For K3 class of SoCs)
      • 3.1.1.5.6. Booting to U-Boot prompt from USB storage
      • 3.1.1.5.7. Booting Linux from USB storage
      • 3.1.1.5.8. Steps for working around SD card issues
    • 3.1.1.6. SPI
      • 3.1.1.6.1. Writing to SPI from U-Boot
      • 3.1.1.6.2. Booting from SPI
    • 3.1.1.7. OSPI/QSPI NOR/NAND
    • 3.1.1.8. NOR
      • 3.1.1.8.1. Writing to NOR from U-Boot
      • 3.1.1.8.2. Booting from NOR
    • 3.1.1.9. UART
      • 3.1.1.9.1. Booting U-Boot from the console UART
    • 3.1.1.10. SATA
      • 3.1.1.10.1. Viewing SATA Devices
      • 3.1.1.10.2. Viewing Partitions
      • 3.1.1.10.3. Identifying Partition Filesystem Type
      • 3.1.1.10.4. Viewing, Reading and Writing to Partition
      • 3.1.1.10.5. View Partition Contents
  • 3.1.2. Troubleshooting
    • 3.1.2.1. U-Boot Debug Tips
    • 3.1.2.2. Debugging SPL in CCS
      • 3.1.2.2.1. Step 1: Downloading CCS
      • 3.1.2.2.2. Step 2: Creating a Target Configuration File
      • 3.1.2.2.3. Step 3: Loading Symbol files
    • 3.1.2.3. Loading Uboot through CCS
      • 3.1.2.3.1. Step 1: Software Downloads
      • 3.1.2.3.2. Step 2: Testing Hardware Connection
      • 3.1.2.3.3. Step 3: Building the SPL/Uboot images
      • 3.1.2.3.4. Step 4: CCS Configuration
      • 3.1.2.3.5. Step 5: Change ARM mode
      • 3.1.2.3.6. Step 6: Loading SPL
      • 3.1.2.3.7. Step 7: Loading Uboot Image
• 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 Release Notes
    • 3.2.2.1. Build Information
    • 3.2.2.2. Generic Kernel Release Notes
    • 3.2.2.3. Known Issues
  • 3.2.3. Kernel Drivers
    • 3.2.3.1. Audio
      • 3.2.3.1.1. Introduction
      • 3.2.3.1.2. Software Architecture
      • 3.2.3.1.3. Generic commands and instructions
      • 3.2.3.1.4. Board-specific instructions
      • 3.2.3.1.5. Potential issues
      • 3.2.3.1.6. Additional Information
    • 3.2.3.2. VIP
    • 3.2.3.3. Crypto
    • 3.2.3.4. DCAN
    • 3.2.3.5. LCDC
    • 3.2.3.6. GPIO
    • 3.2.3.7. I2C
    • 3.2.3.8. CPSW
      • 3.2.3.8.1. Introduction
      • 3.2.3.8.2. Common Platform Time Sync (CPTS) module
    • 3.2.3.9. PRUSS
    • 3.2.3.10. PCIe End Point
    • 3.2.3.11. PCIe Root Complex
    • 3.2.3.12. PWM
    • 3.2.3.13. OSPI/QSPI NOR/NAND
    • 3.2.3.14. SPI
    • 3.2.3.15. SATA
    • 3.2.3.16. NAND
    • 3.2.3.17. MMC/SD
      • 3.2.3.17.1. Introduction
      • 3.2.3.17.2. References
      • 3.2.3.17.3. Acronyms & Definitions
      • 3.2.3.17.4. Features
      • 3.2.3.17.5. Supported High Speed Modes
      • 3.2.3.17.6. Driver Configuration
      • 3.2.3.17.7. Steps for working around SD card issues
    • 3.2.3.18. UART
      • 3.2.3.18.1. Introduction
      • 3.2.3.18.2. Driver Features
      • 3.2.3.18.3. Basic External loopback testing
    • 3.2.3.19. USB DWC3
    • 3.2.3.20. VPE
  • 3.2.4. LTP-DDT Validation
  • 3.2.5. FAQs
• 3.3. Filesystem
• 3.4. Tools
  • 3.4.1. Development Tools
    • 3.4.1.1. Processor SDK Linux Top-Level Makefile
    • 3.4.1.2. Processor SDK Linux GCC Toolchain
    • 3.4.1.3. Creating SD Cards
    • 3.4.1.4. Processor SDK Linux Setup Script
  • 3.4.2. Pin Mux Tools
  • 3.4.3. Code Composer Studio
    • 3.4.3.1. CCS Installation
    • 3.4.3.2. CCS Compiling
    • 3.4.3.3. Remote Explorer Setup with CCS
    • 3.4.3.4. GDB Setup with CCS
    • 3.4.3.5. Kernel Debugging with CCS
• 3.5. IPC
  • 3.5.1. Overview
  • 3.5.2. IPC Quick Start Guide
  • 3.5.3. IPC for AM57xx
  • 3.5.4. IPC Early Boot for AM57xx/DRA7xx
  • 3.5.5. IPC for AM65xx
  • 3.5.6. IPC for K2x
    • 3.5.6.1. Introduction
    • 3.5.6.2. Software Dependencies to Get Started
    • 3.5.6.3. Multiple Processor Manager
      • 3.5.6.3.1. Methods to load and run ELF images using MPM
    • 3.5.6.4. Getting Started with IPC Linux Examples
      • 3.5.6.4.1. Building the Bundled IPC Examples
      • 3.5.6.4.2. Running the Bundled IPC Examples
    • 3.5.6.5. Understanding the Memory Map
      • 3.5.6.5.1. Overall Linux Memory Map
    • 3.5.6.6. Changing the DSP Memory Map
      • 3.5.6.6.1. Linux Device Tree
      • 3.5.6.6.2. Resource Table
      • 3.5.6.6.3. MPM Config File
      • 3.5.6.6.4. Config.bld
    • 3.5.6.7. Modifying ex02_messageQ example to run from DDR
    • 3.5.6.8. Loading DSP images from CCS (without using MPM)
    • 3.5.6.9. MPM Debugging
      • 3.5.6.9.1. Detecting crash event in MPM
    • 3.5.6.10. Disable OpenCL Application
    • 3.5.6.11. Frequently Asked Questions
  • 3.5.7. Multiple Ways of ARM-DSP Communication
  • 3.5.8. IPC Tests
    • 3.5.8.1. Overview
      • 3.5.8.1.1. Linux Unit tests
        • 3.5.8.1.1.1. Single thread MessageQ tests
        • 3.5.8.1.1.2. ping_rpmsg
        • 3.5.8.1.1.3. NameServerApp
        • 3.5.8.1.1.4. MessageQMulti
        • 3.5.8.1.1.5. MessageQMultiMulti
        • 3.5.8.1.1.6. fault
      • 3.5.8.1.2. Qnx Unit tests
        • 3.5.8.1.2.1. Single thread MessageQ tests
        • 3.5.8.1.2.2. NameServerApp
        • 3.5.8.1.2.3. MessageQMulti
        • 3.5.8.1.2.4. Fault
        • 3.5.8.1.2.5. GateMPApp
        • 3.5.8.1.2.6. mmrpc_test
  • 3.5.9. IPC Daemon
    • 3.5.9.1. IPC Daemon (aka LAD)
      • 3.5.9.1.1. Approach
      • 3.5.9.1.2. Limitations
        • 3.5.9.1.2.1. Startup Before Any Clients
        • 3.5.9.1.2.2. Maximum Number of Simultaneous Connections
        • 3.5.9.1.2.3. Hard-coded MultiProc configuration
• 3.6. CMEM
• 3.7. Graphics and Display
  • 3.7.1. Introduction
  • 3.7.2. Software Architecture
  • 3.7.3. Graphics Demos
    • 3.7.3.1. Running demos in Null Window system mode
  • 3.7.4. SGX Debug Info
    • 3.7.4.1. Introduction
    • 3.7.4.2. Baselining the current SGX driver environment
    • 3.7.4.3. Run-time checks/configuration of the SGX driver
      • 3.7.4.3.1. WindowSystem
      • 3.7.4.3.2. DisableHWTextureUpload
      • 3.7.4.3.3. DefaultPixelFormat
    • 3.7.4.4. SGX Driver Failure Modes (Installation)
      • 3.7.4.4.1. Unable to install the kernel modules (pvrsrvkm.ko)
    • 3.7.4.5. SGX Driver Failure Modes (Run time)
      • 3.7.4.5.1. Vertical Tearing / Artifacts / Clipping issues / Missing objects
      • 3.7.4.5.2. Demos are not running at required speed, How to check SGX clock rate?
      • 3.7.4.5.3. Qt demos do not work when PowerVR is enabled
    • 3.7.4.6. Posting to E2E forum
  • 3.7.5. Migration from prior releases
    • 3.7.5.1. From Processor SDK 1.x to 2.x for AM3, AM4
      • 3.7.5.1.1. Window System Libraries
      • 3.7.5.1.2. Obsolete Test Programs
    • 3.7.5.2. From Processor SDK 2.0.0 to 2.0.x for AM4
      • 3.7.5.2.1. Window System Libraries
    • 3.7.5.3. From Processor SDK 2.0.1 to 2.0.x for AM3/4/5
      • 3.7.5.3.1. Window System Libraries
    • 3.7.5.4. From Processor SDK 3.1 to 3.x for AM3/4/5
    • 3.7.5.5. From Processor SDK 6.1 to 6.2 for AM3/4/5/6
      • 3.7.5.5.1. Window System Libraries
  • 3.7.6. DSS Applications
    • 3.7.6.1. Running DSS Applications
      • 3.7.6.1.1. Running drmclone
      • 3.7.6.1.2. Running drmextended
      • 3.7.6.1.3. Running drmzalpha
  • 3.7.7. SGX Build Guide
    • 3.7.7.1. SGX Kernel Module
      • 3.7.7.1.1. Building the SGX Kernel Module
    • 3.7.7.2. SGX Userspace Components
      • 3.7.7.2.1. Installing the SGX Userspace Components
    • 3.7.7.3. SGX Mesa Components
      • 3.7.7.3.1. Building the SGX Mesa Components
    • 3.7.7.4. Using the SGX Stack
  • 3.7.8. Display
    • 3.7.8.1. Finding Connector ID
    • 3.7.8.2. Finding Plane ID
    • 3.7.8.3. Using Connector ID and Plane ID
  • 3.7.9. OpenGL ES
  • 3.7.10. QT Graphics Framework
    • 3.7.10.1. Demos
    • 3.7.10.2. QT QPA
    • 3.7.10.3. Running QT Applications with the Weston IVI shell
  • 3.7.11. GTK+ Graphics Framework
    • 3.7.11.1. Demos
  • 3.7.12. Weston
    • 3.7.12.1. Starting Weston with Systemd
    • 3.7.12.2. Starting Weston Manually
    • 3.7.12.3. Stopping Weston
    • 3.7.12.4. Running Weston clients
    • 3.7.12.5. Running multimedia with Wayland sink
    • 3.7.12.6. Using IVI shell feature
  • 3.7.13. PowerVR Tools
    • 3.7.13.1. PVRTune
    • 3.7.13.2. PVRCarbon
• 3.8. ARM Trusted Firmware-A
• 3.9. OP-TEE