Open the FPGA-in-the-Loop Wizard.
In the MATLAB command window, type the following:
To restore a previous session, use this command:
(This page is for FIL System object™. For Simulink® block FIL options, see Step 3: Set FIL Options for FIL Block.)
In the FIL Options page:
FIL Simulation with: Select
Board Name: Select an FPGA development board. If you have not yet downloaded an HDL Verifier™ FPGA board support package, see Download FPGA Board Support Package. (If you do not see any boards listed, then you have not yet downloaded a support package). If you plan to define a custom board yourself, see FPGA Board Customization.
FPGA-in-the-Loop Connection: FIL simulation
connection method. The options in the drop-down menu update depending
on the connection methods supported for the target board you selected.
If the target board and HDL
Verifier support the connection, you
When you select an Ethernet connection, you can adjust the board IP and MAC addresses, if necessary.
|Board IP address|
Use this option for setting the IP address of the board if it is not the default IP address (192.168.0.2).
If the default board IP address (192.168.0.2) is in use by another device, or you need a different subnet, change the Board IP address according to the following guidelines:
|Board MAC address|
Under most circumstances, you do not need to change the board MAC address. If you connect more than one FPGA development board to a single host computer, change the board MAC address for any additional boards so that each address is unique. You must have a separate NIC for each board.
To change the Board MAC address, click in the Board MAC address field. Specify an address that is different from that belonging to any other device attached to your computer. To obtain the Board MAC address for a specific FPGA development board, refer to the label affixed to the board or consult the product documentation.
FPGA system clock frequency (MHz): Enter
a target clock frequency. For Altera boards and Xilinx ISE-supported
filWizard checks the requested frequency
against those possible for the requested board. If the requested frequency
is not possible for this board,
an error and suggests an alternate frequency. For Xilinx Vivado-supported
boards, or PCI
check the frequency. The synthesis tools make a best effort attempt
at the requested frequency but may choose an alternate frequency if
the specified frequency was not achievable. The default is
(This page is for FIL System object. For Simulink block HDL source files, see Step 4: Add HDL Source Files for FIL Block.)
In the Source Files page:
Specify the HDL design to be cosimulated in the FPGA. These files are the HDL design files to be verified on the FPGA board.
Indicate source files by clicking Add. Select files using the file selection dialog box.
The FIL wizard attempts to identify the source file types. If any of the file types is not what you expect, you can change it by selecting from the File Type drop-down list. Acceptable file types are:
"Others" refers to the following:
For Altera, files specified as
added to the FPGA project, but they have no impact on the generated
block. For example, you can put some comments in a “readme”
file and include it in this file list.
For Xilinx, files specified as
be any file accepted by Xilinx ISE. ISE looks at the file extension
to determine how to use this file. For example, if you add foo.vhd
to the list and specify it as
treats the file as a VHDL file.
Specify which file contains the top-level HDL file.
Check the box on the row of the HDL file that contains the top-level HDL module in the column titled Top-level. The FIL wizard automatically fills the Top-level module name field with the name of the selected HDL file. If the top-level module name and file name do not match, you can manually change the top-level module name in this dialog box. Indicate the top-level module name before you continue.
(Optional) To display the full paths to the source files, check the box titled Show full paths to source files.
(This page is for FIL with a System object. For Simulink, see Step 5: Verify DUT I/O Ports for FIL Block.)
In the DUT I/O Ports page:
Review the port listing. The FIL wizard parses the top-level HDL module to obtain all the I/O ports and display them in the DUT I/O Ports table. The parser attempts to determine the port types from the port names. The wizard then displays these signals under Port Type.
Make sure all input/output/reset ports/clocks are mapped as you expect. If the parser assigned an incorrect port type for any port, you can manually change the signal. For synchronous design, specify a Clock, Reset, or, if desired, a Clock enable signal. The port types specified in this table must be the same as in the HDL code. There must be at least one output port.
Select Manually enter port information to add or remove signals.
Click Regenerate to reload the table with the original port definitions (from the HDL code).
(This page is for FIL System object. For Simulink block output types, see Step 6: Specify Output Types for FIL Block.)
In the Output Types page:
Specify output data types. The wizard assigns data types. If any output data type is not what you expect, manually change the type.
The data type can depend on the specified bit width.
You can specify the output type to be
(This page is for FIL System object. For Simulink, see Step 7: Specify Build Options for FIL Block.)
In the Build Options page:
Specify the folder for the output files. You can use the default option. Usually the default is a subfolder named after the top-level module, located under the current folder.
The Summary displays the locations of the ISE project file and the FPGA programming file. You may need those two files for advanced operations on the FIL block mask.
Click Build to initiate FIL System object generation.
The FIL wizard generates the following files:
a MATLAB function named
toplevel is the name of the HDL top
level. This file contains the code to download the FPGA programming
file to the FPGA.
function toplevel_programFPGA %Load the bitstream in the FPGA filProgramFPGA('Xilinx', '/dir/mybitstream.bit', 1); end
A MATLAB file named
toplevel is the name of the HDL top
level. This file contains a class definition derived from
initializes the private properties. This file is located in the current
The following is a sample of a class definition file generated
using the FIL wizard from a DUT named
classdef fft8_fil < hdlverifier.FILSimulation %fft8_fil is a filWizard generated class used for FPGA-In-the-Loop % simulation with the 'fft8' DUT. % fft8_fil connects MATLAB with a FPGA and cosimulate with it by % writing inputs in the FPGA and reading outputs from the FPGA. % % MYFIL = fft8_fil % % Step method syntax: % % [out1, out2, ...] = step(MYFIL, in1, in2, ...) connect to the FPGA, % write in1, in2, ... to the FPGA and read out1, out2, ... from % the FPGA % % fft8_fil methods: % % step - See above description for use of this method % release - Allow property value and input characteristics changes, and % release connection to FPGA board % clone - Create fft8_fil object with same property values % isLocked - Locked status (logical) % programFPGA - Load the programming file in the FPGA % % fft8_fil properties: % % DUTName - DUT top level name % InputSignals - Input paths in the HDL code % InputBitWidths - Width in bit of the inputs % OutputSignals - Output paths in the HDL code % OutputBitWidths - Width in bit of the outputs % OutputDataTypes - Data type of the outputs % OutputSigned - Sign of the outputs % OutputFractionLengths - Fraction lengths of the outputs % OutputDownsampling - Downsampling factor and phase of the outputs % OverclockingFactor - Overclocking factor of the hardware % SourceFrameSize - Frame size of the source (only for HDL source block) % Connection - Parameters for the connection with the board % FPGAVendor - Name of the FPGA chip vendor % FPGABoard - Name of the FPGA board % FPGAProgrammingFile - Path of the Programming file for the FPGA % ScanChainPosition - Position of the FPGA in the JTAG scan chain % % File Name: fft8_fil.m % Created: 26-Apr-2012 18:18:06 % % Generated by FIL Wizard properties (Nontunable) DUTName = 'fft8'; end methods function obj = fft8_fil %THE FOLLOWING PROTECTED PROPERTIES ARE SPECIFIC TO THE HW DUT %AND MUST NOT BE EDITED (RERUN THE FIL WIZARD TO CHANGE THEM) obj.InputSignals = char('Xin_re','Xin_im'); obj.InputBitWidths = [10,10]; obj.OutputSignals = char('Xout_re','Xout_im'); obj.OutputBitWidths = [13,13]; obj.Connection = char('UDP','192.168.0.2','00-0A-35-02-21-8A'); obj.FPGAVendor = 'Xilinx'; obj.FPGABoard = 'XUP Atlys Spartan-6 development board'; obj.ScanChainPosition = 1 ; %THE FOLLOWING PUBLIC PROPERTIES ARE RELATED TO THE SIMULATION %AND CAN BE EDITED WITHOUT RERUNING THE FIL WIZARD obj.OutputSigned = [true,true]; obj.OutputDataTypes = char('fixedpoint','fixedpoint'); obj.OutputFractionLengths = [9,9]; obj.OutputDownsampling = [1,0]; obj.OverclockingFactor = 1; obj.SourceFramieSize = 1; obj.FPGAProgrammingFile = 'S:\MATLAB\demo\fft8_fil\fft8_fil.bit'; end end end
The FIL wizard opens a command window.
In this window, the FPGA design software performs synthesis, fit, PAR, and FPGA programming file generation.
When the process completes, a message in the command window prompts you to close the window.
Create a custom
the class definition file derived using the FIL wizard. This code
snippet creates an instance of the class and initializes all properties.
MYFIL = toplevel_fil
If you generated your FIL System object from the HDL Workflow Advisor, it is unlikely that you need to adjust any settings. If you generated your FIL System object using the FIL Wizard, you may want to adjust some settings. You can adjust any writable property using one of these methods:
Change the property with the set method:
Set the property directly:
If you edit the
.m file, instantiate the object
in the workspace again, if you had done so previously.
For details about the object properties, see
You can program the FPGA using either the
programFPGA method of the FIL System
If you have not yet performed the Guided Hardware Setup, do so now before loading the
MYFIL is an instance of a
Call the System object in your MATLAB code.
Run your MATLAB code as you normally would. Make sure that you have performed the Guided Hardware Setup before beginning.
The first call to the object establishes communication with the FPGA board.