Learn more about Communications Toolbox

Methods Allowing You to Communicate with the Error Rate Test Console at Simulation Run Time

On this page…
Getting Test Inputs From the Error Rate Test Console Getting the Current Simulation Sweep Value of a Registered Test Parameter Logging Test Data to a Registered Test Probe Logging User-Defined Data To The Test Console

Getting Test Inputs From the Error Rate Test Console

At simulation time, the communications system you design can request input data to the Error Rate Test Console. To request a particular type of input data, the system under test must register the specific input type to the Error Rate Test Console. The system under test calls getInput(obj,inputName) method to request test inputs to the test console.

• obj represents the handle of the Error Rate Test Console

• inputName represents the input that the system under test gets from the Error Rate Test Console

For an Error Rate Test Console, 'NumTransmissions' or 'RandomDiscreetSource' are acceptable selections for inputName.

The system under test provides the following inputs:

• 'NumTransmissions' - calling the getInput method returns the frame length. The system itself is responsible for generating a data frame using a data source.

• 'RandomIntegerSource' - calling the getInput method returns a vector of symbols with a length the Error Rate Test Console FrameLength property specifies. If the system registers this source type, then it must also register a test parameter named 'M' that corresponds to the modulation order.

Back to Top

Getting the Current Simulation Sweep Value of a Registered Test Parameter

For each simulation iteration, the system under test may require the current simulation sweep values from the registered test parameters. To obtain these values from the Error Rate Test console, the system under test calls the getTestParameter(sys,name) method.

Back to Top

Logging Test Data to a Registered Test Probe

At simulation time, the system under test may log data to a registered test probe using the setTestProbeData(sys,name,data) method.

• sys represents the handle to the system

• name represents the name of a registered test probe

• data represents the data the probe logs to the Error Rate Test Console.

Back to Top

Logging User-Defined Data To The Test Console

At simulation time, the system under test may log user-data to the Error Rate Test Console by calling the setUserData method. This user-data passes directly to the specific user-defined metric calculator functions. Log user-data to the Error Rate Test Console as follows:

setUserData(sys,data)

• sys represents the handle to the system

• data represents the data the probe logs to the Error Rate Test Console.

Back to Top

Creating a System

Debug Mode

© 1984-2009- The MathWorks, Inc.    -   Site Help   -   Patents   -   Trademarks   -   Privacy Policy   -   Preventing Piracy   -   RSS