StHlthSigNormn_MDD

Module Design Document

For

State of Health Signal Normalization

Sep 27, 2016

Prepared For:

Software Engineering

Nexteer Automotive,

Saginaw, MI, USA

Prepared By:

Software Group,

Nexteer Automotive,

Saginaw, MI, USAChange History

Sl. No.DescriptionAuthorVersionDate
1Initial VersionAkilan Rathakrishnan1.009-Feb-2016
2Updated for EA4# 5445Akilan Rathakrishnan2.002-May-2016
3Updated for EA4#7305Akilan Rathakrishnan3.027-Sep-2016

Table of Contents

1 StHlthSignNormn High-Level Description 5

2 Design details of software module 6

2.1.1.1 Graphical representation of StHlthSigNormn 6

2.1.1.2 Data Flow Diagram 7

2.1.2 Component level DFD 8

2.1.3 Function level DFD 8

3 Constant Data Dictionary 9

3.1.1.1 Program (fixed) Constants 9

3.1.2 Embedded Constants 9

4 Software Component Implementation 10

4.1.1 Sub-Module Functions 10

4.1.1.1 Init: StHlthSigNormnInit1 10

4.1.1.2 Per: None 10

4.1.2 Interrupt Service Routines 10

4.1.3 Server Runnable Functions 10

4.1.3.1 UpdRawSig 10

4.1.3.1.1 Design Rationale 10

4.1.3.1.2 Store Module Inputs to Local copies 10

4.1.3.1.3 (Processing of function)……… 10

4.1.3.1.4 Store Local copy of outputs into Module Outputs 10

4.1.4 Module Internal (Local) Functions 11

4.1.4.1 Local Function #1 11

4.1.4.1.1 Description 11

4.1.4.2 Local Function #2 Rationale 11

4.1.4.2.1 Description 11

4.1.4.3 Local Function #3 Rationale 11

4.1.4.3.1 Description 11

4.1.4.4 Local Function #4 Rationale 12

4.1.4.4.1 Description 12

4.1.4.5 Local Function #5 Rationale 12

4.1.4.5.1 Description 12

4.1.4.6 Local Function #6 Rationale 12

4.1.4.6.1 Description 12

4.1.4.7 Local Function #7 Rationale 12

4.1.4.7.1 Description 13

4.1.4.8 Local Function #8 Rationale 13

4.1.4.8.1 Description 13

4.1.4.9 Local Function #9 Rationale 13

4.1.4.9.1 Description 13

4.1.4.10 Local Function #10 Rationale 13

4.1.4.10.1 Description 13

4.1.4.11 Local Function #11 Rationale 14

4.1.4.11.1 Description 14

4.1.4.12 Local Function #12 Rationale 14

4.1.4.12.1 Description 14

4.1.4.13 Local Function #13 Rationale 14

4.1.4.13.1 Description 14

4.1.5 Transition Functions 14

5 Known Limitations with Design 15

6 UNIT TEST CONSIDERATION 16

Appendix A Abbreviations and Acronyms 17

Appendix B Glossary 18

Appendix C References 19

StHlthSignNormn High-Level Description

This component acts as an interface component between ES106A (State of Health Signal Statistics) and rest of the components from which signals need to be monitored. It reads data or status values from different components, applies normalization algorithm to convert it as State of Health information which will be in the scale of 0 to 100. It also provides auxiliary output for some signals to indicate the additional information about monitored signals.

Design details of software module

See FDD.

Graphical representation of StHlthSigNormn

Data Flow Diagram

See FDD.

Component level DFD

See FDD.

Function level DFD

See FDD.

Constant Data Dictionary

Program (fixed) Constants

Embedded Constants

Local Constants

Constant NameResolutionUnitsValue
TMAXRNGVAL_CNT_U081Cnt15
VLTGMAXRNGVAL_CNT_U081Cnt15
PHAVLTGDIVBYZEROPROTNVAL_NANOSEC_U321NanoSec180000

* Also see FDD ES105A_StHlthSigNormn_DataDict.m file

Software Component Implementation

<The detailed design of the function is provided in the FDD. The detail design shall only be added to the MDD when it is not provided in the FDD or the FDD is not adequate and clarification is needed.>

Sub-Module Functions

Init: StHlthSigNormnInit1

Design Rationale

None

Module Outputs

See FDD

Module Internal

See FDD

Per: None

Interrupt Service Routines

None

Server Runnable Functions

UpdRawSig

Design Rationale

None

Store Module Inputs to Local copies

See FDD

(Processing of function)………

See FDD

Store Local copy of outputs into Module Outputs

See FDD

Module Internal (Local) Functions

Local Function #1

Function NameEcuTFildMonTypeMinMax
Arguments PassedNoneN/AN/AN/A
Return ValueCtrlrTStHlthUint80100
Return ValueCtrlrTRngUint8015

Description

This function implements “Controller Temperature” block in the FDD

Local Function #2 Rationale

Function NameOutpAssiMonTypeMinMax
Arguments PassedNoneN/AN/AN/A
Return ValueOutpAssiStHlthUint80100
Return ValueVltgRngUint8015

Description

This function implements “Health of Assist Due To Voltage” block in the FDD

Local Function #3 Rationale

Function NameDigTqSnsrStHlthCalcTypeMinMax
Arguments PassedSigId_ArgStHlthMonSig2020
Return ValueDigTqSnsrAStHlthUint80100
Return ValueDigTqSnsrBStHlthUint80100
Return ValueDigTqIdptSigStHlthUint80100

Description

This function implements “Digital Torque Sensor” block in the FDD

Local Function #4 Rationale

Function NameDutyCycExcddStHlthCalcTypeMinMax
Arguments PassedNoneN/AN/AN/A
Return ValueDutyCycStHlthUint80100

Description

This function implements “Duty Cycle” block in the FDD

Local Function #5 Rationale

Function NameEotImpctCntrStHlthCalcTypeMinMax
Arguments PassedNoneN/AN/AN/A
Return ValueEotImpctStHlthUint80100

Description

This function implements “EOT Impact” block in the FDD

Local Function #6 Rationale

Function NameMotPosnStHlthCalcTypeMinMax
Arguments PassedNoneN/AN/AN/A
Return ValueMotPosStHlthUint80100

Description

This function implements “Motor Position” block in the FDD

Local Function #7 Rationale

Function NameMotPosnErrStHlthCalcTypeMinMax
Arguments PassedSigId_ArgStHlthMonSig2020
Return ValueAbsltMotPosABDifStHlthUint80100
Return ValueAbsltMotPosACDifStHlthUint80100
Return ValueAbsltMotPosBCDifStHlthUint80100

Description

This function implements “Motor Position Phase Difference” block in the FDD

Local Function #8 Rationale

Function NameCurrMotSumStHlthCalcTypeMinMax
Arguments PassedSigId_ArgStHlthMonSig2020
Return ValueCurrMotSumABCStHlthUint80100
Return ValueCurrMotSumDEFStHlthUint80100

Description

This function implements “Current Motor Sum” block in the FDD

Local Function #9 Rationale

Function NamePhaVltgStHlthCalcTypeMinMax
Arguments PassedSigId_ArgStHlthMonSig2020
Return ValuePhaAStHlthUint80100
Return ValuePhaBStHlthUint80100
Return ValuePhaCStHlthUint80100
Return ValuePhaDStHlthUint80100
Return ValuePhaEStHlthUint80100
Return ValuePhaFStHlthUint80100

Description

This function implements “Health of Phase” block in the FDD

Local Function #10 Rationale

Function NameRamEccSngBitCorrnStHlthCalcTypeMinMax
Arguments PassedNoneN/AN/AN/A
Return ValueRamEccSngBitCorrnStHlthUint80100

Description

This function implements “Single Bit Correction” block in the FDD

Local Function #11 Rationale

Function NamePhaVltgCalcStHlthTypeMinMax
Arguments PassedMotDrvErrX_NanoSec_T_f32float320,040000000,0
Return ValuePhaXStHlth_Cnt_T_u08Uint80100

Description

This function implements a sub-section in“Health of Phase”” block in the FDD

Local Function #12 Rationale

Function NameFricEstimnStHlthCalcTypeMinMax
Arguments PassedNoneNA
Return ValueNoneNA

Description

This function implements a sub-section in“Friction Estimation”” block in the FDD

Local Function #13 Rationale

Function NameWhlImbRejctnStHlthCalcTypeMinMax
Arguments PassedNoneNA
Return ValueNoneNA

Description

This function implements a sub-section in“Wheel Imbalance Rejection”” block in the FDD

Transition Functions

None.

Known Limitations with Design

None

UNIT TEST CONSIDERATION

None

Abbreviations and Acronyms

Abbreviation or AcronymDescription
DFDDesign functional diagram
MDDModule design Document
FDDFunctional Design Document

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.3.0 R4.0 Rev 2
2MDD GuidelineProcess Release 04.02.01
3Software Naming Conventions.docProcess Release 04.02.01
4Software Design and Coding Standards.docProcess Release 04.02.01
5FDD: ES105A_StHlthSigNormn_DesignSee Synergy subproject version
Last modified October 12, 2025: Initial commit (1fadfc4)