From 05deb817ace8faeea4622c9d8e0bcf88164d3ec5 Mon Sep 17 00:00:00 2001
From: sanni <sanni@users.noreply.github.com>
Date: Sun, 24 Oct 2021 00:41:18 +0200
Subject: [PATCH] V7.0: Add basic support for MKS MINI12864 V3

https://www.aliexpress.com/item/1005003098864693.html
---
 Cart_Reader/Cart_Reader.ino | 480 ++++++++++++++++++++++++++++++------
 Cart_Reader/N64.ino         |  15 +-
 Cart_Reader/NES.ino         |  14 +-
 Cart_Reader/NP.ino          |   2 +-
 Cart_Reader/README.md       |  13 +-
 Cart_Reader/RTC.cpp         |   5 +
 Cart_Reader/RTC.h           |   4 +
 Cart_Reader/SMS.ino         |   4 +-
 Cart_Reader/SNES.ino        |   5 +-
 Cart_Reader/options.h       |  38 ++-
 pinout.ods                  | Bin 19767 -> 20660 bytes
 11 files changed, 483 insertions(+), 97 deletions(-)

diff --git a/Cart_Reader/Cart_Reader.ino b/Cart_Reader/Cart_Reader.ino
index 5015a1f..9c4d587 100644
--- a/Cart_Reader/Cart_Reader.ino
+++ b/Cart_Reader/Cart_Reader.ino
@@ -4,15 +4,19 @@
    This project represents a community-driven effort to provide
    an easy to build and easy to modify cartridge dumper.
 
-   Date:             14.10.2021
-   Version:          6.8
+   Date:             24.10.2021
+   Version:          7.0
 
    SD lib: https://github.com/greiman/SdFat
-   LCD lib: https://github.com/adafruit/Adafruit_SSD1306
+   OLED lib: https://github.com/adafruit/Adafruit_SSD1306
    GFX Lib: https://github.com/adafruit/Adafruit-GFX-Library
    BusIO: https://github.com/adafruit/Adafruit_BusIO
+   LCD lib: https://github.com/olikraus/u8g2
    RGB Tools lib: https://github.com/joushx/Arduino-RGB-Tools
+   Neopixel lib: https://github.com/adafruit/Adafruit_NeoPixel
+   Rotary Enc lib: https://github.com/mathertel/RotaryEncoder
    SI5351 lib: https://github.com/etherkit/Si5351Arduino
+   RTC lib: https://github.com/adafruit/RTClib
 
    Compiled with Arduino 1.8.13
 
@@ -33,14 +37,14 @@
    Gens-gs - Megadrive checksum
 
    And a special Thank You to all coders and contributors on Github and the Arduino forum:
-   jiyunomegami, splash5, Kreeblah, ramapcsx2, PsyK0p4T, Dakkaron, Pickle, sdhizumi,
-   sakman55, Uzlopak, scrap-a, majorpbx, borti4938, Modman, philenotfound, vogelfreiheit
+   jiyunomegami, splash5, Kreeblah, ramapcsx2, PsyK0p4T, Dakkaron, majorpbx, Pickle, sdhizumi,
+   Uzlopak, sakman55, scrap-a, borti4938, vogelfreiheit, Modman, philenotfound
 
    And to nocash for figuring out the secrets of the SFC Nintendo Power cartridge.
 
 **********************************************************************************/
 
-char ver[5] = "6.8";
+char ver[5] = "7.0";
 
 /******************************************
    Libraries
@@ -48,18 +52,18 @@ char ver[5] = "6.8";
 // Options
 #include "options.h"
 
-// SD Card
-#include "SdFat.h"
-SdFs sd;
-FsFile myDir;
-FsFile myFile;
-
 // Basic Libs
 #include <SPI.h>
 #include <Wire.h>
 #include <avr/pgmspace.h>
 #include <avr/wdt.h>
 
+// SD Card
+#include "SdFat.h"
+SdFs sd;
+FsFile myDir;
+FsFile myFile;
+
 // AVR Eeprom
 #include <EEPROM.h>
 // forward declarations for "T" (for non Arduino IDE)
@@ -82,24 +86,34 @@ template <class T> int EEPROM_readAnything(int ee, T& value) {
   return i;
 }
 
-// Graphic I2C LCD
-#include <Adafruit_GFX.h>
-#include <Adafruit_SSD1306.h>
-#define SCREEN_WIDTH 128 // OLED display width, in pixels
-#define SCREEN_HEIGHT 64 // OLED display height, in pixels
-// Declaration for an SSD1306 display connected to I2C (SDA, SCL pins)
-#define OLED_RESET -1 // Reset pin # (or -1 if sharing Arduino reset pin)
-Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire, OLED_RESET);
+// Graphic SPI LCD
+#ifdef enable_LCD
+#include <U8g2lib.h>
+U8G2_ST7567_OS12864_F_4W_HW_SPI display(U8G2_R2, /* cs=*/ 12, /* dc=*/ 11, /* reset=*/ 10);
+#endif
 
-// Adafruit Clock Generator
-#include <si5351.h>
-Si5351 clockgen;
+// Rotary Encoder
+#ifdef enable_rotary
+#include <RotaryEncoder.h>
+#define PIN_IN1 18
+#define PIN_IN2 19
+RotaryEncoder encoder(PIN_IN1, PIN_IN2, RotaryEncoder::LatchMode::FOUR3);
+int rotaryPos = 0;
+#endif
 
-// RGB LED
+// Choose RGB LED type
+#ifdef enable_neopixel
+// Neopixel
+#include <Adafruit_NeoPixel.h>
+Adafruit_NeoPixel pixels(3, 13, NEO_GRB + NEO_KHZ800);
+#else
+#ifndef enable_LCD
+// 4 Pin RGB LED
 #include <RGBTools.h>
-
 // Set pins of red, green and blue
 RGBTools rgb(12, 11, 10);
+#endif
+#endif
 
 typedef enum COLOR_T {
   blue_color,
@@ -111,6 +125,21 @@ typedef enum COLOR_T {
   white_color,
 } color_t;
 
+// Graphic I2C OLED
+#ifdef enable_OLED
+#include <Adafruit_GFX.h>
+#include <Adafruit_SSD1306.h>
+#define SCREEN_WIDTH 128 // OLED display width, in pixels
+#define SCREEN_HEIGHT 64 // OLED display height, in pixels
+// Declaration for an SSD1306 display connected to I2C (SDA, SCL pins)
+#define OLED_RESET -1 // Reset pin # (or -1 if sharing Arduino reset pin)
+Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire, OLED_RESET);
+#endif
+
+// Adafruit Clock Generator
+#include <si5351.h>
+Si5351 clockgen;
+
 // RTC Library
 #ifdef RTC_installed
 #include "RTC.h"
@@ -156,6 +185,14 @@ typedef enum COLOR_T {
 /******************************************
    Variables
  *****************************************/
+#ifdef enable_rotary
+// Button debounce
+boolean buttonState = HIGH;             // the current reading from the input pin
+boolean lastButtonState = HIGH;   // the previous reading from the input pin
+unsigned long lastDebounceTime = 0;  // the last time the output pin was toggled
+unsigned long debounceDelay = 50;    // the debounce time; increase if the output flickers
+#endif
+
 #ifdef enable_OLED
 // Button 1
 boolean buttonVal1 = HIGH; // value read from button
@@ -181,7 +218,9 @@ boolean ignoreUp2 = false; // whether to ignore the button release because the c
 boolean waitForUp2 = false; // when held, whether to wait for the up event
 boolean holdEventPast2 = false; // whether or not the hold event happened already
 boolean longholdEventPast2 = false;// whether or not the long hold event happened already
-#else
+#endif
+
+#ifdef enable_serial
 // For incoming serial data
 int incomingByte;
 #endif
@@ -437,7 +476,9 @@ static const char* const addonsOptions[] PROGMEM = {addonsItem1, addonsItem2, ad
 void aboutScreen() {
   display_Clear();
   // Draw the Logo
+#ifdef enable_OLED
   display.drawBitmap(0, 0, sig, 128, 64, 1);
+#endif
   println_Msg(F("Cartridge Reader"));
   println_Msg(F("github.com/sanni"));
   print_Msg(F("2021 Version "));
@@ -450,7 +491,7 @@ void aboutScreen() {
   display_Update();
 
   while (1) {
-#ifdef enable_OLED
+#if defined(enable_OLED) || defined(enable_LCD)
     // get input button
     int b = checkButton();
 
@@ -474,11 +515,12 @@ void aboutScreen() {
       EEPROM_writeAnything(0, foldern);
       resetArduino();
     }
-#else
+#endif
+#ifdef enable_serial
     wait_serial();
     resetArduino();
 #endif
-    rgb.setColor(random(0, 255), random(0, 255), random(0, 255));
+    setColor_RGB(random(0, 255), random(0, 255), random(0, 255));
     delay(random(50, 100));
   }
 }
@@ -643,6 +685,20 @@ void setup() {
   // Read current folder number out of eeprom
   EEPROM_readAnything(0, foldern);
 
+#ifdef enable_LCD
+  display.begin();
+  display.setFont(u8g2_font_haxrcorp4089_tr);
+#endif
+
+#ifdef enable_neopixel
+  pixels.begin();
+  pixels.clear();
+  pixels.setPixelColor(0, pixels.Color(255, 0, 0));
+  pixels.setPixelColor(1, pixels.Color(0, 0, 255));
+  pixels.setPixelColor(2, pixels.Color(0, 0, 255));
+  pixels.show();
+#endif
+
 #ifdef enable_OLED
   // GLCD
   display.begin(SSD1306_SWITCHCAPVCC, 0x3C);
@@ -661,7 +717,7 @@ void setup() {
   delay(100);
 
   // Initialize LED
-  rgb.setColor(0, 0, 0);
+  setColor_RGB(0, 0, 0);
 
   // Clear the screen.
   display_Clear();
@@ -693,31 +749,24 @@ void setup() {
   display_Update();
   delay(200);
 #endif
+#endif
 
-#else
+#ifdef enable_serial
   // Serial Begin
   Serial.begin(9600);
   Serial.println(F("Cartridge Reader"));
   Serial.println(F("2021 sanni"));
   Serial.println("");
   // LED Error
-  rgb.setColor(0, 0, 255);
+  setColor_RGB(0, 0, 255);
 #endif
 
   // Init SD card
-  if (!sd.begin(SdSpiConfig(SS, DEDICATED_SPI))) {
+  if (!sd.begin(SS)) {
     display_Clear();
     print_Error(F("SD Error"), true);
   }
 
-#ifndef enable_OLED
-  // Print SD Info
-  Serial.print(F("SD Card: "));
-  Serial.print(sd.card()->cardSize() * 512E-9);
-  Serial.print(F("GB FAT"));
-  Serial.println(int(sd.vol()->fatType()));
-#endif
-
 #ifdef RTC_installed
   // Start RTC
   RTCStart();
@@ -748,6 +797,19 @@ void dataIn() {
 /******************************************
    Helper Functions
  *****************************************/
+// Set RGB color
+void setColor_RGB(byte r, byte g, byte b) {
+#ifdef enable_neopixel
+  pixels.clear();
+  pixels.setPixelColor(0, pixels.Color(255, 0, 0));
+  pixels.setPixelColor(1, pixels.Color(g, r, b));
+  pixels.setPixelColor(2, pixels.Color(g, r, b));
+  pixels.show();
+#else
+  rgb.setColor(r, g, b);
+#endif
+}
+
 // Converts a progmem array into a ram array
 void convertPgm(const char* const pgmOptions[], byte numArrays) {
   for (int i = 0; i < numArrays; i++) {
@@ -757,12 +819,12 @@ void convertPgm(const char* const pgmOptions[], byte numArrays) {
 
 void print_Error(const __FlashStringHelper *errorMessage, boolean forceReset) {
   errorLvl = 1;
-  rgb.setColor(255, 0, 0);
+  setColor_RGB(255, 0, 0);
   println_Msg(errorMessage);
   display_Update();
 
   if (forceReset) {
-#ifdef enable_OLED
+#if defined(enable_OLED) || defined(enable_LCD)
     println_Msg(F(""));
     println_Msg(F("Press Button..."));
     display_Update();
@@ -780,7 +842,8 @@ void print_Error(const __FlashStringHelper *errorMessage, boolean forceReset) {
       display_Update();
       delay(2000);
     }
-#else
+#endif
+#ifdef enable_serial
     println_Msg(F("Fatal Error, please reset"));
     while (1);
 #endif
@@ -788,49 +851,73 @@ void print_Error(const __FlashStringHelper *errorMessage, boolean forceReset) {
 }
 
 void wait() {
+#ifdef enable_LCD
+  wait_encoder();
+#endif
 #ifdef enable_OLED
   wait_btn();
-#else
+#endif
+#ifdef enable_serial
   wait_serial();
 #endif
 }
 
 void print_Msg(const __FlashStringHelper *string) {
+#ifdef enable_LCD
+  display.print(string);
+#endif
 #ifdef enable_OLED
   display.print(string);
-#else
+#endif
+#ifdef enable_serial
   Serial.print(string);
 #endif
 }
 
 void print_Msg(const char string[]) {
+#ifdef enable_LCD
+  display.print(string);
+#endif
 #ifdef enable_OLED
   display.print(string);
-#else
+#endif
+#ifdef enable_serial
   Serial.print(string);
 #endif
 }
 
 void print_Msg(long unsigned int message) {
+#ifdef enable_LCD
+  display.print(message);
+#endif
 #ifdef enable_OLED
   display.print(message);
-#else
+#endif
+#ifdef enable_serial
   Serial.print(message);
 #endif
 }
 
 void print_Msg(byte message, int outputFormat) {
+#ifdef enable_LCD
+  display.print(message, outputFormat);
+#endif
 #ifdef enable_OLED
   display.print(message, outputFormat);
-#else
+#endif
+#ifdef enable_serial
   Serial.print(message, outputFormat);
 #endif
 }
 
 void print_Msg(String string) {
+#ifdef enable_LCD
+  display.print(string);
+#endif
 #ifdef enable_OLED
   display.print(string);
-#else
+#endif
+#ifdef enable_serial
   Serial.print(string);
 #endif
 }
@@ -852,56 +939,88 @@ void print_Msg_PaddedHex32(unsigned long message) {
   print_Msg_PaddedHexByte((message >>  0) & 0xFF);
 }
 
-
 void println_Msg(String string) {
+#ifdef enable_LCD
+  display.println(string);
+  display.setCursor(0, display.ty + 8);
+#endif
 #ifdef enable_OLED
   display.println(string);
-#else
+#endif
+#ifdef enable_serial
   Serial.println(string);
 #endif
 }
 
 void println_Msg(byte message, int outputFormat) {
+#ifdef enable_LCD
+  display.println(message, outputFormat);
+  display.setCursor(0, display.ty + 8);
+#endif
 #ifdef enable_OLED
   display.println(message, outputFormat);
-#else
+#endif
+#ifdef enable_serial
   Serial.println(message, outputFormat);
 #endif
 }
 
 void println_Msg(const char message[]) {
+#ifdef enable_LCD
+  display.println(message);
+  display.setCursor(0, display.ty + 8);
+#endif
 #ifdef enable_OLED
   display.println(message);
-#else
+#endif
+#ifdef enable_serial
   Serial.println(message);
 #endif
 }
 
 void println_Msg(const __FlashStringHelper *string) {
+#ifdef enable_LCD
+  display.println(string);
+  display.setCursor(0, display.ty + 8);
+#endif
 #ifdef enable_OLED
   display.println(string);
-#else
+#endif
+#ifdef enable_serial
   Serial.println(string);
 #endif
 }
 
 void println_Msg(long unsigned int message) {
+#ifdef enable_LCD
+  display.print(message);
+  display.setCursor(0, display.ty + 8);
+#endif
 #ifdef enable_OLED
   display.println(message);
-#else
+#endif
+#ifdef enable_serial
   Serial.println(message);
 #endif
 }
 
 void display_Update() {
+#ifdef enable_LCD
+  display.updateDisplay();
+#endif
 #ifdef enable_OLED
   display.display();
-#else
+#endif
+#ifdef enable_serial
   delay(100);
 #endif
 }
 
 void display_Clear() {
+#ifdef enable_LCD
+  display.clearDisplay();
+  display.setCursor(0, 8);
+#endif
 #ifdef enable_OLED
   display.clearDisplay();
   display.setCursor(0, 0);
@@ -909,9 +1028,13 @@ void display_Clear() {
 }
 
 unsigned char question_box(const __FlashStringHelper* question, char answers[7][20], int num_answers, int default_choice) {
+#ifdef enable_LCD
+  return questionBox_LCD(question, answers, num_answers, default_choice);
+#endif
 #ifdef enable_OLED
   return questionBox_OLED(question, answers, num_answers, default_choice);
-#else
+#endif
+#ifdef enable_serial
   return questionBox_Serial(question, answers, num_answers, default_choice);
 #endif
 }
@@ -919,7 +1042,7 @@ unsigned char question_box(const __FlashStringHelper* question, char answers[7][
 /******************************************
   Serial Out
 *****************************************/
-#ifndef enable_OLED
+#ifdef enable_serial
 void wait_serial() {
   while (Serial.available() == 0) {
   }
@@ -1045,29 +1168,248 @@ byte questionBox_Serial(const __FlashStringHelper* question, char answers[7][20]
 void rgbLed(byte Color) {
   switch (Color) {
     case blue_color:
-      rgb.setColor(0, 0, 255);
+      setColor_RGB(0, 0, 255);
       break;
     case red_color:
-      rgb.setColor(255, 0, 0);
+      setColor_RGB(255, 0, 0);
       break;
     case purple_color:
-      rgb.setColor(255, 0, 255);
+      setColor_RGB(255, 0, 255);
       break;
     case green_color:
-      rgb.setColor(0, 255, 0);
+      setColor_RGB(0, 255, 0);
       break;
     case turquoise_color:
-      rgb.setColor(0, 255, 255);
+      setColor_RGB(0, 255, 255);
       break;
     case yellow_color:
-      rgb.setColor(255, 255, 0);
+      setColor_RGB(255, 255, 0);
       break;
     case white_color:
-      rgb.setColor(255, 255, 255);
+      setColor_RGB(255, 255, 255);
       break;
   }
 }
 
+/******************************************
+  LCD Menu Module
+*****************************************/
+#if defined(enable_LCD) && defined(enable_rotary)
+// Read encoder state
+int checkButton() {
+  // Read rotary encoder
+  encoder.tick();
+  int newPos = encoder.getPosition();
+  // Read button
+  boolean reading = (PING & (1 << PING2)) >> PING2;
+
+  // Check if rotary encoder has changed
+  if (rotaryPos != newPos) {
+    int rotaryDir = (int)encoder.getDirection();
+    if (rotaryDir == 1) {
+      rotaryPos = newPos;
+      return 1;
+    }
+    else if (rotaryDir == -1) {
+      rotaryPos = newPos;
+      return 2;
+    }
+    else {
+      return 0;
+    }
+  }
+  // Check if button has changed
+  else {
+    if (reading != lastButtonState) {
+      lastDebounceTime = millis();
+    }
+    if ((millis() - lastDebounceTime) > debounceDelay) {
+      if (reading != buttonState) {
+        buttonState = reading;
+        if (buttonState == 0) {
+          while ((PING & (1 << PING2)) >> PING2 == 0);
+          lastButtonState = reading;
+          return 3;
+        }
+      }
+      else {
+        lastButtonState = reading;
+        return 0;
+      }
+    }
+    else {
+      lastButtonState = reading;
+      return 0;
+    }
+  }
+}
+
+// Wait for user to push button
+void wait_encoder() {
+  // Change led to green
+  if (errorLvl == 0)
+    rgbLed(green_color);
+
+  while (1)
+  {
+    // Get rotary encoder
+    encoder.tick();
+    int newPos = encoder.getPosition();
+
+#ifdef enable_N64
+#ifndef clockgen_installed
+    // Send some clock pulses to the Eeprom in case it locked up
+    if ((mode == mode_N64_Cart) && ((saveType == 5) || (saveType == 6))) {
+      pulseClock_N64(1);
+    }
+#endif
+#endif
+
+    if (rotaryPos != newPos) {
+      rotaryPos = newPos;
+      errorLvl = 0;
+      break;
+    }
+  }
+}
+#endif
+
+#ifdef enable_LCD
+// Display a question box with selectable answers. Make sure default choice is in (0, num_answers]
+unsigned char questionBox_LCD(const __FlashStringHelper * question, char answers[7][20], int num_answers, int default_choice) {
+  //clear the screen
+  display.clearDisplay();
+  display.updateDisplay();
+  display.setCursor(0, 8);
+
+  // change the rgb led to the start menu color
+  rgbLed(default_choice);
+
+  // print menu
+  display.println(question);
+  display.setCursor(0, display.ty + 8);
+  for (unsigned char i = 0; i < num_answers; i++) {
+    // Add space for the selection dot
+    display.print(" ");
+    // Print menu item
+    display.println(answers[i]);
+    display.setCursor(0, display.ty + 8);
+  }
+  display.updateDisplay();
+
+  // start with the default choice
+  choice = default_choice;
+
+  // draw selection box
+  display.setDrawColor(1);
+  display.drawPixel(0, 8 * choice + 12);
+  display.updateDisplay();
+
+  unsigned long idleTime = millis();
+  byte currentColor = 0;
+
+  // wait until user makes his choice
+  while (1) {
+    // Attract Mode
+    if (millis() - idleTime > 300000) {
+      if ((millis() - idleTime) % 4000 == 0) {
+        if (currentColor < 7) {
+          currentColor++;
+          if (currentColor == 1) {
+            currentColor = 2; // skip red as that signifies an error to the user
+          }
+        }
+        else {
+          currentColor = 0;
+        }
+      }
+      rgbLed(currentColor);
+    }
+
+    /* Check Button
+      1 click
+      2 doubleClick
+      3 hold
+      4 longHold */
+    int b = checkButton();
+
+    if (b == 2) {
+      idleTime = millis();
+
+      // remove selection box
+      display.setDrawColor(0);
+      display.drawPixel(0, 8 * choice + 12);
+      display.updateDisplay();
+
+      if ((choice == 0) && (filebrowse == 1)) {
+        if (currPage > 1) {
+          lastPage = currPage;
+          currPage--;
+          break;
+        }
+        else {
+          root = 1;
+          break;
+        }
+      }
+      else if (choice > 0) {
+        choice--;
+      }
+      else {
+        choice = num_answers - 1;
+      }
+
+      // draw selection box
+      display.setDrawColor(1);
+      display.drawPixel(0, 8 * choice + 12);
+      display.updateDisplay();
+
+      // change RGB led to the color of the current menu option
+      rgbLed(choice);
+    }
+
+    // go one down in the menu if the Cart Dumpers button is clicked shortly
+
+    if (b == 1) {
+      idleTime = millis();
+
+      // remove selection box
+      display.setDrawColor(0);
+      display.drawPixel(0, 8 * choice + 12);
+      display.updateDisplay();
+
+      if ((choice == num_answers - 1 ) && (numPages > currPage) && (filebrowse == 1)) {
+        lastPage = currPage;
+        currPage++;
+        break;
+      }
+      else
+        choice = (choice + 1) % num_answers;
+
+      // draw selection box
+      display.setDrawColor(1);
+      display.drawPixel(0, 8 * choice + 12);
+      display.updateDisplay();
+
+      // change RGB led to the color of the current menu option
+      rgbLed(choice);
+    }
+
+    // if the Cart Dumpers button is hold continiously leave the menu
+    // so the currently highlighted action can be executed
+
+    if (b == 3) {
+      idleTime = millis();
+      break;
+    }
+  }
+
+  // pass on user choice
+  setColor_RGB(0, 0, 0);
+  return choice;
+}
+#endif
+
 /******************************************
   OLED Menu Module
 *****************************************/
@@ -1243,7 +1585,7 @@ void wait_btn() {
 }
 
 // Display a question box with selectable answers. Make sure default choice is in (0, num_answers]
-unsigned char questionBox_OLED(const __FlashStringHelper* question, char answers[7][20], int num_answers, int default_choice) {
+unsigned char questionBox_OLED(const __FlashStringHelper * question, char answers[7][20], int num_answers, int default_choice) {
   //clear the screen
   display.clearDisplay();
   display.display();
@@ -1365,7 +1707,7 @@ unsigned char questionBox_OLED(const __FlashStringHelper* question, char answers
   }
 
   // pass on user choice
-  rgb.setColor(0, 0, 0);
+  setColor_RGB(0, 0, 0);
   return choice;
 }
 #endif
@@ -1373,7 +1715,7 @@ unsigned char questionBox_OLED(const __FlashStringHelper* question, char answers
 /******************************************
   Filebrowser Module
 *****************************************/
-void fileBrowser(const __FlashStringHelper* browserTitle) {
+void fileBrowser(const __FlashStringHelper * browserTitle) {
   char fileNames[30][FILENAME_LENGTH];
   int currFile;
   filebrowse = 1;
diff --git a/Cart_Reader/N64.ino b/Cart_Reader/N64.ino
index 4782e47..e973e20 100644
--- a/Cart_Reader/N64.ino
+++ b/Cart_Reader/N64.ino
@@ -182,7 +182,9 @@ void n64ControllerMenu() {
     case 0:
       display_Clear();
       display_Update();
-      controllerTest();
+#ifdef enable_OLED
+      controllerTest_OLED();
+#endif
       quit = 1;
       break;
 
@@ -903,6 +905,7 @@ void get_button()
 /******************************************
   N64 Controller Test
  *****************************************/
+#ifdef enable_OLED
 #define CENTER 64
 
 void oledPrint(const char string[], int x, int y) {
@@ -926,7 +929,7 @@ void printSTR(String st, int x, int y)
   oledPrint(buf, x, y);
 }
 
-void controllerTest() {
+void controllerTest_OLED() {
   // on which screens do we start
   int startscreen = 1;
   int mode = 0;
@@ -1426,6 +1429,8 @@ void controllerTest() {
     }
   }
 }
+#endif
+
 /******************************************
    N64 Controller Pak Functions
    (connected via Controller)
@@ -3069,7 +3074,7 @@ redumpsamefolder:
   else {
     // Dump was bad or unknown
     errorLvl = 1;
-    rgb.setColor(255, 0, 0);
+    setColor_RGB(255, 0, 0);
     println_Msg(F("Checksum not found"));
     println_Msg(F("in N64.txt"));
     println_Msg(F(""));
@@ -3099,7 +3104,7 @@ redumpsamefolder:
       case 1:
         // Dump again into new folder
         display_Clear();
-        rgb.setColor(0, 0, 0);
+        setColor_RGB(0, 0, 0);
         goto redumpnewfolder;
         break;
 
@@ -3118,7 +3123,7 @@ redumpsamefolder:
         display_Clear();
         println_Msg(F("Reading Rom..."));
         display_Update();
-        rgb.setColor(0, 0, 0);
+        setColor_RGB(0, 0, 0);
         goto redumpsamefolder;
         break;
 
diff --git a/Cart_Reader/NES.ino b/Cart_Reader/NES.ino
index c9c8ed2..c4cb242 100644
--- a/Cart_Reader/NES.ino
+++ b/Cart_Reader/NES.ino
@@ -1253,10 +1253,11 @@ chooseMapper:
     errorLvl = 1;
     display.println("Mapper not supported");
     display.display();
-    wait_btn();
+    wait();
     goto chooseMapper;
   }
-#else
+#endif
+#ifdef enable_serial
 setmapper:
   String newmap;
   mapfound = false;
@@ -1356,7 +1357,8 @@ void setPRGSize() {
   println_Msg(F("K"));
   display_Update();
   delay(1000);
-#else
+#endif
+#ifdef enable_serial
   if (prglo == prghi)
     newprgsize = prglo;
   else {
@@ -1429,7 +1431,8 @@ void setCHRSize() {
   println_Msg(F("K"));
   display_Update();
   delay(1000);
-#else
+#endif
+#ifdef enable_serial
   if (chrlo == chrhi)
     newchrsize = chrlo;
   else {
@@ -1549,7 +1552,8 @@ void setRAMSize() {
   }
   display_Update();
   delay(1000);
-#else
+#endif
+#ifdef enable_serial
   if (ramlo == ramhi)
     newramsize = ramlo;
   else {
diff --git a/Cart_Reader/NP.ino b/Cart_Reader/NP.ino
index 56392f8..6efaefb 100644
--- a/Cart_Reader/NP.ino
+++ b/Cart_Reader/NP.ino
@@ -717,7 +717,7 @@ void getCartInfo_SFM() {
   if (checkcart_SFM() == 0) {
     // Checksum either corrupt or 0000
     errorLvl = 1;
-    rgb.setColor(255, 0, 0);
+    setColor_RGB(255, 0, 0);
     display_Clear();
     println_Msg(F("ERROR"));
     println_Msg(F("Rom header corrupt"));
diff --git a/Cart_Reader/README.md b/Cart_Reader/README.md
index 29fb9a7..65c76d6 100644
--- a/Cart_Reader/README.md
+++ b/Cart_Reader/README.md
@@ -57,10 +57,13 @@ To compile and upload the code please have a look at [this wiki article](https:/
 
 Needed libraries(already included in the portable Arduino IDE under Releases)   
 
-SD lib: https://github.com/greiman/SdFat  
-LCD lib: https://github.com/adafruit/Adafruit_SSD1306       
+SD lib: https://github.com/greiman/SdFat    
+OLED lib: https://github.com/adafruit/Adafruit_SSD1306    
 GFX Lib: https://github.com/adafruit/Adafruit-GFX-Library    
 BusIO: https://github.com/adafruit/Adafruit_BusIO    
-RGB Tools lib: https://github.com/joushx/Arduino-RGB-Tools  
-SI5351 lib: https://github.com/etherkit/Si5351Arduino  
-RTC lib: https://github.com/adafruit/RTClib (If you include an RTC)
+LCD lib: https://github.com/olikraus/u8g2     
+RGB Tools lib: https://github.com/joushx/Arduino-RGB-Tools     
+Neopixel lib: https://github.com/adafruit/Adafruit_NeoPixel    
+Rotary Enc lib: https://github.com/mathertel/RotaryEncoder    
+SI5351 lib: https://github.com/etherkit/Si5351Arduino        
+RTC lib: https://github.com/adafruit/RTClib      
\ No newline at end of file
diff --git a/Cart_Reader/RTC.cpp b/Cart_Reader/RTC.cpp
index da4aee2..61b22a4 100644
--- a/Cart_Reader/RTC.cpp
+++ b/Cart_Reader/RTC.cpp
@@ -1,3 +1,6 @@
+#include "options.h"
+#ifdef RTC_installed
+
 #include "RTC.h"
 #include "SdFat.h"
 
@@ -49,3 +52,5 @@ String RTCStamp() {
   // Print results
   return dts;
 }
+
+#endif
diff --git a/Cart_Reader/RTC.h b/Cart_Reader/RTC.h
index 6e8df7d..6a485c4 100644
--- a/Cart_Reader/RTC.h
+++ b/Cart_Reader/RTC.h
@@ -1,3 +1,6 @@
+#include "options.h"
+#ifdef RTC_installed
+
 // RTC Library
 #ifndef _RTC_H
 #define _RTC_H
@@ -11,3 +14,4 @@ void dateTime(uint16_t* date, uint16_t* time);
 String RTCStamp();
 
 #endif
+#endif
diff --git a/Cart_Reader/SMS.ino b/Cart_Reader/SMS.ino
index d18167d..d74cc31 100644
--- a/Cart_Reader/SMS.ino
+++ b/Cart_Reader/SMS.ino
@@ -319,7 +319,7 @@ void getCartInfo_SMS() {
     default:
       cartSize =  48 * 1024UL;
       // LED Error
-      rgb.setColor(0, 0, 255);
+      setColor_RGB(0, 0, 255);
       break;
 
   }
@@ -382,7 +382,7 @@ void getCartInfo_SMS() {
   wait();
 #endif
   // Turn off LED
-  rgb.setColor(0, 0, 0);
+  setColor_RGB(0, 0, 0);
 }
 
 // Read rom and save to the SD card
diff --git a/Cart_Reader/SNES.ino b/Cart_Reader/SNES.ino
index b4c17bd..5c2b25d 100644
--- a/Cart_Reader/SNES.ino
+++ b/Cart_Reader/SNES.ino
@@ -665,7 +665,7 @@ void getCartInfo_SNES() {
     // Checksum either corrupt or 0000
     manualConfig = 1;
     errorLvl = 1;
-    rgb.setColor(255, 0, 0);
+    setColor_RGB(255, 0, 0);
 
     display_Clear();
     println_Msg(F("ERROR"));
@@ -775,7 +775,8 @@ void getCartInfo_SNES() {
   println_Msg(F("Press Button..."));
   display_Update();
   wait();
-#else
+#endif
+#ifdef enable_serial
   println_Msg(F(" "));
 #endif
 
diff --git a/Cart_Reader/options.h b/Cart_Reader/options.h
index c793396..140752a 100644
--- a/Cart_Reader/options.h
+++ b/Cart_Reader/options.h
@@ -1,3 +1,31 @@
+//******************************************
+// CHOOSE HARDWARE VERSION
+//******************************************
+//#define HW4
+#define HW3
+//#define HW2
+//#define HW1
+//#define SERIAL
+
+#if defined(HW4)
+#define enable_LCD
+#define enable_neopixel
+#define enable_rotary
+#endif
+
+#if defined(HW2) || defined(HW3)
+#define enable_OLED
+#define enable_Button2
+#endif
+
+#if defined(HW1)
+#define enable_OLED
+#endif
+
+#if defined(SERIAL)
+#define enable_serial
+#endif
+
 //******************************************
 // GLOBAL OPTIONS
 //******************************************
@@ -5,15 +33,9 @@
 // flashMenu, nesMenu or smsMenu for single slot Cart Readers
 #define startMenu mainMenu
 
-// Comment out to change to Serial Output
-// be sure to change the Arduino Serial Monitor to no line ending
-#define enable_OLED
-// Skip OLED start-up animation
+// Skip start-up animation
 // #define fast_start
 
-// Enable the second button
-#define enable_Button2
-
 // Setup RTC if installed.
 // remove // if you have an RTC installed
 // #define RTC_installed
@@ -46,7 +68,7 @@
 // #define clockgen_installed
 
 // The CRC for N64 Roms will be calculated during dumping from memory instead of after dumping from SD card, not compatible to all Cart Readers
-// #define fastcrc 
+// #define fastcrc
 
 // saves a n64log.txt file with rom info in /N64/ROM
 // #define savesummarytotxt
diff --git a/pinout.ods b/pinout.ods
index 4cec67c562b21c5907ab1dc28b2020239d31ea7e..8b1d83296a38dcb56e016b8096923a4bd24d2725 100644
GIT binary patch
delta 10363
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

delta 9445
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
Xgd_jk;;)_-S6qzJs~4?OzeoQMT_L9^