summaryrefslogtreecommitdiff
path: root/docs/rp2/tutorial
diff options
context:
space:
mode:
authorStig Bjørlykke <stig@bjorlykke.org>2022-12-15 18:32:10 +0100
committerDamien George <damien@micropython.org>2023-01-12 17:07:43 +1100
commit209a6bb6b7b39882e0efdf25eab29931fb2de859 (patch)
treef70f01ad6e54fcfdf85bab3e03aa13889bf59b98 /docs/rp2/tutorial
parent5890a17ae049aad39f97744cadf5844c06a5a4c0 (diff)
docs/rp2: Make LED have exactly 50% duty cycle in PIO 1Hz example.
This ensures the same number of cycles are used for LED on and LED off in the PIO 1Hz example. It's also possible to swap the first set() and the irq() to avoid using an extra instruction, but this tutorial is a good example of how to calculate the cycles. Signed-off-by: Stig Bjørlykke <stig@bjorlykke.org>
Diffstat (limited to 'docs/rp2/tutorial')
-rw-r--r--docs/rp2/tutorial/pio.rst7
1 files changed, 5 insertions, 2 deletions
diff --git a/docs/rp2/tutorial/pio.rst b/docs/rp2/tutorial/pio.rst
index 9981aed83..4e519650e 100644
--- a/docs/rp2/tutorial/pio.rst
+++ b/docs/rp2/tutorial/pio.rst
@@ -76,9 +76,10 @@ and state machines. Below is the code for reference.
nop() [29]
jmp(x_dec, "delay_high")
- # Cycles: 1 + 7 + 32 * (30 + 1) = 1000
+ # Cycles: 1 + 1 + 6 + 32 * (30 + 1) = 1000
+ nop()
set(pins, 0)
- set(x, 31) [6]
+ set(x, 31) [5]
label("delay_low")
nop() [29]
jmp(x_dec, "delay_low")
@@ -113,6 +114,8 @@ the following:
X starts with the value 31 this jump will happen 31 times, so the ``nop() [29]``
runs 32 times in total (note there is also one instruction cycle taken by the
``jmp`` for each of these 32 loops).
+- The single ``nop()`` correlates with the cycle used for IRQ raise, and ensures
+ the same number of cycles are used for LED on and LED off.
- ``set(pins, 0)`` will turn the LED off by setting pin 25 low.
- Another 32 loops of ``nop() [29]`` and ``jmp(...)`` will execute.
- Because ``wrap_target()`` and ``wrap()`` are not specified, their default will