This reference application represents a full vehicle dynamics model undergoing a slowly increasing steering maneuver according to standard SAE J266. You can create your own versions, establishing a framework to test that your vehicle meets the design requirements under normal and extreme driving conditions. Use the reference application to analyze vehicle ride and handling and develop chassis controls. To characterize the steering and lateral vehicle dynamics, use this reference application.
Based on the constant speed, variable steer test defined in SAE J2661, the slowly increasing steering maneuver helps characterize the lateral dynamics of the vehicle. In the test, the driver:
Accelerates until vehicle hits a target velocity.
Maintains a target velocity.
Linearly increases the steering wheel angle from 0 degrees to a maximum angle.
Maintains the steering wheel angle for a specified time.
Linearly decreases the steering wheel angle from maximum angle to 0 degrees.
To test advanced driver assistance systems (ADAS) and automated driving (AD) perception, planning, and control software, you can run the maneuver in a 3D environment. For the 3D visualization engine platform requirements and hardware recommendations, see 3D Visualization Engine Requirements.
To create and open a working copy of the increasing steering reference application project, enter
This table summarizes the blocks and subsystems in the reference application. Some subsystems contain variants.
|Reference Application Element||Description||Variants|
Slowly Increasing Steer block
Generates steering, accelerator, and brake commands for the Longitudinal Driver block
Longitudinal Driver block
Generates normalized acceleration and braking commands to track speed
Implements wind and road forces.
Implements controllers for engine control units (ECUs), transmissions, and brakes
Provides the vehicle trajectory, driver response, and 3D visualization
To override the default variant, on the Modeling tab, in the Design section, click the drop-down. In the General section, select Variant Manager. In the Variant Manager, navigate to the variant that you want to use. Right-click and select Override using this Choice.
Use the Slowly Increasing Steering block to generate steering, accelerator, and brake commands for a slowly increasing steering maneuver.
Longitudinal speed setpoint — Target velocity setpoint
Handwheel rate — Linear rate to increase steering wheel angle
Maximum handwheel angle — Maximum steering wheel angle
To track the vehicle speed, the Longitudinal Driver block implements an optimal single-point preview (look ahead) control model developed by C. C. MacAdam2, 3, 4. The model represents driver steering control behavior during path-following and obstacle avoidance maneuvers. Drivers preview (look ahead) to follow a predefined path.
The Environment subsystem generates the wind and ground forces. The reference application has these environment variants.
Uses Vehicle Terrain Sensor block to implement ray tracing in 3D environment
Implements a constant friction value
The Controllers subsystem generates engine torque, transmission gear, and brake commands. The reference application has these brake variants.
Brake Pressure Control
Anti-lock braking system (ABS) feedback controller that switches between two states
Open loop braking controller
The Passenger Vehicle subsystem has an engine, controllers, and a vehicle body with four wheels. Specifically, the vehicle contains these subsystems.
|Body, Suspension, Wheels Subsystem||Variant||Description|
Vehicle with four wheels:
Vehicle with four wheels.
Mapped spark-ignition (SI) engine
Steering, Transmission, Driveline, and Brakes Subsystem
Driveline Ideal Fixed Gear
Configure the driveline for all-wheel, front-wheel, or rear-wheel drive
Specify the type of torque coupling
Ideal fixed gear transmission
When you run the simulation, the Visualization subsystem provides driver, vehicle, and response information. The reference application logs vehicle signals during the maneuver, including steering, vehicle and engine speed, and lateral acceleration. You can use the Simulation Data Inspector to import the logged signals and examine the data.
Yaw Rate and Steer Scope block
Yaw rate and steering angle versus time:
Steer vs Ay Scope block
Steering angle versus lateral acceleration
Steer, Velocity, Lat Accel Scope block
Vehicle XY Plotter
Plot of vehicle longitudinal versus lateral distance
ISO 15037-1:2006 block
Display ISO standard measurement signals in the Simulation Data Inspector, including steering wheel angle and torque, longitudinal and lateral velocity, and sideslip angle
Optionally, you can enable or disable the 3D visualization environment. For the 3D visualization engine platform requirements and hardware recommendations, see 3D Visualization Engine Requirements. After you open the reference application, in the Visualization subsystem, open the 3D Engine block. Set these parameters.
3D Engine to Enabled.
Scene to one of the scenes, for example
To position the vehicle in the scene:
Select the position initialization method:
Recommended for scene — Set the initial vehicle position to values recommended for the scene
User-specified — Set your own initial vehicle position
Select Apply to modify the initial vehicle position parameters.
Click Update the model workspaces with the initial values to overwrite the initial vehicle position in the model workspaces with the applied values.
When you run the simulation, view the vehicle response in the
To open and close the
AutoVrtlEnv window, use the
Simulink® Run and Stop buttons. If you manually close the
AutoVrtlEnv window, Simulink stops the simulation with an error.
When you enable the 3D visualization environment, you cannot step the simulation back.
To change the camera views, use these key commands.
 SAE J266. Steady-State Directional Control Test Procedures For Passenger Cars and Light Trucks. Warrendale, PA: SAE International, 1996.
 MacAdam, C. C. "An Optimal Preview Control for Linear Systems". Journal of Dynamic Systems, Measurement, and Control. Vol. 102, Number 3, Sept. 1980.
 MacAdam, C. C. "Application of an Optimal Preview Control for Simulation of Closed-Loop Automobile Driving ". IEEE Transactions on Systems, Man, and Cybernetics. Vol. 11, Issue 6, June 1981.
 MacAdam, C. C. Development of Driver/Vehicle Steering Interaction Models for Dynamic Analysis. Final Technical Report UMTRI-88-53. Ann Arbor, Michigan: The University of Michigan Transportation Research Institute, Dec. 1988.