Start of trail Stop with Error navigation bar

Table of Contents

Show Message on Host

Displays the message in a dialog on the host machine.

Library

QUARC Targets/Sinks/Error Handling

MATLAB Command Line

Click to copy the following command line to the clipboard. Then paste it in the MATLAB Command Window:

qc_open_library('quarc_library/Sinks/Error Handling')

Description

Show Message on Host

The Show Message on Host block displays an error message in a dialog on the host when its input is non-zero. Unlike the Stop with Message block it does not stop the model. A fixed error message string can be provided as the error message, or it can interpret its input as a standard QUARC error code and supply the corresponding error message. If the input is interpreted as an error code then only negative inputs cause the block to issue an error message.

The dialog containing the message does not close when the model is terminated. The user must close it manually. However, if the model is restarted, it will reuse the same dialog so that a series of dialogs are not created every time the model is restarted. It will also change the error message in the dialog if the Message type parameter is set to Interpret input as error code and the input changes.

Warning Note that the dialog is displayed as long as the input to the block is non-zero, even if the user closes the dialog. Hence, this block is best used in a Triggered Subsystem so that the dialog is only opened when the input changes.

Input Ports

This block has a single input port. The error message is displayed on the host when this input becomes non-zero or negative, depending on the setting of the Message type parameter.

Output Ports

This block has no output ports.

Data Type Support

The Show Message on Host block accepts signals of any of the built-in Simulink data types at its input. Fixed point is not currently supported.

Parameters and Dialog Box

Show Message on Host

Message type

The type of error message to issue. If this parameter is set to Fixed error message then it uses the contents of the Error message parameter as the error message. If the Message type parameter is set to Interpret input as error code then it interprets the input as a QUARC error code and issues the corresponding error message.

Message icon

The type of icon to display in the dialog.

Error message

The error message to issue. The error message is treated as a string. It is not evaluated so Matlab workspace variables cannot be used. This parameter is ignored if the Message type parameter is set to Interpret input as error code.

Targets

Target Name

Compatible*

Model Referencing

Comments

QUARC Win32 Target

Yes

Yes

QUARC Win64 Target

Yes

Yes

QUARC Linux Nvidia Target

Yes

Yes

QUARC Linux QBot Platform Target

Yes

Yes

QUARC Linux QCar 2 Target

Yes

Yes

QUARC Linux QDrone 2 Target

Yes

Yes

QUARC Linux Raspberry Pi 3 Target

Yes

Yes

QUARC Linux Raspberry Pi 4 Target

Yes

Yes

QUARC Linux RT ARMv7 Target

Yes

Yes

QUARC Linux x64 Target

Yes

Yes

QUARC Linux DuoVero Target

Yes

Yes

QUARC Linux DuoVero 2016 Target

Yes

Yes

QUARC Linux Verdex Target

Yes

Yes

QUARC QNX x86 Target

Yes

Yes

Last fully supported in QUARC 2018.

Rapid Simulation (RSIM) Target

Yes

Yes

S-Function Target

No

N/A

Old technology. Use model referencing instead.

Normal simulation

Yes

Yes

* Compatible means that the block can be compiled for the target.

 

navigation bar