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

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

---