SnsrOffLrng_MDD

Module Design Document

For

Sensor Offset Learning

August 17, 2016

Prepared For:

Software Engineering

Nexteer Automotive,

Saginaw, MI, USA

Prepared By:

SEPG,

Nexteer Automotive,

Saginaw, MI, USA
Change History

VersionDescriptionAuthorDate
1Initial VersionSelva Sengottaiyan07-Feb-2016
2Updated as per FDD v 1.2.0Krishna Anne07-Mar-2016
3Updated graphical representationNick Saxton17-Aug-2016


Table of Contents1 Introduction 6

2 SnsrOffsLrng & High-Level Description 7

3 Design details of software module 8

3.1 Graphical representation of SnsrOffsLrng 9

4 Constant Data Dictionary 11

4.1 Program (fixed) Constants 11

4.1.1 Embedded Constants 11

5 Software Component Implementation 12

5.1 Sub-Module Functions 12

5.1.1 Init: SnsrOffsLrngInit1 12

5.1.1.1 Design Rationale 12

5.1.1.2 Module Outputs 12

5.1.2 Per: SnsrOffsLrngPer1 12

5.1.2.1 Design Rationale 12

5.1.2.2 Store Module Inputs to Local copies 12

5.1.2.3 (Processing of function)……… 12

5.1.2.4 Store Local copy of outputs into Module Outputs 12

5.1.1 Per: SnsrOffsLrngPer2 12

5.1.1.1 Design Rationale 12

5.1.1.2 Store Module Inputs to Local copies 12

5.1.1.3 (Processing of function)……… 12

5.1.1.4 Store Local copy of outputs into Module Outputs 12

5.2 Server Runables 13

5.2.1 SnsrOffsLrng_RstHwTq 13

5.2.1.1 Design Rationale 13

5.2.1.2 Store Module Inputs to Local copies 13

5.2.1.3 (Processing of function)……… 13

5.2.1.4 Store Local copy of outputs into Module Outputs 13

5.2.2 SnsrOffsLrng_RstYawAndAg 13

5.2.2.1 Design Rationale 13

5.2.2.2 Store Module Inputs to Local copies 13

5.2.2.3 (Processing of function)……… 13

5.2.2.4 Store Local copy of outputs into Module Outputs 13

5.2.3 SnsrOffsLrng_SetHwAgOffs 13

5.2.3.1 Design Rationale 13

5.2.3.2 Store Module Inputs to Local copies 13

5.2.3.3 (Processing of function)……… 13

5.2.3.4 Store Local copy of outputs into Module Outputs 13

5.2.4 SnsrOffsLrng_GetHwAgOffs 14

5.2.4.1 Design Rationale 14

5.2.4.2 Store Module Inputs to Local copies 14

5.2.4.3 (Processing of function)……… 14

5.2.4.4 Store Local copy of outputs into Module Outputs 14

5.2.5 SnsrOffsLrng_SetHwTqOffs 14

5.2.5.1 Design Rationale 14

5.2.5.2 Store Module Inputs to Local copies 14

5.2.5.3 (Processing of function)……… 14

5.2.5.4 Store Local copy of outputs into Module Outputs 14

5.2.6 SnsrOffsLrng_GetHwTqOffs 14

5.2.6.1 Design Rationale 14

5.2.6.2 Store Module Inputs to Local copies 14

5.2.6.3 (Processing of function)……… 14

5.2.6.4 Store Local copy of outputs into Module Outputs 14

5.2.7 SnsrOffsLrng_SetYawRateOffs 15

5.2.7.1 Design Rationale 15

5.2.7.2 Store Module Inputs to Local copies 15

5.2.7.3 (Processing of function)……… 15

5.2.7.4 Store Local copy of outputs into Module Outputs 15

5.2.8 SnsrOffsLrng_GetYawRateOffs 15

5.2.8.1 Design Rationale 15

5.2.8.2 Store Module Inputs to Local copies 15

5.2.8.3 (Processing of function)……… 15

5.2.8.4 Store Local copy of outputs into Module Outputs 15

5.3 Module Internal (Local) Functions 15

5.3.1 Module Internal (Local) Functions 15

6 Known Limitations with Design 19

7 UNIT TEST CONSIDERATION 20

Appendix A Abbreviations and Acronyms 21

Appendix B Glossary 22

Appendix C References 23

Introduction

Refer the Design Subproject.

SnsrOffsLrng & High-Level Description

Refer the Design Subproject.

Design details of software module

Graphical representation of SnsrOffsLrng

Constant Data Dictionary

Program (fixed) Constants

Embedded Constants

Local Constants

Constant NameResolutionUnitsValue
HWTQOFFSHILIM_HWNWTMTR_F32Single precision floatHwNwtMtr4
HWTQOFFSLOLIM_HWNWTMTR_F32Single precision floatHwNwtMtr-4
VEHYAWRATEOFFSHILIM_VEHDEGPERSEC_F32Single precision floatVehDegPerSec20
VEHYAWRATEOFFSLOLIM_VEHDEGPERSEC_F32Single precision floatVehDegPerSec-20
HWAGOFFSHILIM_HWDEG_F32Single precision floatHwDeg-30
HWAGOFFSLOLIM_HWDEG_F32Single precision floatHwDeg-30
MTRXSIZE_CNT_U081Cnt3

Software Component Implementation

Sub-Module Functions

Init: SnsrOffsLrngInit1

Design Rationale

Refer the Design.

Module Outputs

Refer the Design.

Per: SnsrOffsLrngPer1

Design Rationale

Refer the Design.

Store Module Inputs to Local copies

Refer the Design.

(Processing of function)………

Refer the Design.

Store Local copy of outputs into Module Outputs

Refer the Design.

Per: SnsrOffsLrngPer2

Design Rationale

Refer the Design.

Store Module Inputs to Local copies

Refer the Design.

(Processing of function)………

Refer the Design.

Store Local copy of outputs into Module Outputs

Refer the Design.

Server Runables

SnsrOffsLrng_RstHwTq

Design Rationale

Refer the Design.

Store Module Inputs to Local copies

Refer the Design.

(Processing of function)………

Refer the Design.

Store Local copy of outputs into Module Outputs

Refer the Design.

SnsrOffsLrng_RstYawAndAg

Design Rationale

Refer the Design.

Store Module Inputs to Local copies

Refer the Design.

(Processing of function)………

Refer the Design.

Store Local copy of outputs into Module Outputs

Refer the Design.

SnsrOffsLrng_SetHwAgOffs

Design Rationale

Refer the Design.

Store Module Inputs to Local copies

Refer the Design.

(Processing of function)………

Refer the Design.

Store Local copy of outputs into Module Outputs

Refer the Design.

SnsrOffsLrng_GetHwAgOffs

Design Rationale

Refer the Design.

Store Module Inputs to Local copies

Refer the Design.

(Processing of function)………

Refer the Design.

Store Local copy of outputs into Module Outputs

Refer the Design.

SnsrOffsLrng_SetHwTqOffs

Design Rationale

Refer the Design.

Store Module Inputs to Local copies

Refer the Design.

(Processing of function)………

Refer the Design.

Store Local copy of outputs into Module Outputs

Refer the Design.

SnsrOffsLrng_GetHwTqOffs

Design Rationale

Refer the Design.

Store Module Inputs to Local copies

Refer the Design.

(Processing of function)………

Refer the Design.

Store Local copy of outputs into Module Outputs

Refer the Design.

SnsrOffsLrng_SetYawRateOffs

Design Rationale

Refer the Design.

Store Module Inputs to Local copies

Refer the Design.

(Processing of function)………

Refer the Design.

Store Local copy of outputs into Module Outputs

Refer the Design.

SnsrOffsLrng_GetYawRateOffs

Design Rationale

Refer the Design.

Store Module Inputs to Local copies

Refer the Design.

(Processing of function)………

Refer the Design.

Store Local copy of outputs into Module Outputs

Refer the Design.

Module Internal (Local) Functions

Module Internal (Local) Functions

Calculate LearnHwAg
Function NameLearnHwAgTypeMinMaxUTP Tol.
Arguments PassedHwAgLrngLrngCdnVld_Cnt_T_loglBooleanFALSETRUE
HwAgLrngEna_Cnt_T_loglBooleanFALSETRUE
SysTqFild_HwNm_T_f32float32-8.88.8
HandwheelPosition_HwDeg_T_f32float32-14401440
Return ValueNone

Description

No flowchart added. For Unit test FDD should provide the information needed regarding function processing

Calculate SOaCHierarchyManager
Function NameSOaCHierarchyManagerTypeMinMaxUTP Tol.
Arguments Passed*EnableYOC_Cnt_T_loglBooleanFALSETRUE
*HwAgLrngEna_Cnt_T_loglBooleanFALSETRUE
*HwAgLrngRst_Cnt_T_loglBooleanFALSETRUE
Return Value

Description

No flowchart added. For Unit test FDD should provide the information needed regarding function processing

Calculate Perform_TqInpDetn
Function NamePerform_TqInpDetnTypeMinMaxUTP Tol.
Arguments PassedNone
Return Value

Description

No flowchart added. For Unit test FDD should provide the information needed regarding function processing

Calculate EnableLearning
Function NameEnableLearningTypeMinMaxUTP Tol.
Arguments Passed
Return ValueHwTqLrngEna_Cnt_T_loglBooleanFALSETRUE

Description

No flowchart added. For Unit test FDD should provide the information needed regarding function processing

Calculate CalculateKVector
Function Name
CalculateKVector
TypeMinMaxUTP Tol.
Arguments PassedTqMdlXAry_HwRadpS_T_f32[3]float32-4242
KVect_Uls_T_f32[3]float32-4242
Return Value

Description

No flowchart added. For Unit test FDD should provide the information needed regarding function processing

Calculate EnablePreProcessing
Function NameEnablePreProcessingTypeMinMaxUTP Tol.
Arguments PassedHwTqPreproc_dB_T_f32float32-10030
SampleCntrLim_Cnt_T_u16Uint16165535
TqInpPrsntVld_Cnt_T_loglBooleanFALSETRUE
TqInpPrsnt_Cnt_T_loglBooleanFALSETRUE
Return Value

Description

No flowchart added. For Unit test FDD should provide the information needed regarding function processing

Calculate UpdateCovarianceMatrix
Function NameUpdateCovarianceMatrixTypeMinMaxUTP Tol.
Arguments PassedTqMdlXAry_HwRadpS_T_f32[3]float32-4242
KVect_Uls_T_f32[3]float32-4242
Return Value

Description

No flowchart added. For Unit test FDD should provide the information needed regarding function processing

TblSize_Cnt_T_u16 is size of the single dimension of TqMdlAryKVect_Uls_T_f32.

Calculate UpdateHwTqOffs
Function NameUpdateHwTqOffsTypeMinMaxUTP Tol.
Arguments PassedHwTqEstimnVld_Cnt_T_loglbooleanFALSETRUE
HwTqDriftEstimnOnCentr_HwNm_T_f32float32-1010
Return ValueNone

Description

No flowchart added. For Unit test FDD should provide the information needed regarding function processing

Calculate UpdateSampleCnt
Function NameUpdateSampleCntTypeMinMaxUTP Tol.
Arguments PassedHwAgMeasd_HwDeg_T_f32float32-14401440
Return ValueNone

Description

No flowchart added. For Unit test FDD should provide the information needed regarding function processing

Known Limitations with Design

The service SetRamblockStatus is used instead Per Instance memory “SetRamBlkSts “ as there is no concept of transition function in EA4. So SetRamblockStatus() is called and set to true whenever SetRamBlkSts PIM is made as True.

UNIT TEST CONSIDERATION

None

Abbreviations and Acronyms

Abbreviation or AcronymDescription

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 GuidelineEA4 01.00.01
3Software Naming Conventions.doc1.0
4Software Design and Coding Standards.doc2.0
5SF051A_SnsrOffsLrng_DesignSee the synergy sub-project version included.
Last modified October 12, 2025: Initial commit (1fadfc4)