GateDrv1Ctrl_MDD
Module Design Document
For
Gate Drive 1 Control
VERSION: 1
DATE: 13-July-2016
Prepared By:
Software Group,
Nexteer Automotive,
Saginaw, MI, USA
Location: The official version of this document is stored in the Nexteer Configuration Management System.
Revision History
| Version | Description | Author | Date |
| 1 | Initial version | Rijvi Ahmed | 13-July-2016 |
Table of Contents
3 GATEDRV1CTRL & High-Level Description 7
4 Design details of software module 8
4.1 Graphical representation of GATEDRV1CTRL 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.2 Initialization Functions 11
7.2.1 Per: GateDrv1CtrlInit1 11
7.3.1 Per: GateDrv1CtrlPer1 11
7.3.1.2 Processing of Function 11
7.3.2 Per: GateDrv1CtrlPer2 11
7.3.2.2 Processing of Function 11
7.5 Serial Communication Functions 11
7.6 Local Function/Macro Definitions 11
7.7 GLObAL Function/Macro Definitions 13
8 Known Limitations With Design 14
Abbrevations And Acronyms
| Abbreviation | Description |
| DFD | Design functional diagram |
| MDD | Module design Document |
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 04.02.01 |
| 2 | Software Naming Conventions | Process 04.02.01 |
| 3 | Software Coding Standards | Process 04.02.01 |
| 4 | FDD – ES312A GateDrv1Ctrl | See synergy sub project version |
GATEDRV1CTRL & High-Level Description
This module configures the GateDrive1 connected with SPI channel CSIH0. It also does the diagnostics for GateDrive1 using SPI interface.
Design details of software module
Graphical representation of GATEDRV1CTRL
Variable Data Dictionary
User defined typedef definition/declaration
| Typedef Name | Element Name | User Defined Type | Legal Range (min) | Legal Range (max) |
| None |
Variable definition for enumerated types
| Enum Name | Element Name | Value |
| None |
Constant Data Dictionary
Program(fixed) Constants
Embedded Constants
Local
| Constant Name | Resolution | Units | Value |
Global
| Constant Name |
| Refer to the FDD |
Module specific Lookup Tables Constants
| Constant Name | Resolution | Value | Software Segment |
| Refer to the design |
Software Module Implementation
Sub-Module Functions
None
Initialization Functions
Per: GateDrv1CtrlInit1
PERIODIC FUNCTIONS
Per: GateDrv1CtrlPer1
Design Rationale
None
Processing of Function
See design model for details.
Per: GateDrv1CtrlPer2
Design Rationale
None
Processing of Function
See design model for details.
Interrupt Functions
None
Serial Communication Functions
None
Local Function/Macro Definitions
Local Function #1
| Function Name | SpiAsyncTx | Type | Min | Max |
| Arguments Passed | Channel_Cnt_T_u08 | Spi_ChannelType | 0 | Full |
| TxData_Cnt_T_u16 | Spi_DataType | 0 | Full | |
| Sequence_Cnt_T_u08 | Spi_SequenceType | 0 | Full | |
| Return Value | None |
Description
(void) Spi_WriteIB( Channel_Cnt_T_u08, &TxData_Cnt_T_u16 );
(void) Call_Spi_AsyncTransmit( Sequence_Cnt_T_u08 );
Local Function #2
| Function Name | OffStVrfySt | Type | Min | Max |
| Arguments Passed | None | |||
| Return Value | None |
Description
See GateDrv1Ctrl/GateDrv1CtrlPer2/Gate Drive Enable/Gate Drive State/OffState Verification Stateblock in design model.
Local Function #3
| Function Name | OffStVrfyData | Type | Min | Max |
| Arguments Passed | None | |||
| Return Value | Flt_Cnt_T_logl | Boolean | FALSE | TRUE |
Description
See GateDrv1Ctrl/GateDrv1CtrlPer2/Gate Drive Enable/Gate Drive State/OffState Verification State/OffSt Verification Chk and Transition to Config State/OffStChk Incomplete/Offstate Verification /OffState Verification Check block in design model.
*It is optimized in the implementation to reduce the high static path count.
Local Function #4
| Function Name | CfgSt | Type | Min | Max |
| Arguments Passed | None | |||
| Return Value | None |
Description
See GateDrv1Ctrl/GateDrv1CtrlPer2/Gate Drive Enable/Gate Drive State/Configuration State block in design model.
Local Function #5
| Function Name | ReadBackRegs | Type | Min | Max |
| Arguments Passed | None | |||
| Return Value | None |
Description
See GateDrv1Ctrl/GateDrv1CtrlPer2/Gate Drive Enable/Gate Drive State/Configuration State/Read back Registers block in design model.
Local Function #6
| Function Name | OperFltMonrSt | Type | Min | Max |
| Arguments Passed | None | |||
| Return Value | None |
Description
See GateDrv1Ctrl/GateDrv1CtrlPer2/Gate Drive Enable/Gate Drive State/Operate Fault Monitor State block in design model.
Local Function #7
| Function Name | GateDrvDetermineOnStSngFETFlt | Type | Min | Max |
| Arguments Passed | None | |||
| Return Value | GenGateDrvFlt_Cnt_T_logl | Boolean | FALSE | TRUE |
Description
See GateDrv1Ctrl/GateDrv1CtrlPer2/Gate Drive Enable/Gate Drive State/Operate Fault Monitor State/Determine Faults/Status Register indicates Fault/Determine OnState Single FET Fault block in design model.
Local Function #8
| Function Name | GateDrvDetermineVltgFlt | Type | Min | Max |
| Arguments Passed | None | |||
| Return Value | GenGateDrvFlt_Cnt_T_logl | Boolean | FALSE | TRUE |
Description
See GateDrv1Ctrl/GateDrv1CtrlPer2/Gate Drive Enable/Gate Drive State/Operate Fault Monitor State/Determine Faults/Status Register indicates Fault/Determine VREG/Bootstrap Voltage Fault block in design model.
Local Function #9
| Function Name | GateDrvDetermineGenericFlt | Type | Min | Max |
| Arguments Passed | None | |||
| Return Value | GenGateDrvFlt_Cnt_T_logl | Boolean | FALSE | TRUE |
Description
See GateDrv1Ctrl/GateDrv1CtrlPer2/Gate Drive Enable/Gate Drive State/Operate Fault Monitor State/Determine Faults/Status Register indicates Fault/Determine Generic Gate Drive Fault block in design model.
GLObAL Function/Macro Definitions
None
Known Limitations With Design
“Operate Fault Monitor State” block need to be revisited and optimized.
UNIT TEST CONSIDERATION
None