.VehicleInterfaces.UsersGuide.DriverInteractionBus .VehicleInterfaces.UsersGuide.DriverInteractionBusThe 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.
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".
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:
For the driver the following conventions are used to describe the pedal positions as normalised values.
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.