SLASH: An Open-Source Research Shell for Alveo V80

SLASH is an open-source platform for AMD Alveo V80 FPGA boards. It provides a complete runtime and development ecosystem for FPGA kernel execution, device management, and memory operations.

Tutorials

• Getting Started
  • Prerequisites
  • What the Example Does
  • Build the Example
  • Run the Example
  • Understanding the Code
  • Next Steps
• Your First Kernel
  • Prerequisites
  • Anatomy of an HLS Kernel
  • HLS Configuration File
  • Linker Configuration
  • CMake Build Setup
  • Build and Run
  • Creating Your Own Project
  • Next Steps
• Buffers and Memory
  • Memory Types on the V80
  • Creating Buffers
  • Host-Device Data Transfer
  • Accessing Buffer Data
  • Complete Example
  • Common Patterns
  • Next Steps
• Emulation and Simulation
  • Prerequisites
  • When to Use Each Mode
  • Build an Emulation Vrtbin
  • Run in Emulation
  • Build and Run in Simulation
  • Querying the Platform at Runtime
  • How Buffers Work in Emulation and Simulation
  • Known Limitations
  • Next Steps
• Platform Setup
  • Prerequisites
  • Static Shell
  • Build the Packages
  • Install the AMI Driver
  • Install SLASH Packages
  • Program the Board
  • Verify the Kernel Module
  • Start the vrtd Daemon
  • Validate the Board
  • User Access
  • Next Steps
• Bootstrapping with AVED
  • When you need this tutorial
  • Prerequisites
  • Download the AVED Deployment Archive
  • Switch the V80 to JTAG Boot Mode
  • Program OSPI Flash via Vivado Hardware Manager
  • Cold-Reboot the Host
  • Verify
  • Next Steps
• Device Management
  • Prerequisites
  • Listing Devices
  • Inspecting a Vrtbin
  • Programming a Device
  • Querying the Active Design
  • Resetting a Device
  • Validating Memory
  • Next Steps
• vrtd Configuration
  • Prerequisites
  • How vrtd Manages Access
  • Configuration File
  • Understanding Roles
  • User and Group Mappings
  • Creating a Custom Role
  • Per-Device Permissions
  • Systemd Integration
  • Multi-Tenancy
  • Troubleshooting
  • Next Steps

How-To Guides

• How-To Guides
  • Install from Packages
  • Use Multiple Boards
  • Set Clock Frequency
  • Chain Streaming Kernels
  • Benchmark Memory
  • Build from Source
  • Use CMake Modules
  • Inspect vrtbin Metadata
  • Use Mock Mode
  • Migrate from XRT to VRT
  • Using RTL Kernels

Reference

• VRT C++ API
  • vrt::Device
  • vrt::Kernel
  • vrt::Buffer
  • vrt::StreamingBuffer
  • vrt::Vrtbin
  • VRT Enumerations
• libslash C API
  • Control Device (ctldev)
  • QDMA
  • Hotplug
• Kernel ABI
  • Data Conventions
  • Concurrency Model
  • Card information and BARs: /dev/slash_ctl<N>
  • Memory transfers via QDMA: /dev/slash_qdma_ctl<N>
  • Device resets and hotplugging: /dev/slash_hotplug
• libvrtd C Client API
  • vrtd Client Functions
  • Wire Protocol
• libvrtdpp C++ Client API
  • vrtd::Session
  • vrtd::Device
  • vrtd::Bar
  • vrtd::BarFile
  • vrtd::Buffer
  • vrtd::QdmaQpair
• vrtd Daemon
  • Client Flow
  • Configuration
• v80-smi
  • Command Reference
• CMake Modules
  • SlashTools
  • BuildHLS
  • FindVivado and FindVitis

Explanation

• Architecture
  • Stack Overview
  • Layer Descriptions
  • Typical Execution Flow
• Memory Model
  • DDR Memory
  • HBM (High Bandwidth Memory)
  • MemoryConfig and Port Mapping
  • Buddy Allocator
  • Platform Differences
• vrtbin Format
  • Overview
  • Archive Contents
  • system_map.xml
  • How VRT Uses the Vrtbin
  • Inspecting a Vrtbin
  • Creating a Vrtbin
• PCIe Topology
  • Physical Functions
  • BDF Addressing
  • Device Discovery
  • Readiness Checks
  • Hotplug Lifecycle
  • Segmented Configuration
  • See Also
• Platform Modes
  • Platform Selection
  • Building for Each Platform
  • Hardware
  • Emulation
  • Simulation

Examples

• Examples