SNIP_CLASSIC_ADC_SECTION_8_3_4_Adc_StartGroupConversion

8.3.4 Adc_StartGroupConversion [SWS_Adc_00367] Definition of API function Adc_StartGroupConversion ⌈ Service Name Adc_StartGroupConversion Syntax void Adc_StartGroupConversion ( Adc_GroupType Group ) Service ID [hex] 0x02 Sync/Async Asynchronous Reentrancy Reentrant Parameters (in) Group Numeric ID of requested ADC Channel group. Parameters (inout) None Parameters (out) None Return value None Description Starts the conversion of all channels of the requested ADC Channel group. Available via Adc.h ⌋ [SWS_Adc_00061] Upstream requirements: SRS_Adc_12364 ⌈The function Adc_StartGroupConversion shall start the conversion of all channels of the requested ADC Channel group. Depending on the group configuration, one-shot or continuous conversion is started.⌋ [SWS_Adc_00431] ⌈The function Adc_StartGroupConversion shall reset the internal result buffer pointer, that conversion result storage always starts, after calling Adc_ StartGroupConversion, at the result buffer base address which was configured with Adc_SetupResultBuffer.⌋ [SWS_Adc_00156] Upstream requirements: SRS_Adc_12317, SRS_Adc_12318 ⌈The function Adc_StartGroupConversion shall NOT automatically enable the notification mechanism for that group (this has to be done by a separate API call).⌋ [SWS_Adc_00146] Upstream requirements: SRS_Adc_12817, SRS_Adc_12364 ⌈The ADC module’s environment shall only call Adc_StartGroupConversion for groups configured with software trigger source.⌋ [SWS_Adc_00259] Upstream requirements: SRS_BSW_00171 ⌈The function Adc_StartGroupConversion shall be pre-compile time configurable On/ Off by the configuration parameter AdcEnableStartStopGroupApi.⌋ [SWS_Adc_00125] Upstream requirements: SRS_BSW_00323, SRS_BSW_00386, SRS_SPAL_12448 ⌈If development error detection for the ADC module is enabled:when called with a non-existing channel group ID, function Adc_StartGroupConversion shall raise development error ADC_E_PARAM_GROUP and return without any action.⌋ [SWS_Adc_00133] Upstream requirements: SRS_BSW_00386, SRS_SPAL_12448 ⌈If development error detection for the ADC module is enabled: when called on a group with trigger source configured as hardware, function Adc_StartGroupConversion shall raise development error ADC_E_WRONG_TRIGG_SRC and return without any action.⌋ [SWS_Adc_00346] ⌈If the priority mechanism is disabled and the queuing is disabled : when called while any of the groups, which can not be implicitly stopped, is not in state ADC_IDLE, the function Adc_StartGroupConversion shall report a runtime error ADC_E_BUSY.⌋ Note: The condition that any group is not in state ADC_IDLE means in this context: • Any conversion is ongoing or • Any HW trigger is enabled [SWS_Adc_00426] ⌈If the priority mechanism is disabled and the queuing is disabled: when called while any of the groups, which can be implicitly stopped, is not in state ADC_IDLE and not in state ADC_STREAM_COMPLETED, the function Adc_ StartGroupConversion shall report a runtime error ADC_E_BUSY.⌋ Note: Groups which can be implicitly stopped are: • Software triggered groups configured in one-shot, single-access mode • Software triggered groups configured in continuous, linear streaming access mode • Hardware triggered groups configured in one-shot, linear streaming access mode [SWS_Adc_00348] ⌈If the priority mechanism is enabled: when called while agroup, which can not be implicitly stopped, is not in state ADC_IDLE, the function Adc_Start GroupConversion shall report a runtime error ADC_E_BUSY.⌋ Note: The condition that the group is not in state ADC_IDLE means in this context: • The conversion of the same group is currently ongoing or • A conversion request for the same group is already stored one time in the queue [SWS_Adc_00427] ⌈If the priority mechanism is enabled: when called while a group, which can be implicitly stopped, is not in state ADC_IDLE and not in state ADC_ STREAM_COMPLETED, the function Adc_StartGroupConversion shall report a runtime error ADC_E_BUSY.⌋ [SWS_Adc_00351] ⌈If the priority mechanism is disabled and the queuing is enabled: when called while a group, which can not be implicitly stopped, is not in state ADC_ IDLE, the function Adc_StartGroupConversion shall report a runtime error ADC_E_ BUSY.⌋ [SWS_Adc_00428] ⌈If the priority mechanism is disabled and the queuing is enabled: when called while a group, which can be implicitly stopped, is not in state ADC_IDLE and not in state ADC_STREAM_COMPLETED, the function Adc_StartGroupConversion shall report a runtime error ADC_E_BUSY.⌋ [SWS_Adc_00294] Upstream requirements: SRS_BSW_00406 ⌈If development error detection for the ADC module is enabled:when called prior to initializing the driver, the function Adc_StartGroupConversion shall raise development error ADC_E_UNINIT.⌋ [SWS_Adc_00424] ⌈If development error detection for the ADC module is enabled: when called prior to initializing the result buffer pointer with function Adc_SetupResult Buffer, the function Adc_StartGroupConversion shall raise development error ADC_E_ BUFFER_UNINIT.⌋