FlsTst_Integration_Manual
Contents
1 Dependencies 1
1.1 SWCs 2
1.2 Functions to be provided to Integration Project 2
2 Configuration 2
2.1 Build Time Config 2
2.2 Configuration Files to be provided by Integration Project 2
2.2.1 Da Vinci Parameter Configuration Changes 3
2.2.2 DaVinci Interrupt Configuration Changes 3
2.2.3 Manual Configuration Changes 3
3 Integration 3
3.1 Required Global Data Inputs 3
3.2 Optional Global Data Inputs 4
3.3 Specific Include Path present 4
4 Runnable Scheduling 4
5 Memory Mapping 4
5.1 Mapping 4
5.2 Usage 4
5.3 NvM Blocks 5
6 Compiler Settings 5
6.1 Preprocessor MACRO 5
6.2 Optimization Settings 5
7 Revision Control Log 5
Dependencies
NOTE – the TMS570_uDiag component includes both uDiag and FlsTst functionality. For complete integration information on the TMS570_uDiag component, also see the Cd_uDiag integration manual (in the TMS570_uDiag\doc folder).
SWCs
Module | Required Feature |
---|---|
NxtrLib | DtrmnElapsedTime_uS_u32() GetSystemTime_uS_u32() |
TMS570 CRC peripheral | Exclusive access to the CRC peripheral registers. |
TMS570 DMA peripheral | Exclusive access to the DMA peripheral registers. |
TMS570 ESM peripheral | Exclusive access to the ESM configuration bits that control the DMA MPU interrupt enable, nError pin action, and Interrupt level mapping. |
DiagMgr (Nexteer DEM) | NxtrDiagMgr_ReportNTCStatus() API |
uDiagESM | DMAMPUErr() Callback notification on DMA MPU violation |
Basic System Services | EnableCRCInterrupt() |
Functions to be provided to Integration Project
< Global function (except the ones that are defined in RTE modules) that is defined in this component but used by other function>
void FlsTst_MainFunction( void );
void FlsTst_Init( const FlsTst_ConfigType* ConfigPtr );
void FlsTst_Suspend( void );
void FlsTst_Resume( void );
Configuration
Build Time Config
Modules | Notes | |
---|---|---|
None |
Configuration Files to be provided by Integration Project
FlsTst_Cfg.c generated by FlsTst_Cfg.c.tt
FlsTst_Cfg.h generated by FlsTst_Cfg.h.tt
NOTES: The FlsTst module parameter description file and generator templates are located in the “generate” folder. The generation scheme at this time relies on the ARTT generation framework developed by BMW. Following are the recommended steps to integrate the provided generation templates and parameter description with Davinci Configurator:
Copy the “Artt/artt” framework folder into the “Generators” directory (if not already present)
Execute the “Integrate.bat” script from the Tools directory of this component to perform the necessary integration steps:
The script creates the required directories in the integration project, “Generators/Artt/FlsTst” and “Generators/Components/_Schemes/FlsTst/bswmd”
The script then copies the required files from the CBD generate directory into the new directories.
If this is the first time integration, then perform the Davinci Configurator 3rd party component integration procedure.
Da Vinci Parameter Configuration Changes
Parameter | Notes | SWC |
---|---|---|
FlsTstConfigSet | At least one block configuration set must be defined. See FlsTst technical reference for details. | FlsTst |
FlsTstConfigurationOfOptApiServices | Configuration of optional API services. All optional services are disabled by default. | FlsTst |
FlsTstDemEventParameterRefs | Configuration of NTC enumeration symbol name for diagnostic tests performed in this module. | FlsTst |
FlsTstGeneral | General module configuration. See FlsTst technical reference for details. | FlsTst |
FlsTst\Runtime\FlsTstBlockBgndConfigSet\App\FlsTstBlockSize | Number of bytes in flash test block – NOTE that this number has a max value of 8388600 in the current version of the uDiag component, and a max value of 524280 in version FDD32B_TMS570_uDiag_000.21 and previous. Numbers greater than the max value will not give an error indication but will cause the flash CRC check to not operate correctly. | FlsTst (contained in TMS570_uDiag component) |
DaVinci Interrupt Configuration Changes
ISR Name | VIM # | Priority Dependency | Notes |
---|---|---|---|
FlsTst_CrcIRQ | 19 | Must be IRQ and Category 2 | |
Manual Configuration Changes
Constant | Notes | SWC |
---|---|---|
None |
Integration
Required Global Data Inputs
<Mention any global variable that this component requires for other components>
Optional Global Data Inputs
<Mention any global variable that this component requires for other components>
Specific Include Path present
<Yes>
Runnable Scheduling
This section specifies the required runnable scheduling.
Runnable | Scheduling Requirements | Privileged Mode | Trigger |
---|---|---|---|
FlsTst_Init() | Must be executed prior to using FlsTst_MainFunction() | Required | Init* |
FlsTst_MainFunction() | Scheduling cycle can influence the time to complete the background test interval. A new test block is started only during the invocation of the MainFunction, so an excessively large period between MainFunction calls will extend the time for a test interval to complete. | Cyclic | |
FlsTst_CrcIrq() | Scheduled via hardware IRQ. The integrator must enable the interrupt source configured in the Os before this runnable can be triggered by the hardware. | IRQ on signature failure |
* Can be called during run time to change block test configuration if required.
Memory Mapping
Mapping
Constant | Notes |
---|---|
FLSTST_START_SEC_VAR_CLEARED_8 | |
FLSTST_START_SEC_VAR_16 | |
FLSTST_START_SEC_VAR_CLEARED_UNSPECIFIED | |
FLSTST_START_SEC_VAR_UNSPECIFIED | |
FLSTST_START_SEC_CODE | |
FLSTST_START_SEC_CONST_UNSPECIFIED |
* Each …START_SEC… constant is terminated by a …STOP_SEC… constant as specified in the AUTOSAR Memory Mapping requirements.
Usage
Feature | RAM | ROM |
---|---|---|
Full driver |
NvM Blocks
Block Name |
---|
<NvM Block Info> |
Note : Size of the NVM block if configured in developer
Compiler Settings
Preprocessor MACRO
<Define all the preprocessor Macros needed and conditions when needed>.
Optimization Settings
Revision Control Log
Rev # | Change Description | Date | Author Initials |
1 | Initial version | JJW | |
2 | Updated integration process description to reference use of Integrate.bat | 09/18/12 | JJW |
3 | Updated to latest template, other misc cleanup. | 06-Jan-14 | KMC |