StOutpCtrl_MDD
Module Design Document
For
StOutpCtrl
VERSION: 2.
DATE: 29-Mar-2016
Prepared By:
Akilan Rathakrishnan
Location: The official version of this document is stored in the Nexteer Configuration Management System.
Revision History
Sl. No. | Description | Author | Version | Date |
1 | Initial Version | Akilan Rathakrishnan | 1.0 | 02-June-2015 |
2 | Implementation of input name change | Basavaraja Ganeshappa | 2.0 | 30-June-2016 |
Table of Contents
3 StOutpCtrl - High-Level Description 7
4 Design details of software module 8
4.1 Graphical representation of StOutpCtrl 8
5.1 User defined typedef definition/declaration 9
5.2 Variable definition for enumerated types 9
6.1 Program(fixed) Constants 10
6.1.2 Module specific Lookup Tables Constants 10
7 Software Module Implementation 11
7.1.1 Initialization Functions 11
7.1.1.1 INIT: StOutpCtrlInit1 11
7.1.1.3 Store Module Inputs to Local copies 11
7.1.1.4 (Processing of function)……… 11
7.1.1.5 Store Local copy of outputs into Module Outputs 11
7.1.2.1 Per: StOutpCtrlPer1 11
7.1.2.3 Store Module Inputs to Local copies 11
7.1.2.4 (Processing of function)……… 11
7.1.2.5 Store Local copy of outputs into Module Outputs 11
7.3 Serial Communication Functions 11
7.4 Local Function/Macro Definitions 12
7.4.1 Local Function #1: RateLimit 12
7.4.2 Local Function #1: RateSource 12
7.5 GLObAL Function/Macro Definitions 12
8 Known Limitations With Design 14
Abbrevations And Acronyms
Abbreviation | Description |
DFD | Design functional diagram |
MDD | Module design Document |
<ADD more to the table if applicable> | |
References
This section lists the title & version of all the documents that are referred for development of this document
Sr. No. | Title | Version |
<1> | <MDD Guidelines> | Process 4.02.01 |
<2> | <Software Naming Conventions> | Process 4.02.01 |
<3> | <Coding standards> | Process 4.02.01 |
<4> | <FDD SF005A_StOutpCtrl_Design> | See Synergy Subproject version |
<Add if more available> |
StOutpCtrl - High-Level Description
Refer FDD
Design details of software module
Graphical representation of StOutpCtrl
Data Flow Diagram
N/A
Module level DFD
N/A
Sub-Module level DFD
N/A
COMPONENT FLOW DIAGRAM
N/A
Variable Data Dictionary
User defined typedef definition/declaration
<This section documents any user types uniquely used for the module.>
Typedef Name | Element Name | User Defined Type | Legal Range (min) | Legal Range (max) |
N/A | ||||
Variable definition for enumerated types
Enum Name | Element Name | Value |
N/A |
Constant Data Dictionary
Program(fixed) Constants
Embedded Constants
< All program specific constants will be defined in detail >
Local
Constant Name | Resolution | Units | Value |
N/A |
Global
<This section lists the global constants used by the module. For details on global constants, refer to the Data Dictionary for the application>
Constant Name |
N/A |
Module specific Lookup Tables Constants
<(This is for lookup tables (arrays) with fixed values, same name as other tables)>
Constant Name | Resolution | Value | Software Segment |
<Refer Constant name qualified in [2]> | <Refer MDD guidelines [1]> | <Refer MDD guidelines [1]> | <Refer MDD guidelines [1]> |
Software Module Implementation
Sub-Module Functions
None
Initialization Functions
INIT: StOutpCtrlInit1
Design Rationale
None
Store Module Inputs to Local copies
Refer to FDD
(Processing of function)………
Refer to FDD
Store Local copy of outputs into Module Outputs
Refer to FDD
PERIODIC FUNCTIONS
(Note: For multiple periodic functions, insert new headers at the “Header 2” level – subset of “7.1.2 Periodic Functions” and follow the same sub-section design shown below). If none required, place the text “None”)>
Per: StOutpCtrlPer1
Design Rationale
None
Store Module Inputs to Local copies
Refer to FDD
(Processing of function)………
Refer to FDD
Store Local copy of outputs into Module Outputs
Refer to FDD
Interrupt Functions
None
Serial Communication Functions
None
Local Function/Macro Definitions
<If these are numerous and defined in a separate source file then reference the source file only.>
Local Function #1: RateLimit
Function Name | RateLimit | Type | Min | Max |
Arguments Passed | SysOperRampRate_UlspS_T_f32 | float32 | 0.1 | 500.0 |
LoaRateLim_UlspS_T_f32 | float32 | 0.1 | 500.0 | |
VehStrtStopRampRate_UlspS_T_f32 | float32 | 0.1 | 500.0 | |
Return Value | SelRampRate_UlspS_T_f32 | float32 | 0.1 | 500.0 |
Description
Implements "Rate Limit" model block in FDD -- selects ramp rate from input rate limits.
Design Rationale
FDD does not show a default case on the switch/case block in this function because none is required – all possible values of the switch variable (which is internal to this component) are covered by the cases shown. However a default clause is required by MISRA Rule 15.3. Therefore the default label was placed with the final case label in the code; this is functionally equivalent to the FDD and satisfies the MISRA rule.
Local Function #1: RateSource
Function Name | RateSource | Type | Min | Max |
Arguments Passed | SysOperMotTqCmdSca_Uls_T_f32 | float32 | 0.0 | 1.0 |
LoaSca_Uls_T_f32 | float32 | 0.0 | 1.0 | |
VehStrtStopMotTqCmdSca_Uls_T_f32 | float32 | 0.0 | 1.0 | |
SelectedState_Cnt_T_u08 | uint8 | 1 | 3 | |
Return Value | SelectedTqCmdSca_Uls_T_f32 | float32 | 0.0 | 1.0 |
Description
Implements "Rate Source" model block in FDD -- selects scale factor from input rate scales.
Design Rationale
FDD does not show a default case on the switch/case block in this function because none is required – all possible values of the switch variable (which is internal to this component) are covered by the cases shown. However a default clause is required by MISRA Rule 15.3. Therefore the default label was placed with the final case label in the code; this is functionally equivalent to the FDD and satisfies the MISRA rule.
GLObAL Function/Macro Definitions
GLObAL Function #1
Function Name | (Exact name used) | Type | Min | Max |
Arguments Passed | None | <Refer MDD guidelines[1]> | <Refer MDD guidelines[1]> | <Refer MDD guidelines[1]> |
Return Value | N/A |
Description
N/A
TRANSIENT FUNCTIONS
None
Known Limitations With Design
None
UNIT TEST CONSIDERATION
None
Appendix
None