Documentation

Multiply-Add

Multiply-add combined operation

Library

HDL Coder / HDL Operations

Description

TheMultiply-Addblock computes the product of the first two inputs, a and b, and adds the result to the third input, c. The inputs can be vectors or scalars.

Operation Precision

The multiplication operation is full precision, regardless of the output type. TheInteger rounding mode,Output data type, andSaturate on integer overflowsettings apply only to the addition operation.

HDL Code Generation

Use theMultiply-Addblock to map a combined multiply-add or a multiply-subtract operation to a DSP unit in your target hardware.

When you generate HDL code for your model, HDL Coder™ configures the multiply-add operation so that your synthesis tool can map to a DSP unit.

Data Type Support

TheMultiply-Addblock accepts and outputs signals of any numeric data type that Simulink®supports, including fixed-point data types.

For more information, seeData Types Supported by Simulink.

Parameters

Function

Specify the function to perform a combined multiply and add or a multiply and subtract operation.

Settings

Default:c+(a.*b)

You can set the function to:

  • c+(a.*b)

  • c-(a.*b)

  • (a.*b)-c

Output data type

Specify the output data type.

Settings

Default:Inherit: Inherit via internal rule

Set the output data type to:

  • A rule that inherits a data type, for example,Inherit: Same as input

  • An expression that evaluates to a valid data type, for example,fixdt([],16,0)

Click theShow data type assistantbutton来显示the Data Type Assistant dialog box, which helps you to set theOutput data typeparameter.

For more information, seeControl Signal Data Types.

Integer rounding mode

Specify the rounding mode for fixed-point operations.

Settings

Default:Floor

天花板

Rounds positive and negative numbers toward positive infinity. Equivalent to the MATLAB®ceilfunction.

Convergent

Rounds number to the nearest representable value. If a tie occurs, rounds to the nearest even integer. Equivalent to the Fixed-Point Designer™convergentfunction.

Floor

Rounds positive and negative numbers toward negative infinity. Equivalent to the MATLABfloorfunction.

Nearest

Rounds number to the nearest representable value. If a tie occurs, rounds toward positive infinity. Equivalent to the Fixed-Point Designernearestfunction.

Round

Rounds number to the nearest representable value. If a tie occurs, rounds positive numbers toward positive infinity and rounds negative numbers toward negative infinity. Equivalent to the Fixed-Point Designerroundfunction.

Simplest

Chooses between rounding toward floor and rounding toward zero to generate rounding code that is as efficient as possible.

Zero

Rounds number toward zero. Equivalent to the MATLABfixfunction.

Command-Line Information

SeeBlock-Specific Parametersfor the command-line information.

See Also

For more information, seeRounding(Fixed-Point Designer).

Saturate on integer overflow

Specify whether overflows saturate.

Settings

Default:Off

On

Overflows saturate to either the minimum or maximum value that the data type can represent.

For example, an overflow associated with a signed 8-bit integer can saturate to -128 or 127.

Off

Overflows wrap to the appropriate value that the data type can represent.

For example, the number 130 does not fit in a signed 8-bit integer and wraps to -126.

Tips

  • Consider selecting this check box when your model has a possible overflow and you want explicit saturation protection in the generated code.

  • Consider clearing this check box when you want to optimize efficiency of your generated code.

    Clearing this check box also helps you to avoid overspecifying how a block handles out-of-range signals. For more information, seeCheck for Signal Range Errors.

  • 选中此复选框时,饱和适用to every internal operation on the block, not just the output or result.

  • In general, the code generation process can detect when overflow is not possible. In this case, the code generator does not produce saturation code.

Command-Line Information

Parameter:SaturateOnIntegerOverflow
Type:character vector
Value:'off'|'on'
Default:'off'

Introduced in R2015b

Was this topic helpful?
Simulink Documentation
万博1manbetx

Try MATLAB, Simulink, and Other Products

Get trial now