MATLAB Examples

Test Downshift Points of a Transmission Controller

This example demonstrates how to test a transmission shift logic controller using test sequences and test assessments.


The Model and Controller

This example uses a simplified drivetrain system arranged in a controller-plant configuration. The objective of the example is to test the transmission controller in isolation, ensuring that it downshifts correctly.

The Test

The controller should downshift between each of its gear ratios in response to a ramped throttle application. The test inputs hold vehicle speed constant while ramping the throttle. The Test Assessment block includes requirements-based assessments of the controller performance.

path = fullfile(matlabroot,'examples','simulinktest');
mdl = 'TransmissionDownshiftTestSequence';
harness = 'controller_harness';

Open the Test Harness

Click the badge on the subsystem shift_controller and open the test harness controller_harness. shift_controller is connected to a Test Sequence block and a Test Assessment block.[mdl '/shift_controller'],harness)

The Test Sequence

Double-click the Test Sequence block to open the test sequence editor.

The test sequence begins by ramping speed to 75 to initialize the controller to fourth gear. Throttle is then ramped at constant speed until a gear change. Subsequent initialization and downshifts execute. After the change to first gear, the test sequence stops.

open_system([harness '/Test Sequence']);

Test Assessments for the Controller

The requirements for the shift controller include conditions which would invalidate the test.

  • Speed shall never be negative.
  • Gear shall always be positive.
  • Throttle shall be between 0% and 100%.

In addition, the functional requirement tested is that the shift controller shall keep the vehicle speed below specified maximums in each of the first three gears.

Open the Test Assessment block. These assertions in the block correspond to the first three requirements. If the controller violates one of the assertions, the simulation fails.

assert(speed >= 0, 'speed must be >= 0');
assert(throttle >= 0, 'throttle must be >= 0 and <= 100');
assert(throttle <= 100, 'throttle must be >= 0 and <= 100');
assert(gear > 0,'gear must be > 0');

The last requirement has three sub-requirements.

  • The controller shall not let the vehicle speed exceed 90 in gear 3.
  • The controller shall not let the vehicle speed exceed 50 in gear 2.
  • The controller shall not let the vehicle speed exceed 30 in gear 1.

You can model these assessments with a When decomposition sequence. When decomposition step selection is based on signal conditions defined in the Step column, with each condition preceded by the when operator. The Transition and Next Step columns do not affect the transition. The last step Else covers any undefined condition and does not use a when declaration.

To change a sequence to a When decomposition, right-click a step and select When decomposition. Sub-steps of this step then operate using the when operator. The assessments use verify statements so that results are available in the Simulation Data Inspector, and so that failures do not stop simulation.

OverSpeed3 when gear==3
verify(speed <= 90,'Engine overspeed in gear 3')
OverSpeed2 when gear==2
verify(speed <= 50,'Engine overspeed in gear 2')
OverSpeed1 when gear==1
verify(speed <= 30,'Engine overspeed in gear 1')

Testing the Controller

Simulate the test harness demonstrates the progressive throttle ramp at each test step, and the corresponding downshifts. The controller passes all of the assessments in the Test Assessment block.

open_system([harness '/FloatingScope'])

View the Results

Click the Simulation Data Inspector button in the test harness toolstrip to view the results. You can compare the speed signal to the verify statement outputs.