Master clock

software/contrib/cvecorder.py

@@ -82,7 +82,7 @@ def __init__(self):
         #self.CvRecording = []  # CV recorder flags
 
         # Load CV Recordings from a previously stored state on disk or initialize if blank
-        self.showLoadingScreen()
+        #self.showLoadingScreen()
         self.loadState()
 
         # Test routine, pick a random bank n times and save, then load the state
@@ -285,7 +285,7 @@ def saveState(self):
     def loadState(self):
 
         # For each bank, check if a state file exists, then load it
-        # If not, initialize the bank with zeros
+        # If not, initialize the bank with zeros then save it
 
         # Potential issue......
         # If for some reason the file open command fails, it will init each bank and wipe any previous recordings
@@ -306,7 +306,7 @@ def loadState(self):
             fileName = f"saved_state_{self.__class__.__qualname__}_{b}.txt"
 
             # Write the value to a the state file
-            maxRetries = 6
+            maxRetries = 2
             attempts = 0
             while attempts < maxRetries:
 
@@ -320,6 +320,7 @@ def loadState(self):
                         if self.initTest:
                             print(f"Loading previous state for bank: {str(b)}. Size: {len(jsonData)}")
 
+                        self.showLoadingScreen(str(b))
                         if self.debugLogging:
                             self.writeToDebugLog(f"[loadState] [{attempts}] Loading previous state for bank: {str(b)}. Size: {len(jsonData)}")
 
@@ -347,14 +348,17 @@ def loadState(self):
                         self.CVR[b].append([])
                         for n in range (0, self.stepLength):
                             self.CVR[b][i].append(0)
+                    # Save the state file for faster loading on next boot
+                    self.bankToSave = b
+                    self.saveState()
 
                 except Exception as e:
-                    self.errorString = 'r'
+                    self.errorString = 'x'
                     if self.debugLogging:
                         self.writeToDebugLog(f"[loadState] [{attempts}] Exception when attempting to open previous state file for bank {b}. {e}")
 
                 # Sleep and increment attempt counter
-                sleep_ms(500)
+                sleep_ms(50)
                 attempts += 1
 
     # Currently not used, but keeping in this script for future use
@@ -379,8 +383,9 @@ def main(self):
 
             # If I have been running, then stopped for longer than reset_timeout, reset the steps and clock_step to 0
             if self.clockStep != 0 and ticks_diff(ticks_ms(), din.last_triggered()) > self.resetTimeout:
-                self.step = 0
-                self.clockStep = 0
+                if self.CvRecording[self.ActiveCvr] != 'true':
+                    self.step = 0
+                    self.clockStep = 0
 
     def getCvBank(self):
         # Read CV Bank selection from knob 1
@@ -428,14 +433,14 @@ def writeToDebugLog(self, msg):
             except Exception as e:
                 print(f'[{attempts}] Error writing to debug log. {e}')
 
-    def showLoadingScreen(self):
+    def showLoadingScreen(self, bank):
         # push the bytearray of the Rpi logo into a 32 x 32 framebuffer, then show on the screen
 
         buffer = bytearray(b"\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00|?\x00\x01\x86@\x80\x01\x01\x80\x80\x01\x11\x88\x80\x01\x05\xa0\x80\x00\x83\xc1\x00\x00C\xe3\x00\x00~\xfc\x00\x00L'\x00\x00\x9c\x11\x00\x00\xbf\xfd\x00\x00\xe1\x87\x00\x01\xc1\x83\x80\x02A\x82@\x02A\x82@\x02\xc1\xc2@\x02\xf6>\xc0\x01\xfc=\x80\x01\x18\x18\x80\x01\x88\x10\x80\x00\x8c!\x00\x00\x87\xf1\x00\x00\x7f\xf6\x00\x008\x1c\x00\x00\x0c \x00\x00\x03\xc0\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00")
         fb = framebuf.FrameBuffer(buffer, 32, 32, framebuf.MONO_HLSB)
         oled.fill(0)
-        #oled.blit(fb, 0,0)
-        oled.text('Loading...', 40, 12, 1)
+        oled.blit(fb, 0,0)
+        oled.text(f'Loading ({bank})...', 40, 12, 1)
         oled.show()
 
     def updateScreen(self):

software/contrib/master_clock.md

@@ -0,0 +1,70 @@
+# EuroPi Master Clock and Clock Divider
+
+'''
+Master Clock
+author: Nik Ansell (github.com/gamecat69)
+date: 2022-08-02
+labels: clock, divider
+
+A master clock and clock divider. Each output sends a +5V trigger/gate at different divisions of the master clock, or randomly if condigured with a division of zero.
+Pulse width (gate/trigger duration) is configurable up to a maximum of 50% of the pulse width of output 1.
+
+All configuration (BPM, Pulse Width, output clock divisions) is automatically saved, then loaded when the module is restarted.
+
+For wonky/more interesting clock patterns try these:
+- Reset to step 1 using a gate into the digital input, or by using an odd value for the maximum division
+- Vary BPM by sending CV into the analog input
+- Set the division to zero for an output, this will cause the output to randomly go from high (+5V) to low (0V)
+
+Demo video: TBC
+
+digital_in: (optional) Reset step count on rising edge
+analog_in: (optional) Adjust BPM
+
+knob_1: Screen 2: Adjust BPM. Screen 3: Select output to edit 
+knob_2: Screen 2: Adjust Pulse width. Screen 3: Adjust division of selected output 
+
+button_1: Start / Stop
+button_2: Short Press (<500ms): Cycle through screens. Long Press (>500ms): Enter config mode
+
+Defaults:
+output_1: clock / 1
+output_2: clock / 2
+output_3: clock / 4
+output_4: clock / 8
+output_5: clock / 16
+output_6: clock / 32
+
+Known Issues:
+- If playback is restarted while screen 2 is in config mode, playback will be slightly irratic
+
+# Getting started
+
+Patch any module that uses gates/triggers to any output! By default the module will run at 100 BPM, using a 50% pulse width and send gates using the default divisions (1,2,4,8,16,32).
+
+# Configuring / Playing around
+
+Use button 2 (right button) to cycle through screens 1 - 3. A description of each screen is shown below.
+Hold button 2 for 2 seconds to enter configuration mode when in screen 2 or 3.
+Configuration mode will exit when changing screens to avoid accidentally changing any values on the next screen.
+Also note that playback will stop when in config mode.
+Each screen has a small indicator on the bottom right to show the screen you are on.
+
+## Screen 1
+- Top: Number of completed cycles since playback was last started, follewed by the current step in the cycle
+- Bottom: Instruction to use B1 to toggle start/stop
+
+## Screen 2
+- BPM
+- Pulse Width (PW) as a percentage of the output 1 division and also as milliseconds
+
+Hold button 2 for 2 seconds to enter configuration mode, then use knob 1 (left) to adjust BPM and knob 2 (right) to adjust pulse width. To exit configuration mode, just press button 2 to move to the next screen.
+
+## Screen 3:
+
+This screen shows the configured clock division for each output.
+To edit a clock division for an output:
+- Use knob 1 to select the output you want to edit
+- Press and hold button 2 for 2 seconds to enter configuration mode
+- Use knob 2 to select the division you want that that output. Setting a division to zero will produce random fluctuations between 0V and +5V.
+- Exit configuration mode by pressing button 2 to move to the next screen