PxVehicleAutoBoxUpdate

Defined in include/vehicle2/drivetrain/PxVehicleDrivetrainFunctions.h

void PxVehicleAutoBoxUpdate(

const PxVehicleEngineParams &engineParams,

const PxVehicleGearboxParams &gearboxParams,

const PxVehicleAutoboxParams &autoboxParams,

const PxVehicleEngineState &engineState,

const PxVehicleGearboxState &gearboxState,

const PxReal dt,

PxU32 &targetGearCommand,

PxVehicleAutoboxState &autoboxState,

PxReal &throttle,

)

Note

The autobox will not begin a gear change if a gear change is already ongoing.

Note

The autobox will not begin a gear change until a threshold time has lapsed since the last automated gear change.

Note

A gear change is considered as ongoing for as long as PxVehicleGearboxState::currentGear is different from PxVehicleGearboxState::targetGear.

Note

The autobox will not shift down from 1st gear or up from reverse gear.

Note

The autobox shifts in single gear increments or decrements.

Note

The autobox instantiates a gear change by setting PxVehicleCommandState::targetGear to be different from from PxVehicleGearboxState::currentGear

Parameters:

• engineParams – [in] specifies the engine configuration.

• gearboxParams – [in] specifies the gear ratios and the time required to complete a gear change.

• autoboxParams – [in] specifies the conditions for switching gear.

• engineState – [in] contains the current angular speed of the engine.

• gearboxState – [in] describes the current and target gear.

• dt – [in] is the time that has lapsed since the last call to PxVehicleAutoBoxUpdate.

• targetGearCommand – [inout] specifies the desired target gear for the gearbox. If set to PxVehicleEngineDriveTransmissionCommandState::eAUTOMATIC_GEAR, the value will get overwritten with a target gear chosen by the autobox.

• autoboxState – [out] specifies the time that has lapsed since the last automated gear change and contains a record of any ongoing automated gear change.

• throttle – [out] A throttle command value in [0, 1] that will be set to 0 if a gear change is initiated or is ongoing.