Zuspec Language

Zuspec is a Python-embedded multi-abstraction language for modeling hardware - from the transfer-function level down to RTL.

Version: 2026.1 (January 2026)

Quick Links:

• API Reference - Complete API documentation (154 elements)

• README - Quick start guide

• Parameterization Guide - Const fields and lambda expressions

• Zuspec IR Checker - IR Checker and flake8 integration (NEW!)

• Profile System - Platform-specific abstraction levels

User Guide:

• Zuspec Language Overview
  • Processing
  • Runtime
  • Datamodel
• Abstraction Levels
  • Overview
  • Logical Interface
  • Physical Interface
  • Internal Implementation
• Components
  • Component Lifecycle
  • Ports and Binding
  • Memory and RegFile Binding
  • Hierarchical Port Binding
  • Supported Exec Methods
  • Supported Special-Purpose Methods
• Class Fields
  • Decorators
  • Field Specifiers
  • Binding Helper
  • Execution Types
  • Parameterization Features
• Core Types
  • Component
  • Time & Timing
  • Integer Types
  • PackedStruct
  • Memory Types
  • Synchronization
  • Pool Types
• Constraints
  • Quick Example
  • Random Variables
  • Constraint Decorators
  • Constraint Expressions
  • Helper Functions
  • Parsing Constraints
  • Complete Example
  • Supported Patterns
  • Design Notes
• Runtime Implementation (Developer)
  • ObjFactory
  • Timebase
  • CompImplRT
  • MemoryRT
  • RegFileRT
  • RegRT
  • AddressSpaceRT
  • AddrHandleRT
• Zuspec IR Checker
  • Overview
  • Architecture
  • Installation and Setup
  • Error Codes
  • Built-in Profiles
  • Profile Auto-Detection
  • Creating Custom Checkers
  • Checker Extension API
  • Command-Line Usage
  • Troubleshooting
  • Comparison with Other Tools
  • Frequently Asked Questions
  • See Also

Advanced Topics:

• Data Model (Developer)
  • Context
  • Data Types
  • Fields
  • Bindings
  • Expressions
  • Statements
  • Functions & Methods
  • Visitor
  • JsonConverter
  • DataModelFactory
  • Profile System

Note

The mypy-based profile checker (profile_checker_guide) is deprecated as of version 2026.1. Use the new flake8-based IR checker instead (see Zuspec IR Checker).