AUTOSAR Classic Memory Services
Die Memory Services verwalten nicht-flüchtige Datenblöcke (NvM), abstrahieren Flash- und EEPROM-Technologien (MemIf, Fee, Ea) und gewährleisten Datenkonsistenz und Datensicherheit über ECU-Abschaltzyklen hinweg.
خريطة المواضيع
BndM
9Ea
16Eep
16Fee
16Fls
17FlsTst
25Mem
20MemAcc
54MemIf
12NvM
36RamTst
27لا توجد بيانات عناصر لهذا الإصدار
BndM
Initializes or reinitializes this module.
void BndM_Init(const BndM_ConfigType* ConfigPtr);This callback function is called when a FLS job has been finished with positive result.
void BndM_JobEndNotification(void);This callback function is called when a FLS job has been canceled or finished with negative result.
void BndM_JobErrorNotification(void);Schedule function for the background processing.
void BndM_MainFunction(void);Cancels the writing
void BndM_WriteCancel(void);Unique identification of an bulk nv block. The BndM_BlockId is assigned by the BndM.
The elements of this structure data type is the C-structured representation of the configured ImplementationDataPrototype.
This type of the external data structure shall contain the post build initialization data for the BndM.
Result of the asynchronous job finish notifications
Ea
Cancels the ongoing asynchronous operation.
void Ea_Cancel (void);Erases the block Block Number.
Std_ReturnType Ea_EraseImmediateBlock (uint16 BlockNumber);Service to return the Job Result.
MemIf_JobResultType Ea_GetJobResult (void);Service to return the Status.
MemIf_StatusType Ea_GetStatus (void);Service to get the version information of this module.
void Ea_GetVersionInfo (Std_VersionInfoType* VersionInfoPtr);Initializes the EEPROM abstraction module.
void Ea_Init (const Ea_ConfigType* ConfigPtr);Invalidates the block Block Number.
Std_ReturnType Ea_InvalidateBlock (uint16 BlockNumber);Service to report to this module the successful end of an asynchronous operation.
void Ea_JobEndNotification (void);Service to report to this module the failure of an asynchronous operation.
void Ea_JobErrorNotification (void);Service to handle the requested jobs and the internal management operations.
void Ea_MainFunction (void);Reads Length bytes of block Blocknumber at offset Block Offset into the buffer Data Buffer Ptr.
Std_ReturnType Ea_Read (uint16 BlockNumber, uint16 BlockOffset, uint8* DataBufferPtr, uint16 Length);Function to switch the mode of the underlying EEPROM Driver
void Ea_SetMode (MemIf_ModeType Mode);Writes the contents of the Data Buffer Ptr to the block Block Number.
Std_ReturnType Ea_Write (uint16 BlockNumber, const uint8* DataBufferPtr);Function to be used by the underlying memory abstraction to signal end of job without error.
void NvM_JobEndNotification (void);Function to be used by the underlying memory abstraction to signal end of job with error.
void NvM_JobErrorNotification (void);Configuration data structure of the Ea module.
Eep
Cancels a running job.
void Eep_Cancel(void);Compares a data block in EEPROM with an EEPROM block in the memory.
Std_ReturnType Eep_Compare(Eep_AddressType EepromAddress, const uint8* DataBufferPtr, Eep_LengthType Length);Service for erasing EEPROM sections.
Std_ReturnType Eep_Erase(Eep_AddressType EepromAddress, Eep_LengthType Length);This service returns the result of the last job.
MemIf_JobResultType Eep_GetJobResult(void);Returns the EEPROM status.
MemIf_StatusType Eep_GetStatus(void);Service to get the version information of this module.
void Eep_GetVersionInfo(Std_VersionInfoType* versioninfo);Service for EEPROM initialization.
void Eep_Init(const Eep_ConfigType* ConfigPtr);This callback function provided by the module user is called when a job has been completed with a positive result.
void Eep_JobEndNotification(void);This callback function provided by the module user is called when a job has been canceled or finished with negative result.
void Eep_JobErrorNotification(void);Service to perform the processing of the EEPROM jobs (read/write/erase/compare) .
void Eep_MainFunction(void);Reads from EEPROM.
Std_ReturnType Eep_Read(Eep_AddressType EepromAddress, uint8* DataBufferPtr, Eep_LengthType Length);Sets the mode.
void Eep_SetMode(MemIf_ModeType Mode);Writes to EEPROM.
Std_ReturnType Eep_Write(Eep_AddressType EepromAddress, const uint8* DataBufferPtr, Eep_LengthType Length);Used as address offset from the configured EEPROM base address to access a certain EEPROM memory area.
This is the type of the external data structure containing the initialization data for the EEPROM driver.
Specifies the number of bytes to read/write/erase/compare.
Fee
Service to call the cancel function of the underlying flash driver.
void Fee_Cancel (void);Service to erase a logical block.
Std_ReturnType Fee_EraseImmediateBlock (uint16 BlockNumber);Service to query the result of the last accepted job issued by the upper layer software.
MemIf_JobResultType Fee_GetJobResult (void);Service to return the status. AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_FlashEEPROMEmulation
MemIf_StatusType Fee_GetStatus (void);Service to return the version information of the FEE module.
void Fee_GetVersionInfo (Std_VersionInfoType* VersionInfoPtr);Service to initialize the FEE module.
void Fee_Init (const Fee_ConfigType* ConfigPtr);Service to invalidate a logical block.
Std_ReturnType Fee_InvalidateBlock (uint16 BlockNumber);Service to report to this module the successful end of an asynchronous operation. AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_FlashEEPROMEmulation
void Fee_JobEndNotification (void);Service to report to this module the failure of an asynchronous operation.
void Fee_JobErrorNotification (void);Service to handle the requested read / write / erase jobs and the internal management operations.
void Fee_MainFunction (void);Service to initiate a read job.
Std_ReturnType Fee_Read (uint16 BlockNumber, uint16 BlockOffset, uint8* DataBufferPtr, uint16 Length);Function to switch the mode of the underlying Flash Driver
void Fee_SetMode (MemIf_ModeType Mode);Service to initiate a write job.
Std_ReturnType Fee_Write (uint16 BlockNumber, const uint8* DataBufferPtr);-
void NvM_JobEndNotification (void);-
void NvM_JobErrorNotification (void);Configuration data structure of the Fee module.
Fls
This callback function is called when a job has been completed with a positive result.
void Fee_JobEndNotification(void);This callback function is called when a job has been canceled or finished with negative result.
void Fee_JobErrorNotification(void);The function Fls_BlankCheck shall verify, whether a given memory area has been erased but not (yet) programmed. The function shall limit the maximum number of checked flash cells per main function cycle to the configured value FlsMaxReadNormalMode or FlsMaxReadFastMode respectively.
Std_ReturnType Fls_BlankCheck(Fls_AddressType TargetAddress, Fls_LengthType Length);Cancels an ongoing job.
void Fls_Cancel(void);Compares the contents of an area of flash memory with that of an application data buffer.
Std_ReturnType Fls_Compare(Fls_AddressType SourceAddress, const uint8* TargetAddressPtr, Fls_LengthType Length);Erases flash sector(s).
Std_ReturnType Fls_Erase(Fls_AddressType TargetAddress, Fls_LengthType Length);Returns the result of the last job.
MemIf_JobResultType Fls_GetJobResult(void);Returns the driver state.
MemIf_StatusType Fls_GetStatus(void);Returns the version information of this module.
void Fls_GetVersionInfo(Std_VersionInfoType* VersioninfoPtr);Initializes the Flash Driver.
void Fls_Init(const Fls_ConfigType* ConfigPtr);Performs the processing of jobs.
void Fls_MainFunction(void);Reads from flash memory.
Std_ReturnType Fls_Read(Fls_AddressType SourceAddress, uint8* TargetAddressPtr, Fls_LengthType Length);Sets the flash driver's operation mode.
void Fls_SetMode(MemIf_ModeType Mode);Writes one or more complete flash pages.
Std_ReturnType Fls_Write(Fls_AddressType TargetAddress, const uint8* SourceAddressPtr, Fls_LengthType Length);Used as address offset from the configured flash base address to access a certain flash memory area.
A pointer to such a structure is provided to the flash driver initialization routine for configuration of the driver and flash memory hardware.
Specifies the number of bytes to read/write/erase/compare.
FlsTst
Service for aborting the Flash Test.
void FlsTst_Abort(void);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 executing the Flash Test in background mode.
void FlsTst_MainFunction(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);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
Mem
Triggers a job to check the erased state of the page which is referenced by targetAddress. The result of this service can be retrieved using the Mem_GetJobResult API. If the checked page is blank, the result of the job is MEM_JOB_OK. Otherwise, if the page is not blank, the result is MEM_INCONSISTENT.
Std_ReturnType Mem_BlankCheck(Mem_InstanceIdType instanceId, Mem_AddressType targetAddress, Mem_LengthType length);De-initialize module. If there is still an access job pending, it is immediately terminated (using hardware cancel operation) and the Mem driver module state is set to unitialized. Therefore, Mem must be re-initialized before it will accept any new job requests after this service is processed.
void Mem_DeInit(void);Triggers an erase job of the given sector/sector batch defined by targetAddress and length. The result of this service can be retrieved using the Mem_GetJobResult API. If the erase operation was successful, the result of the job is MEM_JOB_OK. If the erase operation failed, e.g. due to a hardware issue, the result of the job is MEM_JOB_FAILED.
Std_ReturnType Mem_Erase(Mem_InstanceIdType instanceId, Mem_AddressType targetAddress, Mem_LengthType length);Service to return results of the most recent job.
Mem_JobResultType Mem_GetJobResult(Mem_InstanceIdType instanceId);Service to return the version information of the Mem module.
void Mem_GetVersionInfo(Std_VersionInfoType* versionInfoPtr);Triggers a hardware specific memory driver job. dataPtr can be used to pass and return data to/ from this service. This service is just a dispatcher to the hardware specific service implementation referenced by hwServiceId. The result of this service can be retrieved using the Mem_GetJobResult API. If the hardware specific operation was successful, the result of the job is MEM_JOB_OK. If the hardware specific operation failed, the result of the job is MEM_JOB_ FAILED. Tags: atp.Status=draft
Std_ReturnType Mem_HwSpecificService(Mem_InstanceIdType instanceId, Mem_HwServiceIdType hwServiceId, Mem_DataType* dataPtr, Mem_LengthType* lengthPtr);Initialization function - initializes all variables and sets the module state to initialized.
void Mem_Init(const Mem_ConfigType* configPtr);Service to handle the requested jobs and the internal management operations.
void Mem_MainFunction(void);This service can be used to report an access error in case the Mem driver cannot provide the access error information - typically for ECC faults. It is called by the system ECC handler to propagate an ECC error to the memory upper layers..
void Mem_PropagateError(Mem_InstanceIdType instanceId);Triggers a read job to copy the from the source address into the referenced destination data buffer. The result of this service can be retrieved using the Mem_GetJobResult API. If the read operation was successful, the result of the job is MEM_JOB_OK. If the read operation failed, the result of the job is either MEM_JOB_FAILED in case of a general error or MEM_ECC_ CORRECTED/MEM_ECC_UNCORRECTED in case of a correctable/uncorrectable ECC error.
Std_ReturnType Mem_Read(Mem_InstanceIdType instanceId, Mem_AddressType sourceAddress, Mem_DataType* destinationDataPtr, Mem_LengthType length);Resume suspended memory operation using hardware mechanism. Tags: atp.Status=draft
void Mem_Resume(Mem_InstanceIdType instanceId);Suspend active memory operation using hardware mechanism. Tags: atp.Status=draft
void Mem_Suspend(Mem_InstanceIdType instanceId);Triggers a write job to store the passed data to the provided address area with given address and length. The result of this service can be retrieved using the Mem_GetJobResult API. If the write operation was successful, the job result is MEM_JOB_OK. If there was an issue writing the data, the result is MEM_FAILED.
Std_ReturnType Mem_Write(Mem_InstanceIdType instanceId, Mem_AddressType targetAddress, const Mem_DataType* sourceDataPtr, Mem_LengthType length);Physical memory device address type
Postbuild configuration structure type
Read data user buffer type
Hardware specific service request identifier type
Job end notification function called by Mem in case the job processing is configured for job end notification.
Asynchronous job result type
Physical memory device length type
MemAcc
MemAcc application job end notification callback. The function name is configurable. Tags: atp.Status=draft
void <AddressAreaJobEndNotification>(MemAcc_AddressAreaIdType addressAreaId, MemAcc_JobResultType jobResult);Address area lock application callback. The function name is configurable. Tags: atp.Status=draft
void <ApplicationLockNotification>(void);Dynamic activation and initialization of a Mem driver referenced by hwId and headerAddress.
Std_ReturnType MemAcc_ActivateMem(MemAcc_AddressType headerAddress, MemAcc_HwIdType hwId);Checks if the passed address space is blank, i.e. erased and writeable. The result of this service can be retrieved using the MemAcc_GetJobResult API. If the address area defined by targetAddress and length is blank, the result is MEMACC_MEM_OK, otherwise the result is MEMACC_MEM_INCONSISTENT.
Std_ReturnType MemAcc_BlankCheck(MemAcc_AddressAreaIdType addressAreaId, MemAcc_AddressType targetAddress, MemAcc_LengthType length);Triggers a cancel operation of the pending job for the address area referenced by the address AreaId. Cancelling affects only jobs in pending state. For any other states, the request will be ignored.
void MemAcc_Cancel(MemAcc_AddressAreaIdType addressAreaId);Triggers a job to compare the passed data to the memory content of the provided address area. The job terminates, if all bytes matched or a difference was detected. The result of this service can be retrieved using the MemAcc_GetJobResult() API. If the compare operation determined a mismatch, the result code is MEMACC_MEM_INCONSISTENT. Tags: atp.Status=draft
Std_ReturnType MemAcc_Compare(MemAcc_AddressAreaIdType addressAreaId, MemAcc_AddressType sourceAddress, const MemAcc_DataType* dataPtr, MemAcc_LengthType length);Dynamic deactivation of a Mem driver referenced by hwId and headerAddress.
Std_ReturnType MemAcc_DeactivateMem(MemAcc_HwIdType hwId, MemAcc_AddressType headerAddress);Deinitialize module. If there are still access jobs pending, they are immediately terminated and the module state is set to unitialized. Therefore, MemAcc must be re-initialized before it will accept any new job requests after this service is processed.
void MemAcc_DeInit(void);Triggers an erase job of the given area. Triggers an erase job of the given area defined by targetAddress and length. The result of this service can be retrieved using the Mem_GetJobResult API. If the erase operation was successful, the result of the job is MEM_JOB_OK. If the erase operation failed, e.g. due to a hardware issue, the result of the job is MEM_JOB_FAILED.
Std_ReturnType MemAcc_Erase(MemAcc_AddressAreaIdType addressAreaId, MemAcc_AddressType targetAddress, MemAcc_LengthType length);Returns detailed information of the current memory job like memory device ID, job type, job processing state or job result, address area as well as address and length.
void MemAcc_GetJobInfo(MemAcc_AddressAreaIdType addressAreaId, MemAcc_JobInfoType* jobInfoPtr);Returns the consolidated job result of the address area referenced by addressAreaId.
MemAcc_JobResultType MemAcc_GetJobResult(MemAcc_AddressAreaIdType addressAreaId);Returns the status of the MemAcc job referenced by addressAreaId.
MemAcc_JobStatusType MemAcc_GetJobStatus(MemAcc_AddressAreaIdType addressAreaId);This service function retrieves the physical memory device information of a specific address area. It can be used by an upper layer to get all necessary information to align the start address and trim the length for erase/write jobs.
Std_ReturnType MemAcc_GetMemoryInfo(MemAcc_AddressAreaIdType addressAreaId, MemAcc_AddressType address, MemAcc_MemoryInfoType* memoryInfoPtr);Returns the accumulated number of bytes that have already been processed in the current job.
MemAcc_LengthType MemAcc_GetProcessedLength(MemAcc_AddressAreaIdType addressAreaId);Service to return the version information of the MemAcc module.
void MemAcc_GetVersionInfo(Std_VersionInfoType* versionInfoPtr);Triggers a hardware specific job request referenced by hwServiceId. Service specific data can be passed/retrieved by dataPtr. The result of this service can be retrieved using the MemAcc_GetJobResult API. If the hardware specific operation was successful, the result of the job is MEMACC_MEM_OK. If the hardware specific operation failed, the result of the job is MEMACC_MEM_FAILED.
Std_ReturnType MemAcc_HwSpecificService(MemAcc_AddressAreaIdType addressAreaId, MemAcc_HwIdType hwId, MemAcc_MemHwServiceIdType hwServiceId, MemAcc_DataType* dataPtr, MemAcc_LengthType* lengthPtr);Initialization function - initializes all variables and sets the module state to initialized.
void MemAcc_Init(const MemAcc_ConfigType* configPtr);Service to handle the requested jobs and the internal management operations. Depending on the configuration MemAcc will call the Mem driver main functions.
void MemAcc_MainFunction(void);Triggers a read job to copy data from the source address into the referenced destination data buffer. The result of this service can be retrieved using the MemAcc_GetJobResult API. If the read operation was successful, the result of the job is MEMACC_MEM_OK. If the read operation failed, the result of the job is either MEMACC_MEM_FAILED in case of a general error or MEMACC_MEM_ECC_CORRECTED/MEMACC_MEM_ECC_UNCORRECTED in case of a correctable/uncorrectable ECC error.
Std_ReturnType MemAcc_Read(MemAcc_AddressAreaIdType addressAreaId, MemAcc_AddressType sourceAddress, MemAcc_DataType* destinationDataPtr, MemAcc_LengthType length);Release access lock of provided address area. Tags: atp.Status=draft
Std_ReturnType MemAcc_ReleaseLock(MemAcc_AddressAreaIdType addressAreaId, MemAcc_AddressType address, MemAcc_LengthType length);Request lock of an address area for exclusive access. Once the lock is granted, the referenced lock notification function is called by MemAcc.
Std_ReturnType MemAcc_RequestLock(MemAcc_AddressAreaIdType addressAreaId, MemAcc_AddressType address, MemAcc_AddressType length, void* lockNotificationFctPtr);Triggers a write job to store the passed data to the provided address area with given address and length. The result of this service can be retrieved using the MemAcc_GetJobResult API. If the write operation was successful, the job result is MEMACC_MEM_OK. If there was an issue writing the data, the result is MEMACC_MEM_FAILED.
Std_ReturnType MemAcc_Write(MemAcc_AddressAreaIdType addressAreaId, MemAcc_AddressType targetAddress, const MemAcc_DataType* sourceDataPtr, MemAcc_LengthType length);Unique address area ID type.
Logical memory address type.
Type of the function pointer to register an application callback to be notified once the address area lock was successfully acquired.
Postbuild configuration structure type.
General data type.
Type for the unique numeric identifiers of all Mem hardware instances used for hardware specific requests.
This structure contains information the current processing state of the MemAcc module.
Asynchronous job result type.
Asynchronous job status type.
Type for asynchronous jobs.
Job length type.
Physical memory device address type
This structure contains elements for accessing the Mem driver service functions and consistency information. Tags: atp.Status=draft
Function pointer for the Mem_BlankCheck service for the invocation of the Mem driver API via function pointer interface. Tags: atp.Status=draft
Memory driver configuration structure type
General data type
Function pointer for the Mem_DeInit service for the invocation of the Mem driver API via function pointer interface.
Function pointer for the Mem_Erase service for the invocation of the Mem driver API via function pointer interface. Tags: atp.Status=draft
Function pointer for the Mem_JobResultType service for the invocation of the Mem driver API via function pointer interface.
Index type for Mem driver hardware specific service table.
Function pointer for the Mem_HwSpecificService function for the invocation of the Mem driver API via function pointer interface. Tags: atp.Status=draft
Function pointer for the Mem_Init service for the invocation of the Mem driver API via function pointer interface.
Memory driver instance ID type
Asynchronous job result type
Physical memory device length type
Function pointer for the Mem_MainFunction service for the invocation of the Mem driver API via function pointer interface.
This structure contains information of Mem device characteristics. It can be accessed via the MemAcc_GetMemoryInfo() service. Tags: atp.Status=draft
Function pointer for the Mem_PropagateError service for the invocation of the Mem driver API via function pointer interface.
Function pointer for the Mem_Read service for the invocation of the Mem driver API via function pointer interface. Tags: atp.Status=draft
Function pointer for the Mem_Resume service for the invocation of the Mem driver API via function pointer interface. Tags: atp.Status=draft
Function pointer for the Mem_Suspend service for the invocation of the Mem driver API via function pointer interface. Tags: atp.Status=draft
Function pointer for the Mem_Write service for the invocation of the Mem driver API via function pointer interface. Tags: atp.Status=draft
MemIf
Invokes the "Cancel" function of the underlying memory abstraction module selected by the parameter Device Index.
void MemIf_Cancel (uint8 DeviceIndex);Invokes the "Erase Immediate Block" function of the underlying memory abstraction module selected by the parameter Device Index.
Std_ReturnType MemIf_EraseImmediateBlock (uint8 DeviceIndex, uint16 BlockNumber);Invokes the "Get Job Result" function of the underlying memory abstraction module selected by the parameter Device Index. Available v ia Mem If.h
MemIf_JobResultType MemIf_GetJobResult (uint8 DeviceIndex);Invokes the "Get Status" function of the underlying memory abstraction module selected by the parameter Device Index.
MemIf_StatusType MemIf_GetStatus (uint8 DeviceIndex);Returns version information.
void MemIf_GetVersionInfo (Std_VersionInfoType* VersionInfoPtr);Invokes the "Invalidate Block" function of the underlying memory abstraction module AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_MemoryAbstractionInterface selected by the parameter Device Index.
Std_ReturnType MemIf_InvalidateBlock (uint8 DeviceIndex, uint16 BlockNumber);Invokes the "Set Mode" functions of all underlying memory abstraction modules.
void MemIf_SetMode (MemIf_ModeType Mode);Invokes the "Write" function of the underlying memory abstraction module selected by the parameter Device Index.
Std_ReturnType MemIf_Write (uint8 DeviceIndex, uint16 BlockNumber, const uint8* DataBufferPtr);Denotes the result of the last job.
Denotes the operation mode of the underlying abstraction mod ules and device drivers.
Denotes the current status of the underlying abstraction module and device drive. AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_MemoryAbstractionInterface
NvM
Service to cancel all jobs pending for a NV block.
Std_ReturnType NvM_CancelJobs (NvM_BlockIdType BlockId);Service to cancel a running Nv M_ Write All request.
void NvM_CancelWriteAll (void);Service to erase a NV block.
Std_ReturnType NvM_EraseNvBlock (NvM_BlockIdType BlockId);The function initiates a multi block first initialization request. The job of the function does not care if a block exists in the non - volatile memory or not OR if it is valid (i.e. not corrupted) or not, when processing it.
void NvM_FirstInitAll (void);Service for getting the currently set Data Index of a datase t NVRAM block
Std_ReturnType NvM_GetDataIndex (NvM_BlockIdType BlockId, uint8* DataIndexPtr);Service to read the block dependent error/ status information.
Std_ReturnType NvM_GetErrorStatus (NvM_BlockIdType BlockId, NvM_RequestResultType* RequestResultPtr);Service to get the version information of the Nv M module.
void NvM_GetVersionInfo (Std_VersionInfoType* versioninfo);Service for resetting all internal variables.
void NvM_Init (const NvM_ConfigType* ConfigPtr);Per block callback routine which shall be called by the Nv M module when default data needs to be restored in RAM, and a RO M block is not configured. AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_NVRAMManager
Std_ReturnType NvM_InitBlockCallbackFunction (NvM_InitBlockRequestType InitBlockRequest);Service to invalidate a NV block.
Std_ReturnType NvM_InvalidateNvBlock (NvM_BlockIdType BlockId);Function to be used by the underlying memory abstraction to signal end of job without error.
void NvM_JobEndNotification (void);Function to be used by the underlying memory abstraction to signal end of job with error.
void NvM_JobErrorNotification (void);Service for performing the processing of the Nv M jobs.
void NvM_MainFunction (void);Common callback routine to notify the upper layer that an asynchronous multi block request has been finished. Available v ia Nv M_ Externals.h
Std_ReturnType NvM_MultiBlockCallbackFunction (NvM_MultiBlockRequestType MultiBlockRequest, NvM_RequestResultType JobResult);Initiates a multi block read request.
void NvM_ReadAll (void);Service to copy the data of the NV block to its corresponding RAM block.
Std_ReturnType NvM_ReadBlock (NvM_BlockIdType BlockId, void* NvM_DstPtr);Service to copy the data of the NV block to its corresponding permanent RAM block.
Std_ReturnType NvM_ReadPRAMBlock (NvM_BlockIdType BlockId);Block specific callback routine which shall be called in order to let the application copy data from Nv M module's mirror to RAM block.
Std_ReturnType NvM_ReadRamBlockFromNvm (const void* NvMBuffer);Service to restore the default data to its corr esponding RAM block.
Std_ReturnType NvM_RestoreBlockDefaults (NvM_BlockIdType BlockId, void* NvM_DestPtr);Service to restore the default data to its corresponding permanent RAM block.
Std_ReturnType NvM_RestorePRAMBlockDefaults (NvM_BlockIdType BlockId);Service for setting the lock status of a permanent RAM block or of the explicit synchronization of a NVRAM block.
void NvM_SetBlockLockStatus (NvM_BlockIdType BlockId, boolean BlockLocked);Service for setting/ resetting the write protection for a NV block. Availabl e via Nv M.h
Std_ReturnType NvM_SetBlockProtection (NvM_BlockIdType BlockId, boolean ProtectionEnabled);Service for setting the Data Inde x of a dataset NVRAM block.
Std_ReturnType NvM_SetDataIndex (NvM_BlockIdType BlockId, uint8 DataIndex);Service for setting the RAM block status of a permanent RAM block or the status of the explicit synchronization of a NVRAM block.
Std_ReturnType NvM_SetRamBlockStatus (NvM_BlockIdType BlockId, boolean BlockChanged);Per block callback routine to notify the upper layer that an asynchronous single block request has been finished.
Std_ReturnType NvM_SingleBlockCallbackFunction (NvM_BlockRequestType BlockRequest, NvM_RequestResultType JobResult);Initiates a multi block validation request.
void NvM_ValidateAll (void);Initiates a multi block write request.
void NvM_WriteAll (void);Service to copy the data of the RAM block to its corresponding NV block. Available vi a Nv M.h
Std_ReturnType NvM_WriteBlock (NvM_BlockIdType BlockId, const void* NvM_SrcPtr);Service to copy the data of the permanent RAM block to its corresponding NV block.
Std_ReturnType NvM_WritePRAMBlock (NvM_BlockIdType BlockId);Block specific callback routine which shall be called in order to let the application copy data from RAM block to Nv M module's mirror.
Std_ReturnType NvM_WriteRamBlockToNvm (void* NvMBuffer);Identification of a NVRAM block via a unique block identifier. Reserved NVRAM block IDs: 0 - > to derive multi block request results via Nv M_ Get Error Status 1 - > redundant NVRAM block which holds the configuration ID
Identifies the type of reques t performed on a block when signaled via the callback function
Configuration data structure of the Nv M module.
Identifies the type of request performed on a block when signaled via the callback function
Identifies the type of request performed on multi block when signaled via the callback function or when reporting to Bsw M
Type NvM_RequestResultType.
RamTst
Service for continuing the RAM Test after calling 'Ram Tst_ Stop.
void RamTst_Allow(void);Service changes the current number of tested cells.
void RamTst_ChangeNumberOfTestedCells(RamTst_NumberOfTestedCellsType NewNumberOfTestedCells);Service for RAM Test deinitialization.
void RamTst_DeInit(void);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.
void RamTst_ErrorNotification(void);Service returns the version information of this module.
void RamTst_GetVersionInfo(Std_VersionInfoType* versioninfo);Service for RAM Test initialization.
void RamTst_Init(const RamTst_ConfigType* ConfigPtr);Scheduled function for executing the RAM Test in the background.
void RamTst_MainFunction(void);Service for allowing to continue the background RAM Test at the point is was suspended.
void RamTst_Resume(void);Service for executing the full RAM Test in the foreground.
void RamTst_RunFullTest(void);Service for testing one RAM block in the foreground.
void RamTst_RunPartialTest(RamTst_NumberOfBlocksType BlockId);Service used to set the test algorithm and its parameter set.
void RamTst_SelectAlgParams(RamTst_AlgParamsIdType NewAlgParamsId);Service for stopping the RAM Test.
void RamTst_Stop(void);Service for suspending current operation of background RAM Test, until RESUME is called.
void RamTst_Suspend(void);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.
void RamTst_TestCompletedNotification(void);Service returns the current RAM Test algorithm.
RamTst_AlgorithmType RamTst_GetTestAlgorithm(void);Service returns the ID of the current RAM Test algorithm parameter set.
RamTst_AlgParamsIdType RamTst_GetAlgParams(void);Service returns the current RAM Test execution status.
RamTst_ExecutionStatusType RamTst_GetExecutionStatus(void);Service returns the current number of tested cells per main - function cycle.
RamTst_NumberOfTestedCellsType RamTst_GetNumberOfTestedCells(void);Service returns the current RAM Test result.
RamTst_TestResultType RamTst_GetTestResult(void);Service returns the current RAM Test result for the specified block.
RamTst_TestResultType RamTst_GetTestResultPerBlock(RamTst_NumberOfBlocksType BlockID);This is a value returned by the API service Ram Tst_ Get Test Algorithm().
Data type used to identify a set of configuration parameters for a test algorithm.
Configuration data structure of the Ram Tst module.
This is a status value returned by the API service Ram Tst_ Get Execution Status().
Data type used to identify or count RAM blocks given in the test configuration parameters.
Data type of number of tested RAM cells
This is a status value returned by the API service Ram Tst_ Get Test Result().
دليل العنقودمولَّد بالذكاء الاصطناعي
يؤمّن ويدير البيانات الدائمة بشكل مستقل عن العتاد عبر كتل NVRAM مهيكلة وبرامج تشغيل التجريد.
يؤمّن ويدير البيانات الدائمة بشكل مستقل عن العتاد عبر كتل NVRAM مهيكلة وبرامج تشغيل التجريد.
تحقق حزمة وحدات 'Memory Services' التخزين المستقل عن العتاد وضمان اتساق بيانات التطبيق غير المتطايرة عبر NVRAM Manager بالإضافة إلى وحدات تجريد العتاد MemIf وFee وEa ([SWS_NvM_00447]، [SWS_MemIf_00039]). وتتم معالجة عمليات القراءة والكتابة غير المتزامنة عبر MainFunctions دورية وتُنفذ مجمعةً أثناء بدء تشغيل وحدة التحكم الإلكترونية (NvM_ReadAll) وكذلك عند إيقاف التشغيل (NvM_WriteAll) ModemanagementGuide ص. 54. وفي حالة حدوث أخطاء في العتاد، تتدخل آليات متعددة المستويات لإعادة المحاولة والتكرار والاسترداد من ROM مع إرسال تقارير تلقائية إلى DEM ([SWS_NvM_00470]).
توفر حزمة 'Memory Services' التخزين الدائم وإدارة البيانات غير المتطايرة في حزمة برمجيات BSW لـ AUTOSAR Classic. وتتضمن NVRAM Manager ([SWS_NvM_00447]) على مستوى الخدمات، بالإضافة إلى Memory Abstraction Interface ([SWS_MemIf_00039]) مع وحدتي Flash EEPROM Emulation ([SWS_Fee_00085]) وEEPROM Abstraction ([SWS_Ea_00083]) على مستوى تجريد العتاد AUTOSAR SWS NVRAMManager ص. 10.
مخطط معماري: هيكل الطبقات وعلاقات الوحدات في حزمة Memory Services. المصادر: [SWS_MemIf_00039]، AUTOSAR SWS NVRAMManager ص. 10
يتم تبادل البيانات عبر واجهات برمجة تطبيقات (APIs) متزامنة للتحكم وأوامر قراءة وكتابة غير متزامنة. ويتم تبادل البيانات إما ضمنيًا عبر كتل RAM الدائمة أو صراحةً عبر مرايا RAM الموجهة للوحدة ([SWS_NvM_00455]، [SWS_NvM_00514]) NVDataHandling ص. 12. وتتم المعالجة الدورية للأوامر المصطفة عبر دوال BSW الرئيسية المنفذة دوريًا (NvM_MainFunction، Fee_MainFunction)، بينما تفوّض MemIf الاستدعاءات بدون حالة إلى برامج التشغيل التابعة ([SWS_MemIf_00040]) AUTOSAR CP SWS FlashEEPROMEmulation ص. 42.
في دورة التشغيل، ينسق BswM إجراءات الكتل المتعددة: عند بدء تشغيل النظام، يقرأ NvM_ReadAll البيانات الدائمة من ذاكرة NV إلى RAM ([SWS_NvM_00460])، بينما يقوم NvM_WriteAll بحفظ البيانات المعدلة عند إيقاف التشغيل ([SWS_NvM_00461]) ModemanagementGuide ص. 54. ويتم اعتراض عمليات القراءة أو الكتابة الخاطئة من خلال محاولات إعادة المحاولة وكذلك النسخ المتكررة أو القيم الاحتياطية من ROM؛ ويُبلغ النظام DEM بالأخطاء الدائمة ([SWS_NvM_00470]، [SWS_NvM_00279]) ErrorDescription ص. 62.
معمارية النظام & دور مجموعة الوحدات
تضمن حزمة وحدات خدمات الذاكرة (Memory Services) لـ AUTOSAR Classic Platform الإدارة القياسية والمستقلة عن العتاد واستدامة بيانات التطبيقات والبرمجيات الأساسية في الذاكرة غير المتطايرة. وتنقسم الحزمة عموديًا إلى طبقتين في بنية برمجيات AUTOSAR الأساسية: NVRAM Manager ([SWS_NvM_00447]) على طبقة الخدمات (Services Layer)، بالإضافة إلى Memory Abstraction Interface ([SWS_MemIf_00039]) مع وحدات التجريد التابعة لها Flash EEPROM Emulation ([SWS_Fee_00085]) وEEPROM Abstraction ([SWS_Ea_00083]) على طبقة تجريد عتاد الذاكرة (Memory Hardware Abstraction Layer) AUTOSAR SWS NVRAMManager ص. 10.
يمثل NVRAM Manager (NvM) نقطة الدخول المركزية لمكونات البرمجيات (SW-C) ووحدات BSW مثل وحدة Diagnostic Event Manager (Dem) SWS DiagnosticEventManager ص. 238. ويدير كتل الذاكرة المنطقية، التي تتألف من كتل NV في الذاكرة غير المتطايرة، وكتل RAM في الذاكرة المتطايرة، بالإضافة إلى كتل ROM اختيارية لبيانات التهيئة الأولية ([SWS_NvM_00137]، [SWS_NvM_00128]). وبحسب المتطلبات، يتم دعم أنواع إدارة الكتل native (NVM_BLOCK_NATIVE)، أو redundant (NVM_BLOCK_REDUNDANT)، أو dataset (NVM_BLOCK_DATASET) AUTOSAR CP RS MemoryServices ص. 10.
تغلّف الوحدتان Fee وEa الخصائص المميزة لوسائط التخزين المادية المعنية (Flash أو EEPROM)، وتعينان أرقام الكتل المنطقية وإزاحات العناوين على مساحات العناوين الخطية لبرامج تشغيل MCAL المعنية (Fls أو Eep) ([SWS_Fee_00087]، [SWS_Ea_00086]) AUTOSAR SWS EEPROMAbstraction ص. 23. وتعمل الوحدة MemIf في هذا السياق كطبقة توجيه بحتة، تقوم بإعادة توجيه عمليات الوصول إلى الوحدة الهدف استنادًا إلى المعامل DeviceIndex، دون الاحتفاظ بهياكل تخزين مؤقت خاصة بها ([SWS_MemIf_00040]).
مخطط معماري: هيكل الطبقات وعلاقات الوحدات في حزمة Memory Services. المصادر: [SWS_MemIf_00039]، AUTOSAR SWS NVRAMManager ص. 10
التكامل ومسارات التفاعل بين الوحدات
يتم التفاعل بين الوحدات عبر مسارات متزامنة وغير متزامنة قياسية بشكل صارم. إذا بدأ مستخدم عملية كتابة عبر NvM_WriteBlock، يتم تسجيل الطلب أولاً في الكتلة الإدارية لـ NvM ([SWS_NvM_00455]). وفي حالة الاستدعاء المتزامن، تتم إعادة التوجيه إلى MemIf عبر MemIf_Write ([SWS_MemIf_00040])، والتي تسلم الاستدعاء بدروها إلى Fee_Write أو Ea_Write ([SWS_Fee_00088]، [SWS_Ea_00087]) AUTOSAR SWS NVRAMManager ص. 160.
فيما يتعلق بالاحتفاظ بالبيانات والمزامنة بين التطبيق وNVRAM Manager، يوجد مفهومان أساسيان: المزامنة الضمنية عبر كتل RAM الدائمة (NvMRamBlockDataAddress) والمزامنة الصريحة عبر مخازن مؤقتة قائمة على المرايا (NvMBlockUseSyncMechanism) NVDataHandling ص. 12. وفي حالة المزامنة الصريحة، ينسخ NvM البيانات الصافية عبر روتينات رد النداء المهيأة NvMWriteRamBlockToNvCallback أو NvMReadRamBlockFromNvCallback بين ذاكرة RAM للتطبيق ومرآة RAM الداخلية ([SWS_NvM_00514]، [SWS_NvM_00515]) EXP NVDataHandling ص. 30.
عند استخدام كتل Dataset (NVM_BLOCK_DATASET)، يحدد المستدعي مسبقًا فهرس مجموعة البيانات المطلوب عبر NvM_SetDataIndex ([SWS_NvM_00448]). وبناءً على ذلك، تحسب وحدات التجريد إزاحة العنوان الدقيقة لبرنامج تشغيل MCAL من رقم الكتلة المنطقي والفهرس ([SWS_NvM_00123]) AUTOSAR SWS Flash EEPROM Emulation ص. 21. وتُمرر طلبات الإلغاء عبر MemIf_Cancel مباشرة إلى الوحدات الفرعية Fee_Cancel أو Ea_Cancel ([SWS_MemIf_00041]، [SWS_Fee_00089]).
مخطط تسلسلي: أمر كتابة غير متزامن مع إشعار رد النداء والاستقصاء الدوري (Polling). المصادر: [SWS_NvM_00455]، AUTOSAR SWS NVRAMManager ص. 160
المزامنة، وقابلية إعادة الدخول، وسياقات المهام
معظم واجهات برمجة التطبيقات للتحكم والحالة في الحزمة، بما في ذلك NvM_GetErrorStatus ([SWS_NvM_00451]) وNvM_SetBlockProtection ([SWS_NvM_00450]) وMemIf_GetVersionInfo ([SWS_MemIf_00045])، متزامنة التنفيذ ويمكن معالجتها مباشرة في سياق مهمة المستدعي AUTOSAR SWS NVRAMManager ص. 157. في المقابل، صُممت الدوال الناقلة للبيانات (NvM_ReadBlock، NvM_WriteBlock، Ea_Write) لتكون غير متزامنة وغير قابلة لإعادة الدخول (non-reentrant) ([SWS_MemIf_00040]، [SWS_Ea_00087]).
تُسند المتابعة الدورية للأوامر الجارية إلى الدوال الرئيسية NvM_MainFunction وFee_MainFunction التي يستدعيها Schedule Manager (SchM) أو إحدى مهام BSW بصورة دورية AUTOSAR CP SWS FlashEEPROMEmulation ص. 42. وفي حالة الرسائل غير المتزامنة من برنامج تشغيل MCAL، يمكن أن يتم الإشعار Fee_JobEndNotification أو Fee_JobErrorNotification مباشرة على مستوى المقاطعة ([SWS_Fee_00095]). ويقوم هذا الإشعار بضبط الحالة إلى MEMIF_JOB_OK أو يستدعي روتينات إشعار مهيأة ([SWS_Fee_00142]، [SWS_Fee_00194]) SWS FlashEEPROMEmulation ص. 37.
تفسير: لمنع حالات التسابق (Race Conditions) بين مستدعي API على مستوى المهام والمعالجة الإضافية التدريجية في MainFunctions، يُرجح أن تكون قوائم الانتظار الداخلية والسمات الإدارية محمية بواسطة أقسام حصرية، بينما تعمل MemIf كطبقة إعادة توجيه عديمة الحالة AUTOSAR SWS NVRAMManager ص. 160. سؤال Q-a50c3362a14b9e6d (مفتوح)
دورات الحياة النموذجية وأنماط التشغيل
يتم تنسيق دورة حياة الحزمة بشكل وثيق بواسطة Basic Software Mode Manager (BswM) وECU State Manager (EcuM). وأثناء مرحلة بدء تشغيل وحدة التحكم الإلكترونية (Startup Phase)، تتم التهيئة الأولية المتزامنة لوحدات التجريد أولاً بعد برامج التشغيل عبر Fee_Init أو Ea_Init ([SWS_Fee_00085]، [SWS_Ea_00083])، ثم يليها NVRAM Manager عبر NvM_Init ([SWS_NvM_00447]) AUTOSAR SWS NVRAMManager ص. 156.
عقب التهيئة الأولية، يطلق BswM عملية قراءة الكتل المتعددة NvM_ReadAll لاستعادة جميع كتل RAM المحددة كدائمة من الذاكرة غير المتطايرة ([SWS_NvM_00460]) ModemanagementGuide ص. 54. ويبلغ NvM بالتقدم والنتيجة النهائية إلى BswM عبر دالة رد النداء BswM_NvM_CurrentJobMode ([SWS_NvM_00745]، [SWS_NvM_00888]). وتتم الإشارة إلى حالات الكتل الفردية عبر BswM_NvM_CurrentBlockMode ([SWS_NvM_00746]، [SWS_NvM_00890]) ModemanagementGuide ص. 28.
في مرحلة إيقاف التشغيل، يوجه النظام عبر NvM_WriteAll بإعادة الكتابة الدائمة لجميع كتل RAM المعدلة إلى ذاكرة NV ([SWS_NvM_00461]). ولتحسين عدد دورات كتابة Flash، يمكن عبر NvM_SetRamBlockStatus تحديد ما إذا كانت الكتلة قد عُدلت على نحو موجه ([SWS_NvM_00453]) EXP NVDataHandling ص. 18. ويمكن إلغاء عملية الكتابة الجارية عند حدوث أحداث تنبيه مبكرة عبر NvM_CancelWriteAll ([SWS_NvM_00238]) AUTOSAR SWS NVRAMManager ص. 161.
معالجة الأخطاء، وتتبع DET، والتدهور التدريجي للخدمة (Degradation)
تمتلك الحزمة مفهومًا متعدد المستويات لاكتشاف الأخطاء وتدهور الأداء الوظيفي. ويتم الاستعلام عن الأخطاء التي تحدث على مستوى برنامج التشغيل والتجريد عبر حالة الإرجاع MEMIF_JOB_FAILED باستخدام MemIf_GetJobResult أو الإبلاغ عنها عبر NvM_JobErrorNotification ([SWS_Fee_00091]، [SWS_Ea_00095]) ErrorDescription ص. 49.
عند حدوث أخطاء في القراءة، يعتمد NvM على آليات استرداد مهيأة: في البداية، تُجرى محاولات إعادة القراءة (Read Retries) ([SWS_NvM_00390]). وإذا فشلت هذه المحاولات، يتم في الكتل المتكررة (NVM_BLOCK_REDUNDANT) قراءة النسخة المتكررة ([SWS_NvM_00171]، [SWS_NvM_00531]). وإذا تم اكتشاف فقدان التكرار هنا، يضبط NvM نتيجة المهمة إلى NVM_REQ_REDUNDANCY_FAILED ويبلغ عن خطأ الإنتاج NVM_E_LOSS_OF_REDUNDANCY إلى DEM ([SWS_NvM_00470]، [SWS_NvM_00546]) ErrorDescription ص. 62.
إذا نجح الاسترداد عبر قيم ROM الافتراضية، يبلغ NvM بالنتيجة NVM_REQ_RESTORED_FROM_ROM ([SWS_NvM_00470]). وإذا فشلت جميع إجراءات الاسترداد، يتم الإبلاغ عن NVM_E_REQ_FAILED إلى DEM ([SWS_NvM_00279]، [SWS_NvM_00288]) وتُضبط نتيجة الاستعلام إلى NVM_REQ_NOT_OK ([SWS_NvM_00451]). وفي حالة أخطاء الكتابة، يتحكم NvM في عمليات إعادة محاولة الكتابة (NvMMaxNumOfWriteRetries) قبل إلغاء الطلب ([SWS_NvM_00168]، [SWS_NvM_00213]) ErrorDescription ص. 56.
يلخص هذا الدليل البنية الأساسية وتفاعلات الوحدات وآليات الأخطاء لحزمة Memory Services. تستند جميع المعلومات إلى المواصفات المعيارية لـ AUTOSAR Classic Platform.
يوفر إدارة موحدة ومجردة لتخزين واسترجاع البيانات المستدامة في وحدات الذاكرة غير المتطايرة عبر بنية متعددة الطبقات.
يتولى عنقود خدمات الذاكرة توفير إدارة موحدة ومجردة لتخزين واسترجاع البيانات المستدامة عبر وحدات NvM و MemIf و Fee و Ea AUTOSAR_CP_RS_MemoryServices ص 10. وتعتمد عملياته على نمط غير متزامن تديره الدوال الدورية بالتكامل مع عمليات الإقلاع الشاملة NvM_ReadAll والحفظ عند الإيقاف NvM_WriteAll تحت إشراف مدير الأنماط BswM [SWS_NvM_00460]. كما يضمن العنقود سلامة البيانات عبر آليات استرداد متعددة المستويات تشمل إعادة المحاولة والتكرار الاحتياطي واستعادة القيم الافتراضية من ROM [SWS_NvM_00470].
يوفر عنقود خدمات الذاكرة بنية مجردة ومتكاملة لإدارة تخزين واسترجاع البيانات المستدامة في منصة AUTOSAR Classic Platform. يتألف العنقود من مدير الذاكرة غير المتطايرة NvM الذي يقدم خدمات إدارة الكتل المتزامنة وغير المتزامنة، وواجهة تجريد الذاكرة MemIf التي توجه الطلبات إلى وسائط التخزين المناسبة بناءً على معرف الجهاز، بالإضافة إلى وحدتي Fee لمحاكاة EEPROM فوق قطاعات الفلاش و Ea لتجريد أجهزة EEPROM الفيزيائية AUTOSAR_CP_RS_MemoryServices ص 10 [SWS_MemIf_00039].
مخطط بنية النظام: الهيكل المعماري لعنقود خدمات الذاكرة وتدفق التجريد بين NvM وMemIf وFee وEa. المصادر: AUTOSAR_CP_RS_MemoryServices ص 10 و [SWS_NvM_00557] و [SWS_MemIf_00039].
تعتمد دورة معالجة الطلبات غير المتزامنة على فصل التسجيل عن التنفيذ الفعلي؛ حيث تُدرج طلبات القراءة والكتابة في طوابير NvM مع إعادة قبول فوري، بينما تتولى الدوال الدورية NvM_MainFunction و Fee_MainFunction و Ea_MainFunction نقل البيانات والتحكم في العتاد تدريجيًا، مع دعم التزامن الصريح عبر مرآة الذاكرة لحماية البيانات من التعديل أثناء الكتابة [SWS_NvM_00455] [SWS_NvM_00705] [SWS_MemIf_00040].
مخطط تسلسلي: مسار تنفيذ طلب كتابة غير متزامن مع التزامن الصريح والإشعار عبر رد النداء. المصادر: AUTOSAR_SWS_NVRAMManager ص 160 و [SWS_NvM_00455] و [SWS_MemIf_00040].
تتم إدارة دورات حياة النظام من خلال التنسيق مع BswM؛ حيث تُستعاد جميع الكتل عند بدء التشغيل عبر NvM_ReadAll، وتُحفظ البيانات المعدلة فقط أثناء إيقاف التشغيل عبر NvM_WriteAll بالاعتماد على مؤشر التعديل NvM_SetRamBlockStatus لتقليل إجهاد وسائط التخزين [SWS_NvM_00460] [SWS_NvM_00461] [SWS_NvM_00453].
يتضمن العنقود آليات متقدمة للتعافي من الأخطاء تشمل إعادة المحاولة التلقائية للقراءة والكتابة، والتبديل إلى النسخ المكررة في الكتل الاحتياطية وإبلاغ DEM بفقدان التكرار، بالإضافة إلى استرجاع القيم الافتراضية من ROM عند تلف البيانات الدائمة لضمان استقرار وحدة التحكم [SWS_NvM_00470] [SWS_NvM_00168] [SWS_NvM_00456].
1. بنية النظام ودور عنقود خدمات الذاكرة
يمثل عنقود خدمات الذاكرة (Memory Services Cluster) في منصة AUTOSAR Classic Platform الركيزة الأساسية لإدارة وتجريد عمليات الوصول إلى وسائط التخزين غير المتطايرة (Non-Volatile Memory) لمختلف التطبيقات ووحدات البرمجيات الأساسية (BSW). يضم هذا العنقود أربع وحدات رئيسية تتوزع عبر طبقتي الخدمات (Services Layer) وتجريد العتاد (Memory Hardware Abstraction Layer): مدير الذاكرة غير المتطايرة NvM، وواجهة تجريد الذاكرة MemIf، ومحاكاة ذاكرة EEPROM عبر الذاكرة الوميضية Fee، وتجريد ذاكرة Ea (EEPROM Abstraction) AUTOSAR_CP_RS_MemoryServices ص 10.
تتولى وحدة NvM في طبقة الخدمات توفير واجهات برمجية متزامنة وغير متزامنة لإدارة كتل الذاكرة بموثوقية عالية، وتنظيم البيانات وفق أنواع إدارة متعددة تشمل الكتل الفردية الأصلية (Native) والمكررة للأمان (Redundant) ومجموعات البيانات المفهرسة (Dataset) [SWS_NvM_00557] [SWS_NvM_00558] [SWS_NvM_00559]. وتقوم واجهة MemIf بالفصل التام بين منطق الإدارة العلوي والخصائص الفيزيائية للعتاد، حيث توجه الطلبات ديناميكيًا إلى وحدة Fee أو وحدة Ea بناءً على معامل فهرس الجهاز DeviceIndex [SWS_MemIf_00039] [SWS_MemIf_00040]. بينما تختص Fee بالتعامل مع قطاعات الفلاش والتغلب على قيود المسح وإعادة الكتابة، تتولى Ea إدارة وتعيين العناوين المنطقية لذاكرة EEPROM الفيزيائية عبر مشغل Eep [SWS_Fee_00085] [SWS_Ea_00083].
مخطط بنية النظام: الهيكل المعماري لعنقود خدمات الذاكرة وتدفق التجريد بين NvM وMemIf وFee وEa. المصادر: AUTOSAR_CP_RS_MemoryServices ص 10 و [SWS_NvM_00557] و [SWS_MemIf_00039].
2. مسارات التفاعل وتدفق البيانات والعمليات بين الوحدات
تتم معالجة طلبات القراءة والكتابة في العنقود عبر نمط عمليات غير متزامن ثنائي المراحل يضمن عدم حظر مهام التطبيق. تبدأ العملية بقيام المكون البرمجي بطلب قراءة أو كتابة عبر واجهات مثل NvM_WriteBlock أو NvM_ReadBlock، حيث تتحقق NvM من صحة المعاملات وتدرج الطلب في قائمة الانتظار مع إعادة حالة القبول الفوري E_OK وتعيين نتيجة الطلب إلى NVM_REQ_PENDING [SWS_NvM_00455] [SWS_NvM_00454] AUTOSAR_SWS_NVRAMManager ص 160.
تدعم وحدة NvM آليتين لتنسيق ذاكرة الوصول العشوائي: التزامن الضمني (Implicit Synchronization) حيث يتم التفاعل مباشرة مع مخزن التطبيق الدائم، والتزامن الصريح (Explicit Synchronization) الذي يوظف مرآة ذاكرة وسيطة (RAM Mirror) داخل NvM لحماية البيانات من التعديل أثناء النقل، ويتم نسخ البيانات عبر دوال رد النداء NvM_WriteRamBlockToNvm و NvM_ReadRamBlockFromNvm [SWS_NvM_00705] AUTOSAR_CP_EXP_NVDataHandling ص 14. يتم تمرير البيانات بعد ذلك إلى MemIf عبر MemIf_Write أو MemIf_Read، والتي توجهها بدورها إلى Fee_Write أو Ea_Write [SWS_MemIf_00040] [SWS_Ea_00087].
عند اكتمال العملية في المشغلات السفلية، يُبلّغ المشغل وحدة التجريد عبر Fee_JobEndNotification أو استطلاع النتيجة بواسطة Fee_GetJobResult، لتقوم NvM بتحديث حالة الكتلة إلى NVM_REQ_OK وإشعار التطبيق النهائي عبر رد نداء الكتلة الواحدة NvM_SingleBlockCallbackFunction أو استطلاع الحالة بواسطة NvM_GetErrorStatus [SWS_Fee_00095] [SWS_Fee_00091] [SWS_NvM_00451] [SWS_NvM_00470].
مخطط تسلسلي: مسار تنفيذ طلب كتابة غير متزامن مع التزامن الصريح والإشعار عبر رد النداء. المصادر: AUTOSAR_SWS_NVRAMManager ص 160 و [SWS_NvM_00455] و [SWS_MemIf_00040].
3. التزامن وسياقات المهام وإمكانية إعادة الدخول
تعتمد المعالجة التنفيذية للطلبات داخل العنقود على الاستدعاء الدوري للوظائف الرئيسية (MainFunctions) المجدولة عبر نظام التشغيل أو مدير الجدولة SchM؛ حيث تنفذ NvM_MainFunction و Fee_MainFunction و Ea_MainFunction ضمن مهام دورية (Cyclic Tasks) لتسيير آلات الحالات ومعالجة طوابير الانتظار تدريجيًا AUTOSAR_CP_SWS_FlashEEPROMEmulation ص 42 AUTOSAR_SWS_NVRAMManager ص 160.
في المقابل، تعمل دوال التحكم والإدارة السريعة مثل NvM_GetErrorStatus و NvM_SetDataIndex و NvM_SetBlockProtection بشكل متزامن وفوري ضمن سياق المهمة المستدعية دون إدراج مهام في الطابور العتادي [SWS_NvM_00451] [SWS_NvM_00448] [SWS_NvM_00450]. وتعتبر أغلب واجهات MemIf و Fee و Ea غير قابلة لإعادة الدخول (Non Reentrant) للكتلة أو القناة الواحدة لتفادي تداخل البيانات، مما يستوجب ضبط مناطق الاستبعاد المتبادل في بيئات التشغيل المتعددة المهام [SWS_MemIf_00039] [SWS_Fee_00089].
تتميز دالة الإشعار Fee_JobEndNotification بإمكانية استدعائها مباشرة من مستوى المقاطعة (Interrupt Level) للمشغل الوميضي؛ وعلى الأرجح يتطلب ذلك حماية المناطق الحرجة داخل وحدة Fee لتفادي تعارض البيانات مع الدالة الدورية [SWS_Fee_00095]. كما يوفر العنقود آليات الإلغاء الفوري للعمليات الجارية عبر MemIf_Cancel و Fee_Cancel أو إلغاء العمليات الشاملة عبر NvM_CancelWriteAll عند حدوث استيقاظ طارئ أثناء إيقاف التشغيل [SWS_MemIf_00041] [SWS_Fee_00089] [SWS_NvM_00019] AUTOSAR_SWS_NVRAMManager ص 161.
4. دورات الحياة النموذجية وأنماط التشغيل وإدارة الإقلاع والإيقاف
يتم تنسيق دورة حياة عنقود الذاكرة بدقة عبر مدير نمط البرمجيات الأساسية BswM ومدير حالة وحدة التحكم EcuM. تبدأ مرحلة الإقلاع بتهيئة مشغلات العتاد المنخفضة، تليها تهيئة وحدات التجريد عبر Fee_Init أو Ea_Init، ثم التهيئة المركزية لمدير الذاكرة عبر NvM_Init للانتقال من حالة NVM_UNINIT إلى NVM_IDLE [SWS_Fee_00085] [SWS_Ea_00084] [SWS_NvM_00447] AUTOSAR_SWS_NVRAMManager ص 156.
عقب إتمام التهيئة الأساسية وخلال مرحلة الإقلاع المتقدمة، يُطلق BswM طلب القراءة الجماعية الشامل NvM_ReadAll لاستعادة جميع كتل الذاكرة المكونة إلى ذاكرة RAM [SWS_NvM_00460] ModemanagementGuide ص 54. يراقب BswM تقدم العملية الشاملة عبر الإشعار المتزامن BswM_NvM_CurrentJobMode؛ وعند تحول حالة الطلب من NVM_REQ_PENDING إلى NVM_REQ_OK، ينتقل النظام إلى نمط التشغيل الكامل ECU_RUN ويبدأ تشغيل بيئة التشغيل التطبيقية RTE [SWS_BswM_00152] [SWS_NvM_00745] [SWS_NvM_00888] AUTOSAR_SWS_NVRAMManager ص 163.
أثناء مرحلة إيقاف التشغيل (Shutdown)، يُطلق BswM عملية الكتابة الجماعية NvM_WriteAll لحفظ الكتل المعدلة في الوسائط الدائمة [SWS_NvM_00461]. ولتقليل دورات الكتابة وإجهاد وسائط الفلاش، يتم تفعيل مؤشر التعديل (Dirty Flag)؛ حيث تستدعي التطبيقات أو RTE الدالة NvM_SetRamBlockStatus لتمييز الكتل التي طرأ عليها تغيير فعلي فقط، مما يحصر الكتابة أثناء NvM_WriteAll في تلك الكتل دون غيرها [SWS_NvM_00453] NVDataHandling ص 20.
5. معالجة الأخطاء والتتبع والتراجع الآمن
يتضمن عنقود خدمات الذاكرة استراتيجية متكاملة ومتعددة المستويات للتعامل مع الإخفاقات العتادية والمنطقية. عند اكتشاف فشل في مستوى مشغلات التخزين أو وحدات التجريد، تبلّغ الواجهة MemIf بالنتيجة MEMIF_JOB_FAILED عبر Fee_GetJobResult أو ردود النداء المباشرة NvM_JobErrorNotification [SWS_Fee_00091] [SWS_Ea_00095] ErrorDescription ص 43.
تتولى وحدة NvM إدارة آليات التعافي التلقائي المتسلسلة (Error Recovery): تبدأ بإعادة محاولة القراءة (Read Retry)، وفي حال استمرار الخطأ لكتلة من نوع NVM_BLOCK_REDUNDANT، يتم الانتقال لقراءة النسخة المكررة الاحتياطية وتعيين النتيجة إلى NVM_REQ_REDUNDANCY_FAILED مع إبلاغ مدير أحداث التشخيص DEM بالخطأ NVM_E_LOSS_OF_REDUNDANCY [SWS_NvM_00470] [SWS_NvM_00171] ErrorDescription ص 62. وإذا تعذر الوصول إلى البيانات المكررة، تلجأ NvM إلى استرجاع القيم الافتراضية من كتلة ROM المخزنة في الذاكرة الثابتة وتعيين الحالة إلى NVM_REQ_RESTORED_FROM_ROM عبر NvM_RestoreBlockDefaults [SWS_NvM_00456].
وفي عمليات الكتابة، تنفذ NvM آلية إعادة المحاولة (Write Retry) لعدد مرات محدد مسبقًا؛ وفي حال استنفاد المحاولات وفشل عملية الاسترداد بالكامل، يُسجل الخطأ NVM_E_REQ_FAILED لدى DEM ويُعاد للمستخدم الرمز NVM_REQ_NOT_OK عند فحص الحالة عبر NvM_GetErrorStatus [SWS_NvM_00168] [SWS_NvM_00213] [SWS_NvM_00271] [SWS_NvM_00269] [SWS_NvM_00451]. كما تراقب خدمات التتبع أخطاء التطوير (DET) مثل استدعاء الواجهات قبل اكتمال التهيئة عبر إطلاق NVM_E_UNINIT وتمرير أرقام كتل غير صالحة ErrorDescription ص 62.
تم إنشاء هذا الدليل آليًا بواسطة المساعد الذكي لنظام autodocs استنادًا إلى مواصفات AUTOSAR Classic Platform الإصدار R20-11.
Module im Cluster
Bulk NvData Manager (BndM)
AUTOSAR Classic Memory Services-Modul Bulk NvData Manager (BndM, Spezifikation: AUTOSAR_CP_SWS_BulkNvDataManager.pdf, AUTOSAR_SWS_BulkNvDataManager.pdf).
EEPROM Abstraction (Ea)
Provides uniform access to external and internal EEPROM devices.
EEPROM Driver (Eep)
AUTOSAR Classic Memory Drivers-Modul EEPROM Driver (Eep, Spezifikation: AUTOSAR_CP_SWS_EEPROMDriver.pdf, AUTOSAR_SWS_EEPROMDriver.pdf, AUTOSAR_SWS_EEPROM_Driver.pdf).
Flash EEPROM Emulation (Fee)
Provides emulation of EEPROM-like data blocks on Flash memory devices.
Flash Driver (Fls)
AUTOSAR Classic Memory Drivers-Modul Flash Driver (Fls, Spezifikation: AUTOSAR_CP_SWS_FlashDriver.pdf, AUTOSAR_SWS_FlashDriver.pdf).
Flash Test (FlsTst)
AUTOSAR Classic Memory Drivers-Modul Flash Test (FlsTst, Spezifikation: AUTOSAR_CP_SWS_FlashTest.pdf, AUTOSAR_SWS_FlashTest.pdf).
Memory Driver (Mem)
AUTOSAR Classic Memory Drivers-Modul Memory Driver (Mem, Spezifikation: AUTOSAR_CP_SWS_MemoryDriver.pdf, AUTOSAR_SWS_MemoryDriver.pdf).
Memory Access (MemAcc)
AUTOSAR Classic Memory HW Abstraction-Modul Memory Access (MemAcc, Spezifikation: AUTOSAR_CP_SWS_MemoryAccess.pdf, AUTOSAR_SWS_MemoryAccess.pdf).
Memory Abstraction Interface (MemIf)
Abstracts underlying Flash and EEPROM memory drivers.
NVRAM Manager (NvM)
Provides synchronous and asynchronous block-based data management for non-volatile storage (EEPROM, Flash).
RAM Test (RamTst)
AUTOSAR Classic Memory Drivers-Modul RAM Test (RamTst, Spezifikation: AUTOSAR_CP_SWS_RAMTest.pdf, AUTOSAR_SWS_RAMTest.pdf, AUTOSAR_SWS_RAM_Test.pdf).
gemini-3.8-flash-low· 2026-10-13 · الأصل الألماني