step

Capture one buffer of data from HDL IP core running on FPGA

Since R2024a

Syntax

dataOut = step(hub)

Description

Note

Alternatively, instead of using the step object function to perform the operation defined by the data capture hub object, you can call the hub object with arguments, as if it were a function. For example, y = step(obj,x) and y = obj(x) perform equivalent operations.

dataOut = step(hub) captures live signal data from a design running on an FPGA. The FPGA must contain a data capture IP generated from the FPGA Data Capture Component Generator tool. dataOut is a structure that contains structures for each connected data capture IP. Each such structure contains a field for each signal captured. Call the setDataType object function to specify the data type of each captured signal.

If at least one signal is enabled as part of the trigger condition, the data capture IP waits for a match of the trigger condition and captures the data. If no signals are enabled as part of the trigger condition, the HDL IP core captures and returns the buffered data immediately. When you create the object, no trigger condition is set by default. Call the setTriggerCondition and setTriggerCombinationOperator object functions to configure a trigger condition.

Input Arguments

hub — Data capture hub object

dataCaptureHub object

Data capture hub object that interacts with each data capture IP, specified as a dataCaptureHub object.

Output Arguments

dataOut — Captured data

structure

Captured data, returned as a structure that contains structures for each connected data capture IP. Each such structure contains a field for the Capture_Window signal, a field for the Trigger_Position signal, and a field for each signal captured by FPGA data capture. The captured signal field is a vector of Sample depth values for each signal requested for data capture at generation time. The fields of the structure have these signal names.

• Capture_Window — This signal indicates the current capture window.

• Trigger_Position — This signal indicates the position of the trigger detection clock cycle within a capture buffer.

• All remaining fields — The signal names you specified at generation time.

Version History

Introduced in R2024a