Driveline models

The driveline subsystem (aka drivetrain) is the set of components that deliver power to the vehicle's driven wheels. Currently, Chrono::Vehicle provides templates for traditional drivelines connected to a single motor (in the powertrain subsystem) and delivering power to one, two, or more of the vehicle's axles.

The interfaces between the driveline and powertrain and between the driveline and the driven wheels are force-displacement connections. In particular, the powertrain supplies torque to the driveline's driveshaft and the driveline setts the driveshaft's angular velocity. Similarly, the driveline transmits and applies torques to the axles of the driven wheels and receives the current angular velocity of the wheel axles. Depending on the type of driveline and powertrain, the driveline-powertrain and driveline-wheel connections can be enforced through constraints or purely kinematically.

Four-wheel shafts-based drivetrain

This drivetrain template is modeled using various Chrono 1-D shaft elements (ChShaft) and specialized shaft connection elements. Such elements are used to model the differentials (ChShaftsPlanetary), conical gears (ChShaftsGearboxAngled), and clutches (ChShaftsClutch) for differential locking.

See ChShaftsDriveline4WD and ShaftsDriveline4WD.

The image below shows the 4WD shafts-based driveline connected to a shafts-based powertrain model.

The various template parameters available for a 4WD shafts-based driveline are illustrated in the following sample JSON specification file:

{
"Name": "HMMWV AWD Driveline",
"Type": "Driveline",
"Template": "ShaftsDriveline4WD",
"Shaft Direction":
{
"Motor Block": [1, 0, 0],
"Axle": [0, 1, 0]
},
"Shaft Inertia":
{
"Driveshaft": 0.5,
"Front Driveshaft": 0.5,
"Rear Driveshaft": 0.5,
"Central Differential Box": 0.6,
"Front Differential Box": 0.6,
"Rear Differential Box": 0.6
},
"Gear Ratio":
{
"Front Conical Gear": 0.2,
"Rear Conical Gear": 0.2
},
"Axle Differential Locking Limit": 100,
"Central Differential Locking Limit": 100
}

Two-wheel shafts-based drivetrain

This drivetrain template is similar to the 4WD shafts-based drivetrain model, but can only drive the wheels associated with a single vehicle axle. This axle is arbitrary, so this drivetrain model can be used to model both front-wheel drive and rear-wheel drive vehicles.

See ChShaftsDriveline2WD and ShaftsDriveline2WD.

A sample JSON file with the specification of a 2WD shafts-based driveline is:

{
"Name": "HMMWV RWD Driveline",
"Type": "Driveline",
"Template": "ShaftsDriveline2WD",
"Shaft Direction":
{
"Motor Block": [1, 0, 0],
"Axle": [0, 1, 0]
},
"Shaft Inertia":
{
"Driveshaft": 0.5,
"Differential Box": 0.6
},
"Gear Ratio":
{
"Conical Gear": 0.2
},
"Axle Differential Locking Limit": 100
}

Four-wheel kinematic drivetrain

This template can be used to model a 4WD driveline. It uses a constant front/rear torque split (a value between 0 and 1) and a simple model for Torsen limited-slip differentials.

See ChSimpleDriveline and SimpleDriveline.

A sample JSON file with the specification of a 2WD shafts-based driveline is:

{
"Name": "HMMWV 4WD Driveline",
"Type": "Driveline",
"Template": "SimpleDriveline",
"Front Torque Fraction": 0.5,
"Front Differential Max Bias": 2.0,
"Rear Differential Max Bias": 2.0
}

X-wheel kinematic drivetrain

This simple driveline template can be used to model a XWD driveline, capable of driving one or more vehicle axles. It uses a constant torque split depending on the number of driven axles and a simple model for Torsen limited-slip differentials.

See ChSimpleDrivelineXWD and SimpleDrivelineXWD.

A sample JSON file with the specification of a 2WD shafts-based driveline is:

{
"Name": "MAN 5t, 7t, 10t XWD Driveline",
"Type": "Driveline",
"Template": "SimpleDrivelineXWD",
"Differential Max Bias": 2.0
}