UPL Specification v0.9.1-preview

Scope

This document defines technical specifications for a Universal Payload to be used as a common payload handoff interface in between Platform Init and Payload.

Contents

• License
  • License Information
  • Copyright
• Acknowledgements
• Revision History
• References & Terminology
  • Abbreviation
  • Terminology
  • References
• Chapter 1: Introduction
  • 1.1 Purpose
    • 1.1.1 Platform Init
    • 1.1.2 Payload
  • 1.2 Design Goal
  • 1.3 Security Requirements
• Chapter 2: Payload Image Format
  • 2.1 FIT Images
  • 2.2 FIT Configurations
  • 2.3 FIT Schema
    • 2.3.1 Example FIT
    • 2.3.2 FIT External Data
    • 2.3.3 Loading Process Example
    • 2.3.4 Implementation
  • 2.4 Relocation
    • 2.4.1 Motivation
    • 2.4.2 Relocation Format
    • 2.4.3 Relocation Records
• Chapter 3: Payload Handoff State
  • 3.1 Overview
  • 3.2 Requirements for all architectures
  • 3.3 Architecture
    • 3.3.1 ARM
    • 3.3.2 RISC-V
    • 3.3.3 x86
• Chapter 4: Payload Handoff Format
  • 4.1 Standard Properties and Property Values
    • 4.1.1 Property Values
    • 4.1.2 Standard Properties
  • 4.2 UPL Devicetree Nodes
    • 4.2.1 Node: / (Root Node) (R)
    • 4.2.2 Node: /options/upl-params (R)
    • 4.2.3 Node: /options/upl-image@<addr> (R)
    • 4.2.4 Node: /options/upl-image/image@<addr> (O)
    • 4.2.5 Node: /pci (R)
    • 4.2.6 Node: /isa (O)
    • 4.2.7 Node: Serial Console Device (SD)
    • 4.2.8 Node: framebuffer (for Display) (SD)
    • 4.2.9 Node: chosen (R)
    • 4.2.10 Node: /options/upl-custom (O)
    • 4.2.11 Node: /memory (R)
    • 4.2.12 Node: reserved-memory (R)