RAM Test (RamTst)

Service for RAM Test initialization.

Service for stopping the RAM Test.

Service for allowing to continue the background RAM Test at the point is was suspended.

Service returns the current RAM Test execution status.

Service returns the current RAM Test result.

Service returns the current RAM Test result for the specified block.

Service used to set the test algorithm and its parameter set.

Service returns the current RAM Test algorithm.

Service changes the current number of tested cells.

Service returns the current number of tested cells per main - function cycle.

Service returns the version information of this module.

Scheduled function for executing the RAM Test in the background.

The function Ram Tst_ Test Completed shall be called every time when all RAM blocks of the current test configuration have been tested in the background.

The function Ram Tst_ Error shall be called every time when a RAM failure has been detected by the selected test algorithm in the background.

Service for RAM Test deinitialization.

Service for continuing the RAM Test after calling 'Ram Tst_ Stop.

Service for suspending current operation of background RAM Test, until RESUME is called.

Service returns the ID of the current RAM Test algorithm parameter set.

Service for executing the full RAM Test in the foreground.

Service for testing one RAM block in the foreground.

Data type of number of tested RAM cells

Data type used to identify or count RAM blocks given in the test configuration parameters.

This is a status value returned by the API service Ram Tst_ Get Execution Status().

This is a status value returned by the API service Ram Tst_ Get Test Result().

Data type used to identify a set of configuration parameters for a test algorithm.

This is a value returned by the API service Ram Tst_ Get Test Algorithm().

Configuration data structure of the Ram Tst module.

During the execution of a RAM test algorithm, no other software shall be allowed to modify the RAM area under test.

The RAM Test module shall provide the background RAM test as an asynchronous service.

For the type RamTst_ExecutionStatusType , the enumeration value RAMTST_EXECUTION_UNINIT shall be the default value after a reset.

The function RamTst_Init shall initialize all RAM Test relevant registers and global variables and change the execution status to RAMTST_EXECUTI ON_STOPPED . The test is initialized to use the default test parameter set ( RamTstDefaultAlgParamsId ) as configured by its RamTstAlgParams container.

If the RAM Test execution status is RAMTST_EXECUTION_RUNNING, the function RamTst_MainFunction shall continue to test the RAM blocks defined in the selected RamTstAlgParams .

If the RAM Test execution status is RAMT ST_EXECUTION_RUNNING and i f no blocks have yet been tested (first call of the fun c tion), then the function RamTst_MainFunction shall start testing with the first configured RAM block in the selected RamTstAlgP a rams .

The function RamTst_MainFunction shall update the overall test result status according to SWS_RamTst_00202 . If at least one block test result is RAMTST_RESULT_NOT_OK , then the function shall report the production error RAMTST_MAIN _RAM_FAILURE to the DEM.

For the type RamTst_TestRe sultType ( of the overall test result), the enumeration value RAMTST_RESULT_NOT_TESTED shall be the default value after a reset.

For the type RamTst_AlgorithmType , the enumeration value RAMTST_ALGORITHM_UNDEFINED shall be the default value after reset.

When the RamTst_Stop function is called, RamTst_MainFunction shall still finish the current atomic sequence (if it is executing), and afterward the status shall be set to RAMTST_EX ECUTION_STOPPED . The test result is retained, but test parameters and loop data are not.

The function RamTst_Resume shall permit the RamTst_MainFunction to continue testing at the point where it was suspended, at its next scheduled call. Testing continues according to the saved test states. The function RamTst_Resume shall change the execution status to RAMTST_ EXECUTION _RUNNING if it has been RAMTST_ EXECUTION _ SUSPENDED .

The function RamTst_GetExecutionStatus shall re turn the current RAM Test execution status.

The function RamTst_GetTestAlgorithm shall return the current RAM Test algorithm.

The function RamTst_GetTestResult shall return the current RAM test result.

Within the configuration data for the RAM Test module, there shall be a set of configuration containers named RamTstAlgParams. Each one defines a possible test parameter set to be selected at runtime, which includes an algorithm. The algorithms included in RamTstAlgParams are restricted to those that were pre - compile selecte d to be available to the user via the container RamTstAlgorithms.

Within the configuration data for the RAM Test module, each parameter set of type RamTstAlgParams (as required in SWS_RamTst_00026 ) shall also have memory block configuration containers. The memory block configuration container is defined in RamTstBlockParams . The number of memory block configuration containers is defined by the integrator accordi ng to the RAM test strategy.

If the DET is enabled and the executio n status of the RAM Test is not RAMTST_EXECUTION_RUNNING or RAMTST_EXECUTION_SUSPENDED, the function RamTst_Stop shall report the error value RAMTST_E_STATUS_FAILURE to the DET, and then immediately return.

The function RamTst_GetNumberofTestedCells shall read the current number of tested cells per cycle.

The function RamTst_ChangeNumberOfTestedCells shall change the current number of tested cells (for background tests).

If DET is enabled and the execution status of the RAM Test module is not RAMTST_EXECUTION_SUSPENDED , the function RamTst_Resume shall report the error value RAMTST_E_STATUS_FAILURE to the DET, and then immediately return.

The function RamTst_GetTestResultPerBlock shall return the current RAM test result for the specified block.

If DET is enabled and the BlockID is out of range, the function RamTst_GetTestResultPerBlock shall report the error value RAMTST_E_OUT_OF_RANGE to the DET and return the test result value RAMTST_RESULT_UNDEFINED .

If DET is enabled and the parameter NewNumberOfTestedCells is out of range

The callback notifications shall have no parameters and no return value.

If a callback notification is configured as null pointer, the RAM Test module shall not execute the callbac k.

The RAM Test module shall call t he callback RamTst_TestCompletedNotification every time when it has tested all RAM blocks of the selected parameter set in a background test.

The RAM test module shall call the callback RamTst_Erro rNotification every time when the test algorithm of the selected parameter set has detected a RAM failure in a background test.

After the function Ram Tst_MainFunction has completed testing all RAM blocks configured in the selected RamTstAlgParams , the next call of the function RamTst_MainFunction shall restart the test from the beginning.

The typ e RamTst_AlgorithmType shall contain only the enumerations of the algorithms selected at pre - compile time.

The function RamTst_MainFunction shall test the defined number of RAM cells within one call. The defined number is specified by the function RamTst_ChangeNumberOfTestedCells or by initialization.

If non - destructive RAM Test is c hosen, the RAM Test module shall save the RAM area to be tested before the module modifies it. The RAM Test module shall execute the complete procedure (saving, changing, restoring) without interruption.

For both the destructive an d non - destructive options, the RAM Test module shall ensure that the test algorithm does not overwrite the RAM Test internal variables.

After writing to a cell and before reading back, the RAM Te st module shall provide the possibility to inject instruction(s) forcing the controller to clear its CPU internal cache.

The configuration process for t he RAM Test module shall allow the selection of a subset of different RAM Test algorithms during pre - compile time.

Type of error Related error code Error value A particular API is called in an unexpected state (see also: SWS_ RAMTST_00033, SWS_ RAMTST_00037, SWS_ RAMTST_00095, SWS_ RAMTST_00097, SWS_ Ram Tst_00170, SWS_ Ram Tst_00172, SWS_ Ram Tst_00210, SWS_ Ram Tst_00214) RAMTST_ E_ STATUS_ FAILURE 0x01 API pa rameter out of specified range (see also: SWS_ RAMTST_00039, SWS_ RAMTST_00040, SWS_ RAMTST_00084, SWS_ Ram Tst_00223) RAMTST_ E_ OUT_ OF_ RANGE 0x02 API service used without module initialization (see also: SWS_ RAMTST_00089) RAMTST_ E_ UNINIT 0x03 API service called with a NULL pointer (see also: SWS_ Ram Tst_00222) RAMTST_ E_ PARAM_ POINTER 0x04

Additional errors that are detected because of specific implementation and/or specific hardware properties sh all be added in the RAM Test device specific implementation specification. The classification and enumeration shall be compatible to the errors listed above in SWS_RamTst_00067 .

Production err ors shall be reported to Diagnostic Event Manager (DEM) via the Dem_SetEventStatus API.

The implementer shall provide measured or calculated runtime infor mation in the documentation of the module for each algorithm implementation. The i n formation is to be presented as s hown in the following table, specifying whether the parameters are measured or calculated.

The implementer shall provide integration hints for each algorithm, e.g. “do not use in pa r allel with a DMA”.

The function RamTst_SelectAlgPara ms shall select the test parameter set (i.e. one of the RamTstAlgParams in the container RamTstConfigParams ) to be used by the RAM Test module.

If DET is enabled and the parameter “ NewAlgParamsId ” is out of range, the function RamTst_SelectAlgParams shall report the error value RAMTST_E_OUT_ OF_RANGE to the DET, leaving the current RamTstAlgParams unchanged.

The function RamTst_SelectAlgParams shall re - initialize all RAM Test relevant registers and global variables with the values for the “ NewAlgParamsId ” .

The function RamTst_Init shall be called first before calling any other RAM test functions. If this sequence is not respected, the error code RAMTS T_E_UNINIT shall be reported to the Default Error Tracer (if development error detection is e n abled).

Init functions shall have a pointer to a configuration structure as single parameter . This means that, in accordance with SRS_BSW_00414 only one interface fo r initialization shall be implemented and it shall not depend on the modules configuration which interface the calling software module shall use.

The function RamTst_SelectAlgParams shall initialize the test result status (according to SWS_RamTst_00207 and SWS_RamTst_00202 ).

If the execution status of the RAM Test module is not in the status RAMTST_EXECUTION_STOPPED , the function RamTst_ChangeNumberOfTestedCells shall not change the curr ent number of tested cells and (if DET is enabled) shall report the error value RAMTST_E_STATUS_FAILURE to the DET.

If the DET is enabled and the execution status of t he RAM Test is not RAMTST_EXECUTION_UNINIT , the function RamTst_Init shall report the error value RAMTST_E_STATUS_FAILURE to the DET, and then immediately return.

If DET is enabled and the execution status of the RAM Test module is not RAMTST_EXECUTION_STOPPED , the function RamTst_SelectAlgParams shall report the error value RAMTST_E_STATUS_FAILURE to the DET, t hen immediately return from the function.

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

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)

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

The function RamTst_DeInit shall deinitialize all RAM Test relevant registers and globa l variables that were initialized by RamTst_Init and change the execution status to RAMTST_EXECUTION_UNINIT .

After a RamTst_Stop call, RamTst_MainFunction shall not begin testing again when called by the scheduler until after a RamTst_Allow call.

The function RamTst_Allow shall permit the RamTst_MainFunction to perform testing at its next scheduled call, if it had been stopped. Therefore, it shall change the execution status to RAMTST_EXECUTION_RUNNING , if it has been RAMTST_ EXECUTION _STOPPED. The test shall be continued with the default test parameter set ( RamTstDefaultAlgParamsId ) as configured by its RamTstAlgParams container.

If DET is enabled and the execution status is not RAMTST_EXECUTION_ STOPPED , the function RamTst _Allow shall report the error value RAMTST_E_STATUS_FAILURE to the DET, and then immediately return.

The function RamTst_Suspend shall temporarily prohibit the RamTst_MainFunction from performing tests at its next schedul ed call. When RamTst_Suspend is called and the execution status is RAMTST_ EXECUTION _RUNNING , testing stops after the current atomic sequence, test result and current test states are retained and t he execution status is changed to RAMTST_ EXECUTION _SUSPEN DED.

If DET is enabled and the execution status is not RAMTST_EXECUTION_ RUNNING , the function RamTst_Suspend shall report the error value RAMTST_E_STATUS_FAILURE to the DET, and then immediately return.

If the RA M Test execution status is not RAMTST_EXECUTION_RUNNING when this API is called, the function RamTst_MainFunction shall return immediately without any actions.

For the type RamTst_AlgParamsIdType , the value 0 shall indicate, that no test parameters (and thus no test algorithm) is select ed. This shall be the default value of the corresponding variable after reset.

The function RamTst_GetAlgParams shall return the ID of the currently selected test algorithm parameter set (i.e. the ID of the currently sele cted RamTstAlgParams in the container RamTstConfigParams ).

If the RAM Test execution status is RAMTST_EXECUTION_STOPPED or RAMTST_EXECUTION_SUSPENDED , t he function RamTst_RunPartialTest shall test the specified RAM block .

If the configuration parameter RamTstTestPolicy for a block is set to RAMTEST_NON_DESTRUCTIVE , the test algorithm shal l restore the original memory content of the tested cells of this block after the test (given that no error is d e tected).

If the configuration parameter RamTstTestPolicy for a block is set to RAMTEST_DESTRUCTIVE , the test algorithm sh all fill the tested cells after the test with the bit pattern defined for this block by parameter RamTst_FillPattern (given that no error is d e tected).

The overal l test result – for the set of blocks in the current RamTstAlgParams – shall be  RAMTST_RESULT_NOT_TESTED if no test was started yet (after reset or de - init).  RAMTST_RESULT_UNDEFINED if a test was started, not all blocks have yet been tested and no block r esult is RAMTST_RESULT_NOT_OK.  RAMTST_RESULT_OK if all blocks have been tested with result status RAMTST_RESULT_OK .  RAMTST_RESULT_NOT_OK if at least one block test result is RAMTST_RESULT_NOT_OK regardless whether all blocks have been already tested or no t.

The implementer shall document possible restrictions for the combination of configuration parameters and for their usage in bac k ground/foreground tests. Where applicable, he shall support this by the definitio n of predefined or re c ommended configuration parameter values attached to the BSW Module Description.

U nless covered by some hardware mechanism the RAM Test module shall provide a test algorithm , the RAM Test module may provide additional vendor or hardware specific test algorithms or different variants of the algorithms listed above. These algorithms must be clearly documented by the impleme n ter, especially their fault coverage (for vendor specific configuration parameters see SWS_RamTst_00205 ).

If an implementation of the RAM Test modul e supports vendor specific test algorithms or other additional configuration parameters, the implementer shall provide a formal vendor - specific definition of these parameters including their doc u mentation (as part of the BSW Module Description).

The RAM Test module shall provide the foreground RAM test as an synchronous service.

The test result for a specific block (identified in the given RamTstA l gParams) – shall be  RAMTST_RESULT_NOT_TESTED if this block is considered as not yet tested.  RAMTST_RESULT_UNDEFINED if a test on this block is ru n ning.  RAMTS T_RESULT_OK if all memory cells in this block have been tested sucessfully.  RAMTST_RESULT_NOT_OK if a failure has been detected for at least one memory cell in this block.

If DET is enabled and the execution status of the RAM Test module is not RAMTST_EXECUTION_STOPPED , the function RamTst_RunFullTest shall report the error value RAMTST_E_STATUS_FAILURE to the DET, and then imm ediately return.

If the RAM Test execution status is RAMTST_EXECUTION_STOPPED , the function RamTst_RunFullTest shall set the execution status to RAMTST_EXECUTION_RUNNING during the test and set it back to RAMTST_EXECU TION_STOPPED before returning.

The function RamTst_RunFullTest shall update the test result status of single blocks according to SWS_RamTst_00207 .

The function RamTst _RunFullTest shall update the overall test result status according to SWS_RamTst_00202 . If at least one block test result is RAMTST_RESULT_NOT_OK , then the function shall report the production error RAMTST_RUNFL_RAM_FA ILURE to the DEM.

If DET is enabled and the RAM test execution status is ne i ther RAMTST_EXECUTION_STOPPED nor RAMTST_EXECUTION_SUSPENDED , the function RamTst_RunPartialTest shall report the error value RAMTST_E_STATUS_FAILURE to the DET, and then immediately return.

If the RAM Test execution status is RAMTST_EXECUTION_STOPPED or RAMTST_EXECUTION_SUSPENDED , the function RamTst_RunPartialTest shall set the execution status to RAMTST_EXECUTION_RUNNING during the test, and af ter the test shall set it back to the previous state (the state when the function was called) .

The function RamTst_RunPartialTest shall update the test result status of the tested block according to SWS_RamTst_00207 . If this block test result is RAMTST_RESULT_NOT_OK , then the function shall report the production error RAMTST_ PART _RAM_FAILURE to the DEM.

A successful partial foreground test shall set the bl ock specific result to RAMTST_RESULT_OK. It shall not modify the overall test result. A failing partial foreground test shall set both, the block specific as well as the overall test result to RAMTST_RESULT_NOT_OK.

and the implementation must follow the general r e quirements for interrupt handling (see SRS_BSW_00427, SRS_SPAL_12129, SRS_BSW_00325, SRS_BSW_00439, SRS_BSW_00314).

[SWS_RamTst_00222] ⌈If the function RamTst_GetVersionInfo is called with a NULL pointer as parameter, it shall return immediately without any further action, and If DET is enabled, this function shall report the error value RAMTST_E_PARAM_POINTER to the DET module.⌋ The RamTst_GetVersionInfo API can be enabled or disabled by the configuration parameter RamTstVersionInfoApi within the container RamTstCommon.

If DET is enabl ed and the BlockId is out of range, the function RamTst_RunPartialTest shall report the error value RAMTST_E_OUT_OF_RANGE to the DET and then immediately return.

Unless covered by some hardware mechanism the RAM Test module shall provide a test algorithm with low coverage as stated in [11] , Table D.1.

Unless covered by some hardware mechanism the RAM Test module shall provide a test algorithm with medium coverage a s stated in [11] , Table D.1.

Unless covered by some hardware mechanism the RAM Test module shall provide a test algorithm with high coverage as stated in [11] , Table D.1.

These requirements are not applicable to this specific a tion.

: RAM failure during test. Long Description: The function RamTst_MainFunction shall update the overall test result status and error is updated based on the current status of RamTstAlgParams. See: SWS_RAMTST_00011 Det ection Criteria: Fail If test result of at least one block is RAMTST_RESULT_NOT_OK. See SWS_RamTst_01003 Pass If test result of all the blocks is RAMTST_RESULT_OK. See SWS_RamTst_ 01004 Secondary Parameters: RamTst_MainFunction() tests memory blocks at its next scheduled call. In case of successful test result report Pass. In case of an error always report Fail. Time Required: If any block test results RAMTST_RESULT_NOT_OK, it sh all be immediately reported as error. Monitor Frequency continuous

RAM test for RamTst_MainFunction function shall Fail if test result of at least one block is RAMTST_RESULT_NOT_OK.

RAM test for RamTst_MainFunction function shall Pass if test r esult of all the blocks is RAMTST_RESULT_OK.

The RAM Test shall detect extended production error for RamTst_ RunFullTest function as described below: Error Name: RAMTST_RUNFL_RAM_FAILURE Short Description: RAM failure during test. Long Description: The function RamTst_RunFullTest shall update the overall test result status and error is updated based on the current status of RamTstAlgParams. See: SWS_RAMTST_00213 Detection Criteria: Fail If tes t result of at least one block is RAMTST_RESULT_NOT_OK. See SWS_RamTst_01006 Pass If test result of all the blocks is RAMTST_RESULT_OK. See SWS_RamTst_01007 Secondary Parameters : RamTst_RunFullTest() tests entire RAM space without any interruption. In case of successful test result report Pass. In case of an error always report Fail. Time Required: If any block test results RAMTST_RESULT_NOT_OK, it shall be immediately reported as error. Monitor Frequency once - per - trip

RAM Test for RamTst_ RunFullTest function shall Fail if test result of at least one block is RAMTST_RESULT_NOT_OK.

RAM Test for RamTst_ RunFullTest function shall Pass If test re sult of all the blocks is RAMTST_RESULT_OK.

The RAM Test shall detect extended production error for RamTst_ RunPartialTest function as described below: Error Name: RAMTST_PART_RAM_FAILURE Short Description: RAM failure during test. Long Description: The function RamTst_RunPartialTest shall update the test result status of the tested block and error is updated based on the current status of RamTstAlgParams. See: SWS_RAMTST_00216 Detection Crite ria: Fail If test result of at least one block is RAMTST_RESULT_NOT_OK. See SWS_RamTst_01009 Pass If test result of all the blocks is RAMTST_RESULT_OK. See SWS_RamTst_01010 Seco ndary Parameters: RamTst_RunPartialTest() tests portion of the RAM. In case of successful test result report Pass. In case of an error always report Fail. Time Required: If any block test results RAMTST_RESULT_NOT_OK, it shall be immediately reported as e rror. Monitor Frequency once - per - trip

RAM Test for RamTst_ RunPartialTest function function shall Fail if test result of at least one block is RAMTST_RESULT_NOT_OK.

RAM Test for RamTst_ RunPartialTest function functi on shall Pass If test result of all the blocks is RAMTST_RESULT_OK.

The Configuration pointer ConfigPtr shall always have a NULL_PTR value .

The RAM Test module shall reject configurations with partition mappings which are not supported by the implementation.

The ECUC partitions referenced by RamTstBlockParamsEcucPartitionRef shall be a subset of the ECUC partitions referenced by RamTstEcucPartitionRef.

If RamTstEcucPartitionRef references one or more ECUC partitions, RamTstBlockParamsEcucPartitionRef shall have a multiplicity of one and reference one of these ECUC partitions as well.