3. Foundational Components

• 3.1. U-Boot
  • 3.1.1. Build Guide
    • 3.1.1.1. Setup
      • 3.1.1.1.1. Install host dependencies
      • 3.1.1.1.2. Getting the Source Code
    • 3.1.1.2. Build
      • 3.1.1.2.1. Build U-Boot
    • 3.1.1.3. Target Images
      • 3.1.1.3.1. Images
      • 3.1.1.3.2. Image Formats
    • 3.1.1.4. Boot Flow
    • 3.1.1.5. Environment
      • 3.1.1.5.1. U-Boot Environment
    • 3.1.1.6. RAM and Device Trees
      • 3.1.1.6.1. Available RAM for image download
      • 3.1.1.6.2. Device Trees
      • 3.1.1.6.3. SRAM memory Layout during initial bootloader stage
  • 3.1.2. User’s Guide
    • 3.1.2.1. USB Device Firmware Upgrade (DFU)
      • 3.1.2.1.1. USB Peripheral boot mode (SPL-DFU support)
    • 3.1.2.2. Network (Wired or USB Client)
      • 3.1.2.2.1. Booting U-Boot from the network
      • 3.1.2.2.2. Multiple Interfaces
      • 3.1.2.2.3. Network configuration via DHCP
      • 3.1.2.2.4. Manual network configuration
      • 3.1.2.2.5. Disabling Gigabit Phy Advertising
      • 3.1.2.2.6. Booting Linux from the network
      • 3.1.2.2.7. Sample Script for AM65 SR1
      • 3.1.2.2.8. Sample Script for AM65 SR2
    • 3.1.2.3. NAND
      • 3.1.2.3.1. Erasing, Reading and Writing to/from NAND partitions
      • 3.1.2.3.2. Writing to NAND via DFU
      • 3.1.2.3.3. NAND Boot
      • 3.1.2.3.4. Booting Kernel and Filesystem from NAND
      • 3.1.2.3.5. U-Boot Environment in NAND
    • 3.1.2.4. SD, eMMC and USB
      • 3.1.2.4.1. Overview
      • 3.1.2.4.2. MMC
        • 3.1.2.4.2.1. Listing MMC devices
        • 3.1.2.4.2.2. MMC HW partitions
        • 3.1.2.4.2.3. Selecting MMC device and partitions
        • 3.1.2.4.2.4. View MMC partition contents
        • 3.1.2.4.2.5. MMC supported boot modes
        • 3.1.2.4.2.6. Flashing an MMC device using USB-DFU
        • 3.1.2.4.2.7. Flashing an SD card from a host PC
      • 3.1.2.4.3. USB
        • 3.1.2.4.3.1. Configuring USB in Host Mode
        • 3.1.2.4.3.2. Flash and boot SPL from USB storage
        • 3.1.2.4.3.3. Boot Linux from USB storage
        • 3.1.2.4.3.4. MMC support in u-boot
        • 3.1.2.4.3.5. Steps for working around SD card issues in u-boot
    • 3.1.2.5. USB Mass Storage
      • 3.1.2.5.1. Configuration requirements
      • 3.1.2.5.2. Usage
    • 3.1.2.6. OSPI/QSPI NOR/NAND
    • 3.1.2.7. NOR
      • 3.1.2.7.1. Writing to NOR from U-Boot
      • 3.1.2.7.2. Booting from NOR
    • 3.1.2.8. UART
      • 3.1.2.8.1. Booting U-Boot from the console UART
    • 3.1.2.9. SATA
      • 3.1.2.9.1. Viewing SATA Devices
      • 3.1.2.9.2. Viewing Partitions
      • 3.1.2.9.3. Identifying Partition Filesystem Type
      • 3.1.2.9.4. Viewing, Reading and Writing to Partition
      • 3.1.2.9.5. View Partition Contents
    • 3.1.2.10. UFS
    • 3.1.2.11. DDR
      • 3.1.2.11.1. Overview
      • 3.1.2.11.2. DDR Initialization
      • 3.1.2.11.3. DDR Temperature Monitoring
      • 3.1.2.11.4. Inline ECC
        • 3.1.2.11.4.1. ECC Handling
    • 3.1.2.12. HyperBus and HyperFlash
    • 3.1.2.13. RemoteProc
      • 3.1.2.13.1. Initialization
      • 3.1.2.13.2. Loading
      • 3.1.2.13.3. Starting
      • 3.1.2.13.4. Stop
      • 3.1.2.13.5. Lockstep and Split mode
      • 3.1.2.13.6. HS Devices
    • 3.1.2.14. Adaptive Voltage Scaling (AVS) Class 0
      • 3.1.2.14.1. Hardware Architecture
      • 3.1.2.14.2. Configuration options
      • 3.1.2.14.3. Driver
    • 3.1.2.15. Thermal shutdown Support
      • 3.1.2.15.1. Driver
  • 3.1.3. Troubleshooting
    • 3.1.3.1. U-Boot Debug Tips
    • 3.1.3.2. Debugging U-Boot and SPL
      • 3.1.3.2.1. Debug Example
        • 3.1.3.2.1.1. Setup
        • 3.1.3.2.1.2. Using OpenOCD & GDB
        • 3.1.3.2.1.3. Using CCS
    • 3.1.3.3. Loading Uboot through CCS
      • 3.1.3.3.1. Step 1: Software Downloads
      • 3.1.3.3.2. Step 2: Testing Hardware Connection
      • 3.1.3.3.3. Step 3: Building the SPL/Uboot images
      • 3.1.3.3.4. Step 4: CCS Configuration
      • 3.1.3.3.5. Step 5: Change ARM mode
      • 3.1.3.3.6. Step 6: Loading SPL
      • 3.1.3.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. FIT Image
    • 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. Crypto
      • 3.2.2.2.1. Introduction
      • 3.2.2.2.2. Building the Drivers
      • 3.2.2.2.3. Using Cryptographic Hardware Accelerators from OpenSSL
      • 3.2.2.2.4. Using the TRNG Hardware Accelerator
      • 3.2.2.2.5. Hardware Accelerator testing
        • 3.2.2.2.5.1. Testing using the tcrypt module
        • 3.2.2.2.5.2. IPSec Testing
    • 3.2.2.3. MCAN
    • 3.2.2.4. K3 DDR
      • 3.2.2.4.1. Introduction
      • 3.2.2.4.2. Building and Enabling the Driver
      • 3.2.2.4.3. Using the DDR Temperature Monitoring
    • 3.2.2.5. GPIO
    • 3.2.2.6. I2C
    • 3.2.2.7. CPSW Ethernet
      • 3.2.2.7.1. Introduction
      • 3.2.2.7.2. Instances of the CPSW Subsystem
      • 3.2.2.7.3. TSN Documentation and Testing
      • 3.2.2.7.4. XDP and zero copy
    • 3.2.2.7.3.1. CPSW2g Ethernet
      • 3.2.2.7.3.1.1. Introduction
        • 3.2.2.7.3.1.1.1. Supported platforms
      • 3.2.2.7.3.1.2. Driver Configuration
      • 3.2.2.7.3.1.3. Device tree bindings
      • 3.2.2.7.3.1.4. MAC mode
        • 3.2.2.7.3.1.4.1. Interrupt pacing
        • 3.2.2.7.3.1.4.2. Errata: i2329 MDIO interface corruption (CPSW and PRUSS)
    • 3.2.2.8. PCIe End Point
    • 3.2.2.9. PCIe Root Complex
    • 3.2.2.10. TPS6594 PMIC
      • 3.2.2.10.1. Introduction
      • 3.2.2.10.2. Device tree configuration
      • 3.2.2.10.3. TPS6594 I2C driver
      • 3.2.2.10.4. TPS6594 SPI driver
      • 3.2.2.10.5. TPS6594 GPIO/pinctrl driver
      • 3.2.2.10.6. TPS6594 regulator driver
      • 3.2.2.10.7. TPS6594 ESM driver
      • 3.2.2.10.8. TPS6594 RTC driver
      • 3.2.2.10.9. TPS6594 PFSM driver
    • 3.2.2.11. OSPI/QSPI NOR/NAND
    • 3.2.2.12. SERDES
      • 3.2.2.12.1. Introduction
      • 3.2.2.12.2. Types of SERDES
      • 3.2.2.12.3. SERDES Configurations
      • 3.2.2.12.4. SERDES Instances
      • 3.2.2.12.5. SERDES Muxing
      • 3.2.2.12.6. SERDES Clocking Options
        • 3.2.2.12.6.1. Internal Reference Clock
        • 3.2.2.12.6.2. External Reference Clock
        • 3.2.2.12.6.3. Selecting Between Internal and External Reference Clock
    • 3.2.2.13. SPI
    • 3.2.2.14. NAND
    • 3.2.2.15. MMCSD
      • 3.2.2.15.1. Introduction
      • 3.2.2.15.2. References
      • 3.2.2.15.3. Features
      • 3.2.2.15.4. Supported ultra high speed (UHS) modes
      • 3.2.2.15.5. Driver configuration
      • 3.2.2.15.6. MMC support in Linux
      • 3.2.2.15.7. Steps for working around SD card issues in Linux
      • 3.2.2.15.8. Listing MMC devices from Linux
      • 3.2.2.15.9. Create partitions in eMMC UDA
        • 3.2.2.15.9.1. Create “boot” partition
        • 3.2.2.15.9.2. Create “root” partition
      • 3.2.2.15.10. Formatting eMMC partitions from Linux
        • 3.2.2.15.10.1. Format to vfat
        • 3.2.2.15.10.2. Format to ext4
      • 3.2.2.15.11. Flash eMMC for MMCSD boot
        • 3.2.2.15.11.1. Flash to eMMC “boot” partition
        • 3.2.2.15.11.2. Flash to eMMC “root” partition
    • 3.2.2.16. DM TIMER
      • 3.2.2.16.1. Driver Sources
      • 3.2.2.16.2. Kernel Configuration
      • 3.2.2.16.3. Driver Usage
      • 3.2.2.16.4. Examples
    • 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. UBIFS
    • 3.2.2.19. USB
      • 3.2.2.19.1. Introduction
      • 3.2.2.19.2. TI SoC Integration
      • 3.2.2.19.3. EVM
    • 3.2.2.20. Voltage & Thermal Management (VTM)
      • 3.2.2.20.1. Introduction
      • 3.2.2.20.2. Driver Features
      • 3.2.2.20.3. Finding More Information
  • 3.2.3. LTP-DDT Validation
  • 3.2.4. FAQs
• 3.3. Power Management
  • 3.3.1. DFS
  • 3.3.2. Low power modes
    • 3.3.2.1. Overview
      • 3.3.2.1.1. LPM entry overview
      • 3.3.2.1.2. LPM exit overview
    • 3.3.2.2. How to Test LPM modes
      • 3.3.2.2.1. Hardware modifications
      • 3.3.2.2.2. Software modifications
      • 3.3.2.2.3. Testing
        • 3.3.2.2.3.1. SoC off
        • 3.3.2.2.3.2. IO_ONLY_PLUS_DDR mode
    • 3.3.2.3. Known limitations
• 3.4. Security
  • 3.4.1. Device Security
    • 3.4.1.1. Security Overview
    • 3.4.1.2. Security Domains
    • 3.4.1.3. Security Features at a Glance
• 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. Flash Tools
    • 3.6.2.1. AM335x/AM437x Flash Programming
    • 3.6.2.2. Sitara Uniflash
  • 3.6.3. Code Composer Studio
    • 3.6.3.1. CCS Installation
    • 3.6.3.2. CCS Compiling
    • 3.6.3.3. Remote Explorer Setup with CCS
    • 3.6.3.4. GDB Setup with CCS
    • 3.6.3.5. Kernel Debugging with CCS
  • 3.6.4. System configuration tool
• 3.7. IPC for J7200
  • 3.7.1. Typical Boot Flow on J7200 for ARM Linux users
  • 3.7.2. Getting Started with IPC Linux Examples
  • 3.7.3. Booting Remote Cores from Linux console/User space
  • 3.7.4. DMA memory Carveouts
  • 3.7.5. Changing the Memory Map
  • 3.7.6. RPMsg Char Driver
  • 3.7.7. ti-rpmsg-char library
  • 3.7.8. RPMsg examples:
• 3.8. ARM Trusted Firmware-A
• 3.9. OP-TEE
  • 3.9.1. Getting the OP-TEE Source Code
  • 3.9.2. Setting up the toolchain paths
  • 3.9.3. Building OP-TEE OS
    • 3.9.3.1. Building the OP-TEE image
    • 3.9.3.2. Building the OP-TEE image with debug parameters
    • 3.9.3.3. Building OP-TEE with Pseudo RNG drivers
    • 3.9.3.4. OP-TEE Secure Storage
  • 3.9.4. Getting OP-TEE Client source code
  • 3.9.5. Building u-boot with OP-TEE OS