🚀 SerDes Validation Framework

A comprehensive framework for validating high-speed SerDes protocols with automated data collection, advanced signal analysis, and multi-vendor instrument control.

✨ Key Features

Core Capabilities

• 🔄 Automated Data Collection: Seamless data gathering from lab instruments
• 📊 Advanced Analysis: Comprehensive signal processing and visualization
• 🎛️ Universal Instrument Control: GPIB/USB interface for multi-vendor support
• 📋 Flexible Test Sequences: Customizable, reusable test automation

New Features in v1.2.0

• 🔍 Mock Testing Support: Development and testing without physical hardware
• 📡 224G Ethernet Support: Complete validation suite for 224G interfaces
• 📊 PAM4 Analysis: Advanced PAM4 signal processing capabilities
• 🔬 Enhanced Scope Control: High-bandwidth oscilloscope integration

🎮 Intelligent Hardware/Mock Adaptation

from serdes_validation_framework import get_instrument_controller

# Auto-detects available hardware
controller = get_instrument_controller()

# For development/testing without hardware:
os.environ['SVF_MOCK_MODE'] = '1'

# For specific hardware testing:
os.environ['SVF_MOCK_MODE'] = '0'

# Example usage (works in both modes):
controller.connect_instrument('GPIB::1::INSTR')
response = controller.query_instrument('GPIB::1::INSTR', '*IDN?')
print(f"Operating in {controller.get_mode()} mode")  # 'mock' or 'real'

📡 224G Ethernet Validation

from serdes_validation_framework.protocols.ethernet_224g import (
    Ethernet224GTestSequence,
    ComplianceSpecification
)

# Initialize test sequence
sequence = Ethernet224GTestSequence()

# Run link training
training_results = sequence.run_link_training_test(
    scope_resource="GPIB0::7::INSTR",
    pattern_gen_resource="GPIB0::10::INSTR"
)

# Run compliance tests
compliance_results = sequence.run_compliance_test_suite(
    scope_resource="GPIB0::7::INSTR",
    pattern_gen_resource="GPIB0::10::INSTR"
)

print(f"Training status: {training_results.convergence_status}")
print(f"Compliance status: {compliance_results.test_status}")

📊 PAM4 Signal Analysis

from serdes_validation_framework.data_analysis import PAM4Analyzer

# Initialize analyzer
analyzer = PAM4Analyzer({
    'time': time_data,
    'voltage': voltage_data
})

# Analyze signal
levels = analyzer.analyze_level_separation()
evm = analyzer.calculate_evm()
eye = analyzer.analyze_eye_diagram()

print(f"RMS EVM: {evm.rms_evm_percent:.2f}%")
print(f"Worst Eye Height: {eye.worst_eye_height:.3f}")

🔄 Automatic Mode Selection

The framework intelligently adapts between hardware and mock modes:

Mode	Description	Use Case
🔍 Auto	Automatically detects available hardware	Default behavior
🎮 Mock	Simulates hardware responses	Development & testing
🔧 Real	Uses physical instruments	Production validation

Configure via environment:

# Development without hardware
export SVF_MOCK_MODE=1

# Force hardware mode
export SVF_MOCK_MODE=0

# Auto-detect (default)
unset SVF_MOCK_MODE

📈 Real vs Mock Data Comparison

# Mock mode provides realistic data simulation:
def generate_pam4_waveform():
    """Generate synthetic PAM4 data"""
    levels = np.array([-3.0, -1.0, 1.0, 3.0])
    symbols = np.random.choice(levels, size=num_points)
    noise = np.random.normal(0, 0.05, num_points)
    return symbols + noise

# Auto-switching between real/mock:
def capture_waveform(scope):
    """Capture waveform data"""
    if scope.controller.get_mode() == 'mock':
        return generate_pam4_waveform()
    else:
        return scope.query_waveform()

🚀 Quick Start

Prerequisites

• Python 3.9+ (recommended 3.10)
• Git
• VISA Library (optional, for hardware control)

Installation

# Clone repository
git clone https://github.com/muditbhargava66/serdes-validation-framework.git
cd serdes-validation-framework

# Create virtual environment (recommended)
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

Basic Usage

from serdes_validation_framework import get_instrument_controller

# Initialize controller (auto-detects mock/real mode)
controller = get_instrument_controller()

# Connect to instrument
controller.connect_instrument('GPIB::1::INSTR')

# Basic operations
controller.send_command('GPIB::1::INSTR', '*RST')
response = controller.query_instrument('GPIB::1::INSTR', '*IDN?')

🛠️ Development

Setup Development Environment

# Install dev dependencies
pip install -r requirements-dev.txt

# Run tests
python -m unittest discover -s tests

# Run linter
ruff check src tests

# Test all Python versions
tox

Mock Testing

Enable mock mode for development without hardware:

# Enable mock mode
export SVF_MOCK_MODE=1

# Run examples
python examples/mock_testing_example.py

📊 Feature Comparison

Feature	Mock Mode	Hardware Mode
🚀 Setup Speed	Instant	Requires calibration
📊 Data Quality	Simulated	Real measurements
🔄 Automation	Full support	Full support
📈 Analysis	All features	All features
🕒 Execution Time	Fast	Hardware-dependent
🔧 Requirements	None	VISA, hardware

📚 Documentation

Getting Started

• 📖 Installation Guide
• 🎯 Usage Guide
• 🔰 Quick Start Tutorial
• 🤝 Contributing Guide

API Reference

• 🔌 Instrument Control
• 🧪 Mock Testing
• 📡 224G Ethernet
• 📊 PAM4 Analysis

Guides & Tutorials

• 🔧 Hardware Setup
• 🏃 Mock Testing
• 📈 Signal Analysis
• ✅ Validation Guide

Development Setup

1. Install development dependencies:

   pip install -r requirements-dev.txt

2. Run tests:

   python -m unittest discover -s tests

3. Run linter:

   ruff check src tests

4. Run Tox for testing across multiple environments:

   tox

Project Structure

serdes-validation-framework/
├── .github/                          # [Existing] GitHub specific files
├── docs/
│   ├── api/
│   │   ├── index.md
│   │   ├── usage.md
│   │   ├── eth_224g.md              # [New] 224G Ethernet API documentation
│   │   └── pam4_analysis.md         # [New] PAM4 analysis documentation
│   ├── images/
│   ├── tutorials/
│   │   ├── getting_started.md
│   │   ├── 224g_validation.md       # [New] 224G validation tutorial
│   │   └── pam4_analysis.md         # [New] PAM4 analysis tutorial
│   ├── CONTRIBUTING.md
│   ├── INSTALL.md
│   └── USAGE.md
├── examples/
│   ├── test_sequence_example.py
│   ├── data_analysis_example.py
│   ├── eth_224g_example.py          # [New] 224G testing example
│   └── pam4_analysis_example.py     # [New] PAM4 analysis example
├── scripts/
│   ├── data_collection.py
│   ├── data_analysis.py
│   ├── instrument_control.py
│   ├── test_sequence.py
│   └── eth_224g_validation.py       # [New] 224G validation script
├── src/
│   └── serdes_validation_framework/
│       ├── __init__.py
│       ├── data_collection/         # [Existing] Base data collection
│       │   ├── __init__.py
│       │   └── data_collector.py
│       ├── data_analysis/          
│       │   ├── __init__.py
│       │   ├── analyzer.py
│       │   └── pam4_analyzer.py     # [New] PAM4 signal analysis
│       ├── instrument_control/
│       │   ├── __init__.py
│       │   ├── controller.py
│       │   ├── mock_controller.py
│       │   └── scope_224g.py        # [New] High-bandwidth scope control
│       ├── test_sequence/
│       │   ├── __init__.py
│       │   ├── sequencer.py
│       │   └── eth_224g_sequence.py # [New] 224G test sequences
│       └── protocols/               # [New] Protocol-specific modules
│           ├── __init__.py
│           └── ethernet_224g/
│               ├── __init__.py
│               ├── constants.py      # Protocol constants
│               ├── compliance.py     # Compliance specifications
│               └── training.py       # Link training patterns
├── tests/
│   ├── test_data_collection.py
│   ├── test_data_analysis.py
│   ├── test_instrument_control.py
│   ├── test_test_sequence.py
│   ├── test_pam4_analyzer.py       # [New] PAM4 analyzer tests
│   ├── test_eth_224g_sequence.py   # [New] 224G sequence tests
│   └── test_scope_224g.py         # [New] Scope control tests
├── .gitignore
├── LICENSE
├── README.md                       # [Update] Add 224G features
├── requirements.txt                # [Update] Add new dependencies
├── setup.py                       # [Update] Add new modules
├── CHANGELOG.md
└── tox.ini

🤝 Contributing

We welcome contributions! See our Contributing Guide for details on:

• Code Style
• Development Process
• Submission Guidelines
• Testing Requirements

Community and Support

For any questions, issues, or contributions, please open an issue on the GitHub repository. Contributions and feedback are always welcome.

📄 License

Distributed under the MIT License. See LICENSE for more information.

Star History

---

Enjoy using the SerDes Validation Framework?
⭐️ Star the repo and consider contributing!

📫 Contact: @muditbhargava66 🐛 Report Issues: Issue Tracker

© 2025 Mudit Bhargava. MIT License