HDL Block Properties: Native Floating Point - MATLAB & Simulink (original) (raw)

Overview

Block implementation parameters enable you to control details of the code generated for specific block implementations. See Set and View HDL Model and Block Parameters to learn how to select block implementations and parameters in the GUI or the command line.

Property names are specified as character vectors. The data type of a property value is specific to the property. This section describes the syntax of each block implementation parameter that you can specify in the Native Floating Point tab of the HDL Block Properties. You can see how specifying the parameter affects the generated code.

HDL Block Properties of Library Blocks

HDL block properties of library blocks are treated similar to mask parameters. When you instantiate library blocks in your model, the current HDL block properties of that library block are copied to instances of that block in your model. The HDL block properties of these instances are not synchronized with the HDL block properties of the library block. That is, if you change the HDL block property of the library block, the change does not get propagated to instances of the library block that you already added to your Simulink® model. If you want the HDL block properties of a library block to be synchronized with its instances in the model, create a Subsystem and then place this block inside that Subsystem. The HDL block properties of blocks that reside inside the library block are synchronized with the corresponding instances in your model.

Suppose a library contains a Subsystem block with HDL architecture set to Module. When you instantiate this block in your model, the block instance uses Module as the HDL architecture. If you change the HDL architecture of the Subsystem block in the library toBlackBox, existing instances of that Subsystem block in your model still use Module as the HDL architecture. If you now add instances of the Subsystem block from the library in your model, the new block instances get a copy of the current HDL block properties, and therefore useBlackBox as the HDL architecture. If you want the HDL architecture of the Subsystem block in the library to be synchronized with its instances in the model, create a wrapper subsystem with the HDL architecture that you want inside thisSubsystem.

CheckResetToZero

You can use the CheckResetToZero property for themod and rem functions of the Math Function block in native floating-point mode. If you have numbers a andb such that the quotient a/b is close to an integer, this setting treats a as an integral multiple of b, and rem(a,b)=0. This result is numerically accurate and matches the Simulink simulation result. However, computing this result uses additional resources and increases the area footprint on the target FPGA device.

For example, for these sets of numbers, you get different simulation results when you enable and disable the CheckResetToZero setting.

Set CheckResetToZero For the Math Function Block

To set CheckResetToZero for a block from the HDL Block Properties dialog box:

1. Right-click the block.
2. Select .
3. For CheckResetToZero, select on oroff.

To set CheckResetToZero for the Math Function block inside a subsystem, my_dut in your Simulink model my_design:

hdlset_param('my_design/my_dut/Math', 'CheckResetToZero, 'on')

See also hdlset_param.

DivisionAlgorithm

You can use the DivisionAlgorithm property when you enableNative Floating Point mode for the Divide block and the Math Function block in Reciprocal mode.

Single-Precision Division Resource Utilization and Maximum Clock Frequency onXilinx Virtex-7

Specify DivisionAlgorithm For the Math Function or Division Block

To specify DivisionAlgorithm for a block from the HDL Block Properties dialog box:

1. Right-click the block.
2. Select > .
3. In the Native Floating Point tab, specify theDivisionAlgorithm.

To specify DivisionAlgorithm for the block at the command line, use hdlset_param. For example, this command specifies Radix-4 mode for a Divide block inside a subsystem, my_dut in your Simulink model my_design:

hdlset_param('my_design/my_dut/Divide, 'DivisionAlgorithm', 'Radix-4')

HandleDenormals

You can use the HandleDenormals property for certain blocks that support HDL code generation in Native Floating Point mode. Denormal numbers are numbers that have magnitudes less than the smallest floating-point number that can be represented without leading zeros in the mantissa. With this setting, you can specify whether you want HDL Coder to insert additional logic to handle the denormal numbers in your design. For more information, see Denormal Numbers.

To enable HandleDenormals for a block within a model, set the parameter, HandleDenormals, to 'on' for that block.

Set Handle Denormals For a Block

To set handle denormals for a block from the HDL Block Properties dialog box:

1. Right-click the block.
2. Select > .
3. For HandleDenormals, select , , or .

To set handle denormals for a block from the command line, usehdlset_param. For example, to enable handle denormals for aProduct block inside a subsystem, my_dut in your Simulink model my_design:

hdlset_param('my_design/my_dut/Product', 'HandleDenormals', 'on')

See also Handle Denormals.

InputRangeReduction

You can use the InputRangeReduction property for thesin, cos, tan, sincos, andcos+jsin functions of the Trigonometric Function block inNative Floating Point mode. By default, this setting is enabled for the block, and it assumes that your input range is unbounded. If your input to the block is bounded in the range [-pi, pi], your design does not require the logic to reduce the input range. In that case, you can disable this setting, and the block implementation incurs a lower latency and uses fewer resources on the target hardware. When you disable the setting, the generated model contains a block that verifies whether the inputs are bounded in the range [-pi, pi].If you have unbounded inputs, the generated model triggers an assertion during simulation.

Set InputRangeReduction For the Trigonometric Function Block

To set InputRangeReduction for a block from the HDL Block Properties dialog box:

1. Right-click the block.
2. Select .
3. In the Native Floating Point tab, forInputRangeReduction, select on oroff.

To disable InputRangeReduction for the Trigonometric Function block inside a subsystem, my_trigonometric in your Simulink model my_design:

hdlset_param('my_design/my_dut/my_trigonometric', ... 'InputRangeReduction, 'off')

See also hdlset_param.

LatencyStrategy

You can use the LatencyStrategy property for certain blocks that support HDL code generation for fixed-point and floating-point types. When you use floating-point types, select the model configuration parameter Use Floating Point. For fixed-point types, the property specifies zero, maximum, or custom latency. For floating-point types, the property specifies whether the blocks map to minimum, maximum, or a custom latency for the operator.

To specify the minimum latency option for a block within a model, set the parameter,LatencyStrategy, to 'MIN' for that block.

To learn how to set model-level latency strategy setting, see Latency Considerations with Native Floating Point.

Set Latency Strategy for Fixed-Point Blocks

When you use fixed-point types, you can specify theLatencyStrategy for these blocks.

• Divide and Reciprocal blocks that have ShiftAdd as the HDL architecture.
• Sqrt block that hasSqrtFunction as the HDL architecture.
• Trigonometric Function block that hasFunction set to sin, cos,sincos, cos+jsin, or atan2 and Approximation method as CORDIC.

To set latency strategy for a subsystem from the HDL Block Properties dialog box:

1. In the Simulink toolstrip, on the Apps tab, select HDL Coder.
2. Select the block, and on the tab, click theHDL Block Properties button.
3. In the General tab, specify theLatencyStrategy. If you setLatencyStrategy to , you must specify a value for the CustomLatency.

To specify the latency strategy for a block from the command line, usehdlset_param. For example, to specify the minimum latency for aProduct block inside a subsystem my_dut in your Simulink model my_design:

hdlset_param('my_design/my_dut/Product', 'LatencyStrategy', 'MAX')

See also hdlset_param.

Set Latency Strategy for Floating-Point Block

To set latency strategy for a subsystem from the HDL Block Properties dialog box:

1. In the Simulink toolstrip, on the Apps tab, select HDL Coder.
2. Select the block, and on the tab, click theHDL Block Properties button.
3. In the Native Floating Point tab, specify theLatencyStrategy. If you setLatencyStrategy to , you must specify a value for the NFPCustomLatency.

For details, see the "HDL Code Generation" section of each block page. To learn about blocks for which you can specify a custom latency, see NFPCustomLatency.

To specify the latency strategy for a block from the command line, usehdlset_param. For example, to specify the minimum latency for aProduct block inside a subsystem my_dut in your Simulink model my_design:

hdlset_param('my_design/my_dut/Product', 'LatencyStategy', 'MIN')

See also hdlset_param.

CustomLatency

You can specify a custom latency for certain blocks for fixed-point types. By using the custom latency strategy, you can trade-off between clock frequency and power consumption. To specify a custom latency strategy, set LatencyStrategy toCUSTOM and specify a value for CustomLatency. For details, see the "HDL Code Generation" section of each block page.

You can specify the CustomLatency setting for these blocks with fixed-point types.

• Divide and Reciprocal blocks that have ShiftAdd as the HDL architecture.
• Sqrt block that hasSqrtFunction as the HDL architecture.
• Trigonometric Function block that hasFunction set to sin, cos,sincos, cos+jsin, or atan2 and Approximation method as CORDIC.

Set Custom Latency Value For a Block

To set custom latency value for a subsystem from the HDL Block Properties dialog box:

1. In the Simulink toolstrip, on the Apps tab, select HDL Coder.
2. Select the block, and on the tab, click theHDL Block Properties button.
3. In the General tab, setLatencyStrategy to and specify a value for CustomLatency.

To specify the latency strategy for a block from the command line, usehdlset_param. For example, to specify a custom latency of four for a Product block inside a subsystem my_dut in your Simulink model my_design:

hdlset_param('my_design/my_dut/Product', 'LatencyStrategy', 'Custom') hdlset_param('my_design/my_dut/Product', 'CustomLatency', 4)

See also hdlset_param.

IterationsPerPipeline

When you set LatencyStrategy toCustom(PerIterations), use IterationsPerPipeline setting to specify the number of iterations per pipeline stages. Use theCustom(PerIterations) latency strategy to control the pipeline stages in the generated code and optimize the design for speed and resource utilization.

You can specify the IterationsPerPipeline setting for the blocks that uses iterative algorithm such as ShiftAdd andCORDIC for fixed-point data types, including:

• Divide and Reciprocal blocks that have ShiftAdd as the HDL architecture.
• Sqrt and Reciprocal Sqrtblock that has SqrtFunction as the HDL architecture.
• Trigonometric Function block that hasFunction set to sin, cos,sincos, cos+jsin, or atan2 and Approximation method as CORDIC.

Set Iterations Per Pipeline Value For a Block

To set iterations per pipeline value for a subsystem from the HDL Block Properties dialog box:

1. In the Simulink toolstrip, on the Apps tab, select HDL Coder.
2. Select the block, and on the tab, click theHDL Block Properties button.
3. In the General tab, setLatencyStrategy toCustom(PerIterations) and specify a value forIterationsPerPipeline.

To specify the latency strategy for a block from the command line, usehdlset_param. For example, to specify the iterations per pipeline of four for a Divide block inside a subsystem my_dut in your Simulink model my_design:

hdlset_param('my_design/my_dut/Divide', 'LatencyStrategy', 'Custom(PerIterations)') hdlset_param('my_design/my_dut/Divide', 'IterationsPerPipeline', 4)

See also:

• Divide
• Reciprocal
• Sqrt
• rSqrt
• Atan2
• Sin
• SinCos
• Cos
• Cos+jSin

NFPCustomLatency

You can specify a custom latency for certain blocks in the native floating-point mode. By using the custom latency strategy, you can trade-off between clock frequency and power consumption. To specify a custom latency strategy, set LatencyStrategy to Custom and specify a value for NFPCustomLatency. You can specify the custom latency value from 1 to Max latency of the block. For more information on latency values of floating-point operators, see Latency Values of Floating-Point Operators.

You can specify the NFPCustomLatency setting for these blocks with both single and double data types.

• Add
• Subtract
• Product
• Math Function in Reciprocal mode
• Gain
• Divide
• Relational Operator
• Data Type Conversion
• Rounding Function

You can also specify a NFPCustomLatency setting for these blocks with single data types.

• Sqrt
• Reciprocal Sqrt
• Sum of Elements
• Product of Elements

Set Custom Latency Value For a Block

To set custom latency value for a subsystem from the HDL Block Properties dialog box:

1. Right-click the block.
2. Select > .
3. In the Native Floating Point tab, forLatencyStrategy, select .
4. Specify a value for the NFPCustomLatency.

To specify the latency strategy for a block from the command line, usehdlset_param. For example, to specify a custom latency of four for a Product block inside a subsystem my_dut in your Simulink model my_design:

hdlset_param('my_design/my_dut/Product', 'LatencyStategy', 'Custom') hdlset_param('my_design/my_dut/Product', 'NFPCustomLatency', 4)

See alsohdlset_param.

MantissaMultiplyStrategy

You can use the MantissaMultiplyStrategy property for multipliers that support HDL code generation in native floating-point mode. Blocks that have this setting include Product, Divide, Math Function (in Reciprocal mode), and so on. By using this setting, you can specify how you want HDL Coder to implement the mantissa multiplication operation for the blocks.

To implement the mantissa multiplication with adders and shifters, setMantissaMultiplyStrategy, to'NoMultiplierFullAddShift' for that block.

Set Mantissa Multiply Strategy For a Block

To set adaptive pipelining for a subsystem from the HDL Block Properties dialog box:

1. Right-click the block.
2. Select > .
3. In the Native Floating Point tab, forMantissaMultiplyStrategy, select , , , or .

To specify the mantissa multiply strategy for a block from the command line, usehdlset_param. For example, to implement the mantissa multiplication using adders and shifters for a Product block inside a subsystemmy_dut in your Simulink model my_design:

hdlset_param('my_design/my_dut/Product', ... 'MantissaMultiplyStrategy', 'PartMultiplierPartAddShift')

See also hdlset_param.

MaxIterations

You can use the MaxIterations property for the mod and rem functions of the Math Function block inNative Floating Point mode. If you have numbers a and b that are significantly large integers, you can increase theMaxIterations setting to match the Simulink simulation result. However, computing this result uses additional resources and increases the area footprint on the target FPGA device.

Set MaxIterations For the Math Function Block

To set MaxIterations for a block from the HDL Block Properties dialog box:

1. Right-click the block.
2. Select > .
3. In the Native Floating Point tab, forMaxIterations, select , , or .

To set handle denormals for a block from the command line, usehdlset_param. For example, to enable adaptive pipelining for aProduct block inside a subsystem, my_dut in your Simulink model my_design:

hdlset_param('my_design/my_dut/Product', 'HandleDenormals', 'on')

See also hdlset_param.

See Also

Topics

• Floating Point Support: Field-Oriented Control Algorithm
• Getting Started with HDL Coder Native Floating-Point Support