Visible to Intel only — GUID: jwf1521053361640
Ixiasoft
Visible to Intel only — GUID: jwf1521053361640
Ixiasoft
12.1.1.7. XML Syntax of an RTL Module
The following XML specification file is for an RTL module named my_fp_sqrt_double (line 2) that implements an OpenCL™ helper function named my_sqrtfd (line 2).
1: <RTL_SPEC>
2: <FUNCTION name="my_sqrtfd" module="my_fp_sqrt_double">
3: <ATTRIBUTES>
4: <IS_STALL_FREE value="yes"/>
5: <IS_FIXED_LATENCY value="yes"/>
6: <EXPECTED_LATENCY value="31"/>
7: <CAPACITY value="1"/>
8: <HAS_SIDE_EFFECTS value="no"/>
9: <ALLOW_MERGING value="yes"/>
10: </ATTRIBUTES>
11: <INTERFACE>
12: <AVALON port="clock" type="clock"/>
13: <AVALON port="resetn" type="resetn"/>
14: <AVALON port="ivalid" type="ivalid"/>
15: <AVALON port="iready" type="iready"/>
16: <AVALON port="ovalid" type="ovalid"/>
17: <AVALON port="oready" type="oready"/>
18: <INPUT port="datain" width="64"/>
19: <OUTPUT port="dataout" width="64"/>
20: </INTERFACE>
21: <C_MODEL>
22: <FILE name="c_model.cl" />
23: </C_MODEL>
24: <REQUIREMENTS>
25: <FILE name="my_fp_sqrt_double_s5.v" />
26: <FILE name="fp_sqrt_double_s5.vhd" />
27: </REQUIREMENTS>
28: <RESOURCES>
29: <ALUTS value="2057"/>
30: <FFS value="3098"/>
31: <RAMS value="15"/>
32: <MLABS value="43"/>
33: <DSPS value="1.5"/>
34: </RESOURCES>
35: </FUNCTION>
36: </RTL_SPEC>
XML Element | Description |
---|---|
RTL_SPEC | Top-level element in the XML specification file. There can only be one such top-level element in the file. In this example, the name RTL_SPEC is historic and carries no file-specific meaning. |
FUNCTION | Element that defines the OpenCL function that the RTL module implements. The name attribute within the FUNCTION element specifies the function's name. You may have multiple FUNCTION elements, each declaring a different function that you can call from the OpenCL kernel. The same RTL module can implement multiple functions by specifying different parameters. |
ATTRIBUTES | Element containing other XML elements that describe various characteristics (for example, latency) of the RTL module. The example RTL module takes one PARAMETER setting named WIDTH, which has a value of 32. Refer to XML Elements Associated with the ATTRIBUTES Element in the XML Specification File of an RTL Module for more details other ATTRIBUTES-specific elements.
Note: If you create multiple OpenCL helper functions for different modules, or use the same RTL module with different PARAMETER settings, you must create a separate FUNCTION element for each function.
|
INTERFACE | Element containing other XML elements that describe the RTL module's interface. The example XML specification file shows the Avalon®-ST interface signals that every RTL module must provide (that is, clock, resetn, ivalid, iready, ovalid, and oready). The signal names must match the ones specified in the .xml file. An error will occur during library creation if a signal name is inconsistent. |
C_MODEL | Element specifying one or more files that implement OpenCL C model for the function. The model is used only during emulation. However, the C_MODEL element and the associated file(s) must be present when you create the library file. |
REQUIREMENTS | Element specifying one or more RTL resource files (that is, .v, .sv, .vhd, .hex, and .mif). The specified paths to these files are relative to the location of the XML specification file. Each RTL resource file becomes part of the associated Platform Designer component that corresponds to the entire OpenCL system.
Note: The Intel® FPGA SDK for OpenCL™ library feature does not support .qip files. An Intel® FPGA SDK for OpenCL™ Offline Compiler error will occur if you compile an OpenCL kernel while using a library that includes an unsupported resource file type.
|
RESOURCES | Optional element specifying the FPGA resources that the RTL module uses. If you do not specify this element, the FPGA resources that the RTL module uses will default to zero. |