Add Binary Counter script

Author: chrisib

software/contrib/README.md

@@ -28,6 +28,13 @@ Smooth random voltages based on bezier curves. Inspired by the ADDAC507 Random B
 <i>Author: [chrisib](https://github.com/chrisib)</i>
 <br><i>Labels: Random</i>
 
+### Binary Counter \[ [documentation](/software/contrib/binary_counter.md) | [script](/software/contrib/binary_counter.py) \]
+
+A simple gate sequencer implemented using a 6-bit binary counter.
+
+<i>Author: [chrisib](https://github.com/chrisib)</i>
+<br><i>Labels: gates, sequencer, binary</i>
+
 ### Bit Garden \[ [documentation](/software/contrib/bit_garden.md) | [script](/software/contrib/bit_garden.py) \]
 
 Mirrors a gate/trigger input, with adjustable skip probability across channels.

software/contrib/binary_counter.md

@@ -0,0 +1,24 @@
+# Binary Counter
+
+Binary Counter is a simple gate sequencer that uses binary numbers to turn gates on & off.
+
+Starting from zero, every time a gate is received on `din`, the value of the counter is
+incremented by `k`, and CV1-6 are set on/off according to the binary representation of the
+counter.
+
+## I/O Mapping
+
+| I/O           | Usage
+|---------------|-------------------------------------------------------------------|
+| `din`         | Input gate signal                                                 |
+| `ain`         | CV input to control `k`                                           |
+| `b1`          | Manual gate signal                                                |
+| `b2`          | Reset `n` to zero                                                 |
+| `k1`          | Control for `k`                                                   |
+| `k2`          | Attenuator for `ain`                                              |
+| `cv1`         | Least significant bit output                                      |
+| `cv2`         | 2s-bit output                                                     |
+| `cv3`         | 4s-bit output                                                     |
+| `cv4`         | 8s-bit output                                                     |
+| `cv5`         | 16s-bit output                                                    |
+| `cv6`         | Most significant bit output                                       |

software/contrib/binary_counter.py

@@ -0,0 +1,61 @@
+from europi import *
+from europi_script import EuroPiScript
+
+
+class BinaryCounter(EuroPiScript):
+    MAX_N = (1 << NUM_CVS) - 1
+
+    def __init__(self):
+        super().__init__()
+
+        self.n = 0
+        self.k = int(
+            (
+                k1.percent() + k2.percent() * ain.percent()
+            ) * self.MAX_N
+        )
+
+        self.gate_recvd = False
+
+        din.handler(self.on_gate_rise)
+        din.handler_falling(self.on_gate_fall)
+        b1.handler(self.on_gate_rise)
+        b1.handler_falling(self.on_gate_fall)
+
+        b2.handler(self.reset)
+
+    def on_gate_rise(self):
+        self.gate_recvd = True
+
+    def on_gate_fall(self):
+        turn_off_all_cvs()
+
+    def reset(self):
+        self.n = 0
+
+    def set_outputs(self):
+        for i in range(NUM_CVS):
+            if (self.n >> i) & 0x01:
+                cvs[i].on()
+            else:
+                cvs[i].off()
+
+    def main(self):
+        while True:
+            self.k = int(
+                (
+                    k1.percent() + k2.percent() * ain.percent()
+                ) * self.MAX_N
+            )
+
+            if self.gate_recvd:
+                self.set_outputs()
+                self.n = (self.n + self.k) & self.MAX_N
+                self.gate_recvd = False
+
+            oled.centre_text(f"""k = {self.k}
+{self.n:06b}""")
+
+
+if __name__ == "__main__":
+    BinaryCounter().main()

software/contrib/menu.py

@@ -23,6 +23,7 @@
     ["Arpeggiator",       "contrib.arp.Arpeggiator"],
     ["Bernoulli Gates",   "contrib.bernoulli_gates.BernoulliGates"],
     ["Bezier Curves",     "contrib.bezier.Bezier"],
+    ["Binary Counter",    "contrib.binary_counter.BinaryCounter"],
     ["Bit Garden",        "contrib.bit_garden.BitGarden"],
     ["Clock Modifier",    "contrib.clock_mod.ClockModifier"],
     ["Coin Toss",         "contrib.coin_toss.CoinToss"],