SNIP_CLASSIC_PWM_SECTION_8_3_4_Pwm_SetPeriodAndDuty

8.3.4 Pwm_SetPeriodAndDuty [SWS_Pwm_91001] Definition of API function Pwm_SetPeriodAndDuty ⌈ Service Name Pwm_SetPeriodAndDuty Syntax void Pwm_SetPeriodAndDuty ( Pwm_ChannelType ChannelNumber, Pwm_PeriodType Period, uint16 DutyCycle ) Service ID [hex] 0x03 Sync/Async Asynchronous Reentrancy Reentrant for different channel numbers ChannelNumber Numeric identifier of the PWM Period Period of the PWM signal Parameters (in) DutyCycle Min=0x0000 Max=0x8000 Parameters (inout) None Parameters (out) None Return value None Description Service sets the period and the duty cycle of a PWM channel Available via Pwm.h ⌋ [SWS_Pwm_00019] Upstream requirements: SRS_Pwm_12297 ⌈The function Pwm_SetPeriodAndDuty shall set the period and the duty cycle of a PWM channel.⌋ [SWS_Pwm_00076] ⌈The function Pwm_SetPeriodAndDuty shall update the period always at the end of the current period if supported by the implementation and configured with PwmPeriodUpdatedEndperiod.⌋ [SWS_Pwm_00020] ⌈When updating the PWM period and duty, the driver shall repress any spikes on the PWM output signal.⌋ The PWM duty cycle parameter is necessary to maintain the consistency between frequency and duty cycle. Refer to [SWS_Pwm_00058] and [SWS_Pwm_00059] to know the scaling and format definition of duty cycle parameter Regarding error detection, the requirements [SWS_Pwm_00117], [SWS_Pwm_00045], [SWS_Pwm_00047], [SWS_Pwm_10051] and [SWS_Pwm_20051] are applicable to the function Pwm_SetPeriodAndDuty. [SWS_Pwm_00041] Upstream requirements: SRS_Pwm_12389 ⌈The function Pwm_SetPeriodAndDuty shall allow changing the period only for the PWM channel declared as variable Period type.⌋ [SWS_Pwm_10083] Upstream requirements: SRS_BSW_00171 ⌈The function Pwm_SetPeriodAndDuty shall be pre compile time configurable On/Off by the configuration parameter: PwmSetPeriodAndDuty.⌋ [SWS_Pwm_20083] Upstream requirements: SRS_BSW_00171 ⌈The function Pwm_SetPeriodAndDuty shall be configurable On/Off by the configuration parameter: PwmSetPeriodAndDuty {PWM_SET_PERIOD_AND_DUTY_API}.⌋ [SWS_Pwm_00150] ⌈If the period is set to zero the setting of the duty-cycle is not relevant. In this case the output shall be zero (zero percent duty-cycle).⌋