Damping_Firewall_MDD

Module – Damping Firewall

High-Level Description

This module regulates the damping command according to safety specifications.

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.

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. LPF_KUpdate_f32_m

2. LPF_OpUpdate_f32_m

3. HPF_KUpdate_f32_m

4. HPF_OpUpdate_f32_m

5. FPM_FloatToFixed_m

6. FPM_FixedToFloat_m

7. IntplVarXY_u16_u16Xu16Y_Cnt

8. BilinearXYM_s16_s16Xs16YM_Cnt

9. TableSize_m

10. Limit_m

11. Sign_f32_m

12. Rte_Call_NxtrDiagMgr_SetNTCStatus

13. FPM_Fix_m

14. Abs_s32_m

Data Hiding Functions

1. None

Global Functions/Macros Defined by this Module

None

Local Functions/Macros Used by this MDD only

Local Function #1

Description

Calculate ADD Coefficient

Description

Calculate Filter Coefficients

Description

FiltFreqLUBlnd_RadpS_T_s10p5 = FPM_Fix_m((FiltFreqLUBlnd_RadpS_T_s10p5 * D_2PI_ULS_U3P13), s13p18_T, s10p5_T)

Generate Command

Description

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: DampingFirewall_Init1

Design Rationale

None

Module Outputs

None

Module Internal

None

Initialize Filters

Periodic Functions

Per: DampingFirewall_Per1

Design Rationale

None

Program Flow Start

Rte_Call_ActivePull_Per1_CP0_CheckpointReached()

Store Module Inputs to Local copies

DefeatDampingSvc_Cnt_T_lgc = Rte_IRead_DampingFirewall_Per1_Defeat_Damping_Svc_Cnt_lgc()

MECCounter_Cnt_T_enum = Rte_IRead_DampingFirewall_Per1_MEC_Counter_Cnt_enum()

AsstFirewallActive_Uls_T_f32 = Rte_IRead_DampingFirewall_Per1_AsstFirewallActive_Uls_f32()

DampingCmd_MtrNm_T_f32 = Rte_IRead_DampingFirewall_Per1_DampingCmd_MtrNm_f32()

HwTorque_HwNm_T_f32 = Rte_IRead_DampingFirewall_Per1_HwTorque_HwNm_f32()

InertiaComp_MtrNm_T_f32 = Rte_IRead_DampingFirewall_Per1_InertiaComp_MtrNm_f32()

MtrVelCRF_MtrRadpS_T_f32 = Rte_IRead_DampingFirewall_Per1_MtrVelCRF_MtrRadpS_f32()

VehicleSpeed_Kph_T_f32 = Rte_IRead_DampingFirewall_Per1_VehicleSpeed_Kph_f32()

BaseAsstCmd_MtrNm_T_f32 = Rte_IRead_DampingFirewall_Per1_BaseAssistCmd_MtrNm_f32()

WIRCmdAmpBlnd_MtrNm_T_f32 = Rte_IRead_DampingFirewall_Per1_WIRCmdAmpBlnd_MtrNm_f32()

FDDDefSrvFlg_Cnt_T_lgc = Rte_IRead_DampingFirewall_Per1_FreqDepDmpSrlComSvcDft_Cnt_lgc()

VehicleLonAccel_KphpS_T_f32 = Rte_IRead_DampingFirewall_Per1_VehicleLonAccel_KphpS_f32()

VehicleSpeed_Kph_T_u9p7 = FPM_FloatToFixed_m(VehicleSpeed_Kph_T_f32, u9p7_T)

MtrVelCRF_MtrRadpS_T_s11p4 = FPM_FloatToFixed_m(MtrVelCRF_MtrRadpS_T_f32, s11p4_T)

AbsMtrVelCRF_MtrRadpS_T_u11p5 = FPM_FloatToFixed_m(Abs_f32_m(MtrVelCRF_MtrRadpS_T_f32), u11p5_T)

DampFWPstepNstep_Cnt_T_str.PStep = k_DampFWPstep_Cnt_u16

DampFWPstepNstep_Cnt_T_str.NStep = k_DampFWNstep_Cnt_u16

DampFWPstepNstep_Cnt_T_str.Threshold = t_DampFWPNstepThresh_Cnt_u16[1]

DampFWInrtCmpPstepNstep_Cnt_T_str.PStep = k_DampFWInCmpPStep_Cnt_u16

DampFWInrtCmpPstepNstep_Cnt_T_str.NStep = k_DampFWInCmpNStep_Cnt_u16

DampFWInrtCmpPstepNstep_Cnt_T_str.Threshold = t_DampFWDampInrtCmpPNThesh_Cnt_u16[1]

Damping Limiter – Interpolate and Filter Boundaries

PNCounter

Additional Damping

Store Local copy of outputs into Module Outputs

DampFWUprBound_MtrNm_D_f32 = UprBoundRaw_MtrNm_T_f32

DampFWLwrBound_MtrNm_D_f32 = LwrBoundRaw_MtrNm_T_f32

DampFWAddedDamp_MtrNm_D_f32 = AddedDamp_MtrNm_T_f32

DampFW_ddedDampAFW_MtrNm_D_f32 = AFWAddDamping_MtrNm_T_f32

DampFWAddedDampDFW_MtrNm_D_f32 = DFWAddDamping_MtrNm_T_f32

Rte_IWrite_DampingFirewall_Per1_CombinedDamping_MtrNm_f32(CombinedDamping_MtrNm_T_f32)

Program Flow End

Rte_Call_ActivePull_Per1_CP1_CheckpointReached()

Fault Recovery Functions

None

Shutdown Functions

None

Interrupt Functions

None

Serial Communication Functions

None

Execution Requirements

Execution Sequence of the Module

DampingFirewall_Per1 is called at a rate of 2 ms.

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