AUTOAR4.2.2Fls配置容器20230716A

AUTOAR4.2.2Fls配置容器，Configuration of the Fls (internal or external flash driver) module.

Fls

• Configuration of the Fls (internal or external flash driver) module. Its multiplicity describes the number of flash drivers present, so there will be one container for each flash driver in the ECUC template. When no flash driver is present then the multiplicity is 0.
• FlsConfigSet
  • Container for runtime configuration parameters of the flash driver. Implementation Type: Fls_ConfigType.
  • FlsAcErase
    • Address offset in RAM to which the erase flash access code shall be loaded. Used as function pointer to access the erase flash access code.
    • EcucIntegerParamDef
  • FlsAcWrite
    • Address offset in RAM to which the write flash access code shall be loaded. Used as function pointer to access the write flash access code.
    • EcucIntegerParamDef
  • FlsCallCycle
    • Cycle time of calls of the flash driver's main function (in seconds). dependency: Only relevant if deadline monitoring for internal functionality has to be done in software (e.g. erase / write timings)
    • EcucFloatParamDef
  • FlsDefaultMode
    • This parameter is the default FLS device mode after initialization. Implementation Type: MemIf_ModeType.
    • MEMIF_MODE_FAST
      • The driver is working in fast mode (fast read access / SPI burst access).
    • MEMIF_MODE_SLOW
      • The driver is working in slow mode
  • FlsJobEndNotification（0.1）
    • Mapped to the job end notification routine provided by some upper layer module, typically the Fee module.
    • EcucFunctionNameDef
  • FlsJobErrorNotification（0..1）
    • EcucFunctionNameDef
    • EcucFunctionNameDef
  • FlsMaxReadFastMode
    • The maximum number of bytes to read or compare in one cycle of the flash driver's job processing function in fast mode dependency: The minimum number might depend on the underlying flash device or communication driver, e.g. if the access to an external flash device is done via SPI and the minimum transfer size on SPI is four bytes
    • EcucIntegerParamDef
  • FlsMaxReadNormalMode
    • The maximum number of bytes to read or compare in one cycle of the flash driver's job processing function in normal mode dependency: The minimum number might depend on the underlying flash device or communication driver, e.g. if the access to an external flash device is done via SPI and the minimum transfer size on SPI is four bytes
    • EcucIntegerParamDef
  • FlsMaxWriteFastMode
    • The maximum number of bytes to write in one cycle of the flash driver's job processing function in fast mode dependency: FLS182: This value has to correspond to the settings in FLS_PAGE_LIST. The minimum number is defined by the size of one flash page and therefore depends on the underlying flash device.
    • EcucIntegerParamDef
  • FlsMaxWriteNormalMode
    • The maximum number of bytes to write in one cycle of the flash driver's job processing function in normal mode dependency: FLS182: This value has to correspond to the settings in FLS_PAGE_LIST. The minimum number is defined by the size of one flash page and therefore depends on the underlying flash device.
    • EcucIntegerParamDef
  • FlsProtection
    • Erase/write protection settings. Only relevant if supported by hardware.
    • EcucIntegerParamDef
  • FlsDemEventParameterRefs(0..1)
    • Container for the references to DemEventParameter elements which shall be invoked using the Dem_ReportErrorStatus API in case the corresponding error occurs. The EventId is taken from the referenced DemEventParameter's DemEventId value. The standardized errors are provided in the container and can be extended by vendor specific error references. Tags: atp.Status=obsolete atp.StatusComment=This container is set to obsolete and will be removed in release 4.3. atp.StatusRevisionBegin=4.2.2
    • FLS_E_COMPARE_FAILED(0..1)
      • Symbolic name reference to [ DemEventParameter ]
    • FLS_E_ERASE_FAILED(0..1)
      • Symbolic name reference to [ DemEventParameter ]
    • FLS_E_WRITE_FAILED(0..1)
      • Symbolic name reference to [ DemEventParameter ]
    • FLS_E_READ_FAILED(0..1)
      • Symbolic name reference to [ DemEventParameter ]
    • FLS_E_UNEXPECTED_FLASH_ID(0..1)
      • Symbolic name reference to [ DemEventParameter ]
  • FlsExternalDriver(0..1)
    • This container is present for external Flash drivers only.
    • FlsSpiReference(1...*)
      • Reference to SPI sequence (required for external EEPROM drivers)
      • Symbolic name reference to [ SpiSequence ]
  • FlsSectorList
    • List of flashable sectors and pages.
    • FlsSector(1..*)
      • Configuration description of a flashable sector
      • FlsNumberOfSectors
        • Number of continuous sectors with identical values for FlsSectorSize and FlsPageSize. The parameter FlsSectorStartAddress denotes the start address of the first sector. FlsSectorSize和FlsPageSize值相同的连续扇区数。参数FlsSectorStartAddress表示第一个扇区的起始地址。
        • EcucIntegerParamDef
      • FlsPageSize
        • Size of one page of this sector. Implementation Type: Fls_LengthType. dependency: The sector size has to be an integer multiple of the page size.
        • EcucIntegerParamDef
      • FlsSectorSize
        • Size of this sector. Implementation Type: Fls_LengthType dependency: The sector size has to be an integer multiple of the page size
        • EcucIntegerParamDef
      • FlsSectorStartaddress
        • Start address of this sector. Implementation Type: Fls_AddressType
        • EcucIntegerParamDef
• FlsGeneral
  • Container for general parameters of the flash driver. These parameters are always pre-compile.
  • FlsAcLoadOnJobStart
    • The flash driver shall load the flash access code to RAM whenever an erase or write job is started and unload (overwrite) it after that job has been finished or canceled. true: Flash access code loaded on job start / unloaded on job end or error. false: Flash access code not loaded to / unloaded from RAM at all.
    • EcucBooleanParamDef
  • FlsBaseAddress
    • The flash memory start address (see also SWS_Fls_00208 and SWS_Fls_00209). This parameter defines the lower boundary for read / write / erase and compare jobs.
    • EcucIntegerParamDef
  • FlsBlankCheckApi
    • Compile switch to enable/disable the Fls_BlankCheck function. true: API supported / function provided. false: API not supported / function not provided
    • EcucBooleanParamDef
  • FlsCancelApi
    • Compile switch to enable and disable the Fls_Cancel function. true: API supported / function provided. false: API not supported / function not provided
    • EcucBooleanParamDef
  • FlsCompareApi
    • Compile switch to enable and disable the Fls_Compare function. true: API supported / function provided. false: API not supported / function not provided
    • EcucBooleanParamDef
  • FlsDevErrorDetect
    • EcucBooleanParamDef
  • FlsDriverIndex
    • Index of the driver, used by FEE
    • EcucIntegerParamDef (Symbolic Name generated for this parameter)
  • FlsGetJobResultApi
    • Compile switch to enable and disable the Fls_GetJobResult function. true: API supported / function provided. false: API not supported / function not provided
    • EcucBooleanParamDef
  • FlsGetStatusApi
    • Compile switch to enable and disable the Fls_GetStatus function. true: API supported / function provided. false: API not supported / function not provided
    • EcucBooleanParamDef
  • FlsSetModeApi
    • Compile switch to enable and disable the Fls_SetMode function. true: API supported / function provided. false: API not supported / function not provided
    • EcucBooleanParamDef
  • FlsTotalSize
    • The total amount of flash memory in bytes (see also SWS_Fls_00208 and SWS_Fls_00209). This parameter in conjunction with FLS_BASE_ADDRESS defines the upper boundary for read / write / erase and compare jobs.
    • EcucIntegerParamDef
  • FlsUseInterrupts
    • Job processing triggered by hardware interrupt. true: Job processing triggered by interrupt (hardware controlled). false: Job processing not triggered by interrupt (software controlled) or the underlying hardware does not support interrupt mode for flash operations dependency: Only available if supported by underlying flash hardware
    • EcucBooleanParamDef
  • FlsVersionInfoApi
    • EcucBooleanParamDef
• FlsPublishedInformation
  • Additional published parameters not covered by CommonPublishedInformation container. Note that these parameters do not have any configuration class setting, since they are published information.
  • FlsAcLocationErase
    • Position in RAM, to which the erase flash access code has to be loaded. Only relevant if the erase flash access code is not position independent. If this information is not provided it is assumed that the erase flash access code is position independent and that therefore the RAM position can be freely configured.
    • EcucIntegerParamDef
  • FlsAcLocationWrite
    • Position in RAM, to which the write flash access code has to be loaded. Only relevant if the write flash access code is not position independent. If this information is not provided it is assumed that the write flash access code is position independent and that therefore the RAM position can be freely configured.
    • EcucIntegerParamDef
  • FlsAcSizeErase
    • Number of bytes in RAM needed for the erase flash access code
    • EcucIntegerParamDef
  • FlsAcSizeWrite
    • Number of bytes in RAM needed for the write flash access code
    • EcucIntegerParamDef
  • FlsEraseTime
    • Maximum time to erase one complete flash sector.
    • EcucFloatParamDef
  • FlsErasedValue
    • The contents of an erased flash memory cell.
    • EcucIntegerParamDef
  • FlsExpectedHwId
    • Unique identifier of the hardware device that is expected by this driver (the device for which this driver has been implemented). Only relevant for external flash drivers
    • EcucStringParamDef
  • FlsSpecifiedEraseCycles
    • Number of erase cycles specified for the flash device (usually given in the device data sheet). If the number of specified erase cycles depends on the operating environment (temperature, voltage, ...) during reprogramming of the flash device, the minimum number for which a data retention of at least 15 years over the temperature range from -40°C .. +125°C can be guaranteed shall be given. Note: If there are different numbers of specified erase cycles for different flash sectors of the device this parameter has to be extended to a parameter list (similar to the sector list above).
    • EcucIntegerParamDef
  • FlsWriteTime
    • Maximum time to program one complete flash page
    • EcucFloatParamDef