tyeth
diff --git a/‎tools/pwm/README.md‎ ‎…sts/circuitpython-manual/pwmio/README.md‎tools/pwm/README.md renamed to tests/circuitpython-manual/pwmio/README.md
Lines changed: 6 additions & 0 deletions b/‎tools/pwm/README.md‎ ‎…sts/circuitpython-manual/pwmio/README.md‎tools/pwm/README.md renamed to tests/circuitpython-manual/pwmio/README.md
Lines changed: 6 additions & 0 deletions
diff --git a/‎tools/pwm/code.py‎ ‎tests/circuitpython-manual/pwmio/code.py‎tools/pwm/code.py renamed to tests/circuitpython-manual/pwmio/code.py b/‎tools/pwm/code.py‎ ‎tests/circuitpython-manual/pwmio/code.py‎tools/pwm/code.py renamed to tests/circuitpython-manual/pwmio/code.py
diff --git a/‎tools/pwm/duty.py‎ ‎tests/circuitpython-manual/pwmio/duty.py‎tools/pwm/duty.py renamed to tests/circuitpython-manual/pwmio/duty.py b/‎tools/pwm/duty.py‎ ‎tests/circuitpython-manual/pwmio/duty.py‎tools/pwm/duty.py renamed to tests/circuitpython-manual/pwmio/duty.py
diff --git a/‎tests/circuitpython-manual/pwmio/pwm_flaw_explainer.png‎
300 KB b/‎tests/circuitpython-manual/pwmio/pwm_flaw_explainer.png‎
300 KB
diff --git a/‎tools/pwm/pwm_plot_explainer.png‎ ‎…thon-manual/pwmio/pwm_plot_explainer.png‎tools/pwm/pwm_plot_explainer.png renamed to tests/circuitpython-manual/pwmio/pwm_plot_explainer.png b/‎tools/pwm/pwm_plot_explainer.png‎ ‎…thon-manual/pwmio/pwm_plot_explainer.png‎tools/pwm/pwm_plot_explainer.png renamed to tests/circuitpython-manual/pwmio/pwm_plot_explainer.png
diff --git a/‎tools/pwm/pr.md‎
Lines changed: 0 additions & 95 deletions b/‎tools/pwm/pr.md‎
Lines changed: 0 additions & 95 deletions
diff --git a/‎tools/pwm/pwm_rounding.png‎
-30.8 KB b/‎tools/pwm/pwm_rounding.png‎
-30.8 KB
diff --git a/‎tools/pwm/ramps_esp32s2_905.png‎
-21.9 KB b/‎tools/pwm/ramps_esp32s2_905.png‎
-21.9 KB
diff --git a/‎tools/pwm/ramps_nrf52840_901.png‎
-25.7 KB b/‎tools/pwm/ramps_nrf52840_901.png‎
-25.7 KB
diff --git a/‎tools/pwm/ramps_rp2040_904.png‎
-28.4 KB b/‎tools/pwm/ramps_rp2040_904.png‎
-28.4 KB
@@ -31,3 +31,9 @@ These tests can be used to assess how well the PWM API delivers expected behavio
 7.  Changes in frequency may (and will usually) result in a transient glitch in frequency and duty cycle.  PWM hardware is generally not designed for glitch-free frequency transitions.
 
 8.  PWM frequency and duty cycle should be jitter-free.
+
+## Examples of PWM flaws
+
+The plot at the top of this page depicts data PWM gathered from a device with an API that displays all of the expected behavior listed above.  The plots below show how the tools reveal flaws in the behavior of PWM APIs that are not as complete.
+
+<img src="pwm_flaw_explainer.png">