This is the multi-page printable view of this section. Click here to print.
Component Implementation
1 - Uart0CfgAndUse_IntegrationManual
Integration Manual
For
Uart0CfgAndUse
VERSION: 1.0
DATE: 08-June-2017
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
| Sl. No. | Description | Author | Version | Date |
| 1 | Initial version | Krzysztof Byrski | 1.0 | 08-June-2017 |
Table of Contents
3.2 Global Functions(Non RTE) to be provided to Integration Project 6
4 Configuration REQUIREMeNTS 7
4.2 Configuration Files to be provided by Integration Project 7
4.3 Da Vinci Parameter Configuration Changes 7
4.4 DaVinci Interrupt Configuration Changes 7
4.5 Manual Configuration Changes 7
5 Integration DATAFLOW REQUIREMENTS 8
5.1 Required Global Data Inputs 8
5.2 Required Global Data Outputs 8
5.3 Specific Include Path present 8
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 | EA4 Software Naming Conventions | 01.01.00 |
| 2 | Software Design and Coding Standards | 2.1 |
| 3 | CM760A_Uart0CfgAndUse_Design | See Synergy Sub Project Version |
Dependencies
SWCs
| Module | Required Feature |
| AR350A ImcArbn | All the IMC signal group definitions |
Note : Referencing the external components should be avoided in most cases. Only in unavoidable circumstance external components should be referred. Developer should track the references.
Global Functions(Non RTE) to be provided to Integration Project
Uart0CfgAndUseInin - To be defined as a trusted function as the DTS Channel master registers need to be configured in the supervisor mode.
Configuration REQUIREMeNTS
Build Time Config
| Modules | Notes | |
| IMCARBN_NROF2MILLISECRATEGROUP_CNT_U08 | Takes unsigned value | |
| IMCARBN_NROF10MILLISECRATEGROUP_CNT_U08 | Takes unsigned value | |
| IMCARBN_NROF100MILLISECRATEGROUP_CNT_U08 | Takes unsigned value |
Configuration Files to be provided by Integration Project
None
Da Vinci Parameter Configuration Changes
| Parameter | Notes | SWC |
| None |
DaVinci Interrupt Configuration Changes
| ISR Name | VIM # | Priority Dependency | Notes |
| None |
Manual Configuration Changes
| Constant | Notes | SWC |
| None |
EXCLUSIVE AREAS
| Exclusive Area | Notes | SWC |
| ExclsvAr1Uart0DrvrTxRxBuf | Exclusive area needs to protect access to Transmit and Receive buffers from asynchronous updates by server runnables and periodic updates by tasks. Integrator needs to verify if client calls to server runnables can interrupt periodics and set up exclusive area to properly protect access. If exclusive area is needed, at minimum it must disable OS Task scheduling (It is assumed that all clients call occurs in OS Tasks). |
Integration DATAFLOW REQUIREMENTS
Required Global Data Inputs
None
Required Global Data Outputs
None
Specific Include Path present
Yes
Runnable Scheduling
This section specifies the required runnable scheduling.
| Init | Scheduling Requirements | Trigger |
| Uart0CfgAndUseInit1 | None | RTE(Init) |
| Runnable | Scheduling Requirements | Trigger |
| Uart0CfgAndUsePer1 | None | RTE(2ms) |
| Uart0CfgAndUsePer2 | None | RTE(2ms) |
| Uart0CfgAndUsePer3 | None | RTE(10ms) |
| Uart0CfgAndUsePer4 | None | RTE(100ms) |
.
Memory Map REQUIREMENTS
Mapping
| Memory Section | Contents | Notes |
| CDD_Uart0CfgAndUse_START_SEC_CODE | Functions | |
| CDD_Uart0CfgAndUse_START_SEC_VAR_INIT_128 | Tx Buffer | |
| CDD_Uart0CfgAndUse_DmaWrite_START_SEC_VAR_INIT_128 | Rx Buffer |
* Each …START_SEC… constant is terminated by a …STOP_SEC… constant as specified in the AUTOSAR Memory Mapping requirements.
Usage
| Feature | RAM | ROM |
| None |
Table 1: ARM Cortex R4 Memory Usage
NvM Blocks
None
Compiler Settings
Preprocessor MACRO
None
Optimization Settings
None
Appendix
Header file “CDD_Uart0CfgAndUse.h” shall be included inside Rte_UserTypes.h which will provide typedef Ary1D_u8_2048_Uart0CfgAndUse.
2 - Uart0CfgAndUse_MDD
Module Design Document
For
Uart0CfgAndUse
Jan 11, 2018
Prepared For:
Software Engineering
Nexteer Automotive,
Saginaw, MI, USA
Prepared By:
Software Group,
Nexteer Automotive,
Saginaw, MI, USA
Change History
| Description | Author | Version | Date |
| Initial Version | Krzysztof Byrski | 1 | 08-June-2017 |
| Updated the local functions and constants | Avinash James | 2 | 11-Jan-2018 |
Table of Contents1 Introduction 4
1.1 Purpose 4
1.2 Scope 4
2 Uart0CfgAndUse & High-Level Description 5
3 Design details of software module 6
3.1 Graphical representation of Uart0CfgAndUse 6
3.2 Data Flow Diagram 6
3.2.1 Component level DFD 6
3.2.2 Function level DFD 6
4 Constant Data Dictionary 7
4.1 Program (fixed) Constants 7
4.1.1 Embedded Constants 7
5 Software Component Implementation 8
5.1 Sub-Module Functions 8
5.1.1 Init: Uart0CfgAndUseInit1 8
5.1.2 Per: Uart0CfgAndUsePer1 8
5.1.3 Per: Uart0CfgAndUsePer2 8
5.1.4 Per: Uart0CfgAndUsePer3 8
5.1.5 Per: Uart0CfgAndUsePer4 9
5.2 Server Runables 9
5.3 Interrupt Functions 9
5.4 Module Internal (Local) Functions 9
5.4.1 RollOverAdd 9
5.4.2 UpdDtsTxReg 10
5.4.3 UpdDtsRxReg 10
5.5 GLOBAL Function/Macro Definitions 10
6 Known Limitations with Design 11
7 UNIT TEST CONSIDERATION 12
Appendix A Abbreviations and Acronyms 13
Appendix B Glossary 14
Appendix C References 15
Introduction
Purpose
Module Design Document for CM760A_Uart0CfgAndUse.
Scope
The following definitions are used throughout this document:
Shall: indicates a mandatory requirement without exception in compliance.
Should: indicates a mandatory requirement; exceptions allowed only with documented justification.
May: indicates an optional action.
Uart0CfgAndUse & High-Level Description
Refer FDD.
Design details of software module
Graphical representation of Uart0CfgAndUse

Data Flow Diagram
Refer FDD
Component level DFD
None
Function level DFD
None
Constant Data Dictionary
Program (fixed) Constants
Embedded Constants
Local Constants
| Constant Name | Resolution | Units | Value |
|---|---|---|---|
| ROLLGCNTCHK_CNT_U08 | 1 | Cnt | 255 |
| DATABYTE0_CNT_U08 | 1 | Cnt | 0 |
| DATABYTE1_CNT_U08 | 1 | Cnt | 1 |
| DATABYTE2_CNT_U08 | 1 | Cnt | 2 |
| DATABYTE3_CNT_U08 | 1 | Cnt | 3 |
| DATABYTE4_CNT_U08 | 1 | Cnt | 4 |
| DATABYTE5_CNT_U08 | 1 | Cnt | 5 |
| DATABYTE6_CNT_U08 | 1 | Cnt | 6 |
| DATABYTE7_CNT_U08 | 1 | Cnt | 7 |
| DATABYTE8_CNT_U08 | 1 | Cnt | 8 |
| MASKLOWR16BITOFUINT32_CNT_U16 | 1 | Cnt | 65535 |
| MAXSIGGROUPFORTX_CNT_U08 | 1 | Cnt | 9 |
| TWO_CNT_U08 | 1 | Cnt | 2 |
| UART0RXMAXBUFSIZE_CNT_U08 | 1 | Cnt | 144 |
| UART0TXBUFSIZE_CNT_U08 | 1 | Cnt | 80 |
| RLN30LBRP01BRP_CNT_U08 | 1 | Cnt | 4 |
| DTS101CM_CNT_U32 | 1 | Cnt | 0x20120000 |
| DTS100CM_CNT_U32 | 1 | Cnt | 0x200E0000 |
| DTTCT101_CNT_U32 | 1 | Cnt | 256 |
| DTTC100_CNT_U32 | 1 | Cnt | 9438624 |
| DTTCT100_CNT_U32 | 1 | Cnt | 6720 |
| DTRTC100_CNT_U32 | 1 | Cnt | 9438624 |
Software Component Implementation
Sub-Module Functions
The sub-module functions are grouped based on similar functionality that needs to be executed in a given “State” of the system (refer States and Modes). For a given module, the MDD will identify the type and number of sub-modules required. The sub-module types are described below.
Init: Init1
Design Rationale
Refer FDD
Module Outputs
Refer FDD
Per: Per1
Design Rationale
Refer FDD
Store Module Inputs to Local copies
Refer FDD
(Processing of function)………
Refer FDD
Store Local copy of outputs into Module Outputs
Refer FDD
Per: Per2
Design Rationale
Refer FDD
Store Module Inputs to Local copies
Refer FDD
(Processing of function)………
Refer FDD
Store Local copy of outputs into Module Outputs
Refer FDD
Per: Per3
Design Rationale
Refer FDD
Store Module Inputs to Local copies
Refer FDD
(Processing of function)………
Refer FDD
Store Local copy of outputs into Module Outputs
Refer FDD
Per: Per4
Design Rationale
Refer FDD
Store Module Inputs to Local copies
Refer FDD
(Processing of function)………
Refer FDD
Store Local copy of outputs into Module Outputs
Refer FDD
Server Runables
None
Interrupt Functions
None
Module Internal (Local) Functions
RollOverAdd
| Function Name | RollOverAdd | Type | Min | Max |
| Arguments Passed | Input1_Cnt_T_u08 | uint8 | 0 | 255 |
| Input2_Cnt_T_u08 | uint8 | 0 | 255 | |
| Return Value | Output_Cnt_T_u08 | uint8 | 0 | 143 |
Design Rationale
Refer FDD
Processing
Refer FDD
UpdDtsTxReg
| Function Name | UpdDtsTxReg | Type | Min | Max |
| Arguments Passed | Uart0GlbTx_Cnt_T_u08 | uint8 | 0 | 72 |
| Return Value | None | - | - | - |
Design Rationale
Refer FDD
Processing
Refer FDD
Uart1Diagc
| Function Name | Uart1Diagc | Type | Min | Max |
| Arguments Passed | Uart1RxDataCntr | uint8 | 0 | 255 |
| Return Value | None | - | - | - |
Design Rationale
Refer Uart1RxDataCntr block in FDD
Processing
Refer FDD
GLOBAL Function/Macro Definitions
None
Known Limitations with Design
The client call SetRxSigGroup has one argument Buf which is listed as Output in the design but implemented correctly as Input. This is an update to AR350A and is not done as of today.
The component makes use of static component level variables which are needed for the special DMA mapping .
UNIT TEST CONSIDERATION
Code prover flags out of bound array access as it considers range of the index variable outside the array bounds. But this has been functionally checked to be within the limits.
Abbreviations and Acronyms
| Abbreviation or Acronym | Description |
|---|---|
| - | - |
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
| Term | Definition | Source |
|---|---|---|
| MDD | Module Design Document | |
| DFD | Data Flow Diagram |
References
| Ref. # | Title | Version |
|---|---|---|
| 1 | AUTOSAR Specification of Memory Mapping (Link:AUTOSAR_SWS_MemoryMapping.pdf) | v1.3.0 R4.0 Rev 2 |
| 2 | MDD Guideline | EA4 01.00.01 |
| 3 | Software Naming Conventions | 01.01.00 |
| 4 | Software Design and Coding Standards | 2.1 |
| 5 | CM760A_Uart0CfgAndUse_Design | See Synergy Sub Project Version |
3 - Uart0CfgAndUse_PeerReviewChecklist
Overview
Summary SheetDavinci Files
CDD_Uart0CfgAndUse.c
PolySpace