mhs5200

Python driver for MHS-5200A series DDS signal generators.

Control MHS-5200A dual-channel function generators via USB serial connection. Supports frequency, amplitude, waveform, sweep, and arbitrary waveform upload.

Features

• Dual-channel control (frequency, amplitude, waveform, duty cycle, offset, phase)
• Sweep function (linear/logarithmic)
• Arbitrary waveform upload/download (2048 samples, 12-bit resolution)
• Built-in waveforms (sine, square, triangle, sawtooth)
• Automatic attenuation handling

Supported Models

MHS-5200A series: MHS-5206A, MHS-5212A, MHS-5220A, MHS-5225A

Installation

pip install mhs5200

Quick Start

from mhs5200 import MHS5200, Waveform

with MHS5200('/dev/ttyUSB0') as gen:  # Windows: 'COM3'
    print(gen.get_device_info())
    
    # CH1: 1kHz sine wave, 5Vpp
    gen.set_frequency(1, 1000)
    gen.set_amplitude(1, 5.0)
    gen.set_waveform(1, Waveform.SINE)
    gen.set_all_outputs(True)

Examples

Dual Channel with Phase Shift

from mhs5200 import MHS5200, Waveform

with MHS5200('/dev/ttyUSB0') as gen:
    # CH1: 1kHz sine
    gen.set_frequency(1, 1000)
    gen.set_amplitude(1, 5.0)
    gen.set_waveform(1, Waveform.SINE)
    
    # CH2: 1kHz sine, 90° phase shift (quadrature)
    gen.set_frequency(2, 1000)
    gen.set_amplitude(2, 5.0)
    gen.set_waveform(2, Waveform.SINE)
    gen.set_phase(90)
    
    gen.set_all_outputs(True)

Square Wave with Duty Cycle

from mhs5200 import MHS5200, Waveform

with MHS5200('/dev/ttyUSB0') as gen:
    gen.set_frequency(1, 10000)
    gen.set_amplitude(1, 3.3)
    gen.set_waveform(1, Waveform.SQUARE)
    gen.set_duty_cycle(1, 25.0)  # 25%
    gen.set_all_outputs(True)

Frequency Sweep

from mhs5200 import MHS5200, SweepMode

with MHS5200('/dev/ttyUSB0') as gen:
    gen.configure_sweep(
        start_hz=100,
        stop_hz=10000,
        time_sec=10,
        mode=SweepMode.LINEAR
    )
    gen.sweep_on()

Arbitrary Waveform

import math
from mhs5200 import MHS5200, Waveform

def generate_waveform(num_samples=2048):
    """Sine wave with 3rd harmonic (30%)."""
    samples = []
    for i in range(num_samples):
        t = i / num_samples * 2 * math.pi
        value = math.sin(t) + 0.3 * math.sin(3 * t)
        sample = int(2048 + value / 1.3 * 2047)
        samples.append(max(0, min(4095, sample)))
    return samples

with MHS5200('/dev/ttyUSB0') as gen:
    waveform = generate_waveform()
    gen.upload_arbitrary_waveform(0, waveform)
    
    gen.set_waveform(1, Waveform.ARB00)
    gen.set_frequency(1, 1000)
    gen.set_amplitude(1, 3.0)
    gen.set_all_outputs(True)

API Reference

Device Information

Channel Control

Common Control

Output Control

Sweep

Arbitrary Waveform

Enums

# Waveform types
Waveform.SINE
Waveform.SQUARE
Waveform.TRIANGLE
Waveform.SAWTOOTH_UP
Waveform.SAWTOOTH_DOWN
Waveform.ARB00 – Waveform.ARB15

# Sweep modes
SweepMode.LINEAR
SweepMode.LOG

# Attenuation
Attenuation.ATT_0DB
Attenuation.ATT_20DB

License

MIT License