Check Static Gap

Check that gap exists in signal's range of amplitudes

Library:
Simulink / Model Verification
HDL Coder / Model Verification

Description

The Check Static Gap block checks that an input signal is less than (or optionally equal to) a static lower bound or greater than (or optionally equal to) a static upper bound at the current time step. The Upper bound and Lower bound parameters define the upper and lower bounds of the gap. The block then executes an assertion after comparison. If the signal falls outside of the gap, 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. The input and the bounds 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 bound.
When comparing vectors or matrix signals to other vectors or matrices, the block compares the input signal and the bounds element-by-element.
For models with more than one vector or matrix as the input signal or bounds, the vectors or matrices must have the same dimensions.

Ports

Input

expand all

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

Input signal the block checks if the signal value is less than a static lower bound or greater than a static upper bound.

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 boundary value
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 bound` — Include the upper bound in range
`on` (default) | `off`

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

Command-Line Information

Parameter: max_included

Type: character vector

Values: 'on' | 'off'

Default: 'on'

`Lower bound` — Lower boundary value
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 Value with Check Static Gap Block

This model uses a Check Static Gap Block on an input sine wave to see if the signal falls within a define static gap.

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 element is less than a static lower bound or greater than a static upper bound during simulation, but it is not included in the generated code.

Documentation

Check Static Gap

Description

Ports

Input

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

Output

`Port_1` — Assertion output signal
scalar

Dependencies

Parameters

`Upper bound` — Upper boundary value
scalar | vector | matrix

Command-Line Information

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

Command-Line Information

`Lower bound` — Lower boundary value
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 Value with Check Static Gap 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 Gap

Description

Ports

Input

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

Output

Port_1 — Assertion output signal scalar

Dependencies

Parameters

Upper bound — Upper boundary value scalar | vector | matrix

Command-Line Information

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

Command-Line Information

Lower bound — Lower boundary value 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 Value with Check Static Gap 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 gap
scalar | vector | matrix

`Port_1` — Assertion output signal
scalar

`Upper bound` — Upper boundary value
scalar | vector | matrix

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

`Lower bound` — Lower boundary value
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™.