classDriverInteractionBus
Extends from Modelica.Icons.Information (Icon for general information packages).
Information
The Driver Interaction bus connects the driver's environment to an external driver model and is implemented using expandable connectors. This enables signals to be easily added to the control signal bus to suit a particular application. A minimal set of signals has been defined, see Drivers.Internal, to ensure basic compatibility between the various automotive libraries.
The Driver Interaction bus can contain both normalised physical connectors and sensed values as signal connections.
Naming of Driver Interaction bus components
Connectors placed on the Driver Interaction bus should be named following the same rules as naming the instance of a class. This is based on the view that the items placed on to the control signal bus are actually connectors rather than simple variable values.
This means that connectors placed on the bus are written with a lower-case initial letter and then initial capital letters for each word, like in "acceleratorPedal".
Standard names
The following table defines the standard names and associated connector types and units used.
| Name on the bus | Connector Type | Units | Description |
|---|---|---|---|
| acceleratorPedal | NTI.Flange | - | Accelerator pedal connection using a normalised physical connector |
| brakePedal | NTI.Flange | - | Brake pedal connection using a normalised physical connector |
| clutchPedal | NTI.Flange | - | Clutch pedal connection using a normalised physical connector |
| steeringWheel | NRI.Flange_a | - | Steering wheel connection using a normalised physical connector |
| vehicleSpeed | RealSignal | m/s | Vehicle longitudinal velocity |
| engineSpeed | RealSignal | rad/s | Engine speed |
| gear | IntegerSignal | - | Gear selected by the driver (manual transmission only) |
| clutchLocked | BooleanSignal | - | Flag for clutch state, true=clutch in stuck mode (manual transmission only) |
| gearboxMode | IntegerSignal | Enumeration | Gearbox mode selected by the driver (automatic transmission only) |
| requestedGear | IntegerSignal | - | Gear selected by the driver if the automatic is in a manual mode (automatic transmission only) |
Key:
- NTI = NormalisedTranslational.Interfaces
- NRI = NormalisedRotational.Interfaces
- RealSignal = Modelica.Blocks.Interfaces.RealSignal
- IntegerSignal = Modelica.Blocks.Interfaces.IntegerSignal
- BooleanSignal = Modelica.Blocks.Interfaces.BooleanSignal
- VI = VehicleInterfaces
Pedal Conventions
For the driver the following conventions are used to describe the pedal positions as normalised values.
- 1 = Pedal Fully Pressed
- 0 = Pedal Fully Released
For example: when the accelerator pedal position = 1, the driver is accelerating as fast as possible; when the clutch pedal position = 1, the driver has pressed the clutch pedal and the clutch is actually disengaged.