ICU Driver (Icu)

This function initializes the driver.

This function de - initializes the ICU module.

This function sets the ICU mode.

This function disables the wakeup capability of a single ICU channel.

This function (re - )enables the wakeup capability of the given ICU channel.

This function sets the activation - edge for the given channel.

This function disables the notification of a channel.

This function enables the notification on the given channel.

This function returns the status of the ICU input.

This function starts the capturing of timer values on the edges.

This function stops the timestamp measurement of the given channel.

This function reads the timestamp index of the given channel.

This function resets the value of the counted edges to zero.

This function enables the counting of edges of the given channel.

This function disables the counting of edges of the given channel.

This function reads the number of counted edges.

This function starts the measurement of signals.

This function stops the measurement of signals of the given channel.

Description This function reads the elapsed Signal Low Time for the given channel.

This function reads the coherent active time and period time for the given ICU Channel.

This function returns the version information of this module.

According to the last call of Icu_ Enable Notification, this notification function to be called if the requested signal edge (rising / falling / both edges) occurs (once per edge).

This notification to be called if the number of requested timestamps (Notification interval > 0) are acquired and if the notification has been enabled by the call of Icu_ Enable Notification().

Checks if a wakeup capable ICU channel is the source for a wakeup event and calls the ECU state manager service Ecu M_ Set Wakeup Event in case of a valid ICU channel wakeup event.

This function enables / re - enables the detection of edges of the given channel.

This function disables the detection of edges of the given channel.

This function disables the notification of a channel.

This function enables the notification on the given channel.

Allow enabling / disabling of all interrupts which are not required for the ECU wakeup.

Numeric identifier of an ICU channel Avail able via Icu.h

Input state of an ICU channel

This type contains initialization data.

Definition of the type of activation of an ICU channel.

Width of the buffer for timestamp ticks and measured elapsed timeticks.

Type which shall contain the values, needed for calculating duty cycles.

Type, to abstract the return value of the service Icu_ Get Timestamp Index().Since circular buffer handling is supported and Icu_ Get Timestamp Index can return '0' as a legally true value ( not as an error according to ICU107 and ICU135), Icu_ Index Type may be implemented to have values 1..xyz.

Type, to abstract the return value of the service Icu_ Get Edge Numbers().

Definition of the measurement mode type

Def inition of the measurement property type

Definition of the timestamp measurement property type

[SWS_Icu_00018] Upstream requirements: SRS_SPAL_12056 ⌈The Icu notification functions shall be configurable as function pointers within the ini- tialization data structure (Icu_ConfigType).⌋

[SWS_Icu_00021] Upstream requirements: SRS_SPAL_00157, SRS_Icu_12369 ⌈According to the last call of Icu_EnableNotification, the Icu module shall call the notification function Icu_SignalNotification_<Channel> if the requested signal edge (rising / falling / both edges) occurs (once per edge).⌋

[SWS_Icu_00042] Upstream requirements: SRS_Icu_12305 ⌈After a call of Icu_DisableNotification, the Icu module shall not call the notifi- cation function Icu_SignalNotification_<Channel>.⌋

[SWS_Icu_00044] Upstream requirements: SRS_Icu_12305 ⌈Only those edge notifications shall be provided, which are supported by hardware.⌋

[SWS_Icu_00055] Upstream requirements: SRS_SPAL_12069, SRS_BSW_00410 ⌈The static configuration parameter IcuReportWakeupSource is set to "ON"⌋ • [SWS_Icu_00056] Upstream requirements: SRS_SPAL_12069 ⌈The module is in mode ICU_MODE_SLEEP⌋ • [SWS_Icu_00057] Upstream requirements: SRS_SPAL_12069 ⌈A wakeup event occurs on a wakeup capable ICU channel.⌋

[SWS_Icu_00056] Upstream requirements: SRS_SPAL_12069 ⌈The module is in mode ICU_MODE_SLEEP⌋ • [SWS_Icu_00057] Upstream requirements: SRS_SPAL_12069 ⌈A wakeup event occurs on a wakeup capable ICU channel.⌋

[SWS_Icu_00057] Upstream requirements: SRS_SPAL_12069 ⌈A wakeup event occurs on a wakeup capable ICU channel.⌋

[SWS_Icu_00119] Upstream requirements: SRS_SPAL_12129 ⌈The ISRs shall reset the interrupt flags (if needed by hardware) and call the corre- sponding notification functions.⌋

[SWS_Icu_00187] Upstream requirements: SRS_BSW_00359 ⌈The Icu module’s notification functions shall have no parameters and no return value.⌋

Det _ Report - Error Det.h Service to report development errors. Ecu M _ - Check - Wakeup Ecu M.h This function can be called to check the given wakeup sources. It will pass the argument to the integrator function Ecu M_ Check Wakeup Hook. It can also be called by the ISR of a wakeup s ource to set up the PLL and check other wakeup sources that may be connected to the same interrupt. Ecu M _ Set - Wakeup - Event Ecu M.h Sets the wakeup event.

[SWS_Icu_00216] ⌈The Icu module shall call the notification Icu_TimestampNotification_<Channel> if the number of requested timestamps (Notification interval > 0) are acquired and if the notification has been enabled by the call of Icu_EnableNotification.⌋

[SWS_Icu_00217] ⌈After a call of Icu_DisableNotification the Icu module shall NOT call the notification Icu_TimestampNotification_<Channel>.⌋

[SWS_Icu_00218] ⌈The Icu module’s notification Icu_TimestampNotification_<Channel> depends on pre-processor switch IcuTimestampApi.⌋

[SWS_Icu_00228] ⌈EcuM_CheckWakeup shall be called within the Interrupt Service Routine servicing the ICU channel wakeup event on wakeup-capable channel.⌋

[SWS_Icu_00229] ⌈The ISR’s, providing the wakeup events, shall be responsible for resetting the interrupt flags if required by hardware.⌋

Module Header File Imported Type Ecu M Ecu M.h Ecu M _ Wakeup Source Type Std Std_ Types.h Std _ Return Type Std_ Types.h Std _ Version Info Type

[SWS_Icu_00348] ⌈Re-entrancy of operation Icu_SignalNotification_<Channel> is not relevant for this module (In general it is in this case not re-entrant).⌋

[SWS_Icu_00349] ⌈Re-entrancy of the Icu_TimestampNotification_<Channel> is not relevant for this module (in general it is in this case not re-entrant).⌋

[SWS_Icu_00356] ⌈If development error detection for the Icu module is enabled: The function Icu_GetVersionInfo shall check the parameter versioninfo for not being NULL and shall raise the development error code ICU_E_PARAM_VINFO if the check fails.⌋

[SWS_Icu_00359] ⌈The function Icu_CheckWakeup shall check if a wakeup capable ICU channel is the source for a wakeup event and call EcuM_SetWakeupEvent to indicate a valid timer wakeup event to the ECU State Manager.⌋

[SWS_Icu_00360] ⌈The function Icu_CheckWakeup is only feasible, if IcuReport- WakeupSource is statically configured available.⌋

[SWS_Icu_00361] ⌈The ICU module’s environment shall only use the re-entrant capa- bility of the function Icu_CheckWakeup if the ICU module’s environment takes care that there is no simultaneous usage of the same channel.⌋

[SWS_Icu_00362] ⌈The function Icu_CheckWakeup shall be pre compile time con- figurable On/Off by the configuration parameter: IcuWakeupFunctionalityApi⌋

[SWS_Icu_00363] ⌈If development error detection for the ICU module is enabled: if the function Icu_CheckWakeup is called before the ICU module was initialized, the function Icu_CheckWakeup shall raise the development error ICU_E_UNINIT.⌋

Type of error Related error code Error value API IS called with invalid pointer. ICU_ E_ PARAM_ POINTER 0x0A API service used with an invalid channel identifier or channel was not configured for the functionality of the calling API. ICU_ E_ PARAM_ CHANNEL 0x0B API service used with an invalid or not feasible activation. ICU_ E_ PARAM_ ACTIVATION 0x0C Init funct ion failed. ICU_ E_ INIT_ FAILED 0x0D API service used with an invalid buffer size. ICU_ E_ PARAM_ BUFFER_ SIZE 0x0E API service Icu_ Set Mode used with an invalid mode. ICU_ E_ PARAM_ MODE 0x0F API service used without module initialization. ICU_ E_ UNINIT 0x14 API service Icu_ Set Mode is called while a running operation. ICU_ E_ BUSY_ OPERATION 0x16 API Icu_ Init service is called and when the ICU driver and the Hardware are already initialized. ICU_ E_ ALREADY_ INITIALIZED 0x17 API Icu_ Start Time Stamp is called and the parameter Notify Interval is invalid (e.g."0", Notify Interval < 1) ICU_ E_ PARAM_ NOTIFY_ INTERVAL 0x18 API Icu_ Get Version Info is called and the parameter versioninfo is is invalid ( e.g. NULL ) ICU_ E_ PARAM_ VINFO 0x19

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

If development error detection for the Icu module is enabled: This function shall raise development error ICU_E_UNINIT when the function Icu_Init has not been called .

If development error detection for the Icu module is enabled: This function shall raise development error ICU_E_U NINIT when the function Icu_Init has not been called .

If development error detection fo r the Icu module is enabled: This function shall raise development error ICU_E_UNINIT when the function Icu_Init has not been called .

File Det _ Report - Runtime Error Det.h Service to report runtime errors. If a callout has been configured then this callout shall be called.

Type of error Related error code Error value API service Icu_ Stop Timestamp called on a channel which was not started or already stopped ICU_ E_ NOT_ STARTED 0x15

The ECUC partitions referenced by IcuKernelEcucPar- titionRef shall be a subset of the ECUC partitions referenced by IcuEcucPartitionRef.

The ECUC partitions referenced by IcuChannelEcuc PartitionRef shall be a subset of the ECUC partitions referenced by IcuEcucPartition Ref.

If IcuEcucPartitionRef reference s one or more ECUC partitions, IcuKernelEcucPartitionRef shall have a multiplicity of one and reference one of these ECUC partitions as well.

If IcuEcucPartitionRef references one or more ECUC partitions, IcuChannelEcucPartitionRef shall have a multiplicity of greater than one and reference one or several of these ECUC partitions as well.