Serial_Communication_Output_MDD

Module – Serial Communications Output

High-Level Description

The Serial Communications Output module provides a signal level interface between the EPS application layer and the serial communications software. Provide for the network management functionality for the serial communications interface. This module will be customized for each distinct vehicle platform. This module will be responsible for converting the range and resolution of the Application Layer variables to the range and resolution of the associated serial communications signals.

This module processes the data for transmit signals that are sent from the EPS controller to other ECUs on the communication bus. Global application input data is scaled appropriately and then transferred to the serial communications Interaction Layer using function calls or macros provided. Similarly, the Serial Communications Input module, takes the signal data that is received from the Interaction Layer, scales the data as required by the EPS controller and transfers the updated global data to the EPS application software.

Figures

Component Diagram

This diagram shows all data that is shared between functions within the module.

Variable Data Dictionary

For details on module input / output variable, refer to the Data Dictionary for the application. Input / output variable names are listed here for reference.

(Note: Full variable names required in table.)

Module Internal Variables

This section identifies the name, range and resolutions for module specific data created by this module. If there are no range restrictions on the variable, the term “FULL” is placed into the table for legal range.

User defined typedef definition/declaration

This section documents any user types uniquely used for the module.

Constant Data Dictionary

Calibration Constants

This section lists the calibrations used by the module. For details on calibration constants, refer to the Data Dictionary for the application.

Program(fixed) Constants

Embedded Constants

All embedded constants whose values are provided in Eng units will be evaluated to the equivalent counts by using the FPM_InitFixedPoint_m() macro within the #define statement.

Local

Global

This section lists the global constants used by the module. For details on global constants, refer to the Data Dictionary for the application.

Module specific Lookup Tables Constants

(This is for lookup tables (arrays) with fixed values, same name as other tables)

Functions/Macros used by the Sub-Modules

Library Functions / Macros

The library functions / Macros that are called by the various sub modules are identified below,

1. None

Data Hiding Functions

The data hiding functions / macros used in this module are identified below,

Local Functions/Macros Used by this MDD only

(Note if they are defined in another source file, then reference the appropriate header file)

The local functions/macros in this module are identified below,

1. CalcCRC_EPS_1( void)

2. DetermineWarnDisp(void)

3. ScaleSignal_u16( float32 Signal_Uls_T_f32, float32 LoLmt_Uls_T_f32, float32 HiLmt_Uls_T_f32, float32 Scale_Uls_T_f32, Offset_Uls_T_f32)

4. SrlComOutput_WriteBits(uint32 Data_T_Cnt_u32, uint8* Buffer_T_Cnt_u08, uint16 StartBit_Cnt_T_u16, uint16 EndBit_Cnt_T_u16)

Software Module Implementation

Initialization Functions

Init: SrlComOutput_Init1

Design Rationale

Module Outputs

Module Internal

Set Default Messages

EPSA1_T_str.s.unused0 = 0x00

SetValueTxEPS_AsstStat(EPSA1_T_str, 0x01)

SetValueTxEPS_Warn_Disp_Rq(EPSA1_T_str, 0x00)

EPSA1_T_str.s.unused1 = 0x00

EPSA1_T_str.s.unused2 = 0x00

SetValueTxEPS_Curr(EPSA1_T_str, 0xFF)

EPSA1_T_str.s.unused3 = 0x00

EPSA1_T_str.s.unused4 = 0x00

EPSA1_T_str.s.unused5 = 0x00

EPSA1_T_str.s.unused6 = 0x00

dbkPutTxEPS_A1_PKT(EPSA1_T_str)

CclEnableCommunication()

DpmExternalRequest(DPM_EPS)

SetValueTxWakeupRsn_EPS(WakeupEPS_T_str, D_NMWAKEUPREASONIGN_CNT_U08)

SetValueTxWakeupCnt(WakeupEPS_T_str, 0x00)

WakeupEPS_T_str.s.unused0 = 0x00

nmpduPutWakeup_EPS(WakeupEPS_T_str)

SetValueTxTOI_Act_Sts(EPS1_M_str, 0x00)

SetValueTxStrClmTrqVD(EPS1_M_str, 0x00)

SetValueTxStrClmTrq(EPS1_M_str, 0x07FF)

SetValueTxAssistanceTorque(EPS1_M_str, 0x00)

SetValueTxPTSDriveStyleSts(EPS1_M_str, 0x00)

SetValueTxDSTTorqueOverlayFault(EPS1_M_str, 0x00)

SetValueTxHALFTorqueOverlayFault(EPS1_M_str, 0x00)

SetValueTxHALFTorqueOverlayIntActivated(EPS1_M_str, 0x00)

SetValueTxEPSMotorTorque(EPS1_M_str, 0x00)

SetValueTxEPSMotorTorqueValidData(EPS1_M_str, 0x00)

SetValueTxEPSHandsOnRecognition(EPS1_M_str, 0x00)

SetValueTxEPSTemporaryDeactivationLDW(EPS1_M_str, 0x00)

SetValueTxPTSTorqueOverlayFault(EPS1_M_str, 0x00)

SetValueTxPTSTorqueOverlayIntActivated(EPS1_M_str, 0x00)

SetValueTxMC_EPS_1(EPS1_M_str, MCEPS1_Cnt_M_u08)

CalcCRC_EPS_1()

dbkPutTxEPS_1_PKT(EPS1_M_str)

Rte_Call_SystemTime_GetSystemTime_mS_u32(&NMFirstMsg_mS_M_u32)

Periodic Functions

Per: SrlComOutput_Per1

Design Rationale

Process and update Transmit signal data.

Program Flow Start

N/A

Store Module Inputs to Local copies

Rte_Read_ATermActive_Cnt_lgc(&ATermActive_Cnt_T_lgc)

Rte_Read_EngRPM_Cnt_u16(&EngRPM_Cnt_T_u16)

Rte_Read_VehicleSpeed_Kph_f32(&VehSpd_Kph_T_f32)

Rte_Read_SrlComVehSpdValid_Cnt_lgc(&VehSpdValid_Cnt_T_lgc)

Rte_Read_RampDwnStatusComplete_Cnt_lgc(&RampStatusComplete_T_Cnt_lgc)

Rte_Read_Ap_SrlComOutput_CanMsgReceived_Cnt_lgc(&CanMsgReceived_Cnt_T_lgc)

Rte_Read_Ap_SrlComOutput_OutputRampMult_Uls_f32(&OutputRampMult_Uls_T_f32)

Description

Store Local copy of outputs into Module Outputs

See section above.

Program Flow End

N/A

Fault Recovery Functions

None

Shutdown Functions

None

Interrupt Functions

None

Serial Communication Functions

None

Transition Functions

SrlComOutput_

Design Rationale

Program Flow Start

N/A

Store Module Inputs to Local copies

*See below

Description

Store Local copy of outputs into Module Outputs

See section above.

Program Flow End

N/A

Local Function/Macro Definitions

If these are numerous and defined in a separate source file then reference the source file only.

CalcCRC_EPS_1

Description

DetermineWarnDisp

Description

ScaleSignal_u16

Description

EPS1_PKTConfirmation

Description

ApplCclComStart

Description

SrlComOutput_WriteBits

Description

Execution Requirements

Execution Sequence of the Module

(Describe in words relevant details about the execution sequence of the different sub modules.)

Execution Rates for sub-modules called by the Scheduler

This table serves as reference for the Scheduler design

Execution Requirements for Serial Communication Functions

Memory Map Definition Requirements

Sub Modules (Functions)

This table identifies the software segments for functions identified in this module.

Local Functions

This table identifies the software segments for local functions identified in this module.

Known Issues / Limitations With Design

1. INLINE functions defined in “GlobalMacro.h” are not unit tested

Revision Control Log