Reactive Systems logo
September 19, 2020
Reactis API
 
Spacer

API - Reactis: MATLAB Bindings - Reactis Info File (Test Points)


rsRsiAddTestPointAdd a test point to an .rsi file.
rsRsiImportTestPointsImports all Simulink test point set in the model and adds them as Reactis test points.
rsRsiClearTestPointsRemove all test points from an .rsi file.
rsRsiDefaultTestPointsReset all test point constraints to default values.
rsRsiGetTestPointsGet all test points from an .rsi file.
rsRsiSyncTestPointsSynchronize data types of test points between the .rsi file and associated model.
rsRsiRemoveTestPointRemove a test point from an .rsi file.
rsRsiGetTestPointParameterValueGet the value of a test point parameter.
rsRsiSetTestPointParameterValueSet the value of a test point parameter.


rsRsiAddTestPoint

Add a test point to an .rsi file.

Syntax

tpId = rsRsiAddTestPoint(rsiId,location)

Description

tpId = rsRsiAddTestPoint(rsiId,location) adds a test point found via the string location to the .rsi file identified by rsiId.

For Simulink, location should contain the path and name of a block and an output port number, e.g., sys1/sys2/testblock/3 adds output port #3 of block "testblock" located within sys1/sys2 as a test point.

For Stateflow, location should contain the name of a variable within a Stateflow chart, e.g., sys1/sys2/chart/var adds the variable named "var", located within Stateflow chart "chart" which itself is located within "sys1/sys2". For variables defined within Stateflow sub-states, the state path must also be given, e.g. sys1/sys2/chart/state1/state2/var.

tpId is an identifier for the test point used when calling other rsRsiTestPoint* functions.

See Also

rsRsiOpen, rsRsiClearTestPoints, rsRsiDefaultTestPoints, rsRsiGetTestPoints, rsRsiImportTestPoints, rsRsiSyncTestPoints, rsRsiRemoveTestPoint, rsRsiGetTestPointParameterValue, rsRsiSetTestPointParameterValue


rsRsiImportTestPoints

Imports all Simulink test point set in the model and adds them as Reactis test points.

Syntax

rsRsiImportTestPoints(rsiId)
rsRsiImportTestPoints(rsiId,kinds)

Description

rsRsiImportTestPoints(rsiId) imports test points from the model associated with the .rsi file rsiId and adds them to the .rsi file. The following items are imported:

  • Simulink signals with their "Test point" property checked
  • Stateflow variables with their "Test point" property checked

rsRsiImportTestPoints(rsiId,kinds) imports test points from the model associated with the .rsi file rsiId and adds them to the .rsi file. The items to be imported are specified by the kinds parameter which must be a cell array of strings. Possible kinds of items that can be imported are:

SL Simulink signals with their "Test point" property checked
SF Stateflow variables with their "Test point" property checked
SLSignal Simulink signals that must resolve to Simulink.Signal objects
SFSignal Stateflow variables that must resolve to Simulink.Signal objects

See Also

rsRsiOpen, rsRsiClearTestPoints, rsRsiDefaultTestPoints, rsRsiGetTestPoints, rsRsiSyncTestPoints, rsRsiAddTestPoint, rsRsiRemoveTestPoint, rsRsiGetTestPointParameterValue, rsRsiSetTestPointParameterValue


rsRsiClearTestPoints

Remove all test points from an .rsi file.

Syntax

rsRsiClearTestPoints(rsiId)

Description

rsRsiClearTestPoints(rsiId) removes all test points from the .rsi file identified by rsiId.

See Also

rsRsiOpen, rsRsiDefaultTestPoints, rsRsiGetTestPoints, rsRsiImportTestPoints, rsRsiSyncTestPoints, rsRsiAddTestPoint, rsRsiRemoveTestPoint, rsRsiGetTestPointParameterValue, rsRsiSetTestPointParameterValue


rsRsiDefaultTestPoints

Reset all test point constraints to default values.

Syntax

rsRsiDefaultTestPoints(rsiId)

Description

rsRsiDefaultTestPoints(rsiId) Each test point in the .rsi file identified by rsiId is processed as follows: if the test point exists in the .rsi file but the corresponding block or variable cannot be found in the model, the test point is removed from the .rsi file. Otherwise the model data type's full range will be set as the constraint for the test point.

See Also

rsRsiOpen, rsRsiClearTestPoints, rsRsiGetTestPoints, rsRsiImportTestPoints, rsRsiSyncTestPoints, rsRsiAddTestPoint, rsRsiRemoveTestPoint, rsRsiGetTestPointParameterValue, rsRsiSetTestPointParameterValue


rsRsiGetTestPoints

Get all test points from an .rsi file.

Syntax

tpIds = rsRsiGetTestPoints(rsiId)

Description

tpIds = rsRsiGetTestPoints(rsiId) tpIds is an array containing a list of integer identifiers for test points specified in the .rsi file. These identifiers are used when calling other rsRsiTestPoint* functions.

See Also

rsRsiOpen, rsRsiClearTestPoints, rsRsiDefaultTestPoints, rsRsiImportTestPoints, rsRsiSyncTestPoints, rsRsiAddTestPoint, rsRsiRemoveTestPoint, rsRsiGetTestPointParameterValue, rsRsiSetTestPointParameterValue


rsRsiSyncTestPoints

Synchronize data types of test points between the .rsi file and associated model.

Syntax

rsRsiSyncTestPoints(rsiId)

Description

rsRsiSyncTestPoints(rsiId) Each test point in the .rsi file identified by rsiId is processed as follows: if the test point exists in the .rsi file but the corresponding block or variable cannot be found in the model, the test point is removed from the .rsi file. Otherwise, if the data type of the test point has changed in the model, the new data type's full range will be set as the constraint for the test point.

See Also

rsRsiOpen, rsRsiClearTestPoints, rsRsiGetTestPoints, rsRsiImportTestPoints, rsRsiDefaultTestPoints, rsRsiAddTestPoint, rsRsiRemoveTestPoint, rsRsiGetTestPointParameterValue, rsRsiSetTestPointParameterValue


rsRsiRemoveTestPoint

Remove a test point from an .rsi file.

Syntax

rsRsiRemoveTestPoint(rsiId,tpId)

Description

rsRsiRemoveTestPoint(rsiId,tpId) removes the test point identified by tpId from the file identified by rsiId. tpId must be a test point id returned by rsRsiGetTestPoints or rsRsiAddTestPoint.

See Also

rsRsiOpen, rsRsiClearTestPoints, rsRsiDefaultTestPoints, rsRsiGetTestPoints, rsRsiImportTestPoints, rsRsiSyncTestPoints, rsRsiAddTestPoint, rsRsiSetTestPointParameterValue, rsRsiSetTestPointParameterValue


rsRsiGetTestPointParameterValue

Get the value of a test point parameter.

Syntax

value = rsRsiGetTestPointParameterValue(rsiId,tpId,paramName)

Description

value = rsRsiGetTestPointParameterValue(rsiId,tpId,paramName) retrieves the parameter whose name matches paramName from the test point identified by tpId. rsiId identifies the .rsi file containing the test point. tpId must be a test point id returned by rsRsiGetTestPoints or rsRsiAddTestPoint.

See the documentation for rsRsiSetTestPointParameterValue for a list of available parameters.

See Also

rsRsiOpen, rsRsiClearTestPoints, rsRsiDefaultTestPoints, rsRsiGetTestPoints, rsRsiImportTestPoints, rsRsiSyncTestPoints, rsRsiRemoveTestPoint, rsRsiAddTestPoint, rsRsiSetTestPointParameterValue


rsRsiSetTestPointParameterValue

Set the value of a test point parameter.

Syntax

rsRsiSetTestPointParameterValue(rsiId,tpId,name1,val1,name2,val2,....)

Description

rsRsiSetTestPointParameterValue(rsiId,tpId,name1,val1,name2,val2,....) sets the values of the specified test point parameters to the specified values.

rsiId identifies the .rsi file containing the test point. tpId must be a test point id returned by rsRsiGetTestPoints or rsRsiAddTestPoint.

The following parameters are available:

Name User-defined name of the test point.
Constraint Sets the data type constraint for the test point. For a description of the syntax of type constraints in .rsi files see section 5.3.2 ("Type Constraint Syntax") in the Reactis User's guide.
Capture Capture the data from this test point when creating test suites (possible values are "on" or "off").
Constrain If Capture is enabled then enabling Constrain will constrain values captured in the test suite to the constraint given for the test point (possible values are "on" or "off").
Compare Select whether to compare the value of the test point to the value in an existing test suite when running the suite in Simulator (possible values are "on" or "off").
Tolerance Tolerance for the test point when comparing the test point value to test suite values (only used if Compare is "on").
Assertion Create an assertion that will be violated if the value of the test point is outside the limits given for the constraint. (possible values are "on" or "off").
BoundaryTargets Track boundary coverage according to the constraint data type (possible values are "on" or "off").
CheckRange Select whether to produce an error or warning if the value of the test point is outside the limits given for the constraint. (possible values are "ignore" or "warning" or "error").

See Also

rsRsiOpen, rsRsiClearTestPoints, rsRsiDefaultTestPoints, rsRsiGetTestPoints, rsRsiImportTestPoints, rsRsiSyncTestPoints, rsRsiRemoveTestPoint, rsRsiAddTestPoint, rsRsiGetTestPointParameterValue



Spacer