Active Pull

• 1: Active_Pull_Comp_MDD
• 2: Data Dictionary
• 3: Design Review
• 4: ActivePull_UnitTestReports

1 - Active_Pull_Comp_MDD

Module -- Active Pull Compensation

High-Level Description

This module corrects for vehicle pull issues by compensation for both long and short term torque offsets.

Figures

Component Diagram

Variable Data Dictionary

For details on module input / output variable, refer to the Data Dictionary for the application. Input / output variable names are listed here for reference.

Module Internal Variables

This section identifies the name, range and resolutions for module specific data created by this module. If there are no range restrictions on the variable, the term “FULL” is placed into the table for legal range.

User defined typedef definition/declaration

This section documents any user types uniquely used for the module.

Constant Data Dictionary

Calibration Constants

This section lists the calibrations used by the module. For details on calibration constants, refer to the Data Dictionary for the application.

The filter constants were derived from the requirements in SF-09 in conjunction with the following filter analyses. Note that the upper frequency limits defined in the requirements for some values were not achievable. The data dictionary reflects the limits of both the requirements and the software limitations.

Program(fixed) Constants

Embedded Constants

All embedded constants whose values are provided in Eng units will be evaluated to the equivalent counts by using the FPM_InitFixedPoint_m() macro within the #define statement.

Local

Global

This section lists the global constants used by the module. For details on global constants, refer to the Data Dictionary for the application.

Module specific Lookup Tables Constants

Functions/Macros used by the Sub-Modules

Library Functions / Macros

The library and functions / Macros that are called by the various sub modules are identified below,

1. FPM_FloatToFixed_m

2. FPM_FixedToFloat_m

3. LPF_SvUpdate_s16InFixKTrunc_m

4. Abs_f32_m

5. Min_m

6. Max_m

7. Sign_f32_m

8. Limit_m

9. IntplVarXY_u16_u16Xu16Y_Cnt

Data Hiding Functions

1. <None>

Global Functions/Macros Defined by this Module

None

Local Functions/Macros Used by this MDD only

None

Software Module Implementation

Runtime Environment (RTE) Initial Values

This section lists the initial values of data written by this module but controlled by the RTE. After RTE initialization, the data in this table will contain these values.

Initialization Functions

Init: ActivePull_Init1

Design Rationale

This initialization function is used to set values that are based solely on calibrations and constants (values which will not change over the course of an ignition cycle). This includes preliminary gain calculations, limits, and step sizes. It also initializes the LTComp_HwNm_M_f32 module-internal variable with the appropriate value from NvM.

Module Internal

LTWindUpLimit_HwNm_M_f32 = Min_m(k_TotalLimit_HwNm_f32, k_LTLimit_HwNm_f32)

STStepSize_HwNm_M_f32 = (D_STSAMPLETIME_SEC_F32 * k_STLimit_HwNm_f32) / k_STRampTime_Sec_f32

PullCompStepSize_HwNm_M_f32 = k_OutputMaxRate_HwNmpS_f32 * D_PULLCOMPSAMPLETIME_SEC_F32

Periodic Functions

Per: ActivePull_Per1

Design Rationale

The requirements in SF-13 show a signal called Reset_Svc. This is shown as an input flag to the function. However, the reset service has been implemented as a service call. In order to avoid any thread-based issues, the service sets a separate variable for each periodic (ResetPer1_Cnt_M_lgc, in this case) to TRUE. Then, near the beginning of the execution of the periodic, this value is read. If it has been set to true, it is immediately set to FALSE, and a local copy (ResetSvc_Cnt_T_lgc) is set to TRUE. In this way, each periodic uses its own local copy just as the design dictates using the input signal. The local copy will be set to true for one execution of each periodic function.

The SCom function to set the STComp is done in a similar fashion. The Scom function sets SComSTCompSet_Cnt_M_lgc to TRUE and when ActivePull_Per1 finds this value set to TRUE, it sets it back to FALSE and uses SComSTComp_HwNm_M_f32 as the state variable (instead of STComp_HwNm_M_f32, as it normally would). The state variable itself is never changed, but the output of the next execution of ActivePull_Per1 will reflect the new value.

Program Flow Start

Rte_Call_ActivePull_Per1_CP0_CheckpointReached()

Store Module Inputs to Local copies

DisableLearning_Cnt_T_lgc = Rte_Iread_ActivePull_Per1_DisableLearning_Cnt_lgc()

DisableOutput_Cnt_T_lgc = Rte_Iread_ActivePull_Per1_DisableOutput_Cnt_lgc()

HandwheelAuthority_Uls_T_f32 = Rte_Iread_ActivePull_Per1_HandwheelAuthority_Uls_f32()

HandwheelPosition_HwDeg_T_f32 = Rte_Iread_ActivePull_Per1_HandwheelPosition_HwDeg_f32()

HandwheelVelocity_HwRadpS_T_f32 = Rte_Iread_ActivePull_Per1_HandwheelVelocity_HwRadpS_f32()

HwTorque_HwNm_T_f32 = Rte_Iread_ActivePull_Per1_HwTorque_HwNm_f32()

SrlComYawRate_DegpS_T_f32 = Rte_Iread_ActivePull_Per1_SrlComYawRate_DegpS_f32()

VehicleSpeedValid_Cnt_T_lgc = Rte_Iread_ActivePull_Per1_VehicleSpeedValid_Cnt_lgc()

VehicleSpeed_Kph_T_f32 = Rte_Iread_ActivePull_Per1_VehicleSpeed_Kph_f32()

LTComp_HwNm_T_f32 = LTComp_HwNm_M_f32

PrevSTComp_HwNm_T_f32 = STComp_HwNm_M_f32

Check for Scom Functions

Filter Inputs

Active Compensation Enable

Determine Enable Learning

Short Term Compensation Filter

Calculate Integrator Gains

Error Integrator & Active Limit

Store Local copy of outputs into Module Outputs

HwTrqFilt_HwNm_D_f32 = HwTrqFilt_HwNm_T_f32

YawRateFilt_DegpS_D_f32 = YawRateFilt_DegpS_T_f32

STError_HwNm_D_f32 = STError_HwNm_T_f32

STIntGain_Uls_D_f32 = STIntGain_Uls_T_f32

STReset_Cnt_D_lgc = STReset_Cnt_T_lgc

STComp_HwNm_M_f32 = STComp_HwNm_T_f32

EnableLearn_Cnt_M_lgc = EnableLearning_Cnt_T_lgc

Program Flow End

Rte_Call_ActivePull_Per1_CP1_CheckpointReached()

Per: ActivePull_Per2

Design Rationale

The Reset_Svc functionality is defined in section 6.3.1.1.

Program Flow Start

Rte_Call_ActivePull_Per2_CP0_CheckpointReached()Store Module Inputs to Local copies

VehicleSpeed_Kph_T_f32 = Rte_Iread_ActivePull_Per2_VehicleSpeed_Kph_f32()

DisableOutput_Cnt_T_lgc = Rte_Iread_ActivePull_Per2_DisableOutput_Cnt_lgc()

PrevPullCompCmd_HwNm_T_f32 = PullCompCmd_HwNm_M_f32

STComp_HwNm_T_f32 = STComp_HwNm_M_f32

LTComp_HwNm_T_f32 = LTComp_HwNm_M_f32

Check for Reset

Calculate Active Compensation

Store Local copy of outputs into Module Outputs

PullCompCmd_HwNm_M_f32 = PullCompCmd_HwNm_T_f32

Rte_Iwrite_ActivePull_Per2_PullCompCmd_MtrNm_f32(PullCompCmd_MtrNm_T_f32)

Program Flow End

Rte_Call_ActivePull_Per2_CP1_CheckpointReached()Per: ActivePull_Per3

Design Rationale

The Reset_Svc and state variable functionality are defined in section 6.3.1.1. Note that the Scom functions will have no effect until the next execution of ActivePull_Per3, which could result in a propagation delay of up to 100 ms.

Program Flow Start

Rte_Call_ActivePull_Per3_CP0_CheckpointReached()Store Module Inputs to Local copies

VehSpd_Kph_T_f32 = Rte_IRead_ActivePull_Per3_VehicleSpeed_Kph_f32()

HwTorque_HwNm_T_f32 = Rte_Iread_ActivePull_Per3_HwTorque_HwNm_f32()

EnableLearning_Cnt_T_lgc = EnableLearn_Cnt_M_lgc

STComp_HwNm_T_f32 = STComp_HwNm_M_f32

PrevLTComp_HwNm_T_f32 = LTComp_HwNm_M_f32

Check for Scom Functions

Long Term Compensation Filter

Error Integrator

Store Local copy of outputs into Module Outputs

LTError_HwNm_D_f32 = LTError_HwNm_T_f32

LTComp_HwNm_M_f32 = LTComp_HwNm_T_f32

Program Flow End

Rte_Call_ActivePull_Per3_CP1_CheckpointReached()

Fault Recovery Functions

None

Shutdown Functions

None

Interrupt Functions

None

Serial Communication Functions

Scom: ActivePull_Scom_Reset

Design Rationale

Program Flow Start

N/A

Store Module Inputs to Local copies

Reset Service

Store Local copy of outputs into Module Outputs

None

Program Flow End

N/A

Scom: ActivePull_Scom_SetLTComp

Design Rationale

This function helps to fulfill the requirement that the “Engineering interface tool shall provide ability to set state variable to desired value”. The state variable itself will not be updated until the next time ActivePull_Per3 is run, but the NvM value is updated immediately.

Program Flow Start

N/A

Store Module Inputs to Local copies

None

Store Local copy of outputs into Module Outputs

None

Program Flow End

N/A

Scom: ActivePull_Scom_SetSTComp

Design Rationale

This function helps to fulfill the requirement that the “Engineering interface tool shall provide ability to set state variable to desired value”. The state variable itself will not be updated until the next time ActivePull_Per1 is run.

Program Flow Start

N/A

Store Module Inputs to Local copies

None

Store Local copy of outputs into Module Outputs

None

Program Flow End

N/A

Scom: ActivePull_Scom_ReadParam

Program Flow Start

N/A

Store Module Inputs to Local copies

None

Read Data

*PullCompCmd_HwNm_f32 = PullCompCmd_HwNm_M_f32

*STComp_HwNm_f32 = STComp_HwNm_M_f32

*LTComp_HwNm_f32 = LTComp_HwNm_M_f32

*EnableLearn_Cnt_lgc = EnableLearn_Cnt_M_lgc

Store Local copy of outputs into Module Outputs

None

Program Flow End

N/A

Transition Functions

Trns: ActivePull_Trns1

Design Rationale

This function is run when entering the OPERATE state. The LTComp NvM block is set to write on shutdown (as ActivePull_Per3 will be updating the NvM block), and the timers associated with ActivePull_Per1 are initialized.

Program Flow Start

N/A

Store Module Inputs to Local copies

None

Initialization

Store Local copy of outputs into Module Outputs

None

Program Flow End

N/A

Execution Requirements

Execution Sequence of the Module

ActivePull_Per1 and Per2 are run at 2ms intervals, while Per3 is run at a 100ms interval. However, while Per2 is run in all operation states, Per1 and Per3 are only run in the OPERATE state. ActivePull_Trns1 is run upon entering the OPERATE state.

Execution Rates for sub-modules called by the Scheduler

This table serves as reference for the Scheduler design

Execution Requirements for Serial Communication Functions

Memory Map Definition Requirements

Sub Modules (Functions)

This table identifies the software segments for functions identified in this module.

Local Functions

This table identifies the software segments for local functions identified in this module.

Known Issues / Limitations With Design

1. INLINE functions defined in “GlobalMacro.h” are not unit tested

Revision Control Log

2 - Data Dictionary