Added CV and Gate outputs via 2x i2c MCP4725 modules

uClock.h

@@ -0,0 +1,173 @@
+/*!
+ *  @file       uClock.h
+ *  Project     BPM clock generator for Arduino
+ *  @brief      A Library to implement BPM clock tick calls using hardware timer interruption. Tested on ATmega168/328, ATmega16u4/32u4 and ATmega2560 and Teensy LC.
+ *  @version    1.0.0
+ *  @author     Romulo Silva
+ *  @date       01/04/2022
+ *  @license    MIT - (c) 2022 - Romulo Silva - contact@midilab.co
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a
+ * copy of this software and associated documentation files (the "Software"),
+ * to deal in the Software without restriction, including without limitation
+ * the rights to use, copy, modify, merge, publish, distribute, sublicense,
+ * and/or sell copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included
+ * in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+ * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+ * DEALINGS IN THE SOFTWARE. 
+ */
+
+#ifndef __U_CLOCK_H__
+#define __U_CLOCK_H__
+
+#include <Arduino.h>
+#include <inttypes.h>
+
+namespace umodular { namespace clock {
+
+#define AVR_CLOCK_FREQ  16000000
+
+#define PHASE_FACTOR 16
+
+#define PLL_X 220
+
+// for smooth slave tempo calculate display you should raise this value 
+// in between 64 to 128.
+// note: this doesn't impact on sync time, only display time getTempo()
+// if you dont want to use it, set it to 1 for memory save
+#define EXT_INTERVAL_BUFFER_SIZE 24
+
+#define SECS_PER_MIN  (60UL)
+#define SECS_PER_HOUR (3600UL)
+#define SECS_PER_DAY  (SECS_PER_HOUR * 24L)
+
+#define MIN_BPM 1
+#define MAX_BPM 300
+
+#define ATOMIC(X) noInterrupts(); X; interrupts();
+
+class uClockClass {
+
+  private:
+    
+    void setTimerTempo(float bpm);
+    float inline freqToBpm(uint32_t freq);
+
+    void (*onClock96PPQNCallback)(uint32_t * tick);
+    void (*onClock32PPQNCallback)(uint32_t * tick);
+    void (*onClock16PPQNCallback)(uint32_t * tick);
+    void (*onClockStartCallback)();
+    void (*onClockStopCallback)();
+
+    // internal clock control
+    volatile uint32_t internal_tick;
+    volatile uint32_t div32th_counter;
+    volatile uint32_t div16th_counter;
+    volatile uint8_t mod6_counter;
+
+    // external clock control
+    volatile uint32_t external_clock;
+    volatile uint32_t external_tick;
+    volatile uint32_t indiv32th_counter;
+    volatile uint32_t indiv16th_counter;
+    volatile uint8_t inmod6_counter;
+    volatile uint32_t interval;
+    volatile uint32_t last_interval;
+    uint32_t sync_interval;
+
+    uint32_t tick_us_interval;
+    float tick_hertz_interval;
+
+    float tempo;
+    uint32_t start_timer;
+    uint8_t mode;
+  
+    volatile uint32_t ext_interval_buffer[EXT_INTERVAL_BUFFER_SIZE];
+    uint16_t ext_interval_idx;
+
+  public:
+
+    enum {
+      INTERNAL_CLOCK = 0,
+      EXTERNAL_CLOCK
+    };
+
+    enum {
+      PAUSED = 0,
+      STARTING,
+      STARTED
+    };
+
+    uint8_t state;
+    
+    uClockClass();
+
+    void setClock96PPQNOutput(void (*callback)(uint32_t * tick)) {
+      onClock96PPQNCallback = callback;
+    }
+    
+    void setClock32PPQNOutput(void (*callback)(uint32_t * tick)) {
+      onClock32PPQNCallback = callback;
+    }
+
+    void setClock16PPQNOutput(void (*callback)(uint32_t * tick)) {
+      onClock16PPQNCallback = callback;
+    }
+
+    void setOnClockStartOutput(void (*callback)()) {
+      onClockStartCallback = callback;
+    }
+
+    void setOnClockStopOutput(void (*callback)()) {
+      onClockStopCallback = callback;
+    }
+
+    void init();
+    void handleTimerInt();
+    void handleExternalClock();
+    void resetCounters();
+    
+    // external class control
+    void start();
+    void stop();
+    void pause();
+    void setTempo(float bpm);
+    float getTempo();
+
+    // external timming control
+    void setMode(uint8_t tempo_mode);
+    uint8_t getMode();
+    void clockMe();
+    
+    // todo!
+    void shuffle();
+    void tap();
+    
+    // elapsed time support
+    uint8_t getNumberOfSeconds(uint32_t time);
+    uint8_t getNumberOfMinutes(uint32_t time);
+    uint8_t getNumberOfHours(uint32_t time);
+    uint8_t getNumberOfDays(uint32_t time);
+    uint32_t getNowTimer();
+    uint32_t getPlayTime();
+};
+
+} } // end namespace umodular::clock
+
+extern umodular::clock::uClockClass uClock;
+
+extern "C" {
+  extern volatile uint16_t _clock;
+  extern volatile uint32_t _timer;
+}
+
+#endif /* __U_CLOCK_H__ */