dt: pwm: add period set helpers

The period cell in the PWM specifier needs to be provided in nanoseconds.
However, in some applications it is more convenient to use another scale
such as milliseconds. This patch introduces 3 helpers to allow using
seconds, milliseconds and microseconds scales.

Signed-off-by: Gerard Marull-Paretas <gerard.marull@nordicsemi.no>