Quartus® Prime Pro Edition User Guide: Platform Designer

Download PDF
ID 683609
Date 7/08/2024
Public
Document Table of Contents
Document Table of Contents x
Answers to Top FAQs 1. Creating a System with Platform Designer 2. Creating a Board Support Package with BSP Editor 3. Creating Platform Designer Components 4. Optimizing Platform Designer System Performance 5. Platform Designer Interconnect 6. Platform Designer System Design Components 7. Platform Designer Command-Line Utilities 8. Component Interface Tcl Reference 9. Quartus® Prime Pro Edition User Guide: Platform Designer Document Archives A. Quartus® Prime Pro Edition User Guides
1. Creating a System with Platform Designer x
1.1. Platform Designer Interface Support 1.2. Platform Designer System Design Flow 1.3. Creating or Opening a Platform Designer System 1.4. Using the Board-Aware Flow in Platform Designer 1.5. Viewing a Platform Designer System 1.6. Adding IP Components to a System 1.7. Connecting System Components 1.8. Specifying Interconnect Parameters 1.9. Correcting Platform Designer System Timing Issues 1.10. Specifying Signal and Interface Boundary Requirements 1.11. Configuring Platform Designer System Security 1.12. Upgrading Outdated IP Components in Platform Designer 1.13. Synchronizing System Component Information 1.14. Validating System Integrity 1.15. Preserving System Elements for Debug 1.16. Generating a Platform Designer System 1.17. Generating Simulation Files for Platform Designer Systems and IP Variants 1.18. Adding a System to an Quartus® Prime Project 1.19. Managing Hierarchical Platform Designer Systems 1.20. Saving and Archiving Platform Designer Systems 1.21. Sharing Platform Designer Packaged Subsystems 1.22. Comparing Platform Designer Systems and IP components 1.23. Running System Scripts 1.24. Creating a System with Platform Designer Revision History
1.3. Creating or Opening a Platform Designer System x
1.3.1. Specifying the Target FPGA Device or Board for a System 1.3.2. Specifying Additional Application Memory 1.3.3. Synchronizing IP File References 1.3.4. Converting Incompatible Components
1.4. Using the Board-Aware Flow in Platform Designer x
1.4.1. Accessing FPGA Design Examples 1.4.2. Specifying the Target Board for a Platform Designer System 1.4.3. Generating Board and Preset Files for Existing Systems
1.4.2. Specifying the Target Board for a Platform Designer System x
1.4.2.1. Changing the Target Board for a Platform Designer System 1.4.2.2. Using Board Files
1.4.2.2. Using Board Files x
1.4.2.2.1. Creating a New Board File 1.4.2.2.2. Create New Board Dialog Box Options 1.4.2.2.3. Viewing or Deleting Board Files
1.4.3. Generating Board and Preset Files for Existing Systems x
1.4.3.1. Generating Board and Preset Files for Existing Systems Using Platform Designer 1.4.3.2. Generating Presets for Existing Systems with Multiple Instances 1.4.3.3. Generating Board and Presets for Existing Systems Using Command Line 1.4.3.4. Preset Files Saved
1.5. Viewing a Platform Designer System x
1.5.1. Viewing the System Hierarchy 1.5.2. Filtering the System View 1.5.3. Viewing Clock and Reset Domains 1.5.4. Viewing System Connections 1.5.5. Viewing Avalon® Memory-Mapped Domains in a System 1.5.6. Viewing the System Schematic 1.5.7. Customizing the Platform Designer Layout 1.5.8. Changing the Platform Designer Font
1.5.3. Viewing Clock and Reset Domains x
1.5.3.1. Viewing Clock Domains in a System 1.5.3.2. Viewing Reset Domains in a System
1.6. Adding IP Components to a System x
1.6.1. Modifying IP Parameters 1.6.2. Applying Preset Parameters for Specific Applications 1.6.3. Creating IP Presets Targeting Specific Boards 1.6.4. Applying Presets After Migrating a Board 1.6.5. Adding Third-Party IP Components 1.6.6. Specifying IP Component Instantiation Options 1.6.7. Creating or Opening an IP Core Variant
1.6.1. Modifying IP Parameters x
1.6.1.1. Viewing Component or Parameter Details 1.6.1.2. Viewing a Component's Block Symbol
1.6.2. Applying Preset Parameters for Specific Applications x
1.6.2.1. Customizing IP Presets
1.6.3. Creating IP Presets Targeting Specific Boards x
1.6.3.1. Creating IP Presets 1.6.3.2. Defining Preset Pin Assignments 1.6.3.3. Viewing, Applying, and Deleting IP Presets 1.6.3.4. Auto-Exporting IP Preset Interfaces and Pins 1.6.3.5. Editing Pin Assignments for Presets 1.6.3.6. Viewing IP Presets In Board Catalog
1.6.3.2. Defining Preset Pin Assignments x
1.6.3.2.1. Defining Preset Pin Assignments in Pin Assignments Tab 1.6.3.2.2. Defining Preset Pin Assignments in a Pin File
1.6.4. Applying Presets After Migrating a Board x
1.6.4.1. Comparing and Applying IP Presets
1.6.5. Adding Third-Party IP Components x
1.6.5.1. IP Search Path Recursive Search 1.6.5.2. Defining the IP Search Path with Index Files
1.6.5.1. IP Search Path Recursive Search x
1.6.5.1.1. IP Search Path Precedence 1.6.5.1.2. IP Component Description Files
1.6.6. Specifying IP Component Instantiation Options x
1.6.6.1. Component Implementation Type Options
1.7. Connecting System Components x
1.7.1. Platform Designer 64-Bit Addressing Support 1.7.2. Connecting Hosts and Agents 1.7.3. Connecting NoC IP in Platform Designer 1.7.4. Wire-Level Connectivity
1.7.1. Platform Designer 64-Bit Addressing Support x
1.7.1.1. Support for Avalon® Memory Mapped Non-Power of Two Data Widths
1.7.4. Wire-Level Connectivity x
1.7.4.1. Editing Wire-Level Expressions 1.7.4.2. Wire-Level Expression Syntax 1.7.4.3. Adding or Removing Ports from Wire-Level Endpoint Interfaces 1.7.4.4. Scripting Wire-Level Expressions
1.8. Specifying Interconnect Parameters x
1.8.1. Interconnect Parameters 1.8.2. Previewing the System Interconnect
1.10. Specifying Signal and Interface Boundary Requirements x
1.10.1. Interface Requirements Tab Fields 1.10.2. Editing Exported Interface Signal Names
1.11. Configuring Platform Designer System Security x
1.11.1. System Security Options 1.11.2. Specifying a Default Avalon Agent or AXI Subordinate 1.11.3. Accessing Undefined Memory Regions
1.13. Synchronizing System Component Information x
1.13.1. System Info Tab Fields
1.14. Validating System Integrity x
1.14.1. Validating the System Integrity of Individual Components
1.16. Generating a Platform Designer System x
1.16.1. Generation Dialog Box Options 1.16.2. Specifying the Generation ID 1.16.3. Disabling or Enabling Parallel IP Generation 1.16.4. Files Generated for Platform Designer Systems 1.16.5. Generating System Testbench Files 1.16.6. Generating Example Designs for IP Components 1.16.7. Incremental System Generation Example 1.16.8. Generating the HPS IP Component System View Description File 1.16.9. Generating Header Files for Host Components
1.16.5. Generating System Testbench Files x
1.16.5.1. Platform Designer Testbench Files
1.17. Generating Simulation Files for Platform Designer Systems and IP Variants x
1.17.1. Using the Qrun Flow 1.17.2. Adding Assertion Monitors for Simulation
1.17.1. Using the Qrun Flow x
1.17.1.1. Specifying Simulation File Generation Settings 1.17.1.2. Generating the Simulation Model and Setup Scripts 1.17.1.3. Generating the Testbench System 1.17.1.4. Generating Example Design Simulation Files
1.19. Managing Hierarchical Platform Designer Systems x
1.19.1. Adding a Subsystem to a Platform Designer System 1.19.2. Viewing and Traversing Subsystem Contents 1.19.3. Editing a Subsystem 1.19.4. Saving a Subsystem 1.19.5. Changing a Component's Hierarchy Level
1.20. Saving and Archiving Platform Designer Systems x
1.20.1. Saving Platform Designer Systems 1.20.2. Archiving Platform Designer Systems 1.20.3. Including Platform Designer Systems in Project Archives
1.20.3. Including Platform Designer Systems in Project Archives x
1.20.3.1. Project Files to Include In External Revision Control
1.21. Sharing Platform Designer Packaged Subsystems x
1.21.1. User Personas for Packaged Subsystems 1.21.2. Terminology for Packaged Subsystems 1.21.3. Creating a New Packaged Subsystem 1.21.4. Specifying Additional Packaged Subsystem Files 1.21.5. Modifying the Packaged Subsystem Script 1.21.6. Instantiating a Packaged Subsystem 1.21.7. Revising a Packaged Subsystem 1.21.8. New Packaged Subsystem Dialog Box Options and Controls
1.22. Comparing Platform Designer Systems and IP components x
1.22.1. Using the System Diff Tool
2. Creating a Board Support Package with BSP Editor x
2.1. Creating a BSP from Platform Designer 2.2. Opening a BSP from Platform Designer 2.3. Saving a BSP from Platform Designer 2.4. Exporting a BSP as Tcl from Platform Designer 2.5. BSP Editor GUI 2.6. Creating a Board Support Package with BSP Editor Revision History
2.1. Creating a BSP from Platform Designer x
2.1.1. Create New BSP Dialog Box
2.5. BSP Editor GUI x
2.5.1. Main Tab 2.5.2. BSP Software Packages Tab 2.5.3. BSP Drivers Tab 2.5.4. BSP Linker Script Tab 2.5.5. BSP Enable File Generation Tab 2.5.6. BSP Target Directory Tab 2.5.7. Messages Tabs
2.5.4. BSP Linker Script Tab x
2.5.4.1. Linker Section Mappings 2.5.4.2. Linker Regions
3. Creating Platform Designer Components x
3.1. Platform Designer Components 3.2. Design Phases of an IP Component 3.3. Creating IP Components in the Component Editor 3.4. Creating Generic Components in a System 3.5. Exporting HDL Parameters to a System 3.6. Scripting Wire-Level Expressions 3.7. Control Interfaces Dynamically with an Elaboration Callback 3.8. Control File Generation Dynamically with Parameters and a Fileset Callback 3.9. Create a Composed Component or Subsystem 3.10. Add Component Instances to a Static or Generated Component 3.11. Add IP RTL Core Generated from the Intel® oneAPI Base Toolkit 3.12. Creating Platform Designer Components Revision History
3.1. Platform Designer Components x
3.1.1. Platform Designer Interface Support 3.1.2. Component Structure 3.1.3. Component File Organization 3.1.4. Component Versions
3.1.4. Component Versions x
3.1.4.1. Upgrade IP Components to the Latest Version
3.3. Creating IP Components in the Component Editor x
3.3.1. Save an IP Component and Create the _hw.tcl File 3.3.2. Edit an IP Component with the Platform Designer Component Editor 3.3.3. Specify IP Component Type Information 3.3.4. Create an HDL File in the Platform Designer Component Editor 3.3.5. Defining HDL Parameters in _hw.tcl 3.3.6. Declaring SystemVerilog Interfaces in _hw.tcl 3.3.7. Create an HDL File Using a Template in the Platform Designer Component Editor 3.3.8. Specify Synthesis and Simulation Files in the Platform Designer Component Editor 3.3.9. Add Signals and Interfaces in the Platform Designer Component Editor 3.3.10. Specify Parameters in the Platform Designer Component Editor _hw.tcl Created from Entries in the Parameters Tab
3.3.8. Specify Synthesis and Simulation Files in the Platform Designer Component Editor x
3.3.8.1. Specify HDL Files for Synthesis in the Platform Designer Component Editor 3.3.8.2. Analyze Synthesis Files in the Platform Designer Component Editor 3.3.8.3. Specify Files for Simulation in the Component Editor 3.3.8.4. Include an Internal Register Map Description in the .svd for Agent Interfaces Connected to an HPS Component
3.3.10. Specify Parameters in the Platform Designer Component Editor x
_hw.tcl Created from Entries in the Parameters Tab 3.3.10.1. Valid Ranges for Parameters in the _hw.tcl File 3.3.10.2. Types of Platform Designer Parameters 3.3.10.3. Obtaining Device Trait Information Using PART_TRAIT System Information Parameter 3.3.10.4. Declare Parameters with Custom _hw.tcl Commands 3.3.10.5. Validate Parameter Values with a Validation Callback
3.3.10.2. Types of Platform Designer Parameters x
3.3.10.2.1. Platform Designer User Parameters 3.3.10.2.2. Platform Designer System Information Parameters 3.3.10.2.3. Parameterized Parameter Widths 3.3.10.2.4. Platform Designer Derived Parameters
3.4. Creating Generic Components in a System x
3.4.1. Adding Generic HDL Component Parameters 3.4.2. Adding Generic Blackbox Component Parameters 3.4.3. Adding Generic Component Interfaces and Signals 3.4.4. Creating a System Template for a Generic Component 3.4.5. Exporting a Generic Component
3.4.3. Adding Generic Component Interfaces and Signals x
3.4.3.1. Mirroring Interfaces in a Generic Component 3.4.3.2. Cloning Interfaces in a Generic Component 3.4.3.3. Importing Interfaces to a Generic Component
3.5. Exporting HDL Parameters to a System x
3.5.1. HDL Parameters Tab Settings and Controls
3.10. Add Component Instances to a Static or Generated Component x
3.10.1. Static IP Components 3.10.2. Generated Components 3.10.3. Design Guidelines for Adding Component Instances
4. Optimizing Platform Designer System Performance x
4.1. Designing with Avalon® and AXI Interfaces 4.2. Using Hierarchy in Systems 4.3. Using Concurrency in Memory-Mapped Systems 4.4. Inserting Pipeline Stages to Increase System Frequency 4.5. Using Bridges 4.6. Increasing Transfer Throughput 4.7. Reducing Logic Utilization 4.8. Reducing Power Consumption 4.9. Reset Polarity and Synchronization in Platform Designer 4.10. Optimizing Platform Designer System Performance Design Examples 4.11. Optimizing Platform Designer System Performance Revision History
4.1. Designing with Avalon® and AXI Interfaces x
4.1.1. Designing Streaming Components 4.1.2. Designing Memory-Mapped Components
4.3. Using Concurrency in Memory-Mapped Systems x
4.3.1. Implementing Concurrency With Multiple Hosts 4.3.2. Implementing Concurrency With Multiple Agents 4.3.3. Implementing Concurrency with DMA Engines
4.5. Using Bridges x
4.5.1. Using Bridges to Increase System Frequency 4.5.2. Using Bridges to Minimize Design Logic 4.5.3. Using Bridges to Minimize Adapter Logic 4.5.4. Considering the Effects of Using Bridges
4.5.1. Using Bridges to Increase System Frequency x
4.5.1.1. Inserting Pipeline Bridges 4.5.1.2. Using Clock Crossing Bridges
4.5.1.1. Inserting Pipeline Bridges x
4.5.1.1.1. Implementing Command Pipelining (Host-to-Agent) 4.5.1.1.2. Implementing Response Pipelining (Agent-to-Host)
4.5.2. Using Bridges to Minimize Design Logic x
4.5.2.1. Avoiding Speed Optimizations That Increase Logic 4.5.2.2. Limiting Concurrency
4.5.3. Using Bridges to Minimize Adapter Logic x
4.5.3.1. Determining Effective Placement of Bridges 4.5.3.2. Changing the Response Buffer Depth
4.5.4. Considering the Effects of Using Bridges x
4.5.4.1. Increased Latency 4.5.4.2. Limited Concurrency 4.5.4.3. Address Space Translation 4.5.4.4. Address Coherency
4.5.4.1. Increased Latency x
4.5.4.1.1. Acceptable Latency Increase 4.5.4.1.2. Unacceptable Latency Increase
4.6. Increasing Transfer Throughput x
4.6.1. Using Pipelined Transfers 4.6.2. Arbitration Shares and Bursts
4.6.1. Using Pipelined Transfers x
4.6.1.1. Using the Maximum Pending Reads Parameter
4.6.2. Arbitration Shares and Bursts x
4.6.2.1. Differences Between Arbitration Shares and Bursts 4.6.2.2. Choosing Avalon® Memory Mapped Interface Types 4.6.2.3. Avalon® Memory Mapped Burst Host Example
4.6.2.2. Choosing Avalon® Memory Mapped Interface Types x
4.6.2.2.1. Simple Avalon® Memory Mapped Interfaces 4.6.2.2.2. Pipelined Avalon® Memory Mapped Interfaces 4.6.2.2.3. Burst Avalon® Memory Mapped Interfaces
4.7. Reducing Logic Utilization x
4.7.1. Minimizing Interconnect Logic to Reduce Logic Unitization 4.7.2. Minimizing Arbitration Logic by Consolidating Multiple Interfaces 4.7.3. Reducing Logic Utilization With Multiple Clock Domains 4.7.4. Duration of Transfers Crossing Clock Domains
4.7.1. Minimizing Interconnect Logic to Reduce Logic Unitization x
4.7.1.1. Creating Dedicated Host and Agent Connections to Minimize Interconnect Logic 4.7.1.2. Removing Unnecessary Connections to Minimize Interconnect Logic 4.7.1.3. Simplifying Address Decode Logic
4.7.2. Minimizing Arbitration Logic by Consolidating Multiple Interfaces x
4.7.2.1. Logic Consolidation Trade-Offs 4.7.2.2. Consolidating Interfaces
4.8. Reducing Power Consumption x
4.8.1. Reducing Power Consumption With Multiple Clock Domains 4.8.2. Reducing Power Consumption by Minimizing Toggle Rates 4.8.3. Reducing Power Consumption by Disabling Logic
4.10. Optimizing Platform Designer System Performance Design Examples x
4.10.1. Avalon Pipelined Read Host Example 4.10.2. Multiplexer Examples
4.10.1. Avalon Pipelined Read Host Example x
4.10.1.1. Avalon Pipelined Read Host Example Design Requirements 4.10.1.2. Expected Throughput Improvement
5. Platform Designer Interconnect x
5.1. Memory-Mapped Interfaces 5.2. Avalon® Streaming Interfaces 5.3. Avalon® Streaming Credit Interfaces 5.4. Interrupt Interfaces 5.5. Clock Interfaces 5.6. Reset Interfaces 5.7. Conduits 5.8. Interconnect Pipelining 5.9. Error Correction Coding (ECC) in Platform Designer Interconnect 5.10. AMBA* 3 AXI Protocol Specification Support (version 1.0) 5.11. AMBA* 3 APB Protocol Specification Support (version 1.0) 5.12. AMBA* 4 AXI Memory-Mapped Interface Support (version 2.0) 5.13. AMBA* 4 AXI Streaming Interface Support (version 1.0) 5.14. AMBA* 4 AXI-Lite Protocol Specification Support (version 2.0) 5.15. Port Roles (Interface Signal Types) 5.16. Platform Designer Interconnect Revision History
5.1. Memory-Mapped Interfaces x
5.1.1. Platform Designer Packet Format 5.1.2. Interconnect Domains 5.1.3. Avalon Host and AXI Manager Network Interfaces 5.1.4. Avalon Agent and AXI Subordinate Network Interfaces 5.1.5. Arbitration 5.1.6. Memory-Mapped Arbiter 5.1.7. Datapath Multiplexing Logic 5.1.8. Width Adaptation 5.1.9. Burst Adapter 5.1.10. Waitrequest Allowance Adapter 5.1.11. Read and Write Responses 5.1.12. Platform Designer Address Decoding
5.1.1. Platform Designer Packet Format x
5.1.1.1. Fields in the Platform Designer Packet Format 5.1.1.2. Transaction Types for Memory-Mapped Interfaces 5.1.1.3. Platform Designer Transformations
5.1.2. Interconnect Domains x
5.1.2.1. Using One Domain with Width Adaptation 5.1.2.2. Using Two Separate Domains
5.1.3. Avalon Host and AXI Manager Network Interfaces x
5.1.3.1. Avalon® Memory Mapped Host Agent 5.1.3.2. Avalon® Memory Mapped Host Translator 5.1.3.3. AXI Manager Agent 5.1.3.4. AXI Translator 5.1.3.5. APB Manager Agent 5.1.3.6. APB Subordinate Agent 5.1.3.7. APB Translator 5.1.3.8. AHB Subordinate Agent 5.1.3.9. Memory-Mapped Router 5.1.3.10. Memory-Mapped Traffic Limiter
5.1.4. Avalon Agent and AXI Subordinate Network Interfaces x
5.1.4.1. Avalon® Memory Mapped Agent Translator 5.1.4.2. AXI Translator 5.1.4.3. Wait State Insertion 5.1.4.4. Avalon® Memory Mapped Agent Component 5.1.4.5. AXI Subordinate Agent
5.1.5. Arbitration x
5.1.5.1. Round-Robin Arbitration 5.1.5.2. Fixed Priority Arbitration
5.1.5.1. Round-Robin Arbitration x
5.1.5.1.1. Fairness-Based Shares 5.1.5.1.2. Round-Robin Scheduling
5.1.5.2. Fixed Priority Arbitration x
5.1.5.2.1. Designate a Platform Designer Agent to Use Fixed Priority Arbitration 5.1.5.2.2. Fixed Priority Arbitration with AXI Managers and Avalon® Memory Mapped Agents
5.1.8. Width Adaptation x
5.1.8.1. Memory-Mapped Width Adapter
5.1.8.1. Memory-Mapped Width Adapter x
5.1.8.1.1. AXI Wide-to-Narrow Adaptation 5.1.8.1.2. AXI Narrow-to-Wide Adaptation
5.1.9. Burst Adapter x
5.1.9.1. Burst Adapter Implementation Options 5.1.9.2. Burst Adaptation: AXI to Avalon® 5.1.9.3. Burst Adaptation: Avalon® to AXI
5.2. Avalon® Streaming Interfaces x
5.2.1. Avalon® Streaming Adapters
5.2.1. Avalon® Streaming Adapters x
5.2.1.1. Avalon® Streaming Adapter 5.2.1.2. Channel Adapter 5.2.1.3. Data Format Adapter 5.2.1.4. Error Adapter 5.2.1.5. Timing Adapter
5.2.1.1. Avalon® Streaming Adapter x
5.2.1.1.1. Avalon® Streaming Adapter Parameters Common to Source and Sink Interfaces 5.2.1.1.2. Avalon® Streaming Adapter Upstream Source Interface Parameters 5.2.1.1.3. Avalon® Streaming Adapter Downstream Sink Interface Parameters
5.2.1.2. Channel Adapter x
5.2.1.2.1. Avalon® Streaming Channel Adapter Input Interface Parameters 5.2.1.2.2. Avalon® Streaming Channel Adapter Output Interface Parameters 5.2.1.2.3. Avalon® Streaming Channel Adapter Common to Input and Output Interface Parameters
5.2.1.3. Data Format Adapter x
5.2.1.3.1. Avalon® Streaming Data Format Adapter Input Interface Parameters 5.2.1.3.2. Avalon® Streaming Data Format Adapter Output Interface Parameters 5.2.1.3.3. Avalon® Streaming Data Format Adapter Common to Input and Output Interface Parameters
5.2.1.4. Error Adapter x
5.2.1.4.1. Avalon® Streaming Error Adapter Input Interface Parameters 5.2.1.4.2. Avalon® Streaming Error Adapter Output Interface Parameters 5.2.1.4.3. Avalon® Streaming Error Adapter Common to Input and Output Interface Parameters
5.2.1.5. Timing Adapter x
5.2.1.5.1. Avalon® Streaming Timing Adapter Input Interface Parameters 5.2.1.5.2. Avalon® Streaming Timing Adapter Output Interface Parameters 5.2.1.5.3. Avalon® Streaming Timing Adapter Common to Input and Output Interface Parameters
5.3. Avalon® Streaming Credit Interfaces x
5.3.1. Terms and Concepts 5.3.2. Avalon® Streaming Credit Adapters 5.3.3. Avalon® Streaming Credit Multiplexer 5.3.4. Avalon® Streaming Credit Demultiplexer 5.3.5. Avalon® Streaming Credit Pipeline Bridge
5.3.2. Avalon® Streaming Credit Adapters x
5.3.2.1. Avalon® Streaming Credit Wide to Narrow Adapter 5.3.2.2. Avalon® Streaming Credit Narrow to Wide Adapter 5.3.2.3. Avalon® Streaming Credit Max Credit Adapter 5.3.2.4. Avalon® Streaming Ready to Credit Adapter 5.3.2.5. Avalon® Streaming Credit to Ready Adapter
5.3.2.1. Avalon® Streaming Credit Wide to Narrow Adapter x
5.3.2.1.1. Avalon® Streaming Credit Wide to Narrow Adapter Interface Parameters 5.3.2.1.2. Avalon® Streaming Credit Wide to Narrow Adapter Interface Signals
5.3.2.2. Avalon® Streaming Credit Narrow to Wide Adapter x
5.3.2.2.1. Avalon® Streaming Credit Narrow to Wide Adapter Interface Parameters 5.3.2.2.2. Avalon® Streaming Credit Narrow to Wide Adapter Interface Signals
5.3.2.3. Avalon® Streaming Credit Max Credit Adapter x
5.3.2.3.1. Avalon® Streaming Credit Max Credit Adapter Interface Parameters 5.3.2.3.2. Avalon® Streaming Credit Max Credit Adapter Interface Signals
5.3.2.4. Avalon® Streaming Ready to Credit Adapter x
5.3.2.4.1. Avalon® Streaming Ready to Credit Adapter Interface Parameters 5.3.2.4.2. Avalon® Streaming Ready to Credit Adapter Interface Signals
5.3.2.5. Avalon® Streaming Credit to Ready Adapter x
5.3.2.5.1. Avalon® Streaming Credit to Ready Adapter Interface Parameters 5.3.2.5.2. Avalon® Streaming Credit to Ready Adapter Interface Signals
5.3.3. Avalon® Streaming Credit Multiplexer x
5.3.3.1. Avalon® Streaming Credit Multiplexer Parameters 5.3.3.2. Avalon® Streaming Credit Multiplexer Interface Signals
5.3.4. Avalon® Streaming Credit Demultiplexer x
5.3.4.1. Avalon® Streaming Credit Demultiplexer Parameters 5.3.4.2. Avalon® Streaming Credit Demultiplexer Interface Signals
5.3.5. Avalon® Streaming Credit Pipeline Bridge x
5.3.5.1. Avalon® Streaming Credit Pipeline Bridge Parameters 5.3.5.2. Avalon® Streaming Credit Pipeline Bridge Interface Signals
5.4. Interrupt Interfaces x
5.4.1. Individual Requests IRQ Scheme 5.4.2. Assigning IRQs in Platform Designer
5.4.2. Assigning IRQs in Platform Designer x
5.4.2.1. IRQ Bridge 5.4.2.2. IRQ Mapper 5.4.2.3. IRQ Clock Crosser 5.4.2.4. IRQ Fanout
5.5. Clock Interfaces x
5.5.1. (High Speed Serial Interface) HSSI Clock Interfaces
5.5.1. (High Speed Serial Interface) HSSI Clock Interfaces x
5.5.1.1. HSSI Serial Clock Interface 5.5.1.2. HSSI Bonded Clock Interface
5.5.1.1. HSSI Serial Clock Interface x
5.5.1.1.1. HSSI Serial Clock Source 5.5.1.1.2. HSSI Serial Clock Sink 5.5.1.1.3. HSSI Serial Clock Connection 5.5.1.1.4. HSSI Serial Clock Example
5.5.1.2. HSSI Bonded Clock Interface x
5.5.1.2.1. HSSI Bonded Clock Source 5.5.1.2.2. HSSI Bonded Clock Sink 5.5.1.2.3. HSSI Bonded Clock Connection 5.5.1.2.4. HSSI Bonded Clock Example
5.6. Reset Interfaces x
5.6.1. Single Global Reset Signal Implemented by Platform Designer 5.6.2. Reset Controller 5.6.3. Reset Bridge 5.6.4. Reset Sequencer
5.6.4. Reset Sequencer x
5.6.4.1. Reset Sequencer Parameters 5.6.4.2. Reset Sequencer Timing Diagrams 5.6.4.3. Reset Sequencer CSR Registers 5.6.4.4. Reset Sequencer Software Flows
5.6.4.3. Reset Sequencer CSR Registers x
5.6.4.3.1. Reset Sequencer Status Register 5.6.4.3.2. Reset Sequencer Interrupt Enable Register 5.6.4.3.3. Reset Sequencer Control Register 5.6.4.3.4. Reset Sequencer Software Sequenced Reset Assert Control Register 5.6.4.3.5. Reset Sequencer Software Sequenced Reset Deassert Control Register 5.6.4.3.6. Reset Sequencer Software Direct Controlled Resets 5.6.4.3.7. Reset Sequencer Software Reset Masking
5.6.4.4. Reset Sequencer Software Flows x
5.6.4.4.1. Reset Sequencer (Software-Triggered) Flow 5.6.4.4.2. Reset Assert Flow 5.6.4.4.3. Reset Deassert Flow 5.6.4.4.4. Reset Assert (Software Sequenced) Flow 5.6.4.4.5. Reset Deassert (Software Sequenced) Flow
5.8. Interconnect Pipelining x
5.8.1. Add Pipeline Stages to the Interconnect Schematic
5.10. AMBA* 3 AXI Protocol Specification Support (version 1.0) x
5.10.1. Channels 5.10.2. Cache Support 5.10.3. Security Support 5.10.4. Atomic Accesses 5.10.5. Response Signaling 5.10.6. Ordering Model 5.10.7. Data Buses 5.10.8. Unaligned Address Commands 5.10.9. Avalon® and AXI Transaction Support
5.10.1. Channels x
5.10.1.1. Read and Write Address Channels 5.10.1.2. Write Data, Write Response, and Read Data Channels 5.10.1.3. Low Power Channel
5.10.2. Cache Support x
5.10.2.1. Bufferable 5.10.2.2. Cacheable (Modifiable)
5.10.6. Ordering Model x
5.10.6.1. AXI and Avalon® Ordering
5.10.9. Avalon® and AXI Transaction Support x
5.10.9.1. Transaction Cannot Cross 4KB Boundaries 5.10.9.2. Adjacent Bytelanes with Partial Width Transactions 5.10.9.3. Handling Read Side Effects
5.11. AMBA* 3 APB Protocol Specification Support (version 1.0) x
5.11.1. Bridges 5.11.2. Burst Adaptation 5.11.3. Width Adaptation 5.11.4. Error Response
5.12. AMBA* 4 AXI Memory-Mapped Interface Support (version 2.0) x
5.12.1. Burst Support 5.12.2. QoS 5.12.3. Regions 5.12.4. Write Response Dependency 5.12.5. AWCACHE and ARCACHE 5.12.6. Width Adaptation and Data Packing in Platform Designer 5.12.7. Ordering Model 5.12.8. Read and Write Allocate 5.12.9. Locked Transactions 5.12.10. Memory Types 5.12.11. Mismatched Attributes 5.12.12. Signals
5.13. AMBA* 4 AXI Streaming Interface Support (version 1.0) x
5.13.1. Connection Points 5.13.2. Adaptation
5.13.1. Connection Points x
5.13.1.1. AMBA* 4 AXI Streaming Connection Point Parameters 5.13.1.2. AMBA* 4 AXI Streaming Connection Point Signals
5.14. AMBA* 4 AXI-Lite Protocol Specification Support (version 2.0) x
5.14.1. AMBA* 4 AXI-Lite Signals 5.14.2. AMBA* 4 AXI-Lite Optional Port Support and Interconnect 5.14.3. AMBA* 4 AXI-Lite Bus Width 5.14.4. AMBA* 4 AXI-Lite Outstanding Transactions 5.14.5. AMBA* 4 AXI-Lite IDs 5.14.6. Connections Between AMBA* 3 AXI, AMBA* 4 AXI and AMBA* 4 AXI-Lite 5.14.7. AMBA* 4 AXI-Lite Response Merging
5.14.6. Connections Between AMBA* 3 AXI, AMBA* 4 AXI and AMBA* 4 AXI-Lite x
5.14.6.1. AMBA* 4 AXI-Lite Subordinate Requirements 5.14.6.2. AMBA* 4 AXI-Lite Data Packing
5.15. Port Roles (Interface Signal Types) x
5.15.1. AXI Manager Interface Signal Types 5.15.2. AXI Subordinate Interface Signal Types 5.15.3. AMBA* 4 AXI Manager Interface Signal Types 5.15.4. AMBA* 4 AXI Subordinate Interface Signal Types 5.15.5. AMBA* 4 AXI-Stream Manager and Subordinate Interface Signal Types 5.15.6. AMBA* 4 AXI-Lite Signal Support and Limitations 5.15.7. APB Interface Signal Types 5.15.8. Avalon® Memory Mapped Interface Signal Roles 5.15.9. Avalon® Streaming Interface Signal Roles 5.15.10. Avalon® Streaming Credit Interface Signal Roles 5.15.11. Avalon® Streaming Credit User Signals 5.15.12. Avalon® Clock Source Signal Roles 5.15.13. Avalon® Clock Sink Signal Roles 5.15.14. Avalon® Conduit Signal Roles 5.15.15. Avalon® Tristate Conduit Signal Roles 5.15.16. Avalon® Tri-State Agent Interface Signal Types 5.15.17. Avalon® Interrupt Sender Signal Roles 5.15.18. Avalon® Interrupt Receiver Signal Roles
5.15.6. AMBA* 4 AXI-Lite Signal Support and Limitations x
5.15.6.1. ACE-Lite Transaction Support and Limitations
5.15.10. Avalon® Streaming Credit Interface Signal Roles x
5.15.10.1. Synchronous Interface 5.15.10.2. Typical Data Transfers 5.15.10.3. Returning the Credits
5.15.11. Avalon® Streaming Credit User Signals x
5.15.11.1. Per-Symbol User Signal 5.15.11.2. Per-Packet User Signal
6. Platform Designer System Design Components x
6.1. Bridges 6.2. Error Response Slave Intel® FPGA IP 6.3. Tri-State Components 6.4. Avalon® Data Pattern Generator and Checker Intel® FPGA IP 6.5. Avalon® Streaming Splitter Intel® FPGA IP 6.6. Avalon® Streaming Delay Intel® FPGA IP 6.7. Avalon® Streaming Round Robin Scheduler Intel® FPGA IP 6.8. Avalon® Packets to Transactions Converter Intel® FPGA IP 6.9. Avalon® Streaming Pipeline Stage Intel® FPGA IP 6.10. Avalon® Streaming Multiplexer and Demultiplexer Intel® FPGA IP 6.11. Avalon® Streaming Single-Clock and Dual-Clock FIFO Intel® FPGA IP 6.12. Platform Designer System Design Components Revision History
6.1. Bridges x
6.1.1. Clock Bridge Intel® FPGA IP 6.1.2. Avalon® Memory Mapped Clock Crossing Bridge Intel® FPGA IP 6.1.3. Avalon® Memory Mapped Pipeline Bridge Intel® FPGA IP 6.1.4. Avalon® Memory Mapped Unaligned Burst Expansion Bridge Intel® FPGA IP 6.1.5. Bridges Between Avalon® and AXI Interfaces 6.1.6. AXI Bridge Intel® FPGA IP 6.1.7. AXI Timeout Bridge Intel® FPGA IP 6.1.8. Address Span Extender Intel® FPGA IP
6.1.2. Avalon® Memory Mapped Clock Crossing Bridge Intel® FPGA IP x
6.1.2.1. Avalon® Memory Mapped Clock Crossing Bridge Example 6.1.2.2. Avalon® Memory Mapped Clock Crossing Bridge Parameters
6.1.4. Avalon® Memory Mapped Unaligned Burst Expansion Bridge Intel® FPGA IP x
6.1.4.1. Using the Avalon® Memory Mapped Unaligned Burst Expansion Bridge 6.1.4.2. Avalon® Memory Mapped Unaligned Burst Expansion Bridge Parameters 6.1.4.3. Avalon® Memory Mapped Unaligned Burst Expansion Bridge Example
6.1.6. AXI Bridge Intel® FPGA IP x
6.1.6.1. AXI Bridge Signal Types 6.1.6.2. AXI Bridge Parameters 6.1.6.3. AXI Bridge Subordinate and Manager Interface Parameters
6.1.7. AXI Timeout Bridge Intel® FPGA IP x
6.1.7.1. AXI Timeout Bridge Stages 6.1.7.2. AXI Timeout Bridge Parameters
6.1.8. Address Span Extender Intel® FPGA IP x
6.1.8.1. CTRL Register Layout 6.1.8.2. Address Span Extender Parameters 6.1.8.3. Calculating the Address Span Extender Agent Address 6.1.8.4. Using the Address Span Extender 6.1.8.5. Alternate Options for the Address Span Extender 6.1.8.6. Nios® II Support
6.2. Error Response Slave Intel® FPGA IP x
6.2.1. Error Response Slave Parameters 6.2.2. Error Response Slave CSR Registers 6.2.3. Designating a Default Agent
6.2.2. Error Response Slave CSR Registers x
6.2.2.1. Error Response Slave Access Violation Service 6.2.2.2. CSR Interrupt Status Registers 6.2.2.3. CSR Read Access Violation Log Registers 6.2.2.4. CSR Write Access Violation Log Registers
6.3. Tri-State Components x
6.3.1. Generic Tri-State Controller Intel® FPGA IP 6.3.2. Tri-State Conduit Pin Sharer Intel® FPGA IP 6.3.3. Tri-State Conduit Bridge Intel® FPGA IP
6.4. Avalon® Data Pattern Generator and Checker Intel® FPGA IP x
6.4.1. Avalon® Data Pattern Generator Intel® FPGA IP 6.4.2. Avalon® Data Pattern Checker Intel® FPGA IP 6.4.3. Avalon® Data Pattern Generator and Checker IP Software Programming Model 6.4.4. Avalon® Data Pattern Generator IP API 6.4.5. Avalon® Data Pattern Checker IP API
6.4.1. Avalon® Data Pattern Generator Intel® FPGA IP x
6.4.1.1. Avalon® Data Pattern Generator IP Command Interface 6.4.1.2. Avalon® Data Pattern Generator IP Control and Status Interface 6.4.1.3. Avalon® Data Pattern Generator IP Output Interface 6.4.1.4. Avalon® Data Pattern Generator IP Functional Parameter
6.4.2. Avalon® Data Pattern Checker Intel® FPGA IP x
6.4.2.1. Avalon® Data Pattern Checker IP Input Interface 6.4.2.2. Avalon® Data Pattern Checker IP Control and Status Interface 6.4.2.3. Avalon® Data Pattern Checker IP Functional Parameter 6.4.2.4. Avalon® Data Pattern Checker Input Parameters
6.4.3. Avalon® Data Pattern Generator and Checker IP Software Programming Model x
6.4.3.1. HAL System Library Support 6.4.3.2. Avalon® Data Pattern Generator and Checker IP Files 6.4.3.3. Avalon® Data Pattern Generator and Checker IP Register Maps
6.4.3.3. Avalon® Data Pattern Generator and Checker IP Register Maps x
6.4.3.3.1. Avalon® Data Pattern Generator IP Control and Status Registers 6.4.3.3.2. Avalon® Data Pattern Generator IP Command Registers 6.4.3.3.3. Avalon® Data Pattern Checker IP Control and Status Registers
6.4.4. Avalon® Data Pattern Generator IP API x
6.4.4.1. data_source_reset() 6.4.4.2. data_source_init() 6.4.4.3. data_source_get_id() 6.4.4.4. data_source_get_supports_packets() 6.4.4.5. data_source_get_num_channels() 6.4.4.6. data_source_get_symbols_per_cycle() 6.4.4.7. data_source_get_enable() 6.4.4.8. data_source_set_enable() 6.4.4.9. data_source_get_throttle() 6.4.4.10. data_source_set_throttle() 6.4.4.11. data_source_is_busy() 6.4.4.12. data_source_fill_level() 6.4.4.13. data_source_send_data()
6.4.5. Avalon® Data Pattern Checker IP API x
6.4.5.1. data_sink_reset() 6.4.5.2. data_sink_init() 6.4.5.3. data_sink_get_id() 6.4.5.4. data_sink_get_supports_packets() 6.4.5.5. data_sink_get_num_channels() 6.4.5.6. data_sink_get_symbols_per_cycle() 6.4.5.7. data_sink_get_enable() 6.4.5.8. data_sink_set enable() 6.4.5.9. data_sink_get_throttle() 6.4.5.10. data_sink_set_throttle() 6.4.5.11. data_sink_get_packet_count() 6.4.5.12. data_sink_get_error_count() 6.4.5.13. data_sink_get_symbol_count() 6.4.5.14. data_sink_get_exception() 6.4.5.15. data_sink_exception_is_exception() 6.4.5.16. data_sink_exception_has_data_error() 6.4.5.17. data_sink_exception_has_missing_sop() 6.4.5.18. data_sink_exception_has_missing_eop() 6.4.5.19. data_sink_exception_signalled_error() 6.4.5.20. data_sink_exception_channel()
6.5. Avalon® Streaming Splitter Intel® FPGA IP x
6.5.1. Avalon® Streaming Splitter Intel® FPGA IP Backpressure 6.5.2. Avalon® Streaming Splitter Intel® FPGA IP Interfaces 6.5.3. Avalon® Streaming Splitter Intel® FPGA IP Parameters
6.6. Avalon® Streaming Delay Intel® FPGA IP x
6.6.1. Avalon® Streaming Delay Intel® FPGA IP Reset Signal 6.6.2. Avalon® Streaming Delay Intel® FPGA IP Interfaces 6.6.3. Avalon® Streaming Delay Intel® FPGA IP Parameters
6.7. Avalon® Streaming Round Robin Scheduler Intel® FPGA IP x
6.7.1. Avalon® Streaming Round Robin Scheduler IP Almost-Full Status Interface 6.7.2. Avalon® Streaming Round Robin Scheduler IP Request Interface 6.7.3. Avalon® Streaming Round Robin Scheduler IP Operation 6.7.4. Avalon® Streaming Round Robin Scheduler IP Parameters
6.8. Avalon® Packets to Transactions Converter Intel® FPGA IP x
6.8.1. Avalon® Packets to Transactions Converter IP Interfaces 6.8.2. Avalon® Packets to Transactions Converter IP Operation
6.8.2. Avalon® Packets to Transactions Converter IP Operation x
6.8.2.1. Avalon® Packets to Transactions Converter IP Data Packet Formats 6.8.2.2. Avalon® Packets to Transactions Converter IP Supported Transactions 6.8.2.3. Avalon® Packets to Transactions IP Converter Malformed Packets
6.10. Avalon® Streaming Multiplexer and Demultiplexer Intel® FPGA IP x
6.10.1. Avalon® Streaming Multiplexer and Demultiplexer Software Programming Model 6.10.2. Avalon® Streaming Multiplexer Intel® FPGA IP 6.10.3. Avalon® Streaming Demultiplexer Intel® FPGA IP
6.10.2. Avalon® Streaming Multiplexer Intel® FPGA IP x
6.10.2.1. Avalon® Streaming Multiplexer IP Input Interfaces 6.10.2.2. Avalon® Multiplexer IP Output Interface 6.10.2.3. Avalon® Multiplexer IP Parameters
6.10.3. Avalon® Streaming Demultiplexer Intel® FPGA IP x
6.10.3.1. Avalon® Streaming Demultiplexer IP Input Interface 6.10.3.2. Avalon® Streaming Demultiplexer IP Output Interface 6.10.3.3. Avalon® Streaming Demultiplexer IP Parameters
6.11. Avalon® Streaming Single-Clock and Dual-Clock FIFO Intel® FPGA IP x
6.11.1. Interfaces Implemented in FIFO Cores 6.11.2. Avalon® Streaming FIFO IP Operating Modes 6.11.3. Avalon® Streaming FIFO IP Buffer Fill Level 6.11.4. Almost-Full and Almost-Empty Thresholds to Prevent Overflow and Underflow 6.11.5. Avalon® Streaming Single Clock and Dual Clock FIFO IP Parameters 6.11.6. Avalon® Streaming Single-Clock FIFO IP Registers
6.11.1. Interfaces Implemented in FIFO Cores x
6.11.1.1. Avalon® Streaming Data Interface 6.11.1.2. Avalon® Memory Mapped Control and Status Register Interface 6.11.1.3. Avalon® Streaming Status Interface
7. Platform Designer Command-Line Utilities x
7.1. Run the Platform Designer Editor with qsys-edit 7.2. Scripting IP Core Generation 7.3. Board-Aware Flow Scripting Support 7.4. Display Available IP Components with ip-catalog 7.5. Create an .ipx File with ip-make-ipx 7.6. Generate Simulation Scripts 7.7. Generate a Platform Designer System with qsys-script 7.8. Parameterizing an Instantiated IP Core after save_system Command 7.9. Validate the Generic Components in a System with qsys-validate 7.10. Generate an IP Component or Platform Designer System with quartus_ipgenerate 7.11. Generate an IP Variation File with ip-deploy 7.12. Archive and Extract Platform Designer Systems with qsys-archive 7.13. Apply Presets to a New Board 7.14. Platform Designer Scripting Command Reference 7.15. Platform Designer Scripting Property Reference 7.16. Platform Designer Command-Line Utilities Revision History
7.2. Scripting IP Core Generation x
7.2.1. qsys-generate Command-Line Options
7.14. Platform Designer Scripting Command Reference x
7.14.1. System 7.14.2. Subsystems 7.14.3. Domains and Interfaces 7.14.4. Instances 7.14.5. Instantiations 7.14.6. Components 7.14.7. Connections 7.14.8. Top-level Exports 7.14.9. Validation 7.14.10. Miscellaneous 7.14.11. Wire-Level Connection Commands
7.14.1. System x
7.14.1.1. create_system 7.14.1.2. export_hw_tcl 7.14.1.3. get_device_families 7.14.1.4. get_devices 7.14.1.5. get_module_properties 7.14.1.6. get_module_property 7.14.1.7. get_project_properties 7.14.1.8. get_project_property 7.14.1.9. load_system 7.14.1.10. save_system 7.14.1.11. set_design_id 7.14.1.12. set_module_property 7.14.1.13. set_project_property
7.14.2. Subsystems x
7.14.2.1. get_composed_connections 7.14.2.2. get_composed_connection_parameter_value 7.14.2.3. get_composed_connection_parameters 7.14.2.4. get_composed_instance_assignment 7.14.2.5. get_composed_instance_assignments 7.14.2.6. get_composed_instance_parameter_value 7.14.2.7. get_composed_instance_parameters 7.14.2.8. get_composed_instances
7.14.3. Domains and Interfaces x
7.14.3.1. set_domain_assignment 7.14.3.2. get_domain_assignment 7.14.3.3. get_domain_assignments 7.14.3.4. set_interface_assignment 7.14.3.5. get_interface_assignment 7.14.3.6. get_interface_assignments 7.14.3.7. set_postadaptation_assignment 7.14.3.8. get_postadaptation_assignment 7.14.3.9. get_postadaptation_assignments
7.14.4. Instances x
7.14.4.1. add_instance 7.14.4.2. apply_instance_preset 7.14.4.3. create_ip 7.14.4.4. add_component 7.14.4.5. duplicate_instance 7.14.4.6. enable_instance_parameter_update_callback 7.14.4.7. get_instance_assignment 7.14.4.8. get_instance_assignments 7.14.4.9. get_instance_documentation_links 7.14.4.10. get_instance_interface_assignment 7.14.4.11. get_instance_interface_assignments 7.14.4.12. get_instance_interface_parameter_property 7.14.4.13. get_instance_interface_parameter_value 7.14.4.14. get_instance_interface_parameters 7.14.4.15. get_instance_interface_port_property 7.14.4.16. get_instance_interface_ports 7.14.4.17. get_instance_interface_properties 7.14.4.18. get_instance_interface_property 7.14.4.19. get_instance_interfaces 7.14.4.20. get_instance_parameter_property 7.14.4.21. get_instance_parameter_value 7.14.4.22. get_instance_parameter_values 7.14.4.23. get_instance_parameters 7.14.4.24. get_instance_port_property 7.14.4.25. get_instance_properties 7.14.4.26. get_instance_property 7.14.4.27. get_instances 7.14.4.28. is_instance_parameter_update_callback_enabled 7.14.4.29. remove_instance 7.14.4.30. set_instance_parameter_value 7.14.4.31. set_instance_parameter_values 7.14.4.32. set_instance_property
7.14.5. Instantiations x
7.14.5.1. add_instantiation_hdl_file 7.14.5.2. add_instantiation_interface 7.14.5.3. add_instantiation_interface_port 7.14.5.4. copy_instance_interface_to_instantiation 7.14.5.5. get_instantiation_assignment_value 7.14.5.6. get_instantiation_assignments 7.14.5.7. get_instantiation_hdl_file_properties 7.14.5.8. get_instantiation_hdl_file_property 7.14.5.9. get_instantiation_hdl_files 7.14.5.10. get_instantiation_interface_assignment_value 7.14.5.11. get_instantiation_interface_assignments 7.14.5.12. get_instantiation_interface_parameter_value 7.14.5.13. get_instantiation_interface_parameters 7.14.5.14. get_instantiation_interface_port_properties 7.14.5.15. get_instantiation_interface_port_property 7.14.5.16. get_instantiation_interface_ports 7.14.5.17. get_instantiation_interface_property 7.14.5.18. get_instantiation_interface_properties 7.14.5.19. get_instantiation_interface_sysinfo_parameter_value 7.14.5.20. get_instantiation_interface_sysinfo_parameters 7.14.5.21. get_instantiation_interfaces 7.14.5.22. get_instantiation_properties 7.14.5.23. get_instantiation_property 7.14.5.24. get_loaded_instantiation 7.14.5.25. import_instantiation_interfaces 7.14.5.26. load_instantiation 7.14.5.27. remove_instantiation_hdl_file 7.14.5.28. remove_instantiation_interface 7.14.5.29. remove_instantiation_interface_port 7.14.5.30. save_instantiation 7.14.5.31. set_instantiation_assignment_value 7.14.5.32. set_instantiation_hdl_file_property 7.14.5.33. set_instantiation_interface_assignment_value 7.14.5.34. set_instantiation_interface_parameter_value 7.14.5.35. set_instantiation_interface_port_property 7.14.5.36. set_instantiation_interface_sysinfo_parameter_value 7.14.5.37. set_instantiation_property
7.14.6. Components x
7.14.6.1. apply_component_preset 7.14.6.2. get_component_assignment 7.14.6.3. get_component_assignments 7.14.6.4. get_component_documentation_links 7.14.6.5. get_component_interface_assignment 7.14.6.6. get_component_interface_assignments 7.14.6.7. get_component_interface_parameter_property 7.14.6.8. get_component_interface_parameter_value 7.14.6.9. get_component_interface_parameters 7.14.6.10. get_component_interface_port_property 7.14.6.11. get_component_interface_ports 7.14.6.12. get_component_interface_property 7.14.6.13. get_component_interfaces 7.14.6.14. get_component_parameter_property 7.14.6.15. get_component_parameter_value 7.14.6.16. get_component_parameters 7.14.6.17. get_component_project_properties 7.14.6.18. get_component_project_property 7.14.6.19. get_component_property 7.14.6.20. get_loaded_component 7.14.6.21. load_component 7.14.6.22. reload_component_footprint 7.14.6.23. save_component 7.14.6.24. set_component_parameter_value 7.14.6.25. set_component_project_property
7.14.7. Connections x
7.14.7.1. add_connection 7.14.7.2. auto_connect 7.14.7.3. get_connection_parameter_property 7.14.7.4. get_connection_parameter_value 7.14.7.5. get_connection_parameters 7.14.7.6. get_connection_properties 7.14.7.7. get_connection_property 7.14.7.8. get_connections 7.14.7.9. remove_connection 7.14.7.10. remove_dangling_connections 7.14.7.11. set_connection_parameter_value
7.14.8. Top-level Exports x
7.14.8.1. add_interface 7.14.8.2. get_exported_interface_sysinfo_parameter_value 7.14.8.3. get_exported_interface_sysinfo_parameters 7.14.8.4. get_interface_port_property 7.14.8.5. get_interface_ports 7.14.8.6. get_interface_properties 7.14.8.7. get_interface_property 7.14.8.8. get_interfaces 7.14.8.9. get_port_properties 7.14.8.10. remove_interface 7.14.8.11. set_exported_interface_sysinfo_parameter_value 7.14.8.12. set_interface_port_property 7.14.8.13. set_interface_property
7.14.9. Validation x
7.14.9.1. set_validation_property 7.14.9.2. sync_sysinfo_parameters 7.14.9.3. validate_component 7.14.9.4. validate_component_interface 7.14.9.5. validate_connection 7.14.9.6. validate_instance 7.14.9.7. validate_instance_interface 7.14.9.8. validate_system 7.14.9.9. validate_component_footprint 7.14.9.10. reload_component_footprint
7.14.10. Miscellaneous x
7.14.10.1. auto_assign_base_addresses 7.14.10.2. auto_assign_irqs 7.14.10.3. auto_assign_system_base_addresses 7.14.10.4. get_parameter_properties 7.14.10.5. lock_avalon_base_address 7.14.10.6. send_message 7.14.10.7. set_use_testbench_naming_pattern 7.14.10.8. unlock_avalon_base_address 7.14.10.9. get_testbench_dutname 7.14.10.10. get_use_testbench_naming_pattern
7.14.11. Wire-Level Connection Commands x
7.14.11.1. set_wirelevel_expression 7.14.11.2. get_wirelevel_expressions 7.14.11.3. remove_wirelevel_expressions
7.15. Platform Designer Scripting Property Reference x
7.15.1. Connection Properties 7.15.2. Design Environment Type Properties 7.15.3. Direction Properties 7.15.4. Element Properties 7.15.5. Instance Properties 7.15.6. Interface Properties 7.15.7. Message Levels Properties 7.15.8. Module Properties 7.15.9. Parameter Properties 7.15.10. Parameter Status Properties 7.15.11. Parameter Type Properties 7.15.12. Port Properties 7.15.13. Project Properties 7.15.14. System Info Type Properties 7.15.15. Units Properties 7.15.16. Validation Properties 7.15.17. Interface Direction 7.15.18. File Set Kind 7.15.19. Access Type 7.15.20. Instantiation HDL File Properties 7.15.21. Instantiation Interface Duplicate Type 7.15.22. Instantiation Interface Properties 7.15.23. Instantiation Properties 7.15.24. Port Properties 7.15.25. VHDL Type
8. Component Interface Tcl Reference x
8.1. Platform Designer _hw.tcl Command Reference 8.2. Platform Designer _hw.tcl Property Reference 8.3. Component Interface Tcl Reference Revision History
8.1. Platform Designer _hw.tcl Command Reference x
8.1.1. Interfaces and Ports 8.1.2. Parameters 8.1.3. Interconnect Parameters 8.1.4. Display Items 8.1.5. Module Definition 8.1.6. Composition 8.1.7. Fileset Generation 8.1.8. Miscellaneous 8.1.9. SystemVerilog Interface Commands 8.1.10. Wire-Level Expression Commands
8.1.1. Interfaces and Ports x
8.1.1.1. add_interface 8.1.1.2. add_interface_port 8.1.1.3. get_interfaces 8.1.1.4. get_interface_assignment 8.1.1.5. get_interface_assignments 8.1.1.6. get_interface_ports 8.1.1.7. get_interface_properties 8.1.1.8. get_interface_property 8.1.1.9. get_port_properties 8.1.1.10. get_port_property 8.1.1.11. set_interface_assignment 8.1.1.12. set_interface_property 8.1.1.13. set_port_property 8.1.1.14. set_interface_upgrade_map
8.1.2. Parameters x
8.1.2.1. add_parameter 8.1.2.2. get_parameters 8.1.2.3. get_parameter_properties 8.1.2.4. get_parameter_property 8.1.2.5. get_parameter_value 8.1.2.6. get_string 8.1.2.7. load_strings 8.1.2.8. set_parameter_property 8.1.2.9. set_parameter_value
8.1.3. Interconnect Parameters x
8.1.3.1. set_domain_assignment 8.1.3.2. get_domain_assignment 8.1.3.3. get_domain_assignments 8.1.3.4. set_postadaptation_assignment 8.1.3.5. get_postadaptation_assignment 8.1.3.6. get_postadaptation_assignments
8.1.4. Display Items x
8.1.4.1. add_display_item 8.1.4.2. get_display_items 8.1.4.3. get_display_item_properties 8.1.4.4. get_display_item_property 8.1.4.5. set_display_item_property
8.1.5. Module Definition x
8.1.5.1. add_documentation_link 8.1.5.2. get_module_assignment 8.1.5.3. get_module_assignments 8.1.5.4. get_module_ports 8.1.5.5. get_module_properties 8.1.5.6. get_module_property 8.1.5.7. send_message 8.1.5.8. set_module_assignment 8.1.5.9. set_module_property 8.1.5.10. add_hdl_instance 8.1.5.11. package
8.1.6. Composition x
8.1.6.1. add_instance 8.1.6.2. add_connection 8.1.6.3. get_connections 8.1.6.4. get_connection_parameters 8.1.6.5. get_connection_parameter_value 8.1.6.6. get_instances 8.1.6.7. get_instance_interfaces 8.1.6.8. get_instance_interface_ports 8.1.6.9. get_instance_interface_properties 8.1.6.10. get_instance_property 8.1.6.11. set_instance_property 8.1.6.12. get_instance_properties 8.1.6.13. get_instance_interface_property 8.1.6.14. get_instance_parameters 8.1.6.15. get_instance_parameter_property 8.1.6.16. get_instance_parameter_value 8.1.6.17. get_instance_port_property 8.1.6.18. set_connection_parameter_value 8.1.6.19. set_instance_parameter_value
8.1.7. Fileset Generation x
8.1.7.1. add_fileset 8.1.7.2. add_fileset_file 8.1.7.3. set_fileset_property 8.1.7.4. get_fileset_file_attribute 8.1.7.5. set_fileset_file_attribute 8.1.7.6. get_fileset_properties 8.1.7.7. get_fileset_property 8.1.7.8. get_fileset_sim_properties 8.1.7.9. set_fileset_sim_properties 8.1.7.10. create_temp_file
8.1.8. Miscellaneous x
8.1.8.1. check_device_family_equivalence 8.1.8.2. get_device_family_displayname 8.1.8.3. get_qip_strings 8.1.8.4. set_qip_strings
8.1.9. SystemVerilog Interface Commands x
8.1.9.1. add_sv_interface 8.1.9.2. get_sv_interfaces 8.1.9.3. get_sv_interface_property 8.1.9.4. get_sv_interface_properties 8.1.9.5. set_sv_interface_property
8.1.10. Wire-Level Expression Commands x
8.1.10.1. set_wirelevel_expression 8.1.10.2. get_wirelevel_expressions 8.1.10.3. remove_wirelevel_expressions
8.2. Platform Designer _hw.tcl Property Reference x
8.2.1. Script Language Properties 8.2.2. Interface Properties 8.2.3. SystemVerilog Interface Properties 8.2.4. Instance Properties 8.2.5. Parameter Properties 8.2.6. Parameter Type Properties 8.2.7. Parameter Status Properties 8.2.8. Port Properties 8.2.9. Direction Properties 8.2.10. Display Item Properties 8.2.11. Display Item Kind Properties 8.2.12. Display Hint Properties 8.2.13. Module Properties 8.2.14. Fileset Properties 8.2.15. Fileset Kind Properties 8.2.16. Callback Properties 8.2.17. File Attribute Properties 8.2.18. File Kind Properties 8.2.19. File Source Properties 8.2.20. Simulator Properties 8.2.21. Port VHDL Type Properties 8.2.22. System Info Type Properties 8.2.23. Design Environment Type Properties 8.2.24. Units Properties 8.2.25. Operating System Properties 8.2.26. Quartus.ini Type Properties
Answers to Top FAQs
1. Creating a System with Platform Designer
2. Creating a Board Support Package with BSP Editor
3. Creating Platform Designer Components
4. Optimizing Platform Designer System Performance
5. Platform Designer Interconnect
6. Platform Designer System Design Components
7. Platform Designer Command-Line Utilities
8. Component Interface Tcl Reference
9. Quartus® Prime Pro Edition User Guide: Platform Designer Document Archives
A. Quartus® Prime Pro Edition User Guides

3.3.10. Specify Parameters in the Platform Designer Component Editor

Components can include parameterized HDL, which allow users of the component flexibility in meeting their system requirements. For example, a component with a configurable memory size or data width, allows using one HDL implementation in different systems, each with unique parameters values.

The Parameters tab allows you specify the parameters that are used to configure instances of the component in a Platform Designer system. You can specify various properties for each parameter that describe how to display and use the parameter. You can also specify a range of allowed values that are checked during the validation phase. The Parameters table displays the HDL parameters that are declared in the top-level HDL module. If you have not yet created the top-level HDL file, the top-level synthesis file template created from the Files tab include the parameters that you create on the Parameters tab.

When the component includes HDL files, the parameters match those defined in the top-level module, and you cannot add or remove them on the Parameters tab. To add or remove the parameters, edit your HDL source, and then re-analyze the file.

If you create a top-level template HDL file for synthesis with the Component Editor, you can remove the newly-created file from the Synthesis Files list on the Files tab, make your parameter changes, and then re-analyze the top-level synthesis file.

You can use the Parameters table to specify the following information about each parameter:

  • Name—specifies the parameter name.
  • Default Value—sets the default value for new instances of the component.
  • Editable—specifies if the user can edit the parameter value.
  • Type—defines the parameter type as string, integer, boolean, std_logic, logic vector, natural, or positive.
  • Group—groups parameters in the parameter editor.
  • Tooltip—adds a description of the parameter that appears when the user of the component points to the parameter in the editor.
Figure 139. Parameters Tab in the Platform Designer Components Editor

On the Parameters tab, you can click Preview the GUI at any time to see how the declared parameters appear in the parameter editor. Parameters with their default values appear with checks in the Editable column. Editable parameters cannot contain computed expressions. You can group parameters under a common heading or section in the editor with the Group column, and a tooltip helps users of the component understand the function of the parameter. Various parameter properties allow you to customize the component’s parameter editor, such as specifying parameter option controls, or displaying an image.

_hw.tcl Created from Entries in the Parameters Tab

In this example, the first add_parameter command includes commonly-specified properties. The set_parameter_property command specifies each property individually. The Tooltip column on the Parameters tab maps to the DESCRIPTION property, and there is an additional unused UNITS property created in the code. The HDL_PARAMETER property specifies that the value of the parameter is specified in the HDL instance wrapper when creating instances of the component. The Group column in the Parameters tab maps to the display items section with the add_display_item commands. If you want to expose the HDL parameter so that you can overwrite the value when you instantiate the module, set AFFECTS_GENERATION to false.

Note: If a parameter <n> defines the width of a signal, the signal width must follow the format <n-1> : 0. 
# 
# parameters
# 
add_parameter AXI_ID_W INTEGER 4 "Width of ID fields"
set_parameter_property AXI_ID_W DEFAULT_VALUE 4
set_parameter_property AXI_ID_W DISPLAY_NAME AXI_ID_W
set_parameter_property AXI_ID_W TYPE INTEGER
set_parameter_property AXI_ID_W UNITS None
set_parameter_property AXI_ID_W DESCRIPTION "Width of ID fields"
set_parameter_property AXI_ID_W HDL_PARAMETER true
add_parameter AXI_ADDRESS_W INTEGER 12
set_parameter_property AXI_ADDRESS_W DEFAULT_VALUE 12

add_parameter AXI_DATA_W INTEGER 32
...
# 
# display items
# 
add_display_item "AXI Port Widths" AXI_ID_W PARAMETER ""
Note:

If an AXI subordinate's ID bit width is smaller than required for your system, the AXI subordinate response may not reach all AXI managers. The formula of an AXI subordinate ID bit width is calculated as follows: 

maximum_manager_id_width_in_the_interconnect + log2 = <value>

For example, if an AXI subordinate connects to three AXI managers and the maximum AXI manager ID length of the three managers is 5 bits, then the AXI subordinate ID is 7 bits, and is calculated as follows: 

5 bits + 2 bits (log2(3 managers)) = 7

Platform Designer refers to AXI interface parameters to build AXI interconnect. If these parameter settings are incompatible with the component's HDL behavior, Platform Designer interconnect and transactions may not work correctly. To prevent unexpected interconnect behavior, you must set the AXI component parameters.

Table 37.  AXI Manager Parameters
AXI Manager Parameters Description
readIssuingCapability The maximum number of outstanding read transactions for a manager.
writeIssuingCapability The maximum number of outstanding write transactions for a manager.
combinedIssuingCapability The maximum number of outstanding transactions for a manager.
Table 38.  AXI Subordinate Parameters
AXI Subordinate Parameters Description
readAcceptanceCapability The maximum number of outstanding read commands that a subordinate can accept.
writeAcceptanceCapability The maximum number of outstanding write transactions that a subordinate can accept.
combinedAcceptanceCapability The maximum number of outstanding transactions that a subordinate can accept.
readDataReorderingDepth The number of outstanding read transactions for which a subordinate interface can transmit data. If readDataReorderingDepth = 1, the subordinate processes all transactions in order.

Section Content
Valid Ranges for Parameters in the _hw.tcl File
Types of Platform Designer Parameters
Obtaining Device Trait Information Using PART_TRAIT System Information Parameter
Declare Parameters with Custom _hw.tcl Commands
Validate Parameter Values with a Validation Callback

Related Information
Level Two Title