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. 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
    • 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.1.11. UFS
    • 3.1.1.12. DDR3 ECC
      • 3.1.1.12.1. DDR3 ECC in Keystone-II
        • 3.1.1.12.1.1. DDR3 ECC Handling
    • 3.1.1.13. HyperBus and HyperFlash
    • 3.1.1.14. RemoteProc
      • 3.1.1.14.1. Initialization
      • 3.1.1.14.2. Loading
      • 3.1.1.14.3. Starting
      • 3.1.1.14.4. Stop
      • 3.1.1.14.5. Lockstep and Split mode
      • 3.1.1.14.6. HS Devices
    • 3.1.1.15. Adaptive Voltage Scaling (AVS) Class 0
      • 3.1.1.15.1. Hardware Architecture
      • 3.1.1.15.2. Configuration options
      • 3.1.1.15.3. Driver
    • 3.1.1.16. Thermal shutdown Support
      • 3.1.1.16.1. Driver
  • 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. Debugging SPL in OpenOCD
    • 3.1.2.4. Loading Uboot through CCS
      • 3.1.2.4.1. Step 1: Software Downloads
      • 3.1.2.4.2. Step 2: Testing Hardware Connection
      • 3.1.2.4.3. Step 3: Building the SPL/Uboot images
      • 3.1.2.4.4. Step 4: CCS Configuration
      • 3.1.2.4.5. Step 5: Change ARM mode
      • 3.1.2.4.6. Step 6: Loading SPL
      • 3.1.2.4.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 Drivers
    • 3.2.2.1. ADC
    • 3.2.2.2. Audio
      • 3.2.2.2.1. Introduction
      • 3.2.2.2.2. Software Architecture
      • 3.2.2.2.3. Generic commands and instructions
      • 3.2.2.2.4. Board-specific instructions
      • 3.2.2.2.5. Potential issues
      • 3.2.2.2.6. Additional Information
    • 3.2.2.3. CSI2RX
      • 3.2.2.3.1. Introduction
      • 3.2.2.3.2. Hardware Architecture
      • 3.2.2.3.3. Driver Architecture
        • 3.2.2.3.3.1. The Media Controller API
        • 3.2.2.3.3.2. Utilities to interact with the driver
        • 3.2.2.3.3.3. Building the driver
      • 3.2.2.3.4. Creating device tree nodes for sensor
      • 3.2.2.3.5. Enabling camera sensors
    • 3.2.2.4. Crypto
    • 3.2.2.5. MCAN
    • 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. GPIO
    • 3.2.2.8. HyperBus and HyperFlash
      • 3.2.2.8.1. Introduction
      • 3.2.2.8.2. Driver Architecture
        • 3.2.2.8.2.1. Kernel Configuration Options
        • 3.2.2.8.2.2. DT Configuration
        • 3.2.2.8.2.3. Driver Usage
        • 3.2.2.8.2.4. Testing
    • 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. PCIe End Point
    • 3.2.2.12. PCIe Backplane
    • 3.2.2.13. PCIe Root Complex
    • 3.2.2.14. TPS6594 PMIC
      • 3.2.2.14.1. Introduction
      • 3.2.2.14.2. Device tree configuration
      • 3.2.2.14.3. TPS6594 I2C driver
      • 3.2.2.14.4. TPS6594 SPI driver
      • 3.2.2.14.5. TPS6594 GPIO/pinctrl driver
      • 3.2.2.14.6. TPS6594 regulator driver
      • 3.2.2.14.7. TPS6594 ESM driver
      • 3.2.2.14.8. TPS6594 RTC driver
      • 3.2.2.14.9. TPS6594 PFSM driver
    • 3.2.2.15. Power Management
      • 3.2.2.15.1. DFS
    • 3.2.2.16. OSPI/QSPI
    • 3.2.2.17. SERDES
      • 3.2.2.17.1. Introduction
      • 3.2.2.17.2. Types of SERDES
      • 3.2.2.17.3. SERDES Configurations
      • 3.2.2.17.4. SERDES Instances
      • 3.2.2.17.5. SERDES Muxing
      • 3.2.2.17.6. SERDES Clocking Options
        • 3.2.2.17.6.1. Internal Reference Clock
        • 3.2.2.17.6.2. External Reference Clock
        • 3.2.2.17.6.3. Selecting Between Internal and External Reference Clock
    • 3.2.2.18. SPI
    • 3.2.2.19. NAND
    • 3.2.2.20. MMC/SD
      • 3.2.2.20.1. Introduction
      • 3.2.2.20.2. References
      • 3.2.2.20.3. Acronyms & Definitions
      • 3.2.2.20.4. Features
      • 3.2.2.20.5. Supported High Speed Modes
      • 3.2.2.20.6. Driver Configuration
      • 3.2.2.20.7. Steps for working around SD card issues
    • 3.2.2.21. UART
      • 3.2.2.21.1. Introduction
      • 3.2.2.21.2. Driver Features
      • 3.2.2.21.3. Basic External loopback testing
    • 3.2.2.22. UFS
    • 3.2.2.23. USB
      • 3.2.2.23.1. Introduction
      • 3.2.2.23.2. TI SoC Integration
      • 3.2.2.23.3. EVM
    • 3.2.2.24. Voltage & Thermal Management (VTM)
      • 3.2.2.24.1. Introduction
      • 3.2.2.24.2. Driver Features
      • 3.2.2.24.3. Finding More Information
  • 3.2.3. LTP-DDT Validation
  • 3.2.4. 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. Flash Tools
    • 3.4.2.1. AM335x/AM437x Flash Programming
    • 3.4.2.2. Sitara Uniflash
  • 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.4.4. System configuration tool
• 3.5. IPC for J721E
  • 3.5.1. Typical Boot Flow on J721E for ARM Linux users
  • 3.5.2. Getting Started with IPC Linux Examples
  • 3.5.3. Booting Remote Cores from Linux console/User space
  • 3.5.4. DMA memory Carveouts
  • 3.5.5. Changing the Memory Map
  • 3.5.6. RPMsg Char Driver
  • 3.5.7. ti-rpmsg-char library
  • 3.5.8. RPMsg examples:
• 3.6. Graphics and Display
  • 3.6.1. Introduction
  • 3.6.2. Software Architecture
  • 3.6.3. Graphics Demos
  • 3.6.4. Display
    • 3.6.4.1. Finding Connector ID
    • 3.6.4.2. Finding Plane ID
  • 3.6.5. Wayland/Weston
    • 3.6.5.1. Starting Weston with Systemd
    • 3.6.5.2. Starting Weston Manually
    • 3.6.5.3. Running Weston clients
    • 3.6.5.4. Running multimedia with Wayland sink
    • 3.6.5.5. Exiting Weston
    • 3.6.5.6. Using IVI shell feature
      • 3.6.5.6.1. Running QT applications with IVI shell
  • 3.6.6. Using the PowerVR Tools
    • 3.6.6.1. PVRTune
    • 3.6.6.2. PVRCarbon
  • 3.6.7. Rogue Debug Info
  • 3.6.8. Rogue Power Management Info
    • 3.6.8.1. APM
    • 3.6.8.2. Suspend & Resume
• 3.7. Multimedia Video Codec
  • 3.7.1. Introduction
  • 3.7.2. Encoder and Decoder Capabilities
  • 3.7.3. Demos
  • 3.7.4. Software Architecture
    • 3.7.4.1. Software Stack of Accelerated Codec Encoding/Decoding
    • 3.7.4.2. Linux Kernel Drivers
      • 3.7.4.2.1. V4L2 Video Decoder
      • 3.7.4.2.2. V4L2 Video Encoder
    • 3.7.4.3. GStreamer Plugins for Multimedia
  • 3.7.5. GStreamer Pipelines
    • 3.7.5.1. Running a GStreamer pipeline
    • 3.7.5.2. Limitations of GStreamer Plugins
    • 3.7.5.3. GStreamer Plugin Internals
  • 3.7.6. Memory Optimisation
    • 3.7.6.1. Decoder Driver Memory Optimisation
  • 3.7.7. Rebuilding and Debugging
    • 3.7.7.1. Rebuilding V4L2 Drivers
    • 3.7.7.2. Debug Logs
    • 3.7.7.3. Latency Profiling
• 3.8. Virtualization
  • 3.8.1. Docker Linux Container Runtime
    • 3.8.1.1. Overview
    • 3.8.1.2. Exploring Docker In Processor SDK
      • 3.8.1.2.1. Booting the Docker Filesystem
      • 3.8.1.2.2. Configuring the Docker daemon
      • 3.8.1.2.3. Docker Hello World
    • 3.8.1.3. Docker References
• 3.9. ARM Trusted Firmware-A
• 3.10. OP-TEE