DEENESPTFRRUARHIKOZHNL

Flash Test (FlsTst)

ModulFlsTst (Flash Test)
BSW-Modul-ID104
Standard-Header#include "FlsTst.h"
SWS-SpezifikationAUTOSAR_CP_SWS_FlashTest.pdf, AUTOSAR_SWS_FlashTest.pdf
Umfang48 Records · 8 Snippets
ClusterSpeicher-Stack (Memory)

Flash Test (FlsTst)

AUTOSAR Classic Memory Drivers-Modul Flash Test (FlsTst, Spezifikation: AUTOSAR_CP_SWS_FlashTest.pdf, AUTOSAR_SWS_FlashTest.pdf).

Funktionen — Übersicht

Typen — Übersicht

Anforderungen — Übersicht

Funktionen & Typen — Detailansicht

函数 FlsTst_Init [SWS_FlsTst_00017] 📄 PDF

void FlsTst_Init(const FlsTst_ConfigType* ConfigPtr);

Service for Flash Test initialization.

函数 FlsTst_Suspend [SWS_FlsTst_00034] 📄 PDF

void FlsTst_Suspend(void);

Service for suspending current operation of the Flash Test, until Fls Tst_ Resume is called.

函数 FlsTst_Resume [SWS_FlsTst_00035] 📄 PDF

void FlsTst_Resume(void);

Service for continuing the Flash Test at the point it was suspended.

函数 FlsTst_GetCurrentState [SWS_FlsTst_00040] 📄 PDF

FlsTst_StateType FlsTst_GetCurrentState(void);

Service returns the current Flash Test exection state.

函数 FlsTst_GetTestResultBgnd [SWS_FlsTst_00042] 📄 PDF

FlsTst_TestResultBgndType FlsTst_GetTestResultBgnd(void);

Service returns the Background Flash Test result.

函数 FlsTst_GetTestSignatureBgnd [SWS_FlsTst_00054] 📄 PDF

FlsTst_TestSignatureBgndType FlsTst_GetTestSignatureBgnd(void);

Service returns the Flash Test result in background mode.

函数 FlsTst_GetTestSignatureFgnd [SWS_FlsTst_00057] 📄 PDF

FlsTst_TestSignatureFgndType FlsTst_GetTestSignatureFgnd(void);

Service returns the Flash Test result in foreground mode.

函数 FlsTst_GetErrorDetails [SWS_FlsTst_00060] 📄 PDF

FlsTst_ErrorDetailsType FlsTst_GetErrorDetails(void);

Service returns error detais monitored from the Flash module.

函数 FlsTst_TestEcc [SWS_FlsTst_00063] 📄 PDF

Std_ReturnType FlsTst_TestEcc(void);

Service executes a test of ECC hardware. This is only applicable in case the hardware provices such functionality.

函数 FlsTst_MainFunction [SWS_FlsTst_00066] 📄 PDF

void FlsTst_MainFunction(void);

Service for executing the Flash Test in background mode.

函数 FlsTst_TestCompletedNotification [SWS_FlsTst_00077] 📄 PDF

void FlsTst_TestCompletedNotification(void);

The function Fls Tst_ Test Completed shall be called every time when a complete test cycle had been tested.

函数 FlsTst_GetTestResultFgnd [SWS_FlsTst_00112] 📄 PDF

FlsTst_TestResultFgndType FlsTst_GetTestResultFgnd(void);

Service returns the Foreground Flash Test result.

类型 FlsTst_ConfigType [SWS_FlsTst_00018] 📄 PDF

This type of external data structure shall contain the initialization data for the Flash Test.

类型 FlsTst_StateType [SWS_FlsTst_00048] 📄 PDF

This is a state value returned by the API service Fls Tst_ Get Current State().

类型 FlsTst_BlockIdFgndType [SWS_FlsTst_00100] 📄 PDF

This type specifies the identification (ID) for a Flash block to be tested in foreground mode, which is configured in the configuration structure.

类型 FlsTst_ErrorDetailsType [SWS_FlsTst_00108] 📄 PDF

This type shall specify implementation specific error information monitored in the Flash test module.

requirement SWS_FlsTst_00007 [SWS_FlsTst_00007] 📄 PDF

Type of error Related error code Error value Failure within Flash Test execution state FLSTST_ E_ STATE_ FAILURE 0x01 API parameter out of specified range FLSTST_ E_ PARAM_ INVALID 0x02 API service used without module initialization FLSTST_ E_ UNINIT 0x03 Flash Test module is already initialized FLSTST_ E_ ALREADY_ INITIALIZED 0x04 For Variant PB: Configuration pointer is a NULL pointer. For Variant PC: Configuration pointer is NOT a NULL pointer. FLSTST_ E_ INIT_ FAILED 0x05 Pointer is a NULL pointer FLSTST_ E_ PARAM_ POINTER 0x06

requirement SWS_FlsTst_00011 [SWS_FlsTst_00011] 📄 PDF

The function FlsTst_Init shall be called first before calling any other Flash Test functions except the function FlsTst_GetCurrentState . If this sequence is not respected, the error code FLSTST_E_UNINIT shall be reported to the Default Error Tracer (if development error detection is enabled).

requirement SWS_FlsTst_00016 [SWS_FlsTst_00016] 📄 PDF

Module Header File Imported Type Dem Rte_ Dem_ Type.h Dem _ Event Id Type Rte_ Dem_ Type.h Dem _ Event Status Type Std Std_ Types.h Std _ Return Type Std_ Types.h Std _ Version Info Type

requirement SWS_FlsTst_00028 [SWS_FlsTst_00028] 📄 PDF

[SWS_FlsTst_00028] Upstream requirements: SRS_SPAL_12163 ⌈The function FlsTst_DeInit shall de-initialize all Flash Test relevant registers and global variables that were initialized by FlsTst_Init.⌋

requirement SWS_FlsTst_00029 [SWS_FlsTst_00029] 📄 PDF

[SWS_FlsTst_00029] ⌈The function FlsTst_DeInit shall set the Flash Test module state to FLSTST_UNINIT.⌋

requirement SWS_FlsTst_00033 [SWS_FlsTst_00033] 📄 PDF

[SWS_FlsTst_00033] Upstream requirements: SRS_BSW_00323, SRS_BSW_00386, SRS_SPAL_12448, SRS_ FlsTst_14219 ⌈If development error detection is enabled and the parameter FgndBlockId is out of range, the DET error value FLSTST_E_PARAM_INVALID shall be raised and the func- tion shall return without any action with return value E_NOT_OK.⌋

requirement SWS_FlsTst_00050 [SWS_FlsTst_00050] 📄 PDF

[SWS_FlsTst_00050] Upstream requirements: SRS_FlsTst_14219 ⌈The function FlsTst_StartFgnd is only applicable for Foreground mode Flash Test operation.⌋

requirement SWS_FlsTst_00051 [SWS_FlsTst_00051] 📄 PDF

[SWS_FlsTst_00051] Upstream requirements: SRS_FlsTst_14219 ⌈The function FlsTst_StartFgnd shall be pre compile time configurable On/Off by the configuration parameter: FlsTst_StartFgndApi.⌋

requirement SWS_FlsTst_00061 [SWS_FlsTst_00061] 📄 PDF

[SWS_FlsTst_00061] Upstream requirements: SRS_FlsTst_14223 ⌈The function FlsTst_GetErrorDetails shall return the error details monitored from the Flash Test driver.⌋

requirement SWS_FlsTst_00062 [SWS_FlsTst_00062] 📄 PDF

[SWS_FlsTst_00062] Upstream requirements: SRS_BSW_00386, SRS_FlsTst_14223 ⌈The function FlsTst_GetErrorDetails shall be pre compile time configurable On/Off by the configuration parameter: FlsTst_GetErrorDetailsApi.⌋

requirement SWS_FlsTst_00064 [SWS_FlsTst_00064] 📄 PDF

[SWS_FlsTst_00064] Upstream requirements: SRS_FlsTst_14224 ⌈The function FlsTst_TestEcc shall execute a test of the ECC circuitry.⌋

requirement SWS_FlsTst_00065 [SWS_FlsTst_00065] 📄 PDF

[SWS_FlsTst_00065] Upstream requirements: SRS_BSW_00386, SRS_FlsTst_14224 ⌈The function FlsTst_TestEcc shall be pre compile time configurable On/Off by the configuration parameter: FlsTst_TestEccApi.⌋

requirement SWS_FlsTst_00072 [SWS_FlsTst_00072] 📄 PDF

Dem _ Set - Event Status Dem.h Called by SW - Cs or BSW modules to report monitor status information to the Dem. BSW modules calling Dem_ Set Event Status can safely ignore the return value. This API will be available only if ({Dem/ Dem Config Set/ Dem Event Parameter/ Dem Event Reporting Type} == STANDARD_ REPORTING)

requirement SWS_FlsTst_00074 [SWS_FlsTst_00074] 📄 PDF

[SWS_FlsTst_00074] Upstream requirements: SRS_FlsTst_14212 ⌈The callback notifications shall be configurable as function pointers within the initial- ization data structure (FlsTst_ConfigType).⌋

requirement SWS_FlsTst_00075 [SWS_FlsTst_00075] 📄 PDF

[SWS_FlsTst_00075] Upstream requirements: SRS_FlsTst_14212 ⌈The callback notifications shall have no parameters and no return value.⌋

requirement SWS_FlsTst_00076 [SWS_FlsTst_00076] 📄 PDF

[SWS_FlsTst_00076] Upstream requirements: SRS_FlsTst_14212 ⌈If a callback notification is configured as null pointer, the Flash Test module shall not execute the callback.⌋

requirement SWS_FlsTst_00140 [SWS_FlsTst_00140] 📄 PDF

[SWS_FlsTst_00140] ⌈The length of a partial test is defined by the number of tested cells, which shall be tested in one scheduled task. (see [ECUC_FlsTst_00161]). The required time for a partial test without interruption is defined as "T est time". ⌋ Note: The partial test can be interrupted by a higher priority task at any time, because the Flash test does not require atomic sequences. It is the responsibility of the user to ensure that the interruptible partial test is finished before the scheduler interval is started(See Figure 7.2). [SWS_FlsTst_00142] ⌈A background test shall be aborted or suspended via the API services FlsTst_Abort() or FlsTst_Suspended(). The maximum latency time until the API call request is processed, shall be configurable (see [ECUC_FlsTst_00120]). ⌋ est

requirement SWS_FlsTst_00142 [SWS_FlsTst_00142] 📄 PDF

[SWS_FlsTst_00142] ⌈A background test shall be aborted or suspended via the API services FlsTst_Abort() or FlsTst_Suspended(). The maximum latency time until the API call request is processed, shall be configurable (see [ECUC_FlsTst_00120]). ⌋ est

requirement SWS_FlsTst_00143 [SWS_FlsTst_00143] 📄 PDF

[SWS_FlsTst_00143] Upstream requirements: SRS_FlsTst_14219 ⌈Foreground tests are defined as synchronous tests which shall not be interrupted. The execution of Foreground tests is configurable (see [ECUC_FlsTst_00086]) and can be called after module initialization at any time. ⌋

requirement SWS_FlsTst_00156 [SWS_FlsTst_00156] 📄 PDF

Figure 7.1: Background Test: Test Interval [SWS_FlsTst_00140] ⌈The length of a partial test is defined by the number of tested cells, which shall be tested in one scheduled task. (see [ECUC_FlsTst_00161]). The required time for a partial test without interruption is defined as "T est time". ⌋ Note: The partial test can be interrupted by a higher priority task at any time, because the Flash test does not require atomic sequences. It is the responsibility of the user to ensure that the interruptible partial test is finished before the scheduler interval is started(See Figure 7.2). [SWS_FlsTst_00142] ⌈A background test shall be aborted or suspended via the API services FlsTst_Abort() or FlsTst_Suspended(). The maximum latency time until the API call request is processed, shall be configurable (see [ECUC_FlsTst_00120]). ⌋ est

requirement SWS_FlsTst_00167 [SWS_FlsTst_00167] 📄 PDF

When FlsTstTestResultSignature is disabled, the function FlsTst_MainFunction shall set the overall r esult status for a test interval to FLSTST_RESULT_NOT_OK if at least one block test result is not ok regardless whether all blocks are already tested or not. Additionally the DEM FLSTST_E_FLSTST_FAILURE shall be triggered with the detection criteria "Fail" .

requirement SWS_FlsTst_00168 [SWS_FlsTst_00168] 📄 PDF

: Failure detection in back ground mode Long Description: This Extended Production Error shall be issued in case a failure is detected in background mode within a test interval. Detection Criteria: Fail At least one block within a test interval in background mode is NOT OK (see SWS _FlsTst_00167 ) Pass All blocks within a test interval in background mode are tested with the result OK.(see SWS_FlsTst_00161) Secondary Parameters: N/A Time Required : N/A Monitor Frequency continuous

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/CP_MOD_FlsTst
Status
unspecified
Version
AUTOSAR/AP/record/CP_MOD_FlsTst@rel:R20-11#e1174c55
Content hash
e1174c55
Source
https://www.autosar.org/fileadmin/standards/R20-11/CP/AUTOSAR_SWS_FlashTest.pdf#nameddest=SWS_FlsTst_00017

初始化与状态

Service for Flash Test De - Initialization.

void FlsTst_DeInit(void);

Service returns the version information of this module.

void FlsTst_GetVersionInfo(Std_VersionInfoType* versioninfo);

Service for Flash Test initialization.

void FlsTst_Init(const FlsTst_ConfigType* ConfigPtr);

服务

Service for aborting the Flash Test.

void FlsTst_Abort(void);

Service for continuing the Flash Test at the point it was suspended.

void FlsTst_Resume(void);

Service for executing foreground Flash Test.

Std_ReturnType FlsTst_StartFgnd(FlsTst_BlockIdFgndType FgndBlockId);

Service for suspending current operation of the Flash Test, until Fls Tst_ Resume is called.

void FlsTst_Suspend(void);

The function Fls Tst_ Test Completed shall be called every time when a complete test cycle had been tested.

void FlsTst_TestCompletedNotification(void);

Service executes a test of ECC hardware. This is only applicable in case the hardware provices such functionality.

Std_ReturnType FlsTst_TestEcc(void);

Service returns error detais monitored from the Flash module.

FlsTst_ErrorDetailsType FlsTst_GetErrorDetails(void);

Service returns the current Flash Test exection state.

FlsTst_StateType FlsTst_GetCurrentState(void);

Service returns the Background Flash Test result.

FlsTst_TestResultBgndType FlsTst_GetTestResultBgnd(void);

Service returns the Foreground Flash Test result.

FlsTst_TestResultFgndType FlsTst_GetTestResultFgnd(void);

Service returns the Flash Test result in background mode.

FlsTst_TestSignatureBgndType FlsTst_GetTestSignatureBgnd(void);

Service returns the Flash Test result in foreground mode.

FlsTst_TestSignatureFgndType FlsTst_GetTestSignatureFgnd(void);

周期性

Service for executing the Flash Test in background mode.

void FlsTst_MainFunction(void);

类型

This type specifies the identification (ID) for a Flash block to be tested in foreground mode, which is configured in the configuration structure.

This type of external data structure shall contain the initialization data for the Flash Test.

This type shall specify implementation specific error information monitored in the Flash test module.

This is a state value returned by the API service Fls Tst_ Get Current State().

Return type of API service Fls Tst_ Get Test Result Bgnd().

Return type of API service Fls Tst_ Get Result Fgnd().

Type for test signature in background mode.

Type for test signature in foreground mode

需求

SWS_FlsTst_00007 requirement

Type of error Related error code Error value Failure within Flash Test execution state FLSTST_ E_ STATE_ FAILURE 0x01 API parameter out of specified range FLSTST_ E_ PARAM_ INVALID 0x02 API service used without module initialization FLSTST_ E_ UNINIT 0x03 Flash Test module is already initialized FLSTST_ E_ ALREADY_ INITIALIZED 0x04 For Variant PB: Configuration pointer is a NULL pointer. For Variant PC: Configuration pointer is NOT a NULL pointer. FLSTST_ E_ INIT_ FAILED 0x05 Pointer is a NULL pointer FLSTST_ E_ PARAM_ POINTER 0x06

SWS_FlsTst_00011 requirement

The function FlsTst_Init shall be called first before calling any other Flash Test functions except the function FlsTst_GetCurrentState . If this sequence is not respected, the error code FLSTST_E_UNINIT shall be reported to the Default Error Tracer (if development error detection is enabled).

SWS_FlsTst_00016 requirement

Module Header File Imported Type Dem Rte_ Dem_ Type.h Dem _ Event Id Type Rte_ Dem_ Type.h Dem _ Event Status Type Std Std_ Types.h Std _ Return Type Std_ Types.h Std _ Version Info Type

SWS_FlsTst_00028 requirement

[SWS_FlsTst_00028] Upstream requirements: SRS_SPAL_12163 ⌈The function FlsTst_DeInit shall de-initialize all Flash Test relevant registers and global variables that were initialized by FlsTst_Init.⌋

SWS_FlsTst_00029 requirement

[SWS_FlsTst_00029] ⌈The function FlsTst_DeInit shall set the Flash Test module state to FLSTST_UNINIT.⌋

SWS_FlsTst_00033 requirement

[SWS_FlsTst_00033] Upstream requirements: SRS_BSW_00323, SRS_BSW_00386, SRS_SPAL_12448, SRS_ FlsTst_14219 ⌈If development error detection is enabled and the parameter FgndBlockId is out of range, the DET error value FLSTST_E_PARAM_INVALID shall be raised and the func- tion shall return without any action with return value E_NOT_OK.⌋

SWS_FlsTst_00050 requirement

[SWS_FlsTst_00050] Upstream requirements: SRS_FlsTst_14219 ⌈The function FlsTst_StartFgnd is only applicable for Foreground mode Flash Test operation.⌋

SWS_FlsTst_00051 requirement

[SWS_FlsTst_00051] Upstream requirements: SRS_FlsTst_14219 ⌈The function FlsTst_StartFgnd shall be pre compile time configurable On/Off by the configuration parameter: FlsTst_StartFgndApi.⌋

SWS_FlsTst_00061 requirement

[SWS_FlsTst_00061] Upstream requirements: SRS_FlsTst_14223 ⌈The function FlsTst_GetErrorDetails shall return the error details monitored from the Flash Test driver.⌋

SWS_FlsTst_00062 requirement

[SWS_FlsTst_00062] Upstream requirements: SRS_BSW_00386, SRS_FlsTst_14223 ⌈The function FlsTst_GetErrorDetails shall be pre compile time configurable On/Off by the configuration parameter: FlsTst_GetErrorDetailsApi.⌋

SWS_FlsTst_00064 requirement

[SWS_FlsTst_00064] Upstream requirements: SRS_FlsTst_14224 ⌈The function FlsTst_TestEcc shall execute a test of the ECC circuitry.⌋

SWS_FlsTst_00065 requirement

[SWS_FlsTst_00065] Upstream requirements: SRS_BSW_00386, SRS_FlsTst_14224 ⌈The function FlsTst_TestEcc shall be pre compile time configurable On/Off by the configuration parameter: FlsTst_TestEccApi.⌋

SWS_FlsTst_00072 requirement

Dem _ Set - Event Status Dem.h Called by SW - Cs or BSW modules to report monitor status information to the Dem. BSW modules calling Dem_ Set Event Status can safely ignore the return value. This API will be available only if ({Dem/ Dem Config Set/ Dem Event Parameter/ Dem Event Reporting Type} == STANDARD_ REPORTING)

SWS_FlsTst_00073 requirement

Det _ Report Error Det.h Service to report development errors.

SWS_FlsTst_00074 requirement

[SWS_FlsTst_00074] Upstream requirements: SRS_FlsTst_14212 ⌈The callback notifications shall be configurable as function pointers within the initial- ization data structure (FlsTst_ConfigType).⌋

SWS_FlsTst_00075 requirement

[SWS_FlsTst_00075] Upstream requirements: SRS_FlsTst_14212 ⌈The callback notifications shall have no parameters and no return value.⌋

SWS_FlsTst_00076 requirement

[SWS_FlsTst_00076] Upstream requirements: SRS_FlsTst_14212 ⌈If a callback notification is configured as null pointer, the Flash Test module shall not execute the callback.⌋

SWS_FlsTst_00140 requirement

[SWS_FlsTst_00140] ⌈The length of a partial test is defined by the number of tested cells, which shall be tested in one scheduled task. (see [ECUC_FlsTst_00161]). The required time for a partial test without interruption is defined as "T est time". ⌋ Note: The partial test can be interrupted by a higher priority task at any time, because the Flash test does not require atomic sequences. It is the responsibility of the user to ensure that the interruptible partial test is finished before the scheduler interval is started(See Figure 7.2). [SWS_FlsTst_00142] ⌈A background test shall be aborted or suspended via the API services FlsTst_Abort() or FlsTst_Suspended(). The maximum latency time until the API call request is processed, shall be configurable (see [ECUC_FlsTst_00120]). ⌋ est

SWS_FlsTst_00142 requirement

[SWS_FlsTst_00142] ⌈A background test shall be aborted or suspended via the API services FlsTst_Abort() or FlsTst_Suspended(). The maximum latency time until the API call request is processed, shall be configurable (see [ECUC_FlsTst_00120]). ⌋ est

SWS_FlsTst_00143 requirement

[SWS_FlsTst_00143] Upstream requirements: SRS_FlsTst_14219 ⌈Foreground tests are defined as synchronous tests which shall not be interrupted. The execution of Foreground tests is configurable (see [ECUC_FlsTst_00086]) and can be called after module initialization at any time. ⌋

SWS_FlsTst_00156 requirement

Figure 7.1: Background Test: Test Interval [SWS_FlsTst_00140] ⌈The length of a partial test is defined by the number of tested cells, which shall be tested in one scheduled task. (see [ECUC_FlsTst_00161]). The required time for a partial test without interruption is defined as "T est time". ⌋ Note: The partial test can be interrupted by a higher priority task at any time, because the Flash test does not require atomic sequences. It is the responsibility of the user to ensure that the interruptible partial test is finished before the scheduler interval is started(See Figure 7.2). [SWS_FlsTst_00142] ⌈A background test shall be aborted or suspended via the API services FlsTst_Abort() or FlsTst_Suspended(). The maximum latency time until the API call request is processed, shall be configurable (see [ECUC_FlsTst_00120]). ⌋ est

SWS_FlsTst_00167 requirement

When FlsTstTestResultSignature is disabled, the function FlsTst_MainFunction shall set the overall r esult status for a test interval to FLSTST_RESULT_NOT_OK if at least one block test result is not ok regardless whether all blocks are already tested or not. Additionally the DEM FLSTST_E_FLSTST_FAILURE shall be triggered with the detection criteria "Fail" .

SWS_FlsTst_00168 requirement

: Failure detection in back ground mode Long Description: This Extended Production Error shall be issued in case a failure is detected in background mode within a test interval. Detection Criteria: Fail At least one block within a test interval in background mode is NOT OK (see SWS _FlsTst_00167 ) Pass All blocks within a test interval in background mode are tested with the result OK.(see SWS_FlsTst_00161) Secondary Parameters: N/A Time Required : N/A Monitor Frequency continuous