Generating HDL Code Using the GUI :: Introduction to HDL Code Gene...

jar:file:///C:/Program%20Files/MATLAB/R2009b/help/toolbox/slhdlcod...

Generating HDL Code Using the GUI

On this page Simulink HDL Coder GUI Overview Creating a Folder and Local Model File Viewing Coder Options in the Configuration Parameters Dialog Box Creating a Control File Initializing Model Parameters with hdlsetup Selecting and Checking a Subsystem for HDL Compatibility Generating VHDL Code Generating VHDL Test Bench Code Verifying Generated Code Generating Verilog Model and Test Bench Code

Simulink HDL Coder GUI Overview

You can view and edit options and parameters that affect HDL code generation in the Configuration Parameters dialog box, or in the Model Explorer. The following figure shows the top-level HDL Coder options pane as displayed in the Configuration Parameters dialog box.

The following figure shows the top-level HDL Coder options pane as displayed in the Model Explorer.

1 of 9

30/10/2010 18:13

Generating HDL Code Using the GUI :: Introduction to HDL Code Gene...

jar:file:///C:/Program%20Files/MATLAB/R2009b/help/toolbox/slhdlcod...

If you are not familiar with Simulink configuration sets and how to view and edit them in the Configuration Parameters dialog box, see the following documentation: Setting Up Configuration Sets Configuration Parameters Dialog Box If you are not familiar with the Model Explorer, see Exploring, Searching, and Browsing Models. In the hands-on code generation exercises that follow, you will use the Configuration Parameters dialog box to view and set the coder options and controls. The exercises use the sfir_fixed demo model (see The sfir_fixed Demo Model) in basic code generation and verification steps. Back to Top

Creating a Folder and Local Model File

In this section you will setup the folder and a local copy of the demo model.

Creating a Folder
Start by setting up a working folder: 1. Start the MATLAB software. 2. Create a folder named sl_hdlcoder_work, for example: mkdir C:\work\sl_hdlcoder_work You will use sl_hdlcoder_work to store a local copy of the demo model and to store directories and code generated by the coder. The location of the folder does not matter, except that it should not be within the MATLAB folder tree. 3. Make the sl_hdlcoder_work folder your working folder, for example: cd C:\work\sl_hdlcoder_work

Making a Local Copy of the Model File

2 of 9

30/10/2010 18:13

Generating HDL Code Using the GUI :: Introduction to HDL Code Gene...

jar:file:///C:/Program%20Files/MATLAB/R2009b/help/toolbox/slhdlcod...

Next, make a copy of the sfir_fixed demo model: 1. To open the demo model, type the following command at the MATLAB prompt: demos The Help window opens. 2. In the Demos pane on the left, click the + for Simulink. Then click the + for Simulink HDL Coder. Then double-click the list entry for the Symmetric FIR Filter demo. The sfir_fixed model opens. 3. Select Save As from the File menu and save a local copy of sfir_fixed.mdl to your working folder. 4. Leave the sfir_fixed model open and proceed to the next section. Back to Top

Viewing Coder Options in the Configuration Parameters Dialog Box

The coder option settings are displayed as a category of the model's active configuration set. You can view and edit these options in the Configuration Parameters dialog box, or in the Model Explorer. This discussion uses the Configuration Parameters dialog box. To access the coder settings: 1. Select Configuration Parameters from the Simulation menu in the sfir_fixed model window. The Configuration Parameters dialog box opens with the Solver options pane displayed, as shown in the following figure.

2. Observe that the Select tree in the left pane of the dialog box includes an HDL Coder category, as shown. 3. Click the HDL Coder category in the Select tree. The HDL Coder pane is displayed, as shown in the following figure.

3 of 9

30/10/2010 18:13

Generating HDL Code Using the GUI :: Introduction to HDL Code Gene...

jar:file:///C:/Program%20Files/MATLAB/R2009b/help/toolbox/slhdlcod...

The HDL Coder pane contains top-level options and buttons that control the HDL code generation process. Several other categories of options are available under the HDL Coder entry in the Select tree. This exercise uses a small subset of these options, leaving the others at their default settings. Code Generation Options in the Simulink HDL Coder GUI summarizes all the options available in the HDL Coder category. Back to Top

Creating a Control File

Code generation control files (referred to in this document as control files) let you Save your model's HDL code generation options. Extend the HDL code generation process and direct its details. A control file is an M-file that you attach to your model, using either the makehdl command or the Configuration Parameters dialog box. In this tutorial, you will use a control file to save HDL code generation options. This is a required step with most models, because HDL code generation settings are not saved in the .mdl file like other components of a model's configuration set. If you want your HDL code generation settings to persist across sessions with a model, you must save your current settings to a control file. The control file is then linked to the model, and the linkage is preserved when you save the model. When a control file is linked to a model, the control file name is displayed in the File name field of the top-level HDL Coder options pane. The sfir_fixed demo model is attached to the control file sfir_fixed_control.m. This control file is stored within the MATLAB demo directories and should not be overwritten. For use in this tutorial, you will save the current HDL code generation options to a new control file in the working folder. Later in the tutorial, you will change some options and save them to the control file.

4 of 9

30/10/2010 18:13

Generating HDL Code Using the GUI :: Introduction to HDL Code Gene...

jar:file:///C:/Program%20Files/MATLAB/R2009b/help/toolbox/slhdlcod...

To save the current HDL code generation options to a new control file: 1. 2. 3. 4. Open the Configuration Parameters dialog box and select the HDL Coder options pane. Under Code generation control file, click the Save button. A standard file dialog box opens. Navigate to your current working folder and save the file as sfir_fixed_control.m. Select Save from the File menu. When you save the model, the control file linkage information is written to the .mdl file, and the control file linkage persists in future sessions with your model.

This tutorial uses a control file only as a mechanism for saving HDL code generation settings. This simple application of a control file does not require knowledge of any internal details about the file. You can also use a control file to direct or customize many details of the code generation process. It is strongly recommended that you read Code Generation Control Files, after completing this tutorial. Back to Top

Initializing Model Parameters with hdlsetup

Before generating code, you must set some parameters of the model. Rather than doing this manually, use the M-file utility, hdlsetup.m. The hdlsetup command uses the set_param function to set up models for HDL code generation quickly and consistently. To set the model parameters: 1. At the MATLAB command prompt, type hdlsetup('sfir_fixed') 2. Select Save from the File menu, to save the model with its new settings. You do not need to update the control file at this point, because hdlsetup modifies only the model parameters, not the HDL code generation options. Before continuing with code generation, consider the settings that hdlsetup applies to the model. hdlsetup configures Solver options that are recommended or required by the coder. These are Type: Fixed-step. (The coder currently supports variable-step solvers under limited conditions. See hdlsetup.) Solver: Discrete (no continuous states). Other fixed-step solvers could be selected, but this option is usually the correct one for simulating discrete systems. Tasking mode: SingleTasking. The coder does not currently support models that execute in multitasking mode. Do not set Tasking mode to Auto.

5 of 9

30/10/2010 18:13

Generating HDL Code Using the GUI :: Introduction to HDL Code Gene...

jar:file:///C:/Program%20Files/MATLAB/R2009b/help/toolbox/slhdlcod...

hdlsetup also configures the model start and stop times and fixed-step size as follows: Start Time: 0.0 s Stop Time: 10 s Fixed step size (fundamental periodic sample time): auto If Fixed step size is set to auto the step size is chosen automatically, based on the sample times specified in the model. In the demo model, only the Signal From Workspace block specifies an explicit sample time (1 s); all other blocks inherit this sample time. The model start and stop times determine the total simulation time. This in turn determines the size of data arrays that are generated to provide stimulus and output data for generated test benches. For the demo model, computation of 10 seconds of test data does not take a significant amount of time. Computation of sample values for more complex models can be time consuming. In such cases, you may want to decrease the total simulation time. The remaining parameters set by hdlsetup affect error severity levels, data logging, and model display options. If you want to view the complete set of model parameters affected by hdlsetup, open hdlsetup.m in the MATLAB Editor. The model parameter settings provided by hdlsetup are intended as useful defaults, but they may not be appropriate for all your applications. For example, hdlsetup sets a default Simulation stop time of 10 s. A total simulation time of 1000 s would be more realistic for a test of the sfir_fixed demo model. If you would like to change the simulation time, enter the desired value into the Simulation stop time field of the Simulink window. See the "Model Parameters" table in the "Model and Block Parameters" section of the Simulink documentation for a summary of user-settable model parameters. Back to Top

Selecting and Checking a Subsystem for HDL Compatibility

The coder generates code from either the current model or from a subsystem at the root level of the current model. You use the Generate HDL for menu to select the model or subsystem from which code is to be generated. Each entry in the menu shows the full path to the model or one of its subcomponents. The sfir_fixed demo model is configured with the sfixed_fir/symmetric_fir subsystem selected for code generation. If this is not the case, make sure that the symmetric_fir subsystem is selected for code generation, as follows: 1. Select sfixed_fir/symmetric_fir from the Generate HDL for menu. 2. Click Apply. The dialog box should now appear as shown in the following figure.

To check HDL compatibility for the subsystem:

6 of 9

30/10/2010 18:13

Generating HDL Code Using the GUI :: Introduction to HDL Code Gene...

jar:file:///C:/Program%20Files/MATLAB/R2009b/help/toolbox/slhdlcod...

1. Click the Run Compatibility Checker button. 2. The HDL compatibility checker examines the system selected in the Generate HDL for menu for any compatibility problems. In this case, the selected subsystem is fully HDL-compatible, and the compatibility checker displays the following message: ### Starting HDL Check. ### HDL Check Complete with 0 errors, warnings and messages. 3. The compatibility checker also displays an HTML report in a Web browser, as shown in the following figure.

Back to Top

Generating VHDL Code

The top-level HDL Coder options are now set as follows: The Generate HDL for field specifies the sfixed_fir/symmetric_fir subsystem for code generation. The Language field specifies (by default) generation of VHDL code. The Folder field specifies a target folder that stores generated code files and scripts. The default target folder is a subfolder of your working folder, named hdlsrc. The following figure shows these settings.

Before generating code, select Current Folder from the Desktop menu in the MATLAB window. This displays the Current Folder browser, which lets you access your working folder and the files that will be generated within it. To generate code: 1. Click the Generate button.

7 of 9

30/10/2010 18:13

Generating HDL Code Using the GUI :: Introduction to HDL Code Gene...

jar:file:///C:/Program%20Files/MATLAB/R2009b/help/toolbox/slhdlcod...

2. As code generation proceeds, the coder displays progress messages. The process should complete successfully with the message ### HDL Code Generation Complete. Observe that the names of generated files in the progress messages are hyperlinked. After code generation completes, you can click these hyperlinks to view the files in the MATLAB Editor. The coder compiles the model before generating code. Depending on model display options (such as port data types, etc.), the appearance of the model may change after code generation. A folder icon for the hdlsrc folder is now visible in the Current Folder browser. To view generated code and script files, double-click the hdlsrc folder icon. The files that were generated in the hdlsrc folder are symmetric_fir.vhd: VHDL code. This file contains an entity definition and RTL architecture implementing the symmetric_fir filter. symmetric_fir_compile.do: Mentor Graphics ModelSim compilation script (vcom command) to compile the generated VHDL code. symmetric_fir_synplify.tcl: Synplify synthesis script. symmetric_fir_map.txt: Mapping file. This report file maps generated entities (or modules) to the subsystems that generated them (see Code Tracing Using the Mapping File). To view the generated VHDL code in the MATLAB Editor, double-click the symmetric_fir.vhd file icon in the Current Folder browser. At this point it is suggested that you study the ENTITY and ARCHITECTURE definitions while referring to HDL Code Generation Defaults in the makehdl reference documentation. The reference documentation describes the default naming conventions and correspondences between the elements of a model (subsystems, ports, signals, etc.) and elements of generated HDL code. Before proceeding to the next section, close any files you have opened in the editor. Then, click the Go Up One Level button in the Current Folder browser, to set the current folder back to your sl_hdlcoder_work folder.

3. 4.

5.

6.

Back to Top

Generating VHDL Test Bench Code

At this point, the Generate HDL for, Language, and Folder fields are set as they were in the previous section. Accordingly, you can now generate VHDL test bench code to drive the VHDL code generated previously for the sfixed_fir/symmetric_fir subsystem. The code will be written to the same target folder as before. To generate a VHDL test bench: 1. Click the Test Bench entry in the HDL Coder list in the Select tree. The Test Bench pane is displayed, as shown in the following figure.

2. Select the HDL test bench option. 3. Click the Generate Test bench button. 4. As test bench generation proceeds, the coder displays progress messages. The process should complete successfully with the message

8 of 9

30/10/2010 18:13

Generating HDL Code Using the GUI :: Introduction to HDL Code Gene...

jar:file:///C:/Program%20Files/MATLAB/R2009b/help/toolbox/slhdlcod...

### HDL TestBench Generation Complete. 5. The files that were generated in the hdlsrc folder are symmetric_fir_tb.vhd: VHDL test bench code and generated test and output data. symmetric_fir_tb_compile.do: Mentor Graphics ModelSim compilation script (vcom commands). This script compiles and loads both the entity to be tested (symmetric_fir.vhd) and the test bench code (symmetric_fir_tb.vhd). symmetric_fir_tb_sim.do: Mentor Graphics ModelSim script to initialize the simulator, set up wave window signal displays, and run a simulation. Back to Top

Verifying Generated Code

You can now take the generated code and test bench to an HDL simulator for simulated execution and verification of results. See Simulating and Verifying Generated HDL Code for an example of how to use generated test bench and script files with the Mentor Graphics ModelSim simulator. Back to Top

Generating Verilog Model and Test Bench Code

The procedure for generating Verilog code is the same as for generating VHDL code (see Generating a VHDL Entity from a Subsystem and Generating VHDL Test Bench Code), except that you should select Verilog from the Language field of the HDL Coder options, as shown in the following figure.

Back to Top
Provide feedback about this page

Generating HDL Code Using the Command Line Interface

Simulating and Verifying Generated HDL Code

1984-2009 The MathWorks, Inc. Terms of Use Patents Trademarks Acknowledgments

9 of 9

30/10/2010 18:13