MCU Driver (Mcu)

This service initializes the MCU driver.

This service initializes the RAM section wise.

This service initializes the PLL and other MCU specific clock options.

This service activates the PLL clock to the MCU clock distribution.

This service provides the lock status of the PLL.

The service reads the reset type from the hardware, if supported.

The service reads the reset type from the hardware register, if supported.

The service performs a microcontroller reset.

This service activates the MCU power modes.

This service returns the version information of this module.

This service provides the actual status of the microcontroller Ram. (if supported)

A pointer to such a structure is provided to the MCU initialization routines for configuration.

This is a status value returned by the function Mcu_ Get Pll Status of the MCU module.

Specifies the identification (ID) for a clock setting, which is configured in the configuration structure

This is the type of the reset enumerator containing the subset of reset types. It is not required that all reset types are supported by hardware.

This type specifies the reset reason in raw register format read from a reset status register.

Name Mcu_ Mode Type Kind Type Derived from uint Range 0..<number of MCU modes> - 1 -- The range is dependent on the number of MCU modes provided in the configuration structure. The type shall be chosen depending on MCU platform for best performance. Des cription This type specifies the identification (ID) for a MCU mode, which is configured in the configuration structure. Available via Mcu.h

This type specifies the identification (ID) for a RAM section, which is conf igured in the configuration structure.

This is the Ram State data type returned by the function Mcu_ Get Ram State of the Mcu module. It is not required that all RAM state types are supported by the hardware.

[SWS_Mcu_00011] ⌈The function Mcu_InitRamSection shall fill the memory from address McuRamSectionBaseAddress up to address McuRamSectionBaseAd- dress + McuRamSectionSize-1 with the byte-value contained in McuRamDefault- Value and by writing at once a number of bytes defined by McuRamSectionWrite- Size, where McuRamSectionBaseAddress, McuRamSectionSize, McuRamDe- faultValue and McuRamSectionWriteSize are the values of the configuration parameters for each RamSection.⌋

Type of error Related error code Error value API service called with wrong parameter MCU_ E_ PARAM_ CONFIG 0x0A API service called with wrong parameter MCU_ E_ PARAM_ CLOCK 0x0B API service called with wrong parameter MCU_ E_ PARAM_ MODE 0x0C API service called with wrong parameter MCU_ E_ PARAM_ RAMSECTION 0x0D API service called with wrong parameter MCU_ E_ PLL_ NOT_ LOCKED 0x0E API service called with wrong parameter MCU_ E_ UNINIT 0x0F API service called with wrong parameter MCU_ E_ PARAM_ POINTER 0x10 API service called with wrong parameter MCU_ E_ INIT_ FAILED 0x11

[SWS_Mcu_00056] ⌈The function Mcu_DistributePllClock shall return without affecting the MCU hardware if the PLL clock has been automatically activated by the MCU hardware.⌋

[SWS_Mcu_00136] ⌈The MCU module’s environment shall call the function Mcu_- InitRamSection only after the MCU module has been initialized using the function Mcu_Init.⌋

[SWS_Mcu_00140] ⌈The function Mcu_DistributePllClock shall activate the PLL clock to the MCU clock distribution.⌋

[SWS_Mcu_00141] ⌈The function Mcu_DistributePllClock shall remove the cur- rent clock source (for example internal oscillator clock) from MCU clock distribution.⌋ The MCU module’s environment shall only call the function Mcu_DistributePll- Clock after the status of the PLL has been detected as locked by the function Mcu_ GetPllStatus.

[SWS_Mcu_00142] ⌈If the function Mcu_DistributePllClock is called before PLL has locked, this function shall return E_NOT_OK immediately, without any further ac- tion.⌋

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

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

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_Mcu_00205] ⌈The function Mcu_DistributePllClock shall be available if the pre-compile parameter McuNoPll is set to FALSE. Otherwise, this Api has to be disabled (see also [ECUC_Mcu_00180]).⌋

Fail criteria for MCU_E_CLOCK_FAILURE: a clock source failure occurs

Pass criteria for MCU_E_CLOCK_FAILURE: no clock source failure occur s

: The MCU Driver module shall reject configurations with partition mappings which are not supported by the implementation.

: The module will operate as an independent instance in each of the partitions, means the called API will only tar get the partition it is called in.