Check Static Range

Check that signal falls inside fixed range of amplitudes

Library:
Simulink / Model Verification
HDL Coder / Model Verification

Description

The Check Static Range block checks that each element of the input signal falls inside the same range of amplitudes at each time step. The Upper bound and Lower bound parameters define the upper and lower bounds of the range. The block then executes an assertion after comparison. If the signal falls inside the bounds, the assertion is true (1) and the block does nothing. If not, the block halts the simulation and returns an error message by default.

The input signal and bounds can be scalars, vectors, or matrices. All three must be the same data type. The block compares the value of the input to the bounds differently depending on the signal.

When comparing scalars to vectors or matrices, the block compares the scalar to each element of the non-scalar input signal or bounds.
When comparing vectors or matrix signals to other vectors or matrices, the block compares the input signal to the bounds element-by-element.
For models with more than one vector or matrix input signal or bounds, the vectors or matrices must have the same dimensions.

Ports

Input

expand all

`Port_1` — Input signal checked against range
scalar | vector | matrix

Input signal checked against the range specified by the Upper bound and Lower bound parameters.

Output

expand all

`Port_1` — Assertion output signal
scalar

Output signal that is true (1) if the assertion succeeds, and false (0) if the assertion fails. If, in the Configuration Parameters window, in the Math and Data Types section, under Advanced parameters, you select Implement logic signals as Boolean data, then the output data type is Boolean. Otherwise, the data type of the signal is double.

Dependencies

To enable this output port, set the Output assertion signal parameter check box.

Data Types: double | Boolean

Parameters

expand all

`Upper bound` — Upper bound compared to input signal
scalar | vector | matrix

Specify the upper bound on the range of amplitudes that the input signal can have.

Command-Line Information

Parameter: max

Type: character vector

Values: scalar | vector | matrix

Default: '0'

`Inclusive upper boundary` — Include the upper bound in range
`on` (default) | `off`

Select this check box to make the range of valid input amplitudes include the lower bound.

Command-Line Information

Parameter: min_included

Type: character vector

Values: 'on' | 'off'

Default: 'on'

`Lower bound` — Lower bound compared to input signal
scalar | vector | matrix

Specify the lower bound on the range of amplitudes that the input signal can have.

Command-Line Information

Parameter: min

Type: character vector

Values: scalar | vector | matrix

Default: '0'

`Inclusive lower bound` — Include the lower bound in range
`on` (default) | `off`

Select this check box to make the range of valid input amplitudes include the lower bound.

Command-Line Information

Parameter: min_included

Type: character vector

Values: 'on' | 'off'

Default: 'on'

`Enable assertion` — Enable or disable check
`on` (default) | `off`

Clearing this parameter disables the block and causes the model to behave as if the block does not exist. To enable or disable all verification blocks, regardless of the setting of this option, go to the Configuration Parameters window, click Diagnostics > Data Validity, expand the Advanced parameters section, and set Model Verification block enabling to Enable all or Disable all.

Command-Line Information

Parameter: enabled

Type: character vector

Values: 'on' | 'off'

Default: 'on'

`Simulation callback when assertion fails (optional)` — Expression to evaluate when assertion fails
`''` (default) | MATLAB expression

Specify a MATLAB^® expression to evaluate when the assertion fails. Because the expression is evaluated in the MATLAB workspace, define all variables used in the expression in that workspace.

Dependencies

To enable this parameter, select the Enable assertion parameter.

Command-Line Information

Parameter: callback

Type: character vector

Values: MATLAB expression

Default: ''

`Stop simulation when assertion fails` — Whether to stop simulation when check fails
`on` (default) | `off`

Select this parameter to stop the simulation when the check fails. Clear this parameter to display a warning and continue the simulation.

Command-Line Information

Parameter: stopWhenAssertionFail

Type: character vector

Values: 'on' | 'off'

Default: 'on'

`Output assertion signal` — Create output signal
`off` (default) | `on`

Select this parameter to enable the output port.

Command-Line Information

Parameter: export

Type: character vector

Values: 'on' | 'off'

Default: 'off'

`Select icon type` — Select icon type
`graphic` (default) | `text`

Specify the style of the block icon. The graphic option displays a graphical representation of the assertion condition on the icon. The text option displays a mathematical expression that represents the assertion condition.

Command-Line Information

Parameter: icon

Type: character vector

Values: 'graphic' | 'text'

Default: 'graphic'

Model Examples

Check Signal Range with Check Static Range Block

Using the Check Static Range block, you can check the upper and lower bounds of a signal amplitude against values defined in the block parameters.

Open Model

Block Characteristics

Data Types	`Boolean` \| `double` \| `enumerated` \| `fixed point` \| `half` \| `integer` \| `single`
Direct Feedthrough	`no`
Multidimensional Signals	`yes`
Variable-Size Signals	`no`
Zero-Crossing Detection	`no`

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.

For information about how Simulink^® Coder™ generated code handles Model Verification blocks, see Configure Model for Debugging (Simulink Coder).

Not recommended for production code.

HDL Code Generation
Generate Verilog and VHDL code for FPGA and ASIC designs using HDL Coder™.

HDL Coder™ provides additional configuration options that affect HDL implementation and synthesized logic.

HDL Architecture

This block checks whether each input signal element falls within the same amplitude range at each time step during simulation, but it is not included in the generated code.

Documentation

Check Static Range

Description

Ports

Input

`Port_1` — Input signal checked against range
scalar | vector | matrix

Output

`Port_1` — Assertion output signal
scalar

Dependencies

Parameters

`Upper bound` — Upper bound compared to input signal
scalar | vector | matrix

Command-Line Information

`Inclusive upper boundary` — Include the upper bound in range
`on` (default) | `off`

Command-Line Information

`Lower bound` — Lower bound compared to input signal
scalar | vector | matrix

Command-Line Information

`Inclusive lower bound` — Include the lower bound in range
`on` (default) | `off`

Command-Line Information

`Enable assertion` — Enable or disable check
`on` (default) | `off`

Command-Line Information

`Simulation callback when assertion fails (optional)` — Expression to evaluate when assertion fails
`''` (default) | MATLAB expression

Dependencies

Command-Line Information

`Stop simulation when assertion fails` — Whether to stop simulation when check fails
`on` (default) | `off`

Command-Line Information

`Output assertion signal` — Create output signal
`off` (default) | `on`

Command-Line Information

`Select icon type` — Select icon type
`graphic` (default) | `text`

Command-Line Information

Model Examples

Check Signal Range with Check Static Range Block

Block Characteristics

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.

HDL Code Generation
Generate Verilog and VHDL code for FPGA and ASIC designs using HDL Coder™.

PLC Code Generation
Generate Structured Text code using Simulink® PLC Coder™.

Fixed-Point Conversion
Design and simulate fixed-point systems using Fixed-Point Designer™.

See Also

Simulink Documentation

Support

Documentation

Check Static Range

Description

Ports

Input

Port_1 — Input signal checked against range scalar | vector | matrix

Output

Port_1 — Assertion output signal scalar

Dependencies

Parameters

Upper bound — Upper bound compared to input signal scalar | vector | matrix

Command-Line Information

Inclusive upper boundary — Include the upper bound in range on (default) | off

Command-Line Information

Lower bound — Lower bound compared to input signal scalar | vector | matrix

Command-Line Information

Inclusive lower bound — Include the lower bound in range on (default) | off

Command-Line Information

Enable assertion — Enable or disable check on (default) | off

Command-Line Information

Simulation callback when assertion fails (optional) — Expression to evaluate when assertion fails '' (default) | MATLAB expression

Dependencies

Command-Line Information

Stop simulation when assertion fails — Whether to stop simulation when check fails on (default) | off

Command-Line Information

Output assertion signal — Create output signal off (default) | on

Command-Line Information

Select icon type — Select icon type graphic (default) | text

Command-Line Information

Model Examples

Check Signal Range with Check Static Range Block

Block Characteristics

Extended Capabilities

C/C++ Code Generation Generate C and C++ code using Simulink® Coder™.

HDL Code Generation Generate Verilog and VHDL code for FPGA and ASIC designs using HDL Coder™.

PLC Code Generation Generate Structured Text code using Simulink® PLC Coder™.

Fixed-Point Conversion Design and simulate fixed-point systems using Fixed-Point Designer™.

See Also

Simulink Documentation

Support

`Port_1` — Input signal checked against range
scalar | vector | matrix

`Port_1` — Assertion output signal
scalar

`Upper bound` — Upper bound compared to input signal
scalar | vector | matrix

`Inclusive upper boundary` — Include the upper bound in range
`on` (default) | `off`

`Lower bound` — Lower bound compared to input signal
scalar | vector | matrix

`Inclusive lower bound` — Include the lower bound in range
`on` (default) | `off`

`Enable assertion` — Enable or disable check
`on` (default) | `off`

`Simulation callback when assertion fails (optional)` — Expression to evaluate when assertion fails
`''` (default) | MATLAB expression

`Stop simulation when assertion fails` — Whether to stop simulation when check fails
`on` (default) | `off`

`Output assertion signal` — Create output signal
`off` (default) | `on`

`Select icon type` — Select icon type
`graphic` (default) | `text`

C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.

HDL Code Generation
Generate Verilog and VHDL code for FPGA and ASIC designs using HDL Coder™.

PLC Code Generation
Generate Structured Text code using Simulink® PLC Coder™.

Fixed-Point Conversion
Design and simulate fixed-point systems using Fixed-Point Designer™.