.VehicleInterfaces.UsersGuide.QuickStart

Information

This section will quickly highlight some of the features of the library.

Getting started

A new subsystem should extend a class from within VehicleInterfaces.SubsystemTypeName.Interfaces. These classes only provide the basic connection interface required. If you also want to use the standard Icon for your new subsystem these can be found in VehicleInterfaces.Icons.

Examples

A number of vehicle model examples are included for four wheeled vehicles and could be duplicated or extended to create your own vehicle models. All the subsystems are defined as replaceable so they can be changed to the required definition after extending from the example. Control system blocks can be added as required by dragging the controller model into the vehicle model and connecting the controller to the control bus.

WheelHub connectors

The WheelHub connectors are based on a new connector found in Modelica.Mechanics.MultiBody.Interfaces called FlangeWithBearing. This connector contains a 1D rotational connector and an optional MultiBody connector. The MultiBody connector can be enabled/disabled via a parameter in the connector definition. In the case of the VehicleInterfaces subsystem definitions these parameters are propagated to the subsystem level so that they can all be set by one parameter. The MultiBody connector is used to provide the support for the rotating component.

For example, the MultiBody connector in the WheelHub connection between the driveline and chassis subsystems provides a way to support the ends of the halfshafts when modelling the driveline as a MultiBody system. In the driveline and chassis subsystem templates this MultiBody connector is enabled via a parameter called includeWheelBearings. Both subsystems must have the same setting for this parameter for them to be compatible. Dymola generates a warning about unmatched connectors if this is not the case. To access the parameters, first extend the template to create your new driveline model. Then go to the component browser and right click on the extended class and select parameters. The parameter dialog will now be displayed and allow you access to the connector parameters.

Optional connectors

Many of the subsystem templates contain optional connectors. These are highlighted in the template diagrams by an orange dashed line around the connector. These connectors are enabled by parameters.

For example: The driveline subsystem contains an optional MultiBody connector called drivelineMount. This is enabled via a parameter called includeMount. To access the parameters, first extend the template to create your new driveline model. Then go to the component browser and right click on the extended class and select parameters. The parameter dialog will now be displayed and allow you access to the connector parameters.

Control Bus Structure

The control bus structure utilises expandable connectors to provide a flexible bus concept. This approach makes it easy to add new signals to the control bus so that data can be passed around the model. The control bus structure implemented is hierarchical so that signals are easily located. The approach adopted is that physical measurements taken from, for example, the transmission are placed on a sub-bus called transmissionBus. Signals output from control blocks, for example the transmission controller, are placed on a sub-bus called transmissionControlBus.


Generated at 2024-03-27T19:15:56Z by OpenModelicaOpenModelica 1.22.3 using GenerateDoc.mos