diff options
author | Joey Castillo <jose.castillo@gmail.com> | 2021-08-02 13:48:35 -0400 |
---|---|---|
committer | Joey Castillo <jose.castillo@gmail.com> | 2021-08-02 14:36:04 -0400 |
commit | 34945d78e933fc62bedcc975e88be02a0b7fcc2e (patch) | |
tree | 317edc18fe08d76a1f5d8c3aabf88cf58ba73897 /watch-library/hal/documentation/pwm.rst | |
parent | 2d1e2e8c76623543817f4c62b26fc300c1fd0d2c (diff) | |
download | Sensor-Watch-34945d78e933fc62bedcc975e88be02a0b7fcc2e.tar.gz Sensor-Watch-34945d78e933fc62bedcc975e88be02a0b7fcc2e.tar.bz2 Sensor-Watch-34945d78e933fc62bedcc975e88be02a0b7fcc2e.zip |
major project reorg, move library one level up
Diffstat (limited to 'watch-library/hal/documentation/pwm.rst')
-rw-r--r-- | watch-library/hal/documentation/pwm.rst | 53 |
1 files changed, 53 insertions, 0 deletions
diff --git a/watch-library/hal/documentation/pwm.rst b/watch-library/hal/documentation/pwm.rst new file mode 100644 index 00000000..71785c63 --- /dev/null +++ b/watch-library/hal/documentation/pwm.rst @@ -0,0 +1,53 @@ +The PWM Driver(bare-bone) +========================= + +Pulse-width modulation (PWM) is used to create an analog behavior +digitally by controlling the amount of power transferred to the +connected peripheral. This is achieved by controlling the high period +(duty-cycle) of a periodic signal. + +User can change the period or duty cycle whenever PWM is running. The +function pwm_set_parameters is used to configure these two parameters. +Note these are raw register values and the parameter duty_cycle means +the period of first half during one cycle, which should be not beyond +total period value. + +In addition, user can also get multi PWM channels output from different +peripherals at the same time, which is implemented more flexible by the +function pointers. + +Features +-------- + +* Initialization/de-initialization +* Enabling/disabling +* Run-time control of PWM duty-cycle and period +* Notifications about errors and one PWM cycle is done + +Applications +------------ + +Motor control, ballast, LED, H-bridge, power converters, and +other types of power control applications. + +Dependencies +------------ + +The peripheral which can perform waveform generation like frequency +generation and pulse-width modulation, such as Timer/Counter. + +Concurrency +----------- + +N/A + +Limitations +----------- + +The current driver doesn't support the features like recoverable, +non-recoverable faults, dithering, dead-time insertion. + +Known issues and workarounds +---------------------------- + +N/A |