drivers: some adjustments to low-level pwm driver

- adjusted doxygen and boilerplate
- changed return values for start and stop functions