Documentation

Simscape Driveline Block Libraries

About the Simscape Driveline Block Library

Simscape™ Driveline™ software is organized into a set of libraries of closely related blocks. This section shows you how to open these Simscape Driveline block libraries and explains the nature of each library.

Access the Libraries

There are several ways to open the Simscape Driveline block library.

You can access the blocks through the Simulink® Library Browser. Open the browser by clicking the Simulink button . Expand the Simscape entry, then the Simscape Driveline subentry, in the contents tree.

You can also access the blocks directly inside the Simscape Driveline library in several ways:

  • In the Simulink Library Browser, right-click the Simscape Driveline subentry under Simscape and select Open SimDriveline Library. The library appears.

  • Click the Start button in the lower-left corner of your MATLAB® desktop. In the pop-up menu, select Simulink, then SimDriveline, then Block Library.

  • Enter drivelib at the MATLAB command line.

Simscape Driveline Library

Once you perform one of these steps, the Simscape Driveline library opens. This library displays seven top-level block groups. You can expand each library by double-clicking its icon.

The next section summarizes the blocks of each library and their use.

Use the Libraries

The Simscape Driveline block library is organized into separate libraries, each with a different type of driveline block.

Solver & Inertias

The Solvers & Inertias library provides the Inertia block, which represents a rotating body specified by its moment of inertia, the fundamental unit of driveline modeling. It also contains the Housing block, which represents an immobile rotational ground.

Finally, the library contains the Driveline Environment block, which configures the driveline settings of a Simscape Driveline block diagram, and the Shared Environment block, which allows you to connect two driveline block diagrams in a nonphysical way so that they share the same driveline environment settings.

Gears

The Gears library contains blocks that represent simple and complex gears, driveline elements that couple distinct driveline axes and constrain their relative motions. The Gear blocks range from simple two-wheel gear couplings with fixed and variable gear ratios, to complex multiwheel and multiaxis gears such as planetary and differential gears.

Dynamic Elements

The Dynamic Elements library contains blocks that model such critical drivetrain components as clutches, torque converters, damped springs, and stops. Dynamic elements generate internal driveline torques.

The blocks of this library serve as suggestions for developing variant or entirely new models to simulate the same components. Look under the block mask, break the block's library link before modifying it, and create your own version.

Transmission Templates

The Transmission Templates are a set of predesigned transmission examples constructed from gears, clutches, and inertias. You can copy and use these examples in your drivetrain models.

Transmission templates copied into your model are not linked to the block library. You can modify and rebuild these template copies at will.

Sensors & Actuators

The Sensors & Actuators library provides blocks for sensing and initiating the motions of driveline axes and applying and sensing torques along those axes.

Interface Elements

The Interface Elements library enables connections between Simscape Driveline driveshaft connection lines and Simscape mechanical rotational motion.

Vehicle Components

The Vehicle Components library contains blocks that represent components of a full vehicle beyond the drivetrain itself. It includes models of engines, wheeled vehicles, and tires in contact with the ground.

The blocks of this library serve as suggestions for developing variant or entirely new models to simulate the same components. Look under the block mask, break the block's library link before modifying it, and create your own version.

Was this topic helpful?