iRiser Documentation

Python API and examples for controlling SANBlaze iRiser5 hardware.

Contents

• iRiser Getting Started
  • Concepts
  • Creating a Riser object
  • Immediate signal control (set and clear)
  • Programming models
  • Reading GPIO state
  • Typical workflow
• iRiser Signal Reference
  • Discovering signal names
  • Name matching
  • Common signals
  • Direction and value semantics
• Examples
  • Immediate set and clear
  • Discover signal names
  • Driving a single signal
  • Driving multiple signals
  • Passing in invalid signal names
  • Mirror signals with LEDs
  • Low-level PERST and refclk sequence
• iRiser Power Measurement
  • Requirements
  • Power rails
  • Power DMA service
  • Typical workflow
  • API reference
  • Troubleshooting
• iRiser API
  • Riser
  • Bits
  • Action
  • Sequence
• iRiser FAQ
  • How do I reset an iRiser back to factory settings?
  • Which slot number should I use?
  • What does “iRiser5 not found” mean?
  • When should I use set/clear instead of sequences?
  • How do I find valid signal names?
  • What happens when I pass an invalid signal name?
  • Why must I call wait_for_stopped after start_sequence?
  • When do I need set_dir or toggle_bit?
  • How do I start the power measurement service?

Overview

The iRiser provides timed GPIO control (PERST, refclk, power rails), immediate set/clear commands for single signals, and DMA-based power measurement on drive slots. Use iRiser Getting Started for concepts and workflow, Examples for copy-paste examples, and iRiser API for the full method reference.

Quick start

from sanblaze import riser

device = riser.Riser(1)
device.init()
bits = device.get_bits(raw=True)
for bit in bits.bits:
    print(bit.name)

See also iRiser Signal Reference for common signal names and iRiser Power Measurement for power capture used by OCP Group 6 tests.