longitudinal motorcycle braking test
this reference application represents an in-plane longitudinal motorcycle undergoing a braking test. you can create your own versions, establishing a framework to test that your motorcycle meets the design requirements under normal and extreme driving conditions. use this reference application in ride and handling studies and chassis controls development to characterize the vehicle dynamics of a motorcycle during a braking test.
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 .
to create and open a working copy of the longitudinal motorcycle braking test reference application, enter
this table summarizes the blocks and subsystems in the reference application. some subsystems contain variants.
reference application element | description | variants |
---|---|---|
straight maneuver reference generator | generates accelerator and brake commands to conduct a straight line maneuver. the acceleration begins at the specified rate until the motorcycle achieves the longitudinal velocity setpoint. the motorcycle controller maintains the longitudinal velocity setpoint for the specified time or distance. the controller then decelerates the motorcycle. optionally, specify fault conditions before braking during a test. if the motorcycle speed, steering angle, or yaw rate is not within the allowable range before braking, the block sets a fault condition. | na |
longitudinal rider | implements the rider model that the reference application uses to generate acceleration, braking, gear, and steering commands. by default, longitudinal rider
subsystem use is the longitudinal driver block with
control type, cntrltype set to
| na |
environment | implements wind and road forces, including a constant or split friction coefficient scaling factor. | ✓ |
controllers | implements controllers for engine control units (ecus), transmissions, anti-lock braking systems (abs), and active differentials. | ✓ |
motorcycle vehicle | implements the:
| ✓ |
visualization | provides the motorcycle trajectory, rider response, and 3d visualization. to enable 3d visualization, set the 3d engine block parameter 3d engine parameter to enabled. for the minimum 3d visualization environment hardware requirements, see . | ✓ |
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 set as label model active choice.
straight maneuver reference generator
the straight maneuver reference generator block generates accelerator and brake commands to conduct a straight line maneuver. the acceleration begins at the specified rate until the motorcycle achieves the longitudinal velocity setpoint. the motorcycle controller maintains the longitudinal velocity setpoint for the specified time or distance. the controller then decelerates the motorcycle.
use the maneuver parameters to specify the maneuver start time, velocity setpoint, acceleration, and deceleration.
optionally, on the tracking parameters tab, select enable fault tracking before braking. use the parameters to specify fault conditions before braking. if the motorcycle speed, steering angle, or yaw rate is not within the allowable range before braking, the block sets a fault condition.
for more information, see .
longitudinal rider
the longitudinal rider subsystem implements the rider
model that the reference application uses to generate acceleration, braking, gear, and
steering commands. by default, longitudinal rider subsystem use is the
longitudinal driver block with control type,
cntrltype set to predictive
.
environment
the environment subsystem implements wind and road forces. the reference application has these ground feedback variants.
environment | variant | description |
---|---|---|
ground feedback |
| uses block to implement ray tracing in 3d environment. |
| implements a constant friction coefficient scaling factor. |
controllers
the controllers subsystem generates engine torque, transmission gear, brake pressure, and differential pressure commands.
ecu
the ecu controller generates the engine torque command. the controller prevents
over-revving the engine by limiting the engine torque command to the value specified
by model workspace variable engrevlim
. by default, the value is
7000 rpm. if the differential torque command exceeds the limited engine torque
command, the ecu sets the engine torque command to the commanded differential
torque.
transmission control
the transmission controller subsystem generates the transmission gear command. the controller includes these variants.
variant | description |
---|---|
| implements a transmission control module (tcm) that uses stateflow® logic to generate the gear command based on the motorcycle acceleration, wheel speed, and engine speed. |
| open loop transmission control. the controller sets the gear command to the gear request. |
| implements a transmission control module (tcm) that uses stateflow logic to generate the gear command based on the motorcycle acceleration, brake command, wheel speed, engine speed, and gear request. |
| implements a paddle controller that uses the motorcycle acceleration and engine speed to generate the gear command. |
brake pressure control
the brake controller subsystem implements a brake pressure control subsystem to generate the brake pressure command. the brake pressure control subsystem has these variants.
variant | description |
---|---|
| implements an abs feedback controller that switches between two states to regulate wheel slip. the bang-bang control minimizes the error between the actual slip and desired slip. for the desired slip, the controller uses the slip value at which the mu-slip curve reaches a peak value. this desired slip value is optimal for minimum braking distance. |
| open loop brake control. the controller sets the brake pressure command to a reference brake pressure based on the brake command. |
| five-state abs control when you simulate the brake test. the five-state abs controller uses logic-switching based on wheel deceleration and motorcycle acceleration to control the braking pressure at each wheel. consider using five-state abs control to prevent wheel lock-up, decrease braking distance, or maintain yaw stability during the maneuver. the default abs parameters are set to work on roads that have a constant friction coefficient scaling factor of 1. |
active differential control
the active differential control subsystem generates the differential pressure command. to calculate the command, the subsystem has these variants.
variant | description |
---|---|
| implements a controller that generates the differential pressure command based on the:
|
| does not implement a controller. sets the differential pressure command to 0. |
motorcycle vehicle
the motorcycle vehicle subsystem has an engine, controllers, and a vehicle body with four wheels. specifically, the motorcycle contains these subsystems.
subsystem | variant | description |
---|---|---|
body, suspension, wheels |
| motorcycle with two wheels:
|
simscape multibody |
| motorcycle with two wheels implemented with simscape™ multibody™. |
engine subsystem | variant | description |
---|---|---|
engine |
| implemented with block. |
steering, transmission, driveline, and brakes subsystem | description | |
---|---|---|
two wheels chain driven | transmission | implements an ideal fixed gear transmission. |
implements the dynamic effects of a motorcycle chain on the motorcycle body longitudinal in-plane block, including dynamic tension and moment drive coupling. |
visualization
when you run the simulation, the visualization subsystem provides rider and motorcycle response information. the reference application logs motorcycle signals during the maneuver, including steering, motorcycle and engine speed, and lateral acceleration. by default, the yaw rate, brake pressure, velocity, accel scope block shows the signals as the simulation runs. you can use the simulation data inspector to import the logged signals and examine the data.
element | description |
---|---|
driver commands | driver commands:
|
vehicle response | motorcycle response:
|
yaw rate, brake pressure, velocity, accel scope block |
|
if you enable 3d visualization on the reference generator block 3d engine tab by selecting enabled, you can view the vehicle response in the simulation 3d viewer.
to smoothly change the camera views, use these key commands.
key | camera view | |
---|---|---|
1 | back left |
|
2 | back | |
3 | back right | |
4 | left | |
5 | internal | |
6 | right | |
7 | front left | |
8 | front | |
9 | front right | |
0 | overhead |
for additional camera controls, use these key commands.
key | camera control |
---|---|
tab | cycle the view between all vehicles in the scene. |
mouse scroll wheel | control the camera distance from the vehicle. |
l | toggle a camera lag effect on or off. when you enable the lag effect, the camera view includes:
this lag enables improved visualization of overall vehicle acceleration and rotation. |
f | toggle the free camera mode on or off. when you enable the free camera mode, you can use the mouse to change the pitch and yaw of the camera. this mode enables you to orbit the camera around the vehicle. |
see also
| | | |