Controlling Riviera-PRO from MATLAB®


Riviera-PRO provides a bidirectional MATLAB co-simulation interface that allows the integration of the MathWorks' system-level computing environment with Aldec's HDL-based simulation environment. The interface enables engineers to verify that their ASIC/FPGA implementations match system specifications. Riviera-PRO can either act as a master or slave in co-simulation with MATLAB:

  1. Master mode enables Riviera-PRO users to extend the testbench capabilities of HDL languages with the computing power of the MATLAB environment. This includes executing MATLAB® commands, calling M-functions, or transferring data to or from the MATLAB workspace. So, while remaining in the Riviera-PRO (HDL) environment, you can control the MATLAB environment. If you want to pursue this approach please refer to the following application note:

  2. Slave mode enables MATLAB users to play with a bit-accurate model of their IP without even having to leave the MATLAB environment. Riviera-PRO’s MATLAB interface supports the flow in which you can keep MATLAB as a main environment and can call Riviera-PRO for HDL simulations. This way, you may not even need to deal with the HDL simulation environment at all (given your design-specific interface implemented by someone else at the HDL side). Please continue reading if you want to pursue this approach.

NOTE: In both approaches listed above, all data transfer operations over the interface are controlled from your HDL code. Communication with MATLAB is accomplished with a dedicated set of subprograms prepared for both Verilog and VHDL.

Implementing Your Design-Specific Interface

You can skip to the next section if your HDL model already has the interface implemented. The MATLAB interface operation is based on calling interface functions within the HDL code. If you need to implement the interface from scratch, refer to the following application note:

Interface highlights

Setting up MATLAB for Co-Simulation

In order to setup the interface, follow the configuration procedure described below:

  1. Start MATLAB.

  2. Change the current directory in the MATLAB window to the $aldec/interfaces/matlab directory.

  3. Type setup in the MATLAB Command Window and press Enter. The appearing warning dialog box prevents you from accidental removal of previous versions of the Riviera-PRO Toolbox installed in MATLAB. Press Yes to continue. The following message should be displayed in the Command Window:

    Welcome to Riviera-Pro Toolbox Setup.
    Installing Riviera-Pro Toolbox...
    Adding Riviera-Pro Toolbox path:

The Riviera-Pro Toolbox has been installed successfully. After the setup is finished, you are able to use the Riviera-PRO Toolbox immediately. The Riviera-PRO Toolbox comprises of the MATLAB and Simulink Interfaces.

Running Simulation from MATLAB

Here are the basic steps you need to follow to run simulation from MATLAB:

  1. Make sure you have implemented your design-specific interface

  2. Start MATLAB and create an M-script in it

  3. Execute (run) this script in MATLAB which will call Riviera-PRO and perform HDL simulation

Riviera-PRO uses commands to perform HDL simulation. Please refer to the manual at for more detail on how to use Riviera-PRO macro commands. Below is the sample script to perform HDL compilation and simulation from the MATLAB environment (based on the fft_analysis sample design available with Riviera-PRO installation at /examples/tools/matlab):

%Initialize Riviera-PRO from Matlab

%Compile project
riv_do('alib work')
riv_do('acom -dbg src/cfft/*.vhd')
riv_do('acom -dbg src/*.vhd')

%Execute 6 simulation for different window_type 'w' value
for w=1:6
    asimstring = ['asim -ieee_nowarn -Gwindow_type=' num2str(w) ' top_fft_tb']
    riv_do('run -all')
    %Collect all 6 results to the common arrays


Please use the above script from MATLAB (from fft_analysis directory) to perform co-simulation. Here are the results of the sample script execution:


Riviera-PRO can be started from MATLAB, and execute designs with MATLAB interface code. It allows creating robust testbench scenarios with extensive math data analysis of multiple HDL simulation runs within one MATLAB instance.

Printed version of site: