FPGA Data Capture Component Generator

Configure and generate FPGA data capture components

Description

The FPGA Data Capture Component Generator tool configures and generates components for capturing data from a design running on an FPGA. The generated components capture a window of signal data from the FPGA and return the data to MATLAB^® or Simulink^®.

To use this tool, you must have an existing HDL design and FPGA project. To capture the signals, HDL Verifier™ generates an IP core that you must integrate into your HDL project, and deploy to the FPGA along with the rest of your design.

The Generate button in this tool generates the following components:

• HDL IP core, for integration into your FPGA design. Connect the signals you want to capture and use as triggers, and connect a clock and clock enable.

• Generation report, with list of generated files and instructions for next steps.

• Tool to set capture parameters and capture data to the MATLAB workspace. See FPGA Data Capture.

• Customized version of the hdlverifier.FPGADataReader System object™ that provides an alternative, programmatic, way to configure and capture data.

• Simulink model that contains a customized FPGA Data Reader block. If you have a DSP System Toolbox™ license, this model streams the captured signals into the Logic Analyzer waveform viewer. Otherwise, the Scope block displays the signals.

For a workflow overview, see Data Capture Workflow.

Open the FPGA Data Capture Component Generator

At the MATLAB command prompt, enter:

generateFPGADataCaptureIP

To reload the parameters of the most recent design, use the restore argument:

generateFPGADataCaptureIP('restore',true);

Examples

Related Examples

• Read Audio Signal from Intel FPGA Board Using FPGA Data Capture

Parameters

Ports

Port Name — Name of input port on the generated IP

character vector

The name does not have to match the signal name in your HDL files. This name is used for:

• Input port on the generated HDL IP core. Internal to the IP, this signal is routed to the capture buffer, or to use as part of trigger condition, depending on your selection for Use As.

• Structure field in the captured data returned to the MATLAB workspace

• Port on the generated Simulink block

• Table of signals in the trigger and data types parameters editor at capture time

Bit Width — Number of bits in signal

positive integer

This number is used to generate the HDL IP port definition, and contributes to the total width of the capture buffer. You can specify the data type for the captured data at capture time.

Note

If you do not have Fixed-Point Designer™, data capture can only return built-in data types, such as uint8. You must specify ports for the generated IP that match the sizes of the built-in data types, that is 1, 8, 16, 32, or 64 bits. We recommend Fixed-Point Designer to enable fixed-point data types and captured signals of any size.

Use As — How the signal is routed inside the IP logic

Both trigger and data (default) | Data | Trigger

When you specify a signal as Data, the signal is captured to the sample buffer and returned to MATLAB, but it cannot contribute to a trigger condition. When you specify a signal as Trigger, it is available for defining a trigger condition at capture time, but is not captured and returned to MATLAB. You can also specify that the signal is used as Both trigger and data.

Target

Generated IP name — Name of generated components

datacapture (default) | character vector

This name is used for the generated HDL IP core, the System object, and the Simulink model.

FPGA vendor — FPGA and software vendor

Altera | Xilinx

The available vendors depend on which HDL Verifier support package you have installed. There are separate support packages for Altera^® and Xilinx^® boards.

Generated IP language — Language used for the generated HDL IP core

VHDL (default) | Verilog

Language used for the generated HDL IP core, specified as Verilog or VHDL.

Destination folder — Location to save the generated files

hdlsrc (default) | character vector

Location to save the generated files, specified as the name of a folder on the host computer.

Capture

Sample depth — Number of samples captured for each signal

128 (default) | integer power of two

Use this parameter specify the size of the memory in the generated HDL IP core. The width of the memory is the total bit width of the data signals.

When specifying the sample depth, consider the number of windows you plan to configure when reading the data, because together they impact the window depth of each capture window. The window depth is the Sample depth divided by the Number of capture windows. Specify Number of capture windows in the FPGA Data Capture App.

For example: If Sample depth is 4096 and Number of capture windows is 4, then each capture window has a window depth of 1024.