SNIP_CLASSIC_PWM_SECTION_8_3_3_Pwm_SetDutyCycle

8.3.3 Pwm_SetDutyCycle [SWS_Pwm_91000] Definition of API function Pwm_SetDutyCycle ⌈ Service Name Pwm_SetDutyCycle Syntax void Pwm_SetDutyCycle ( Pwm_ChannelType ChannelNumber, uint16 DutyCycle ) Service ID [hex] 0x02 ▽ △ Sync/Async Asynchronous Reentrancy Reentrant for different channel numbers ChannelNumber Numeric identifier of the PWM Parameters (in) DutyCycle Min=0x0000 Max=0x8000 Parameters (inout) None Parameters (out) None Return value None Description Service sets the duty cycle of the PWM channel. Available via Pwm.h ⌋ [SWS_Pwm_00013] Upstream requirements: SRS_Pwm_12295 ⌈The function Pwm_SetDutyCycle shall set the duty cycle of the PWM channel.⌋ [SWS_Pwm_00014] ⌈When the requested duty cycle is either 0% or 100%, the function Pwm_SetDutyCycle shall set the PWM output state to either PWM_HIGH or PWM_LOW, with regard to both the configured polarity parameter and the requested duty cycle. Thus for 0% requested Duty Cycle the output will be the inverse of the configured polarity parameter, and for 100% Duty Cycle the output will be equal to the configured polarity parameter.⌋ [SWS_Pwm_00016] ⌈The function Pwm_SetDutyCycle shall modulate the PWM output signal according to parameters period, duty cycle and configured polarity, when the duty cycle > 0 % and < 100%.⌋ [SWS_Pwm_00017] Upstream requirements: SRS_Pwm_12382 ⌈The function Pwm_SetDutyCycle shall update the duty cycle always at the end of the period if supported by the implementation and configured with PwmDutycycleUpdatedEndperiod.⌋ Regarding format definition of duty cycle parameter, the requirement [SWS_Pwm_00058] is applicable to the function Pwm_SetDutyCycle. Regarding scaling definition of duty cycle parameter, the requirement [SWS_Pwm_00059] is applicable to the function Pwm_SetDutyCycle. [SWS_Pwm_00018] ⌈The driver shall forbid the spike on the PWM output signal.⌋ Regarding error detection, the requirements [SWS_Pwm_00117], [SWS_Pwm_00047], [SWS_Pwm_10051] and [SWS_Pwm_20051] are applicable to the function Pwm_SetDutyCycle. [SWS_Pwm_10082] Upstream requirements: SRS_BSW_00171 ⌈The function Pwm_SetDutyCycle shall be pre compile time configurable On/Off by the configuration parameter: PwmSetDutyCycle.⌋ [SWS_Pwm_20082] Upstream requirements: SRS_BSW_00171 ⌈The function Pwm_SetDutyCycle shall be configurable On/Off by the configuration parameter: PwmSetDutyCycle {PWM_SET_DUTY_CYCLE_API}.⌋