SNIP_CLASSIC_ADC_SECTION_8_3_14_Adc_SetPowerState

8.3.14 Adc_SetPowerState [SWS_Adc_00475] Definition of API function Adc_SetPowerState ⌈ Service Name Adc_SetPowerState Syntax Std_ReturnType Adc_SetPowerState ( Adc_PowerStateRequestResultType* Result ) Service ID [hex] 0x10 Sync/Async Synchronous Reentrancy Non Reentrant Parameters (in) None Parameters (inout) None Parameters (out) Result If the API returns E_OK: ADC_SERVICE_ACCEPTED: Power state change executed. If the API returns E_NOT_OK: ADC_NOT_INIT: ADC Module not initialized. ADC_SEQUENCE_ERROR: wrong API call sequence. ADC_HW_FAILURE: the HW module has a failure which prevents it to enter the required power state. Return value Std_ReturnType E_OK: Power Mode changed E_NOT_OK: request rejected Description This API configures the Adc module so that it enters the already prepared power state, chosen between a predefined set of configured ones. Available via Adc.h ⌋ [SWS_Adc_00481] ⌈The API configures the HW in order to enter the previously prepared Power State. All preliminary actions to enable this transition (e.g. setting all channels in IDLE status, de-registering of all notifications and so on) must already have been taken by the responsible SWCs (e.g. IoHwAbs). The API shall not execute preliminary, implicit power state changes (i.e. if a requested power state is not reachable starting from the current one, no intermediate power state change shall be executed and the request shall be rejected)⌋ [SWS_Adc_00482] ⌈In case the target power state is the same as the current one, no action is executed and the API returns immediately with an E_OK result.⌋ [SWS_Adc_00483] ⌈In case the normal Power State is requested, the API shall refer to the necessary parameters contained in the same containers used by Adc_Init.⌋ No separate container or hard coded data shall be used for the normal (i.e. full) power mode, in order to avoid misalignments between initialization parameters used during the init phase and during a power state change. [SWS_Adc_00484] ⌈For the other power states, only power state transition specific reconfigurations shall be executed in the context of this API (i.e. the API cannot be used to apply a completely new configuration to the Adc module). Any other re-configuration not strictly related to the power state transition shall not take place.⌋ [SWS_Adc_00485] ⌈The API shall refer to the configuration container related to the required Power State in order to derive some specific features of the state (e.g support of Power States).⌋ [SWS_Adc_00486] ⌈In case development error reporting is activated: The API shall report the DET error ADC_E_UNINIT in case this API is called before having initialized the HW unit.⌋ [SWS_Adc_00487] ⌈The API shall report a runtime error ADC_E_NOT_DISENGAGED in case this API is called when one or more HW channels (where applicable) are in a state different then IDLE (or similar non-operational states) and/or there are still notification registered for the HW module channels.⌋ [SWS_Adc_00488] ⌈In case development error reporting is activated: The API shall report the DET error ADC_E_POWER_STATE_NOT_SUPPORTED in case this API is called with an unsupported power state or the peripheral does not support low power states at all.⌋ [SWS_Adc_00489] ⌈The API shall report a runtime error ADC_E_TRANSITION_ NOT_POSSIBLE in case the requested power state cannot be directly reached from the current power state.⌋ [SWS_Adc_00490] ⌈In case development error reporting is activated: The API shall report the DET error ADC_E_PERIPHERAL_NOT_PREPARED in case the HW unit has not been previously prepared for the target power state by use of the API Adc_PreparePowerState().⌋