This is the multi-page printable view of this section. Click here to print.
Adc Driver
1 - Adc2_MDD
Module – ADC2
High-Level Description
The ADC2 module shall control sampling and conversion of voltages from the hardware layer into digital signals.
Figures
Component Diagram
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.
| Module Inputs | Module Outputs |
|---|---|
| None | None |
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.
| Variable Name | Resolution | Legal Range (min) | Legal Range (max) | Software Segment |
|---|---|---|---|---|
| None |
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) |
|---|---|---|---|---|
| See Adc_MDD.doc for Adc subsystem types |
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.
| Constant Name |
|---|
| None |
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
| Constant Name | Resolution | Units | Value |
|---|---|---|---|
| D_GROUPEV_CNT_U8 | 1 | Counts | 0 |
| D_GROUP1_CNT_U8 | 1 | Counts | 1 |
| D_GROUP2_CNT_U8 | 1 | Counts | 2 |
| D_NTCPARMBIT1_CNT_U8 | 1 | Counts | 2 |
| D_ADC2EVTBUFSZ_CNT_U08 | 1 | Counts | Generated in Adc_Cfg.h |
| D_ADC2G1BUFSZ_CNT_U08 | 1 | Counts | Generated in Adc_Cfg.h |
| D_ADC2G2BUFSZ_CNT_U08 | 1 | Counts | Generated in Adc_Cfg.h |
| D_ADC2EVSRC_CNT_U32 | 1 | Counts | Generated in Adc_Cfg.h |
| D_ADC2G1SRC_CNT_U32 | 1 | Counts | Generated in Adc_Cfg.h |
| D_ADC2G2SRC_CNT_U32 | 1 | Counts | Generated in Adc_Cfg.h |
| D_ADC2NUMEVTCH_CNT_U08 | 1 | Counts | Generated in Adc_Cfg.h |
| D_ADC2EVTCH_CNT_U32 | 1 | Counts | Generated in Adc_Cfg.h |
| D_ADC2NUMG1CH_CNT_U08 | 1 | Counts | Generated in Adc_Cfg.h |
| D_ADC2G1CH_CNT_U32 | 1 | Counts | Generated in Adc_Cfg.h |
| D_ADC2NUMG2CH_CNT_U08 | 1 | Counts | Generated in Adc_Cfg.h |
| D_ADC2G2CH_CNT_U32 | 1 | Counts | Generated in Adc_Cfg.h |
| D_ADC2RSLTBASEADR_CNT_U32 | 1 | Counts | Generated in Adc_Cfg.h |
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 |
|---|
| None |
Module specific Lookup Tables Constants
| Constant Name | Resolution | Value | Software Segment |
|---|---|---|---|
| T_Adc2GroupConfigData_Cnt_Str[3] | Adc_GroupConfigDataType | { D_ADC2NUMEVTCH_CNT_U08, D_ADC2EVTCH_CNT_U32, &(((uint32*)D_ADC2RSLTBASEADR_CNT_U32)[0]), }, { D_ADC2NUMG1CH_CNT_U08, D_ADC2G1CH_CNT_U32, &(((uint32*)D_ADC2RSLTBASEADR_CNT_U32)[D_ADC2EVTBUFSZ_CNT_U08]), }, { D_ADC2NUMG2CH_CNT_U08, D_ADC2G2CH_CNT_U32, &(((uint32*)D_ADC2RSLTBASEADR_CNT_U32)[D_ADC2EVTBUFSZ_CNT_U08 + D_ADC2G1BUFSZ_CNT_U08]), } | CONST_32 |
Functions/Macros used by the Sub-Modules
Library Functions / Macros
The library and functions / Macros that are called by the various sub modules are identified below,
None
Data Hiding Functions
Global Functions/Macros Defined by this Module
ADC2 Init
| Function Name | Adc2_init1 | Type | Min | Max | UTP Tol. |
|---|---|---|---|---|---|
| Arguments Passed | ConfigPtr | Adc_ConfigType* | N/A | N/A | |
| Return Value | N/A |
This function is used to initialize each of the ADC2 Groups (Event, Group1, and Group2).
Initialize Module Internal Variables
None
Register Configuration
Start Initial Conversions
Start Group Conversion
| Function Name | Adc2_StartGroupConversion | Type | Min | Max | UTP Tol. |
|---|---|---|---|---|---|
| Arguments Passed | group | uint8 | 0 | 2 | |
| Return Value | N/A |
This function starts a software triggered conversion of all channels of the requested Adc channel group.
Start Conversions
Enable Group Notification
| Function Name | Adc2_EnableGroupNotification | Type | Min | Max | UTP Tol. |
|---|---|---|---|---|---|
| Arguments Passed | group | uint8 | 0 | 15 | |
| Return Value | N/A |
This inline function reads and returns the individual channel conversion result.
Enable Notification Conditions
Local Functions/Macros Used by this MDD only
Read Channel Conversions
| Function Name | Adc2_ReadConversion | Type | Min | Max | UTP Tol. |
|---|---|---|---|---|---|
| Arguments Passed | ConvId | uint16 | 0 | 15 | |
| Return Value | conversion result | uint16 | 0 | 4095 | 0 |
This inline function reads and returns the individual channel conversion result.
Read Group
Software Module Implementation
Runtime Environment (RTE) Initial Values
None
Initialization Functions
None
Periodic Functions
None
Fault Recovery Functions
None
Shutdown Functions
None
Interrupt Functions
None
Serial Communication Functions
None
Transition Functions
None
Execution Requirements
Execution Sequence of the Module
Adc2_Init should be called after SystemTime_Init due to the use of the uS System Time.
Adc2_Init should be called prior to MtrCtrl ISR being enabled.
Execution Rates for sub-modules called by the Scheduler
This table serves as reference for the Scheduler design
| Function Name | Calling Frequency | System State(s) in which the function is called |
|---|---|---|
| Adc2_Init | Once (at initialization) | STARTUP |
Execution Requirements for Serial Communication Functions
| Function Name | Sub-Module called by (Serial Comm Function Name) |
|---|---|
| N/A |
Memory Map Definition Requirements
Sub Modules (Functions)
This table identifies the software segments for functions identified in this module.
| Name of Sub Module | Software Segment |
|---|---|
| Adc2_Init | ADC2_START_SEC_CODE |
| Adc2_StartGroupConversion | ADC2_START_SEC_CODE |
| Adc2_EnableGroupNotification | ADC2_START_SEC_CODE |
| Adc2_ReadConversion | inline |
Local Functions
This table identifies the software segments for local functions identified in this module.
| Name of Sub Module | Software Segment |
|---|---|
| None |
Known Issues / Limitations With Design
INLINE functions defined in “GlobalMacro.h” are not unit tested
Revision Control Log
| Item # | Rev # | Change Description | Date | Author Initials |
|---|---|---|---|---|
| 1 | 1.0 | Initial version based on FDD 33C rev 006 | 05Nov12 | LN |
| 2 | 2.0 | Design updates to meet FDD and simplify configuration | 24APR13 | Selva |
| 3 | 3.0 | Fixed typo in flowchart | 22MAY13 | LWW |
2 - Adc_Common_MDD
Module -- Adc Core
High-Level Description
The Adc Common module provides “stateless” application context independent functions which provide functionality required by both the Adc and Adc2 modules. In order to operate in any given application, the function design must not write to any fixed static variable location, unless it is in Globally shared memory. All static variable writes outside of Globally shared memory must be performed via pointer access where the caller provides the pointer reference to allowed writable memory in the application context from with the caller is executing.
The motivation for creating core functions is to reduce duplication and testing of common code design.
Figures
Component Diagram
None
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.
| Module Inputs | Module Outputs |
|---|---|
| None | None |
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.
| Variable Name | Resolution | Legal Range (min) | Legal Range (max) | Software Segment |
|---|---|---|---|---|
| None |
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) |
|---|---|---|---|---|
| None |
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.
| Constant Name |
|---|
| None |
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
| Constant Name | Resolution | Units | Value |
|---|---|---|---|
| D_NUMOFADCCALREADS_CNT_U8 | 1 | Counts | 8 |
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 |
|---|
| D_FALSE_CNT_LGC |
| D_TRUE_CNT_LGC |
Module specific Lookup Tables Constants
| Constant Name | Resolution | Value | Software Segment |
|---|---|---|---|
| None |
Functions/Macros used by the Sub-Modules
Library Functions / Macros
The library and functions / Macros that are called by the various sub modules are identified below,
None
Data Hiding Functions
<None>
Global Functions/Macros Defined by this Module
Offset Calibration
| Function Name | ADCOffsetCalibration | Type | Min | Max | UTP Tol. |
|---|---|---|---|---|---|
| Arguments Passed | adcREG | adcctrlregs_t* | FULL | FULL | |
| Return Value | Status_Cnt_T_u08 | uint8 | FULL | FULL |
Perform the ADC Calibration and Storing of offset.
Calibration Offset
Local Functions/Macros Used by this MDD only
Software Module Implementation
Runtime Environment (RTE) Initial Values
None
Initialization Functions
None
Periodic Functions
None
Fault Recovery Functions
None
Shutdown Functions
None
Interrupt Functions
None
Serial Communication Functions
None
Transition Functions
None
Execution Requirements
Execution Sequence of the Module
No integration scheduling required. The only service offered by this module has a fixed scheduling within the Adc subsystem.
Execution Rates for sub-modules called by the Scheduler
This table serves as reference for the Scheduler design
| Function Name | Calling Frequency | System State(s) in which the function is called |
|---|---|---|
| None |
Execution Requirements for Serial Communication Functions
| Function Name | Sub-Module called by (Serial Comm Function Name) |
|---|---|
| N/A |
Memory Map Definition Requirements
Sub Modules (Functions)
This table identifies the software segments for functions identified in this module.
| Name of Sub Module | Software Segment |
|---|---|
| ADCOffsetCalibration | ADC_START_SEC_CODE |
Local Functions
This table identifies the software segments for local functions identified in this module.
| Name of Sub Module | Software Segment |
|---|---|
Known Issues / Limitations With Design
INLINE functions defined in “GlobalMacro.h” are not unit tested
Revision Control Log
| Item # | Rev # | Change Description | Date | Author Initials |
|---|---|---|---|---|
| 1 | 1.0 | Initial version | 24Apr13 | Selva |
3 - Adc_MDD
Module -- ADC
High-Level Description
The ADC module shall control sampling and conversion of voltages from the hardware layer into digital signals. The ADC Register definition has been captured from the TMS570LS31x/21x 16/32-Bit RISC Flash Microcontroller Technical Reference Manual (SPNU499 – September 2011).
Figures
Component Diagram
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.
| Module Inputs | Module Outputs |
|---|---|
| None | None |
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.
| Variable Name | Resolution | Legal Range (min) | Legal Range (max) | Software Segment |
|---|---|---|---|---|
| None |
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) |
|---|---|---|---|---|
| Adc_GroupType | N/A | uint8 | 0 | 2 |
| Adc_GroupConfigDataType | uint8 NumOfChannels, uint32 ChannelSelect, uint32* ResultBuf | struct | FULL | FULL |
| Adc_StatusType | ADC_IDLE, ADC_BUSY, ADC_COMPLETED, ADC_STREAM_COMPLETED | enum | 0 | 3 |
| Adc_ValueGroupType | N/A | uint16 | 0 | 4095 |
| Adc_ValueGroupType | N/A | uint16* | FULL | FULL |
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.
| Constant Name |
|---|
| k_VbattOVTransIntConfig_Cnt_u32 |
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
| Constant Name | Resolution | Units | Value |
|---|---|---|---|
| D_NUMOFGROUPS_CNT_U8 | 1 | Counts | 3 |
| D_GROUPEV_CNT_U8 | 1 | Counts | 0 |
| D_GROUP1_CNT_U8 | 1 | Counts | 1 |
| D_GROUP2_CNT_U8 | 1 | Counts | 2 |
| D_NUMOFADCCALREADS_CNT_U8 | 1 | Counts | 8 |
| D_NTCPARMBIT0_CNT_U8 | 1 | Counts | 1 |
| D_NTCPARMBIT1_CNT_U8 | 1 | Counts | 2 |
| D_NTCPARMBIT2_CNT_U8 | 1 | Counts | 4 |
| D_ADC1RSLTBASEADR_CNT_U32 | 1 | Counts | 0xFF3E0000U |
| D_ADC1NUMRSLTBUF_CNT_U08 | 1 | Counts | 64 |
| D_ADC1CURRENTMODE_ULS_LGC | 1 | BOOLEAN | Generated in Adc_Cfg.h. |
| D_ADC1MAGINTMASK1_CNT_U16 | 1 | Counts | 0/0* |
| D_ADC1MAGINTASET_CNT_U16 | 1 | Counts | 1/0* |
| D_ADC1MAGINTCR1_CNT_U32 | 1 | Counts | k_VbattOVTransIntConfig_Cnt_u32/ 0* |
| D_ADC1THRINTENACLR_CNT_U16 | 1 | Counts | 6/7* |
| D_ADC1EVTBUFSZ_CNT_U08 | 1 | Counts | Generated in Adc_Cfg.h. |
| D_ADC1G1BUFSZ_CNT_U08 | 1 | Counts | Generated in Adc_Cfg.h. |
| D_ADC1G2BUFSZ_CNT_U08 | 1 | Counts | Generated in Adc_Cfg.h. |
| D_GROUPEND_CNT_U32 | 1 | Counts | Generated in Adc_Cfg.h. |
| D_GROUPBUSY_CNT_U32 | 1 | Counts | Generated in Adc_Cfg.h. |
D_ADC1CURRENTMODE_ULS_LGC if True value 1 is selected to proceed. If not value 2 will be used,
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 |
|---|
| T_Adc1GroupConfigData_Cnt_Str[D_NUMOFGROUPS_CNT_U8] |
Module specific Lookup Tables Constants
| Constant Name | Resolution | Value | Software Segment |
|---|---|---|---|
| None |
Functions/Macros used by the Sub-Modules
Library Functions / Macros
The library and functions / Macros that are called by the various sub modules are identified below,
None
Data Hiding Functions
<None>
Global Functions/Macros Defined by this Module
ADC Init
| Function Name | Adc_Init_FixedCfg ( macro aliased is Adc_Init(x) ) | Type | Min | Max | UTP Tol. |
|---|---|---|---|---|---|
| Arguments Passed | None | N/A | N/A | N/A | |
| Return Value | N/A |
This function is used to initialize each of the ADC1 Groups (Event, Group1, and Group2).
Initialize Module Internal Variables
None
Register Configuration
Setup Result Buffer
| Function Name | Adc_SetupResultBuffer | Type | Min | Max | UTP Tol. |
|---|---|---|---|---|---|
| Arguments Passed | Group | Adc_GroupType | 0 | 2 | |
| DataBufferPtr | Adc_ValueGroupRefType | FULL | FULL | ||
| Return Value | N/A | Std_ReturnType | 0 | 0 | 0 |
This function is the Adc group result buffer setup service. It is responsible for setting up the result buffer pointer of the group.
This Api is provided to support for the standard Autosar API, however the design of this driver does not buffer an intermediate copy of the results and therefore does not require a result buffer. The hardware provides a sufficient Adc results buffer.
For optimization purposes, this function could be defined as a macro.
Setup Group’s Result Buffer
return E_OK
Start Group Conversion
| Function Name | Adc_StartGroupConversion | Type | Min | Max | UTP Tol. |
|---|---|---|---|---|---|
| Arguments Passed | Group | Adc_GroupType | 0 | 2 | |
| DataBufferPtr | Adc_ValueGroupRefType | FULL | FULL | ||
| Return Value | N/A | Std_ReturnType | 0 | 0 | 0 |
This function starts a software triggered conversion of all channels of the requested Adc channel group.
In order to provide optimized execution of this single line function, this API should be defined as a macro, however, due to timing it is at the moment defined as a function. The need for minimal runtime is driven by a Nexteer use case which executes this in the context of the MtrCtrl ISR in some EPS systems.
Select Channels to Convert
adcREG1->GxSEL[Group] = T_Adc1GroupConfigData_Cnt_Str[Group].ChannelSelect
Get Group Status
| Function Name | Adc_GetGroupStatus | Type | Min | Max | UTP Tol. |
|---|---|---|---|---|---|
| Arguments Passed | Group | Adc_GroupType | 0 | 2 | |
| Return Value | ReturnVal_Cnt_T_Enum | Adc_StatusType | 0 | 3 | 0 |
Returns the conversion status of the requested ADC1 channel group.
Get Status
Read Group Conversions
| Function Name | Adc_ReadGroup | Type | Min | Max | UTP Tol. |
|---|---|---|---|---|---|
| Arguments Passed | Group | Adc_GroupType | 0 | 2 | |
| Return Value | ReturnVal_Cnt_T_Enum | Adc_StatusType | 0 | 3 | 0 |
Reads the group conversion result of the last completed conversion round of the requested group and
stores the channel values starting at the DataBufferPtr address. The group channel values are stored in ascending channel number order (in contrast to the storage layout of the result buffer if streaming access is configured).
Per the design direction in FDD33, direct ADC result buffer acces is used instead of using the hardware FIFO access register.
Read Group
Local Functions/Macros Used by this MDD only
Software Module Implementation
Runtime Environment (RTE) Initial Values
None
Initialization Functions
None
Periodic Functions
None
Fault Recovery Functions
None
Shutdown Functions
None
Interrupt Functions
None
Serial Communication Functions
None
Transition Functions
None
Execution Requirements
Execution Sequence of the Module
Adc_Init should be called after SystemTime_Init due to the use of the uS System Time.
Adc_Init should be called prior to IoHwAb_Init to ensure registers are configured prior to triggering initial conversions.
Execution Rates for sub-modules called by the Scheduler
This table serves as reference for the Scheduler design
| Function Name | Calling Frequency | System State(s) in which the function is called |
|---|---|---|
| Adc_Init | Once (at initialization) | STARTUP |
Execution Requirements for Serial Communication Functions
| Function Name | Sub-Module called by (Serial Comm Function Name) |
|---|---|
| N/A |
Memory Map Definition Requirements
Sub Modules (Functions)
This table identifies the software segments for functions identified in this module.
| Name of Sub Module | Software Segment |
|---|---|
| Adc_Init | ADC_START_SEC_CODE |
| Adc_SetupResultBuffer | ADC_START_SEC_CODE |
| Adc_StartGroupConversion | ADC_START_SEC_CODE |
| Adc_ReadGroup | ADC_START_SEC_CODE |
| Adc_GetGroupStatus | ADC_START_SEC_CODE |
| ADCOffsetCalibration | ADC_START_SEC_CODE |
Local Functions
This table identifies the software segments for local functions identified in this module.
| Name of Sub Module | Software Segment |
|---|---|
Known Issues / Limitations With Design
INLINE functions defined in “GlobalMacro.h” are not unit tested
Revision Control Log
| Item # | Rev # | Change Description | Date | Author Initials |
|---|---|---|---|---|
| 1 | 1.0 | Initial version based on FDD 33C rev 006 | 05Nov12 | LN |
| 2 | 2 | Constant confiuguration tables renamed to start with “T_” Rewored Adc_ReadGroup to provide direct fixed memory access as required in the FDD | 15Jan13 | JJW |
| 3 | 3 | Updated FDD 33C rev 007 and FDD33E rev2 | 25-April-13 | Selva |
4 - Data Dictionary
Overview
Change LogVariable Dictionary
Calibration Dictionary
Global Constants
Template
Help
Sheet 1: Change Log
| Adc- Rev 1.0 | <- Global Program / Module Name | ||||||
| Revision | Author | Date | Change Description | Data Dictionary Type: | Component | ||
| 1 | Selva | 26-Apr-12 | Updated to ver 02 FDD | ||||
Sheet 2: Variable Dictionary
Sheet 3: Calibration Dictionary
Sheet 4: Global Constants
| Adc- Rev 1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Variable Information (Global Variables Only) | Achieved in Software Design | Used in Module List | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Layer 2 | Layer 3 | Layer 4 | Layer 5 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Constant Name | Description | Uints | Type | Engineering Value | ADC | ADC Diagnostics | Data Memory Verification | DC Link Power Control | DSP Computational Integrity | DSP SPI driver | Event Manager Driver | External Memory Driver | Flash Programming Exec | GPIO | Illegal OpCode Handler | Interrupt Handler | Motor Current Driver | Motor Driver Diagnostics | Motor Position Driver | Phase Feedback Capture | Powerdown Control | Primary Shutdown Control | Program Flow | Program Memory Diagnostic | PWM Duty Cycle | Redundant Memory Check | Redundant Rapid Shutdown | Scheduler | Stack Monitor | State Dependent Task List | System Boot & Startup | System Control | Temperature Sensor Diagnostic | Unused Interrupt Handler | Utilization Monitor | Watchdog Dirver | Smith | Battery Voltage | Battery Voltage Diagnostics | Diagnostic CTC Manager | Diagnostic Manager | Diagnostics Application Services | EOL TorqueTest | Flash Boot Loader | Flight Recorder | Handwheel Position | Handwheel Torque | Motor Control Output Conversion | Motor Position Diagnostics | Motor Position Initialization | Motor Velocity | Motor Velocity Tachometer | Serial Communications I/O | Serial Communications Services | States and Modes | Tuning Select | Vehicle Power Mode | Vehicle Speed | Controller Polarity | Current Estimation | Handwheel Velocity | Inverse Motor Model | Motor Temperature Estimation | Motor Torque Limit | Output Reasonableness Dianostic | Parameter Estimation | Quadrant and rate Detection | Active Pull Compensation | Assist | Damping | Duty Cycle | Kinematic Integrity Diagnostic | Long Term Vehicle Speed Diagnostic | Max Assist Limit | Return | State Output Control | Torque Output |
Sheet 5: Template
| 2.2a | Data File: | |||||
| Header: | extern <TYPE><TAB><NAME>; | |||||
| Source: | #pragma DATA_SECTION(<ROOTNAME>, "<SEGMENT>"); <TYPE> <NAME>; | |||||
| EOL Constants: | ||||||
| Header: | extern <TYPE><TAB><NAME>; | |||||
| Source: | #pragma DATA_SECTION(<ROOTNAME>, "<SEGMENT>"); <TYPE> <NAME>; | |||||
| Global (Embedded) Constants: | ||||||
| Header: | #define <NAME><COL40><VALUE> | |||||
| A2L Name | ||||||
| Measurement: | rte_<SWC>_<NAME> | |||||
| Calibration Constants: | ||||||
| Tuning ID: | ||||||
| Tuning: | N | Index Range: | ||||
| Header: | extern CONST(<AUTOSAR_TYPE>, CAL_CONST) <NAME>; | |||||
| Source: | #pragma DATA_SECTION(<ROOTNAME>, ".<SEGMENT>"); CONST(<AUTOSAR_TYPE>, CAL_CONST) <NAME> = <VALUE>; | |||||
| eCal: | <NAME> | |||||
| Tuning: | Y | Index Range: | ||||
| Header: | <NONCRITICAL> #define <ROOTNAME><TAB>k_N_CalNC_Cnt_Str.<ROOTNAME> <NONCRITICAL> <SAFETYCRITICAL> #define <ROOTNAME><TAB>k_S_CalSC_Cnt_Str.<ROOTNAME> <SAFETYCRITICAL> | |||||
| Source: | ||||||
| eCal: | <NONCRITICAL> k_N_CalNC_Cnt_Str.<ROOTNAME> <NONCRITICAL> <SAFETYCRITICAL> k_S_CalSC_Cnt_Str.<ROOTNAME> <SAFETYCRITICAL> | |||||
| Tuning: | P | Index Range: | ||||
| Header: | <NONCRITICAL> #define <ROOTNAME><TAB>k_N_CalNC_Cnt_Str.Personality[L3_S_CalPersSelect_Cnt_G_u16].<ROOTNAME> <NONCRITICAL> <SAFETYCRITICAL> #define <ROOTNAME><TAB>k_S_CalSC_Cnt_Str.SC_Personality[L3_S_CalPersSelect_Cnt_G_u16].<ROOTNAME> <SAFETYCRITICAL> | |||||
| Source: | ||||||
| eCal: | <NONCRITICAL> k_N_CalNC_Cnt_Str.Personality[L3_S_CalPersSelect_Cnt_G_u16].<ROOTNAME> <NONCRITICAL> <SAFETYCRITICAL> k_S_CalSC_Cnt_Str.SC_Personality[L3_S_CalPersSelect_Cnt_G_u16].<ROOTNAME> <SAFETYCRITICAL> | |||||
Sheet 6: Help
| Short cut | Macro | Sescription |
| Ctrl-q | ClearDataDictFilter | Will clear all autofilters on the Global Data Dictionary |
| DFD_Create | Creates a Series of Data Flow Worksheet Pages from the information in the data dictionary. If Data Flow Worksheet pages already exist, they will be deleted first. | |
| DFD_Delete | Will clear all Data Flow Diagram pages from the Data Dictionary. This will make the file smaller for archiving. | |
| DFD_Print | Formate and prepares to print the Data Flow Worksheet pages. |
5 - Integration_Manual_ADC
1.2 Configuration Files to be provided by Integration Project 2
1.3 Functions to be provided to Integration Project 2
Dependencies
SWCs
| Module | Required Feature |
|---|---|
Configuration Files to be provided by Integration Project
NOTE:
For Projects using 33E, make sure “D_ADC1CURRENTMODE_ULS_LGC” is defined Adc_Cfg.h file.
For Projects using 33C, make sure “D_ADC1CURRENTMODE_ULS_LGC” is NOT defined Adc_Cfg.h file.
Template for Configuration file:
Adc_Cfg.h
Adc2_Cfg.h
Functions to be provided to Integration Project
Adc2_ReadConversion
Adc2_Init1
Adc2_StartGroupConversion
Adc2_EnableGroupNotification
Adc_Init_FixedCfg
Adc_StartGroupConversion
Adc_ReadGroup
Adc_GetGroupStatus
Configuration
Build Time Config
| Modules | Notes | |
|---|---|---|
| None |
Generator Config
| Constant | Notes | SWC |
|---|---|---|
| None |
Integration
Global Data
None
Component Conflicts
IoHwAb
Include Path
$PROJECTPATH$\Adc\include
Adc.h, Adc2.h, Adc_Common.h
Configurator Changes
None
Runnable Scheduling
This section specifies the required runnable scheduling.
| Init | Scheduling Requirements | Trigger |
|---|---|---|
| Adc_Init() | Before Adc2_Init1 initialization | ECU Startup |
| Adc2_Init1() | Before PWMCdd initialization | ECU Startup |
| Runnable | Scheduling Requirements | Trigger |
|---|---|---|
| Adc_StartGroupConversion | None | ISR |
*Note:
.
Memory Mapping
Mapping
| Memory Section | Contents | Notes |
|---|---|---|
| ADC2_START_SEC_CODE | ||
| ADC2_START_SEC_CONST_32 | ||
| ADC_START_SEC_CONST_32 | ||
| ADC_START_SEC_CODE |
* Each …START_SEC… constant is terminated by a …STOP_SEC… constant as specified in the AUTOSAR Memory Mapping requirements.
Usage
| Feature | RAM | ROM |
|---|---|---|
| <Memmap usuage info> |
Revision Control Log
| Rev # | Change Description | Date | Author |
|---|---|---|---|
| 1 | Initial version | 09-Apr-13 | Selva |