BmwTqOvrlCdngAndDrvgDynFac_MDD

Module Design Document

For

BmwTqOvrlCdngAndDrvgDynFac

April 26, 2018

Prepared For:

Software Engineering

Nexteer Automotive,

Saginaw, MI, USA

Prepared By:

Software Group,

Nexteer Automotive,

Tychy, Poland
Change History

DescriptionAuthorVersionDate
Initial versionMarek Brykczyński126-Apr-2018


Table of Contents

1 Introduction 5

1.1 Purpose 5

1.2 Scope 5

2 BmwTqOvrlCdngAndDrvgDynFac & High-Level Description 6

3 Design details of software module 7

3.1 Graphical representation of BmwTqOvrlCdngAndDrvgDynFac 7

3.2 Data Flow Diagram 7

3.2.1 Component level DFD 8

3.2.2 Function level DFD 8

4 Constant Data Dictionary 9

4.1 Program (fixed) Constants 9

4.1.1 Embedded Constants 9

5 Software Component Implementation 10

5.1 Sub-Module Functions 10

5.1.1 Init: BmwTqOvrlCdngAndDrvgDynFacInit1 10

5.1.2 Per: BmwTqOvrlCdngAndDrvgDynFacPer1 10

5.2 Server Runables 10

5.3 Interrupt Functions 10

5.4 Module Internal (Local) Functions 11

5.4.1 CalcCdndTqOvrl 11

5.4.2 CalcnDampgCmdSca 11

5.4.3 CalcnEffortCmdSca 11

5.4.4 CalcnLimdCdndTqOvrl 11

5.4.5 CalcnRtnCmdSca 12

5.4.6 StTranDetn 12

5.4.7 TqOvrlCdng 12

5.5 GLOBAL Function/Macro Definitions 12

6 Known Limitations with Design 14

7 UNIT TEST CONSIDERATION 15

Appendix A Abbreviations and Acronyms 16

Appendix B Glossary 17

Appendix C References 18

Introduction

Purpose

Module Design Document for CF040A_BmwTqOvrlCdngAndDrvgDynFac_Impl.

Scope

The following definitions are used throughout this document:

  • Shall: indicates a mandatory requirement without exception in compliance.

  • Should: indicates a mandatory requirement; exceptions allowed only with documented justification.

  • May: indicates an optional action.

BmwTqOvrlCdngAndDrvgDynFac & High-Level Description

The BMW Torque Overlay Conditioning And Driving Dynamic Factor function handles the filtering and ramping of the BMW Output Torque Overlay Command functionality and conditioning of the BMW Driving Dynamic Factors for Effort/Assist, Return and Damping.

Design details of software module

Graphical representation of BmwTqOvrlCdngAndDrvgDynFac

Data Flow Diagram

Refer FDD

Component level DFD

Refer FDD

Function level DFD

Refer FDD

Constant Data Dictionary

Program (fixed) Constants

Embedded Constants

Local Constants

Constant NameResolutionUnitsValue
-

Refer FDD for local constants.

Software Component Implementation

Sub-Module Functions

The sub-module functions are grouped based on similar functionality that needs to be executed in a given “State” of the system (refer States and Modes). For a given module, the MDD will identify the type and number of sub-modules required. The sub-module types are described below.

Init: BmwTqOvrlCdngAndDrvgDynFacInit1

Design Rationale

Refer FDD

Module Outputs

Refer FDD

Per: BmwTqOvrlCdngAndDrvgDynFacPer1

Design Rationale

Refer FDD

Store Module Inputs to Local copies

Refer FDD

(Processing of function)………

Refer FDD

Store Local copy of outputs into Module Outputs

Refer FDD

Server Runables

None

Interrupt Functions

None

Module Internal (Local) Functions

CalcCdndTqOvrl

Function NameCalcCdndTqOvrlTypeMinMax
Arguments PassedFildBmwTarSteerTqDrvrActr_MotNwtMtr_T_f32float32-8.88.8
BmwTarSteerTqDrvrActr_MotNwtMtr_T_f32float32-8.88.8
BmwDrvgDynErrIfActv_Cnt_T_loglbooleanFALSETRUE
Return ValueCdndTqOvrl_MotNwtMtr_T_f32float32-8.88.8

CalcnDampgCmdSca

Function NameCalcnDampgCmdScaTypeMinMax
Arguments PassedDrvgDynActv_Cnt_T_loglbooleanFALSETRUE
ReqdDampgCmdSca_Uls_T_f32float3201
DrvgDynActvTrig_Cnt_T_loglbooleanFALSETRUE
Return Value----

CalcnEffortCmdSca

Function NameCalcnEffortCmdScaTypeMinMax
Arguments PassedDrvgDynActv_Cnt_T_loglbooleanFALSETRUE
ReqdEffortCmdSca_Uls_T_f32float3212
DrvgDynActvTrig_Cnt_T_loglbooleanFALSETRUE
Return Value----

CalcnLimdCdndTqOvrl

Function NameCalcnLimdCdndTqOvrlTypeMinMax
Arguments PassedCdndTqOvrl_MotNwtMtr_T_f32float32-8.88.8
VehSpd_Kph_T_u9p7uint16068408
Return Value----

CalcnRtnCmdSca

Function NameCalcnRtnCmdScaTypeMinMax
Arguments PassedDrvgDynActv_Cnt_T_loglbooleanFALSETRUE
ReqdRtnCmdSca_Uls_T_f32float3201
DrvgDynActvTrig_Cnt_T_loglbooleanFALSETRUE
Return Value----

StTranDetn

Function NameStTranDetnTypeMinMax
Arguments PassedDrvgDynIfSt_Cnt_T_u08uint832255
BmwTarSteerTqDrvrActr_MotNwtMtr_T_f32float32-8.88.8
FildBmwTarSteerTqDrvrActr_MotNwtMtr_T_f32float32-8.88.8
Return ValueOutpRstTrig_Cnt_T_loglbooleanFALSETRUE

TqOvrlCdng

Function NameTqOvrlCdngTypeMinMax
Arguments PassedDrvgDynIfSt_Cnt_T_u08uint832255
BmwTarSteerTqDrvrActr_MotNwtMtr_T_f32float32-8.88.8
VehSpd_Kph_T_u9p7uint16068408
BmwDrvgDynErrIfActv_Cnt_T_loglbooleanFALSETRUE
Return ValueOutpRstTrig_Cnt_T_loglbooleanFALSETRUE

Design Rationale

Refer FDD

Processing

Refer FDD

GLOBAL Function/Macro Definitions

None

Known Limitations with Design

None

UNIT TEST CONSIDERATION

None

Abbreviations and Acronyms

Abbreviation or AcronymDescription
FDDFunctional Design Document. (See references)

Glossary

Note: Terms and definitions from the source “Nexteer Automotive” take precedence over all other definitions of the same term. Terms and definitions from the source “Nexteer Automotive” are formulated from multiple sources, including the following:

  • ISO 9000

  • ISO/IEC 12207

  • ISO/IEC 15504

  • Automotive SPICE® Process Reference Model (PRM)

  • Automotive SPICE® Process Assessment Model (PAM)

  • ISO/IEC 15288

  • ISO 26262

  • IEEE Standards

  • SWEBOK

  • PMBOK

  • Existing Nexteer Automotive documentation

TermDefinitionSource
MDDModule Design Document
DFDData Flow Diagram

References

Ref. #TitleVersion
1AUTOSAR Specification of Memory Mapping (Link:AUTOSAR_SWS_MemoryMapping.pdf)v1.4.0 R4.0 Rev 3
2MDD Guideline EA41.02
3EA4 Software Naming Conventions1.01
4Software Design and Coding Standards2.01
5CF011A_BmwTqOvrlCdngAndDrvgDynFac_DesignSee Synergy Sub Project Version
Last modified October 12, 2025: Initial commit (af72ad2)