checkStatus

Check current status of FPGA data capture in nonblocking mode

Since R2022a

Syntax

status = checkStatus(DC)

Description

status = checkStatus(DC) returns the current status of the data capture object DC in nonblocking capture mode.

Note

The checkStatus function is not supported in blocking capture mode.

Examples

Check Current Status of Data Capture Object

Before you use this example, you must have previously generated the customized data capture object using the FPGA Data Capture Component Generator tool. You must also have integrated the generated IP code into your project and deployed it to the FPGA. The data capture object communicates with the FPGA over a JTAG cable. Make sure that the required cable is connected between the board and the host computer.

Change the capture mode to nonblocking mode.

DC.CaptureMode = 'nonblocking';

Check the current status of the data capture object.

status = checkStatus(DC)

status = 

  struct with fields:

    CapturedWindows: 0
          RunStatus: 'Not started'
       TriggerStage: 0

Use the step function to capture data. The data is captured immediately from the FPGA.

dataOut = step(DC);

Check the current status of the data capture object.

status = checkStatus(DC)

status = 

  struct with fields:

    CapturedWindows: 1
          RunStatus: 'Successfully captured data from FPGA'
       TriggerStage: 0

Input Arguments

DC — Customized data capture object

hdlverifier.FPGADataReader System object™

Customized data capture object, specified as an hdlverifier.FPGADataReader System object.

Output Arguments

status — Current status of data capture object

structure

Current status of the data capture object, returned as a structure containing fields for these signals.

• CapturedWindows — This signal indicates the total number of windows captured so far.

• RunStatus — This signal indicates the current running status of the data capture object using one of these options.

  • 'Not started' — Data capture not started.

  • 'Waiting for trigger' — Data capture object is waiting for a trigger event to start data capture.

  • 'Evaluating capture condition' — Data capture object is evaluating the capture condition.

  • 'Successfully captured data from FPGA' — Data captured successfully from the FPGA.

  • 'Stopped' — Data capture has stopped.

• TriggerStage — This signal indicates the trigger stage under evaluation for the run status 'Waiting for trigger'. For the run statuses 'Evaluating capture condition', 'Successfully captured data from FPGA', and 'Stopped', this signal indicates the updated value of the trigger stage.

Version History

Introduced in R2022a