TAPA Documentation

Overview

• TAPA Overview
  • High-Frequency
  • Speed
  • Expressiveness
  • HBM-Specific Optimizations
  • Successful Cases
  • Getting Started
  • TAPA Publications
• TAPA Basics
  • TAPA Program
  • TAPA Compilation Process
  • Magic of TAPA

Installation

• Install TAPA
  • Option 1: One-Click Install from Binary
  • Option 2: Install from Source
    • Build Prerequisites
    • Additional Build Prerequisites for Testing
    • Runtime Dependency
    • Build and Installation
    • Additional Build Prerequisites for Documentation
• Install Gurobi (Recommended)
• Verify Installation
• Update TAPA

Getting Started

• Hello World: Vector Add
• Run Software Simulation
• Synthesize into RTL
• Run Hardware Simulation with Vitis
• Run Hardware Simulation with TAPA Simulator
• Generate Bitstream
• Execute on an FPGA
• Using CMake

FCCM 2022 Tutorial

• FCCM 2022 Tutorial

Tutorial: High Frequency

• Supported Devices
• Introduction to AutoBridge
• Basic Usage
• Improve Floorplan Quality
• Automatic HBM Channel Binding
• Get Best Results with Multi-Floorplanning
• Adjust the Floorplan Parameters (Experts Only)
• Manual Floorplanning (Experts Only)
• Scalability
• Tips to Improve Frequency
• How to Find Post-Routing Critical Paths

Tutorial: Speed

• TAPA RTL Simulation
  • Basic Usage
  • View Waveform
  • Simulation Frozen
  • Tips
  • Limitation

Tutorial: Expressiveness

• Flexible Interaction with Streams
  • Peeking a Stream
  • End-of-Transaction
• More on Defining Tasks
  • Detached Task
  • Hierarchical Design
• Less Repetitive Code with Stream/MMAP Array
• Flexible Memory Access
  • The Programming Model of async_mmap
  • Basic Usage of async_mmap
  • Runtime Burst Detection
  • Smaller Area Overhead
  • Sharing External Memory Interfaces
  • Example 1: Multi-Outstanding Random Memory Accesses
  • Example 2: Sequential Read from async_mmap into an Array
  • Example 3: Sequential Write into async_mmap from a FIFO
  • Example 4: Simultaneous Read and Write to async_mmap

Tutorial: Design Tips

• Migrate from Vitis HLS
  • Example 1
    • Update the Includes
    • Update the Top Function
    • Update Task Definitions
    • Final Look of Example 1
  • Example 2
    • Dataflow in a Loop
    • Computation in the Top Function
    • Final Look of Example 2
• Debug Tips

Example Designs

• Mini Examples
  • Vector Add
  • Vector Add with Shared Memory Interface
  • Vector Add with Multiple Task Hierarchy
  • Bandwidth Test (using async_mmap)
  • Network
  • Cannon
  • Jacobi
• Real-World Examples

More about TAPA

• Summary
  • Programmability Improvement
  • Beyond Programmability
• Kernel Communication Interface
• Host-Kernel Interface
• Software Simulation
• RTL Code Generation
• Memory System
• Detached Tasks
• Hardware FIFO
• Timing Closure

Reference

• The TAPA Library (libtapa)
  • The Task Instantiation Library
    • task
      • task
        • task::task()
        • task::invoke()
        • task::invoke()
        • task::invoke()
      • seq
        • seq::seq()
  • The Streaming Library
    • istream
      • istream
        • istream::empty()
        • istream::try_eot()
        • istream::eot()
        • istream::eot()
        • istream::try_peek()
        • istream::peek()
        • istream::peek()
        • istream::peek()
        • istream::try_read()
        • istream::read()
        • istream::operator>>()
        • istream::read()
        • istream::read()
        • istream::read()
        • istream::try_open()
        • istream::open()
    • istreams
      • istreams
        • istreams::operator[]()
        • istreams::length
    • ostream
      • ostream
        • ostream::full()
        • ostream::try_write()
        • ostream::write()
        • ostream::operator<<()
        • ostream::try_close()
        • ostream::close()
    • ostreams
      • ostreams
        • ostreams::operator[]()
        • ostreams::length
    • stream
      • stream
        • stream::stream()
        • stream::stream()
        • stream::depth
    • streams
      • streams
        • streams::streams()
        • streams::streams()
        • streams::operator[]()
        • streams::length
        • streams::depth
  • The MMAP Library
    • async_mmap
      • async_mmap
        • async_mmap::addr_t
        • async_mmap::resp_t
        • async_mmap::read_addr
        • async_mmap::read_data
        • async_mmap::write_addr
        • async_mmap::write_data
        • async_mmap::write_resp
    • mmap
      • mmap
        • mmap::mmap()
        • mmap::mmap()
        • mmap::mmap()
        • mmap::operator T*()
        • mmap::operator++()
        • mmap::operator--()
        • mmap::operator++()
        • mmap::operator--()
        • mmap::get()
        • mmap::size()
        • mmap::vectorized()
        • mmap::reinterpret()
    • mmaps
      • mmaps
        • mmaps::mmaps()
        • mmaps::mmaps()
        • mmaps::operator[]()
        • mmaps::vectorized()
        • mmaps::reinterpret()
  • The Utility Library
    • widthof
      • widthof()
      • widthof()
• The TAPA Compiler (tapac)
  • Positional Arguments
  • options
  • Compilation Steps
  • Floorplanning
  • Strategy
• Organization of TAPA Output Files
  • The XO Object
  • The XXX_generate_bitstream.sh script
  • The XXX_floorplan.tcl
  • tapac Intermediate Files
• Known Issues