tests: drivers: pwm: pwm_api: Missing sleep statement

If a board runs this test at a high frequency,
they will see a noticable skip of a test due to
a missing k_sleep function that allows the pwm
time to display the requested pwm signal.

Signed-off-by: Emilio Benavente <emilio.benavente@nxp.com>