]> Shamusworld >> Repos - apple2/blobdiff - src/apple2.cpp
Added initial emulator configuration window, cleanup of settings code.
[apple2] / src / apple2.cpp
index 36bf0b0f0dee9d0832e2cbccca2a09b5595db274..e97363afdf68a4ea4555c383645fdc4b81e20f70 100644 (file)
@@ -2,12 +2,13 @@
 // Apple 2 SDL Portable Apple Emulator
 //
 // by James Hammons
-// © 2014 Underground Software
+// © 2018 Underground Software
 //
-// Loosely based on AppleWin by Tom Charlesworth which was based on AppleWin by
-// Oliver Schmidt which was based on AppleWin by Michael O'Brien. :-) Parts are
-// also derived from ApplePC. Too bad it was closed source--it could have been
-// *the* premier Apple II emulator out there.
+// Parts loosely inspired by AppleWin by Tom Charlesworth which was based on
+// AppleWin by Oliver Schmidt which was based on AppleWin by Michael O'Brien.
+// :-)  Some parts (mainly TV rendering) are derived from ApplePC.  Too bad it
+// was closed source--it could have been *the* premier Apple II emulator out
+// there.
 //
 // JLH = James Hammons <jlhamm@acm.org>
 //
 // STILL TO DO:
 //
 // - Port to SDL [DONE]
-// - GUI goodies
 // - Weed out unneeded functions [DONE]
 // - Disk I/O [DONE]
 // - 128K IIe related stuff [DONE]
-// - State loading/saving
+// - State loading/saving [DONE]
+// - GUI goodies
+//
+// BUGS:
+//
+// - Having a directory in the ${disks} directory causes a segfault in floppy
 //
 
 #include "apple2.h"
 
 #include <SDL2/SDL.h>
 #include <fstream>
-#include <string>
 #include <iomanip>
 #include <iostream>
 #include <stdio.h>
 #include <stdlib.h>
+#include <string>
 #include <time.h>
+#include "firmware/apple2-fw.h"
+#include "firmware/apple2e-enh.h"
+#include "firmware/firmware.h"
+#include "floppydrive.h"
+#include "harddrive.h"
 #include "log.h"
-#include "video.h"
-#include "sound.h"
+#include "mmu.h"
+#include "mockingboard.h"
 #include "settings.h"
-#include "v65c02.h"
-#include "applevideo.h"
+#include "sound.h"
 #include "timing.h"
-#include "floppy.h"
-#include "firmware.h"
-#include "mmu.h"
-
+#include "video.h"
+#include "gui/diskselector.h"
+#include "gui/config.h"
 #include "gui/gui.h"
 
 // Debug and misc. defines
@@ -68,10 +76,14 @@ uint8_t ram[0x10000], rom[0x10000];                 // RAM & ROM spaces
 uint8_t ram2[0x10000];                                         // Auxillary RAM
 V65C02REGS mainCPU;                                                    // v65C02 execution context
 uint8_t appleType = APPLE_TYPE_IIE;
-FloppyDrive floppyDrive;
 bool powerStateChangeRequested = false;
+uint64_t frameCycleStart;
+
+uint64_t frameTicks = 0;
+uint64_t frameTime[60];
+uint32_t frameTimePtr = 0;
 
-// Local variables (actually, they're global since they're not static)
+// Exported variables
 
 uint8_t lastKeyPressed = 0;
 bool keyDown = false;
@@ -79,8 +91,9 @@ bool openAppleDown = false;
 bool closedAppleDown = false;
 bool store80Mode = false;
 bool vbl = false;
-bool slotCXROM = false;
+bool intCXROM = false;
 bool slotC3ROM = false;
+bool intC8ROM = false;
 bool ramrd = false;
 bool ramwrt = false;
 bool altzp = false;
@@ -88,19 +101,27 @@ bool ioudis = true;
 bool dhires = false;
 // Language card state (ROM read, no write)
 uint8_t lcState = 0x02;
+uint8_t blinkTimer = 0;
 
 static bool running = true;                                    // Machine running state flag...
-static uint32_t startTicks;
+static uint64_t startTicks;
 static bool pauseMode = false;
 static bool fullscreenDebounce = false;
-static bool capsLock = false;
-static bool capsLockDebounce = false;
+static bool resetKeyDown = false;
+static int8_t hideMouseTimeout = 60;
+
+// Vars to handle the //e's 2-key rollover
+static SDL_Keycode keysHeld[2];
+static uint8_t keysHeldAppleCode[2];
+static uint8_t keyDownCount = 0;
+static uint8_t keyDelay = 0;
 
 // Local functions
 
 static void SaveApple2State(const char * filename);
 static bool LoadApple2State(const char * filename);
 static void ResetApple2State(void);
+static void AppleTimer(uint16_t);
 
 // Local timer callback functions
 
@@ -110,71 +131,131 @@ static void BlinkTimer(void);
 #ifdef THREADED_65C02
 // Test of threaded execution of 6502
 static SDL_Thread * cpuThread = NULL;
-//static SDL_mutex * cpuMutex = NULL;
 static SDL_cond * cpuCond = NULL;
 static SDL_sem * mainSem = NULL;
 static bool cpuFinished = false;
-//static bool cpuSleep = false;
 
 // NB: Apple //e Manual sez 6502 is running @ 1,022,727 Hz
+//     This is a lie. At the end of each 65 cycle line, there is an elongated
+//     cycle (the so-called 'long' cycle) that throws the calcs out of whack.
+//     So actually, it's supposed to be 1,020,484.32 Hz
 
 // Let's try a thread...
 //
 // Here's how it works: Execute 1 frame's worth, then sleep. Other stuff wakes
-// it up
+// it up.
 //
+static uint32_t sampleCount;
+static uint64_t sampleClock, lastSampleClock;
 int CPUThreadFunc(void * data)
 {
        // Mutex must be locked for conditional to work...
        // Also, must be created in the thread that uses it...
        SDL_mutex * cpuMutex = SDL_CreateMutex();
 
-// decrement mainSem...
-//SDL_SemWait(mainSem);
 #ifdef CPU_THREAD_OVERFLOW_COMPENSATION
-       float overflow = 0.0;
+//     float overflow = 0.0;
 #endif
 
        do
        {
-// This is never set to true anywhere...
-//             if (cpuSleep)
-//                     SDL_CondWait(cpuCond, cpuMutex);
-
+uint64_t cpuFrameTickStart = SDL_GetPerformanceCounter();
+uint64_t oldClock = mainCPU.clock;
+sampleCount = 0;
+sampleClock = lastSampleClock = mainCPU.clock;
 // decrement mainSem...
 #ifdef THREAD_DEBUGGING
 WriteLog("CPU: SDL_SemWait(mainSem);\n");
 #endif
                SDL_SemWait(mainSem);
 
-// There are exactly 800 slices of 21.333 cycles per frame, so it works out
-// evenly.
+               // There are exactly 800 slices of 21.333 cycles per frame, so it works
+               // out evenly.
+               // [Actually, seems it's 786 slices of 21.666 cycles per frame]
+
+               // Set our frame cycle counter to the correct # of cycles at the start
+               // of this frame
+               frameCycleStart = mainCPU.clock - mainCPU.overflow;
 #ifdef THREAD_DEBUGGING
 WriteLog("CPU: Execute65C02(&mainCPU, cycles);\n");
 #endif
-               for(int i=0; i<800; i++)
+               for(int i=0; i<262; i++)
                {
-                       uint32_t cycles = 21;
-                       overflow += 0.333333334;
-
-                       if (overflow > 1.0)
-                       {
-                               cycles++;
-                               overflow -= 1.0;
-                       }
+                       // If the CTRL+Reset key combo is being held, make sure the RESET
+                       // line stays asserted:
+                       if (resetKeyDown)
+                               mainCPU.cpuFlags |= V65C02_ASSERT_LINE_RESET;
 
-                       Execute65C02(&mainCPU, cycles);
-                       WriteSampleToBuffer();
+                       Execute65C02(&mainCPU, 65);
 
-                       // Dunno if this is correct (seems to be close enough)...
-                       vbl = (i < 670 ? true : false);
+                       // According to "Understanding The Apple IIe", VBL asserted after
+                       // the last byte of the screen is read and let go on the first read
+                       // of the first byte of the screen. We now know that the screen
+                       // starts on line #6 and ends on line #197 (of the vertical
+                       // counter--actual VBLANK proper happens on lines 230 thru 233).
+                       vbl = ((i >= 6) && (i <= 197) ? true : false);
                }
 
+//WriteLog("*** Frame ran for %d cycles (%.3lf µs, %d samples).\n", mainCPU.clock - oldClock, ((double)(SDL_GetPerformanceCounter() - cpuFrameTickStart) * 1000000.0) / (double)SDL_GetPerformanceFrequency(), sampleCount);
+//     frameTicks = ((SDL_GetPerformanceCounter() - startTicks) * 1000) / SDL_GetPerformanceFrequency();
+/*
+Other timings from UTA2E:
+Power-up reset                         32.6 msec / 512 horizontal scans
+Flash cycle                                    1.87 Hz / Vertical freq./32
+Delay before auto repeat       534-801 msec / 32-48 vertical scans
+Auto repeat frequency          15 Hz / Vertical freq./4
+Vertical frequency                     59.94 Hz (actually, 59.92 Hz [59.92274339401])
+Horizontal frequency           15,734 Hz (actually, 15700 Hz)
+1 NTSC frame = 17030 cycles (N.B.: this works out to 1021800 cycles per sec.)
+NTSC clock frequency ("composite" freq.) is 1.02048432 MHz, which is 14.31818 x (65 / (65 x 14 + 2)) MHz.
+1 line = 65 cycles
+70 blank lines for top margin, 192 lines for screen, (35 & 35?)
+VA-C,V0-5 is upcounter starting at 011111010 ($FA) to 111111111 ($1FF)
+Horizontal counter is upcounter resets to 0000000, then jumps to 1000000 &
+counts up to 1111111 (bit 7 is Horizontal Preset Enable, which resets the counter when it goes low, the rest are H0-5)
+
+pg. 3-24 says one cycle before VBL the counters will be at
+010111111/1111111 (that doesn't look right to me...)
+
+Video address bits:
+
+A0 <- H0
+A1 <- H1
+A2 <- H2
+A3 <- SUM-A3
+A4 <- SUM-A4
+A5 <- SUM-A5
+A6 <- SUM-A6
+A7 <- V0
+A8 <- V1
+A9 <- V2
+
+SUMS are calculated like so:
+
+  1        1       0       1
+          H5      H4      H3
+  V4      V3      V4      V3
+------------------------------
+SUM-A6  SUM-A5  SUM-A4  SUM-A3
+
+In TEXT mode, A10 == (80STORE' * PAGE2)', A11 == 80STORE' * PAGE2
+A12-A15 == 0
+
+In HIRES mode, A13 == (PAGE2 * 80STORE')', A14 == PAGE2 * 80STORE'
+A10 == VA, A11 == VB, A12 == VC, A15 == 0
+
+N.B.: VA-C are lower bits than V5-0
+
+HC, from 00, 0 to 23 is the HBL interval, with horizontal retrace occuring between cycles 8 and 11.
+VC, from line 0-5 and 198-261 is the VBL interval, with vertical retrace occuring between lines 230-233
+
+*/
+
 #ifdef THREAD_DEBUGGING
 WriteLog("CPU: SDL_mutexP(cpuMutex);\n");
 #endif
                SDL_mutexP(cpuMutex);
-// increment mainSem...
+               // increment mainSem...
 #ifdef THREAD_DEBUGGING
 WriteLog("CPU: SDL_SemPost(mainSem);\n");
 #endif
@@ -224,7 +305,7 @@ bool LoadImg(char * filename, uint8_t * ram, int size)
 }
 
 
-const uint8_t stateHeader[19] = "APPLE2SAVESTATE1.0";
+const uint8_t stateHeader[19] = "APPLE2SAVESTATE1.2";
 static void SaveApple2State(const char * filename)
 {
        WriteLog("Main: Saving Apple2 state...\n");
@@ -252,8 +333,9 @@ static void SaveApple2State(const char * filename)
        fputc((uint8_t)closedAppleDown, file);
        fputc((uint8_t)store80Mode, file);
        fputc((uint8_t)vbl, file);
-       fputc((uint8_t)slotCXROM, file);
+       fputc((uint8_t)intCXROM, file);
        fputc((uint8_t)slotC3ROM, file);
+       fputc((uint8_t)intC8ROM, file);
        fputc((uint8_t)ramrd, file);
        fputc((uint8_t)ramwrt, file);
        fputc((uint8_t)altzp, file);
@@ -269,7 +351,10 @@ static void SaveApple2State(const char * filename)
        fputc(lcState, file);
 
        // Write out floppy state
-       floppyDrive.SaveState(file);
+       floppyDrive[0].SaveState(file);
+
+       // Write out Mockingboard state
+       MBSaveState(file);
        fclose(file);
 }
 
@@ -309,8 +394,9 @@ static bool LoadApple2State(const char * filename)
        closedAppleDown = (bool)fgetc(file);
        store80Mode = (bool)fgetc(file);
        vbl = (bool)fgetc(file);
-       slotCXROM = (bool)fgetc(file);
+       intCXROM = (bool)fgetc(file);
        slotC3ROM = (bool)fgetc(file);
+       intC8ROM = (bool)fgetc(file);
        ramrd = (bool)fgetc(file);
        ramwrt = (bool)fgetc(file);
        altzp = (bool)fgetc(file);
@@ -326,13 +412,16 @@ static bool LoadApple2State(const char * filename)
        lcState = fgetc(file);
 
        // Read in floppy state
-       floppyDrive.LoadState(file);
+       floppyDrive[0].LoadState(file);
 
+       // Read in Mockingboard state
+       MBLoadState(file);
        fclose(file);
 
        // Make sure things are in a sane state before execution :-P
        mainCPU.RdMem = AppleReadMem;
        mainCPU.WrMem = AppleWriteMem;
+       mainCPU.Timer = AppleTimer;
        ResetMMUPointers();
 
        return true;
@@ -346,8 +435,9 @@ static void ResetApple2State(void)
        closedAppleDown = false;
        store80Mode = false;
        vbl = false;
-       slotCXROM = false;
+       intCXROM = false;
        slotC3ROM = false;
+       intC8ROM = false;
        ramrd = false;
        ramwrt = false;
        altzp = false;
@@ -355,13 +445,43 @@ static void ResetApple2State(void)
        dhires = false;
        lcState = 0x02;
        ResetMMUPointers();
+       MBReset();
 
        // Without this, you can wedge the system :-/
        memset(ram, 0, 0x10000);
+       memset(ram2, 0, 0x10000);
        mainCPU.cpuFlags |= V65C02_ASSERT_LINE_RESET;
 }
 
 
+static double cyclesForSample = 0;
+static void AppleTimer(uint16_t cycles)
+{
+       // Handle PHI2 clocked stuff here...
+       MBRun(cycles);
+       floppyDrive[0].RunSequencer(cycles);
+
+#if 1
+       // Handle sound
+       // 21.26009 cycles per sample @ 48000 (running @ 1,020,484.32 Hz)
+       // 16.688154500083 ms = 1 frame
+       cyclesForSample += (double)cycles;
+
+       if (cyclesForSample >= 21.26009)
+       {
+#if 0
+sampleClock = mainCPU.clock;
+WriteLog("    cyclesForSample = %lf (%d samples, cycles=%d)\n", cyclesForSample, sampleClock - lastSampleClock, cycles);
+sampleCount++;
+lastSampleClock = sampleClock;
+#endif
+               WriteSampleToBuffer();
+               cyclesForSample -= 21.26009;
+       }
+#endif
+}
+
+
 #ifdef CPU_CLOCK_CHECKING
 uint8_t counter = 0;
 uint32_t totalCPU = 0;
@@ -374,7 +494,49 @@ int main(int /*argc*/, char * /*argv*/[])
 {
        InitLog("./apple2.log");
        LoadSettings();
-       srand(time(NULL));                                                                      // Initialize RNG
+       srand(time(NULL));                      // Initialize RNG
+
+#if 0
+// Make some timing/address tables
+
+       for(uint32_t line=0; line<262; line++)
+       {
+               WriteLog("LINE %03i: ", line);
+
+               for(uint32_t col=0; col<65; col++)
+               {
+                       // Convert these to H/V counters
+                       uint32_t hcount = col - 1;
+
+                       // HC sees zero twice:
+                       if (hcount == 0xFFFFFFFF)
+                               hcount = 0;
+
+                       uint32_t vcount = line + 0xFA;
+
+                       // Now do the address calculations
+                       uint32_t sum = 0xD + ((hcount & 0x38) >> 3)
+                               + (((vcount & 0xC0) >> 6) | ((vcount & 0xC0) >> 4));
+                       uint32_t address = ((vcount & 0x38) << 4) | ((sum & 0x0F) << 3) | (hcount & 0x07);
+
+                       // Add in particulars for the gfx mode we're in...
+                       if (false)
+                               // non hires
+                               address |= (!(!store80Mode && displayPage2) ? 0x400 : 0)
+                                       | (!store80Mode && displayPage2 ? 0x800 : 0);
+                       else
+                               // hires
+                               address |= (!(!store80Mode && displayPage2) ? 0x2000: 0)
+                                       | (!store80Mode && displayPage2 ? 0x4000 : 0)
+                                       | ((vcount & 0x07) << 10);
+
+                       WriteLog("$%04X ", address);
+               }
+
+               WriteLog("\n");
+       }
+
+#endif
 
        // Zero out memory
        memset(ram, 0, 0x10000);
@@ -385,30 +547,41 @@ int main(int /*argc*/, char * /*argv*/[])
        SetupAddressMap();
        ResetMMUPointers();
 
+       // Install devices in slots
+       InstallFloppy(SLOT6);
+       InstallMockingboard(SLOT4);
+       InstallHardDrive(SLOT7);
+
        // Set up V65C02 execution context
        memset(&mainCPU, 0, sizeof(V65C02REGS));
        mainCPU.RdMem = AppleReadMem;
        mainCPU.WrMem = AppleWriteMem;
+       mainCPU.Timer = AppleTimer;
        mainCPU.cpuFlags |= V65C02_ASSERT_LINE_RESET;
 
+#if 0
        if (!LoadImg(settings.BIOSPath, rom + 0xC000, 0x4000))
        {
                WriteLog("Could not open file '%s'!\n", settings.BIOSPath);
                return -1;
        }
+#else
+       memcpy(rom + 0xC000, apple2eEnhROM, 0x4000);
+#endif
 
        WriteLog("About to initialize video...\n");
 
        if (!InitVideo())
        {
-               std::cout << "Aborting!" << std::endl;
+               printf("Could not init screen: aborting!\n");
                return -1;
        }
 
        GUI::Init(sdlRenderer);
 
-       // Have to do this *after* video init but *before* sound init...!
-//Shouldn't be necessary since we're not doing emulation in the ISR...
+       WriteLog("About to initialize audio...\n");
+       SoundInit();
+
        if (settings.autoStateSaving)
        {
                // Load last state from file...
@@ -416,16 +589,30 @@ int main(int /*argc*/, char * /*argv*/[])
                        WriteLog("Unable to use Apple2 state file \"%s\"!\n", settings.autoStatePath);
        }
 
-       WriteLog("About to initialize audio...\n");
-       SoundInit();
-       SetupBlurTable();                                                       // Set up the color TV emulation blur table
-       running = true;                                                         // Set running status...
-       InitializeEventList();                                          // Clear the event list before we use it...
-       SetCallbackTime(FrameCallback, 16666.66666667); // Set frame to fire at 1/60 s interval
-       SetCallbackTime(BlinkTimer, 250000);            // Set up blinking at 1/4 s intervals
+/*
+So, how to run this then?  Right now, we have two separate threads, one for the CPU and one for audio.  The screen refresh is tied to the CPU thread.
+
+To do this properly, however, we need to execute approximately 1,020,484.32 cycles per second, and we need to tie the AY/regular sound to this rate.  Video should happen still approximately 60 times a second, even though the real thing has a frame rate of 59.92 Hz.
+
+Right now, the speed of the CPU is tied to the host system's refresh rate (which seems to be somewhere around 59.9 Hz).  Under this regime, the sound thread is starved much of the time, which means there's a timing mismatch somewhere between the sound thread and the CPU thread and the video (main) thread.
+
+Other considerations: Even though we know the exact amount of cycles for one frame (17030 cycles to be exact), because the video frame rate is slightly under 60 (~59.92) the amount of time those cycles take can't be tied to the host system refresh rate, as they won't be the same (it will have about 8,000 or so more cycles in one second than it should have using 60 frames per second as the base frequency).  However, we do know that the system clock is 14.318180 MHz, and we do know that 1 out of every 65 cycles will take 2 extra ticks of the system clock (cycles are normally 14 ticks of the system clock).  So, by virtue of this, we know how long one frame is in seconds exactly (which would be (((65 * 14) + 2) * 262) / 14318180 = 16.688154500083 milliseconds).
+
+So we need to decouple the CPU thread from the host video thread, and have the CPU frame run at its rate so that it will complete its running in its alloted time.  We also need to have a little bit of cushion for the sound thread, so that its buffer doesn't starve.  Assuming we get the timing correct, it will pull ahead and fall behind and all average out in the end.
+
+
+*/
+
+       running = true;
+       InitializeEventList();
+       // Set frame to fire at 1/60 s interval
+       SetCallbackTime(FrameCallback, 16666.66666667);
+       // Set up blinking at 1/4 s intervals
+//     SetCallbackTime(BlinkTimer, 250000);
        startTicks = SDL_GetTicks();
 
 #ifdef THREADED_65C02
+       // Kick off the CPU...
        cpuCond = SDL_CreateCond();
        mainSem = SDL_CreateSemaphore(1);
        cpuThread = SDL_CreateThread(CPUThreadFunc, NULL, NULL);
@@ -437,7 +624,9 @@ int main(int /*argc*/, char * /*argv*/[])
 
        while (running)
        {
+#ifdef CPU_CLOCK_CHECKING
                double timeToNextEvent = GetTimeToNextEvent();
+#endif
 #ifndef THREADED_65C02
                Execute65C02(&mainCPU, USEC_TO_M6502_CYCLES(timeToNextEvent));
 
@@ -471,103 +660,103 @@ WriteLog("Main: SDL_DestroyCond(cpuCond);\n");
        if (settings.autoStateSaving)
                SaveApple2State(settings.autoStatePath);
 
-       floppyDrive.SaveImage(0);
-       floppyDrive.SaveImage(1);
+       floppyDrive[0].SaveImage(0);
+       floppyDrive[0].SaveImage(1);
 
+#if 0
+#include "dis65c02.h"
+static char disbuf[80];
+uint16_t pc=0x801;
+while (pc < 0x9FF)
+{
+       pc += Decode65C02(&mainCPU, disbuf, pc);
+       WriteLog("%s\n", disbuf);
+}
+#endif
+
+       SaveSettings();
        SoundDone();
        VideoDone();
-       SaveSettings();
        LogDone();
 
        return 0;
 }
 
 
-/*
-Apple II keycodes
------------------
-
-Key     Aln CTL SHF BTH
------------------------
-space  $A0     $A0     $A0 $A0         No xlation
-RETURN $8D     $8D     $8D     $8D             No xlation
-0              $B0     $B0     $B0     $B0             Need to screen shift+0 (?)
-1!             $B1 $B1 $A1 $A1         No xlation
-2"             $B2     $B2     $A2     $A2             No xlation
-3#             $B3     $B3     $A3     $A3             No xlation
-4$             $B4     $B4     $A4     $A4             No xlation
-5%             $B5     $B5     $A5     $A5             No xlation
-6&             $B6     $B6     $A6     $A6             No xlation
-7'             $B7     $B7     $A7     $A7             No xlation
-8(             $B8     $B8     $A8     $A8             No xlation
-9)             $B9     $B9     $A9     $A9             No xlation
-:*             $BA     $BA     $AA     $AA             No xlation
-;+             $BB     $BB     $AB     $AB             No xlation
-,<             $AC     $AC     $BC     $BC             No xlation
--=             $AD     $AD     $BD     $BD             No xlation
-.>             $AE     $AE     $BE     $BE             No xlation
-/?             $AF     $AF     $BF     $BF             No xlation
-A              $C1     $81     $C1     $81
-B              $C2     $82     $C2     $82
-C              $C3     $83     $C3     $83
-D              $C4     $84     $C4     $84
-E              $C5     $85     $C5     $85
-F              $C6     $86     $C6     $86
-G              $C7     $87     $C7     $87
-H              $C8     $88     $C8     $88
-I              $C9     $89     $C9     $89
-J              $CA     $8A     $CA     $8A
-K              $CB     $8B     $CB     $8B
-L              $CC     $8C     $CC     $8C
-M              $CD     $8D     $DD     $9D             -> ODD
-N^             $CE     $8E     $DE     $9E             -> ODD
-O              $CF     $8F     $CF     $8F
-P@             $D0     $90     $C0     $80             Need to xlate CTL+SHFT+P & SHFT+P (?)
-Q              $D1     $91     $D1     $91
-R              $D2     $92     $D2     $92
-S              $D3     $93     $D3     $93
-T              $D4     $94     $D4     $94
-U              $D5     $95     $D5     $95
-V              $D6     $96     $D6     $96
-W              $D7     $97     $D7     $97
-X              $D8     $98     $D8     $98
-Y              $D9     $99     $D9     $99
-Z              $DA     $9A     $DA     $9A
-<-             $88     $88     $88     $88
-->             $95     $95     $95     $95
-ESC            $9B     $9B     $9B     $9B             No xlation
-*/
+//
+// Apple //e scancodes. Tables are normal (0), +CTRL (1), +SHIFT (2),
+// +CTRL+SHIFT (3). Order of keys is:
+// Delete, left, tab, down, up, return, right, escape
+// Space, single quote, comma, minus, period, slash
+// Numbers 0-9
+// Semicolon, equals, left bracket, backslash, right bracket, backquote
+// Letters a-z (lowercase)
+//
+// N.B.: The Apple //e keyboard maps its shift characters like most modern US
+//       keyboards, so this table should suffice for the shifted keys just
+//       fine.
+//
+uint8_t apple2e_keycode[4][56] = {
+       {       // Normal
+               0x7F, 0x08, 0x09, 0x0A, 0x0B, 0x0D, 0x15, 0x1B,
+               0x20, 0x27, 0x2C, 0x2D, 0x2E, 0x2F,
+               0x30, 0x31, 0x32, 0x33, 0x34, 0x35, 0x36, 0x37, 0x38, 0x39,
+               0x3B, 0x3D, 0x5B, 0x5C, 0x5D, 0x60,
+               0x61, 0x62, 0x63, 0x64, 0x65, 0x66, 0x67, 0x68, 0x69, 0x6A,
+               0x6B, 0x6C, 0x6D, 0x6E, 0x6F, 0x70, 0x71, 0x72, 0x73, 0x74,
+               0x75, 0x76, 0x77, 0x78, 0x79, 0x7A
+       },
+       {       // With CTRL held
+               0x7F, 0x08, 0x09, 0x0A, 0x0B, 0x0D, 0x15, 0x1B,
+               0x20, 0x27, 0x2C, 0x1F, 0x2E, 0x2F,
+               0x30, 0x31, 0x00, 0x33, 0x34, 0x35, 0x1E, 0x37, 0x38, 0x39,
+               0x3B, 0x3D, 0x1B, 0x1C, 0x1D, 0x60,
+               0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08, 0x09, 0x0A,
+               0x0B, 0x0C, 0x0D, 0x0E, 0x0F, 0x10, 0x11, 0x12, 0x13, 0x14,
+               0x15, 0x16, 0x17, 0x18, 0x19, 0x1A
+       },
+       {       // With Shift held
+               0x7F, 0x08, 0x09, 0x0A, 0x0B, 0x0D, 0x15, 0x1B,
+               0x20, 0x22, 0x3C, 0x5F, 0x3E, 0x3F,
+               0x29, 0x21, 0x40, 0x23, 0x24, 0x25, 0x5E, 0x26, 0x2A, 0x28,
+               0x3A, 0x2B, 0x7B, 0x7C, 0x7D, 0x7E,
+               0x41, 0x42, 0x43, 0x44, 0x45, 0x46, 0x47, 0x48, 0x49, 0x4A,
+               0x4B, 0x4C, 0x4D, 0x4E, 0x4F, 0x50, 0x51, 0x52, 0x53, 0x54,
+               0x55, 0x56, 0x57, 0x58, 0x59, 0x5A
+       },
+       {       // With CTRL+Shift held
+               0x7F, 0x08, 0x09, 0x0A, 0x0B, 0x0D, 0x15, 0x1B,
+               0x20, 0x22, 0x3C, 0x1F, 0x3E, 0x3F,
+               0x29, 0x21, 0x00, 0x23, 0x24, 0x25, 0x1E, 0x26, 0x2A, 0x28,
+               0x3A, 0x2B, 0x1B, 0x1C, 0x1D, 0x7E,
+               0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08, 0x09, 0x0A,
+               0x0B, 0x0C, 0x0D, 0x0E, 0x0F, 0x10, 0x11, 0x12, 0x13, 0x14,
+               0x15, 0x16, 0x17, 0x18, 0x19, 0x1A
+       }
+};
 
 static uint32_t frameCount = 0;
 static void FrameCallback(void)
 {
        SDL_Event event;
+       uint8_t keyIndex;
+
+       frameTimePtr = (frameTimePtr + 1) % 60;
+       frameTime[frameTimePtr] = startTicks;
 
        while (SDL_PollEvent(&event))
        {
                switch (event.type)
                {
-// Problem with using SDL_TEXTINPUT is that it causes key delay. :-/
-#if 0
-               case SDL_TEXTINPUT:
-//Need to do some key translation here, and screen out non-apple keys as well...
-//(really, could do it all in SDL_KEYDOWN, would just have to get symbols &
-// everything else done separately. this is slightly easier. :-P)
-//                     if (event.key.keysym.sym == SDLK_TAB)   // Prelim key screening...
-                       if (event.edit.text[0] == '\t') // Prelim key screening...
+               case SDL_KEYDOWN:
+                       // We do our own repeat handling thank you very much! :-)
+                       if (event.key.repeat != 0)
                                break;
 
-                       lastKeyPressed = event.edit.text[0];
-                       keyDown = true;
-
-                       //kludge: should have a caps lock thingy here...
-                       //or all uppercase for ][+...
-//                     if (lastKeyPressed >= 'a' && lastKeyPressed <='z')
-//                             lastKeyPressed &= 0xDF;         // Convert to upper case...
+                       // This breaks IMEs and the like, but we'll do simple for now
+                       if (GUI::KeyDown(event.key.keysym.sym))
+                               break;
 
-                       break;
-#endif
-               case SDL_KEYDOWN:
                        // Use CTRL+SHIFT+Q to exit, as well as the usual window decoration
                        // method
                        if ((event.key.keysym.mod & KMOD_CTRL)
@@ -580,196 +769,120 @@ static void FrameCallback(void)
                                return;
                        }
 
-                       // CTRL+RESET key emulation (mapped to CTRL+`)
-// This doesn't work...
-//                     if (event.key.keysym.sym == SDLK_BREAK && (event.key.keysym.mod & KMOD_CTRL))
-//                     if (event.key.keysym.sym == SDLK_PAUSE && (event.key.keysym.mod & KMOD_CTRL))
+                       // CTRL+RESET key emulation (mapped to CTRL+HOME)
                        if ((event.key.keysym.mod & KMOD_CTRL)
-                               && (event.key.keysym.sym == SDLK_BACKQUOTE))
+                               && (event.key.keysym.sym == SDLK_HOME))
                        {
-//NOTE that this shouldn't take place until the key is lifted... !!! FIX !!!
-//ALSO it seems to leave the machine in an inconsistent state vis-a-vis the language card...
-                               mainCPU.cpuFlags |= V65C02_ASSERT_LINE_RESET;
+//seems to leave the machine in an inconsistent state vis-a-vis the language card... [does it anymore?]
+                               resetKeyDown = true;
+                               // Need to reset the MMU switches as well on RESET
+                               intCXROM = false;
+                               slotC3ROM = false;
+                               intC8ROM = false;
                                break;
                        }
 
-                       if (event.key.keysym.sym == SDLK_RIGHT)
-                               lastKeyPressed = 0x15, keyDown = true;
-                       else if (event.key.keysym.sym == SDLK_LEFT)
-                               lastKeyPressed = 0x08, keyDown = true;
-                       else if (event.key.keysym.sym == SDLK_UP)
-                               lastKeyPressed = 0x0B, keyDown = true;
-                       else if (event.key.keysym.sym == SDLK_DOWN)
-                               lastKeyPressed = 0x0A, keyDown = true;
-                       else if (event.key.keysym.sym == SDLK_RETURN)
-                               lastKeyPressed = 0x0D, keyDown = true;
-                       else if (event.key.keysym.sym == SDLK_ESCAPE)
-                               lastKeyPressed = 0x1B, keyDown = true;
-                       else if (event.key.keysym.sym == SDLK_BACKSPACE)
-                               lastKeyPressed = 0x7F, keyDown = true;
-
-                       // Fix CTRL+key combo...
-                       if (event.key.keysym.mod & KMOD_CTRL)
-                       {
-                               if (event.key.keysym.sym >= SDLK_a && event.key.keysym.sym <= SDLK_z)
-                               {
-                                       lastKeyPressed = (event.key.keysym.sym - SDLK_a) + 1;
-                                       keyDown = true;
-//printf("Key combo pressed: CTRL+%c\n", lastKeyPressed + 0x40);
-                                       break;
-                               }
-                       }
+                       // There has GOT to be a better way off mapping SDLKs to our
+                       // keyindex. But for now, this should suffice.
+                       keyIndex = 0xFF;
 
-#if 1
-                       // Fix SHIFT+key combo...
-                       if (event.key.keysym.mod & KMOD_SHIFT)
+                       switch (event.key.keysym.sym)
                        {
-                               if (event.key.keysym.sym >= SDLK_a && event.key.keysym.sym <= SDLK_z)
-                               {
-                                       lastKeyPressed = (event.key.keysym.sym - SDLK_a) + 0x41;
-                                       keyDown = true;
-//printf("Key combo pressed: CTRL+%c\n", lastKeyPressed + 0x40);
-                                       break;
-                               }
-                               else if (event.key.keysym.sym == SDLK_1)
-                               {
-                                       lastKeyPressed = '!';
-                                       keyDown = true;
-                                       break;
-                               }
-                               else if (event.key.keysym.sym == SDLK_2)
-                               {
-                                       lastKeyPressed = '@';
-                                       keyDown = true;
-                                       break;
-                               }
-                               else if (event.key.keysym.sym == SDLK_3)
-                               {
-                                       lastKeyPressed = '#';
-                                       keyDown = true;
-                                       break;
-                               }
-                               else if (event.key.keysym.sym == SDLK_4)
-                               {
-                                       lastKeyPressed = '$';
-                                       keyDown = true;
-                                       break;
-                               }
-                               else if (event.key.keysym.sym == SDLK_5)
-                               {
-                                       lastKeyPressed = '%';
-                                       keyDown = true;
-                                       break;
-                               }
-                               else if (event.key.keysym.sym == SDLK_6)
-                               {
-                                       lastKeyPressed = '^';
-                                       keyDown = true;
-                                       break;
-                               }
-                               else if (event.key.keysym.sym == SDLK_7)
-                               {
-                                       lastKeyPressed = '&';
-                                       keyDown = true;
-                                       break;
-                               }
-                               else if (event.key.keysym.sym == SDLK_8)
-                               {
-                                       lastKeyPressed = '*';
-                                       keyDown = true;
-                                       break;
-                               }
-                               else if (event.key.keysym.sym == SDLK_9)
-                               {
-                                       lastKeyPressed = '(';
-                                       keyDown = true;
-                                       break;
-                               }
-                               else if (event.key.keysym.sym == SDLK_0)
-                               {
-                                       lastKeyPressed = ')';
-                                       keyDown = true;
-                                       break;
-                               }
-                               else if (event.key.keysym.sym == SDLK_MINUS)
-                               {
-                                       lastKeyPressed = '_';
-                                       keyDown = true;
-                                       break;
-                               }
-                               else if (event.key.keysym.sym == SDLK_EQUALS)
-                               {
-                                       lastKeyPressed = '+';
-                                       keyDown = true;
-                                       break;
-                               }
-                               else if (event.key.keysym.sym == SDLK_LEFTBRACKET)
-                               {
-                                       lastKeyPressed = '{';
-                                       keyDown = true;
-                                       break;
-                               }
-                               else if (event.key.keysym.sym == SDLK_RIGHTBRACKET)
-                               {
-                                       lastKeyPressed = '}';
-                                       keyDown = true;
-                                       break;
-                               }
-                               else if (event.key.keysym.sym == SDLK_BACKSLASH)
-                               {
-                                       lastKeyPressed = '|';
-                                       keyDown = true;
-                                       break;
-                               }
-                               else if (event.key.keysym.sym == SDLK_SEMICOLON)
-                               {
-                                       lastKeyPressed = ':';
-                                       keyDown = true;
-                                       break;
-                               }
-                               else if (event.key.keysym.sym == SDLK_QUOTE)
-                               {
-                                       lastKeyPressed = '"';
-                                       keyDown = true;
-                                       break;
-                               }
-                               else if (event.key.keysym.sym == SDLK_COMMA)
-                               {
-                                       lastKeyPressed = '<';
-                                       keyDown = true;
-                                       break;
-                               }
-                               else if (event.key.keysym.sym == SDLK_PERIOD)
-                               {
-                                       lastKeyPressed = '>';
-                                       keyDown = true;
-                                       break;
-                               }
-                               else if (event.key.keysym.sym == SDLK_SLASH)
-                               {
-                                       lastKeyPressed = '?';
-                                       keyDown = true;
-                                       break;
-                               }
-                               else if (event.key.keysym.sym == SDLK_BACKQUOTE)
-                               {
-                                       lastKeyPressed = '~';
-                                       keyDown = true;
-                                       break;
-                               }
+                       case SDLK_BACKSPACE:    keyIndex =  0; break;
+                       case SDLK_LEFT:         keyIndex =  1; break;
+                       case SDLK_TAB:          keyIndex =  2; break;
+                       case SDLK_DOWN:         keyIndex =  3; break;
+                       case SDLK_UP:           keyIndex =  4; break;
+                       case SDLK_RETURN:       keyIndex =  5; break;
+                       case SDLK_RIGHT:        keyIndex =  6; break;
+                       case SDLK_ESCAPE:       keyIndex =  7; break;
+                       case SDLK_SPACE:        keyIndex =  8; break;
+                       case SDLK_QUOTE:        keyIndex =  9; break;
+                       case SDLK_COMMA:        keyIndex = 10; break;
+                       case SDLK_MINUS:        keyIndex = 11; break;
+                       case SDLK_PERIOD:       keyIndex = 12; break;
+                       case SDLK_SLASH:        keyIndex = 13; break;
+                       case SDLK_0:            keyIndex = 14; break;
+                       case SDLK_1:            keyIndex = 15; break;
+                       case SDLK_2:            keyIndex = 16; break;
+                       case SDLK_3:            keyIndex = 17; break;
+                       case SDLK_4:            keyIndex = 18; break;
+                       case SDLK_5:            keyIndex = 19; break;
+                       case SDLK_6:            keyIndex = 20; break;
+                       case SDLK_7:            keyIndex = 21; break;
+                       case SDLK_8:            keyIndex = 22; break;
+                       case SDLK_9:            keyIndex = 23; break;
+                       case SDLK_SEMICOLON:    keyIndex = 24; break;
+                       case SDLK_EQUALS:       keyIndex = 25; break;
+                       case SDLK_LEFTBRACKET:  keyIndex = 26; break;
+                       case SDLK_BACKSLASH:    keyIndex = 27; break;
+                       case SDLK_RIGHTBRACKET: keyIndex = 28; break;
+                       case SDLK_BACKQUOTE:    keyIndex = 29; break;
+                       case SDLK_a:            keyIndex = 30; break;
+                       case SDLK_b:            keyIndex = 31; break;
+                       case SDLK_c:            keyIndex = 32; break;
+                       case SDLK_d:            keyIndex = 33; break;
+                       case SDLK_e:            keyIndex = 34; break;
+                       case SDLK_f:            keyIndex = 35; break;
+                       case SDLK_g:            keyIndex = 36; break;
+                       case SDLK_h:            keyIndex = 37; break;
+                       case SDLK_i:            keyIndex = 38; break;
+                       case SDLK_j:            keyIndex = 39; break;
+                       case SDLK_k:            keyIndex = 40; break;
+                       case SDLK_l:            keyIndex = 41; break;
+                       case SDLK_m:            keyIndex = 42; break;
+                       case SDLK_n:            keyIndex = 43; break;
+                       case SDLK_o:            keyIndex = 44; break;
+                       case SDLK_p:            keyIndex = 45; break;
+                       case SDLK_q:            keyIndex = 46; break;
+                       case SDLK_r:            keyIndex = 47; break;
+                       case SDLK_s:            keyIndex = 48; break;
+                       case SDLK_t:            keyIndex = 49; break;
+                       case SDLK_u:            keyIndex = 50; break;
+                       case SDLK_v:            keyIndex = 51; break;
+                       case SDLK_w:            keyIndex = 52; break;
+                       case SDLK_x:            keyIndex = 53; break;
+                       case SDLK_y:            keyIndex = 54; break;
+                       case SDLK_z:            keyIndex = 55; break;
                        }
-#endif
 
-                       // General keys...
-                       if (event.key.keysym.sym >= SDLK_SPACE && event.key.keysym.sym <= SDLK_z)
+                       // Stuff the key in if we have a valid one...
+                       if (keyIndex != 0xFF)
                        {
-                               lastKeyPressed = event.key.keysym.sym;
+                               // Handle Shift, CTRL, & Shift+CTRL combos
+                               uint8_t table = 0;
+
+                               if (event.key.keysym.mod & KMOD_CTRL)
+                                       table |= 1;
+
+                               if (event.key.keysym.mod & KMOD_SHIFT)
+                                       table |= 2;
+
+                               lastKeyPressed = apple2e_keycode[table][keyIndex];
                                keyDown = true;
 
-                               // Check for Caps Lock key...
-                               if (event.key.keysym.sym >= SDLK_a && event.key.keysym.sym <= SDLK_z && capsLock)
+                               // Handle Caps Lock
+                               if ((SDL_GetModState() & KMOD_CAPS)
+                                       && (lastKeyPressed >= 0x61) && (lastKeyPressed <= 0x7A))
                                        lastKeyPressed -= 0x20;
 
+                               // Handle key repeat if the key hasn't been held
+                               keyDelay = 15;
+                               keyDownCount++;
+
+                               // Buffer the key held. Note that the last key is always
+                               // stuffed into keysHeld[0].
+                               if (keyDownCount >= 2)
+                               {
+                                       keysHeld[1] = keysHeld[0];
+                                       keysHeldAppleCode[1] = keysHeldAppleCode[0];
+
+                                       if (keyDownCount > 2)
+                                               keyDownCount = 2;
+                               }
+
+                               keysHeld[0] = event.key.keysym.sym;
+                               keysHeldAppleCode[0] = lastKeyPressed;
                                break;
                        }
 
@@ -788,31 +901,17 @@ static void FrameCallback(void)
                                        SpawnMessage("*** RESUME ***");
                                }
                        }
-
-                       // Paddle buttons 0 & 1
-                       if (event.key.keysym.sym == SDLK_LALT)
+                       // Buttons 0 & 1
+                       else if (event.key.keysym.sym == SDLK_LALT)
                                openAppleDown = true;
-                       if (event.key.keysym.sym == SDLK_RALT)
+                       else if (event.key.keysym.sym == SDLK_RALT)
                                closedAppleDown = true;
-
-                       if (event.key.keysym.sym == SDLK_F11)
-                               dumpDis = !dumpDis;                             // Toggle the disassembly process
-
-/*else if (event.key.keysym.sym == SDLK_F9)
-{
-       floppyDrive.CreateBlankImage(0);
-//     SpawnMessage("Image cleared...");
-}//*/
-/*else if (event.key.keysym.sym == SDLK_F10)
-{
-       floppyDrive.SwapImages();
-//     SpawnMessage("Image swapped...");
-}//*/
-
-                       if (event.key.keysym.sym == SDLK_F2)
+                       else if (event.key.keysym.sym == SDLK_F2)
                                TogglePalette();
                        else if (event.key.keysym.sym == SDLK_F3)
                                CycleScreenTypes();
+                       else if (event.key.keysym.sym == SDLK_F4)
+                               ToggleTickDisplay();
                        else if (event.key.keysym.sym == SDLK_F5)
                        {
                                VolumeDown();
@@ -833,6 +932,34 @@ static void FrameCallback(void)
 
                                SpawnMessage("Volume: %s", volStr);
                        }
+                       else if (event.key.keysym.sym == SDLK_F7)
+                       {
+                               // 4th root of 2 is ~1.18920711500272 (~1.5 dB)
+                               // This attenuates by ~3 dB
+                               VAY_3_8910::maxVolume /= 1.4142135f;
+                               SpawnMessage("MB Volume: %d", (int)VAY_3_8910::maxVolume);
+                       }
+                       else if (event.key.keysym.sym == SDLK_F8)
+                       {
+                               VAY_3_8910::maxVolume *= 1.4142135f;
+                               SpawnMessage("MB Volume: %d", (int)VAY_3_8910::maxVolume);
+                       }
+else if (event.key.keysym.sym == SDLK_F9)
+{
+       floppyDrive[0].CreateBlankImage(1);
+//     SpawnMessage("Image cleared...");
+}//*/
+/*else if (event.key.keysym.sym == SDLK_F10)
+{
+       floppyDrive[0].SwapImages();
+//     SpawnMessage("Image swapped...");
+}//*/
+                       // Toggle the disassembly process
+                       else if (event.key.keysym.sym == SDLK_F11)
+                       {
+                               dumpDis = !dumpDis;
+                               SpawnMessage("Trace: %s", (dumpDis ? "ON" : "off"));
+                       }
                        else if (event.key.keysym.sym == SDLK_F12)
                        {
                                if (!fullscreenDebounce)
@@ -842,48 +969,99 @@ static void FrameCallback(void)
                                }
                        }
 
-                       if (event.key.keysym.sym == SDLK_CAPSLOCK)
-                       {
-                               if (!capsLockDebounce)
-                               {
-                                       capsLock = !capsLock;
-                                       capsLockDebounce = true;
-                               }
-                       }
-
                        break;
+
                case SDL_KEYUP:
                        if (event.key.keysym.sym == SDLK_F12)
                                fullscreenDebounce = false;
-                       if (event.key.keysym.sym == SDLK_CAPSLOCK)
-                               capsLockDebounce = false;
-
                        // Paddle buttons 0 & 1
-                       if (event.key.keysym.sym == SDLK_LALT)
+                       else if (event.key.keysym.sym == SDLK_LALT)
                                openAppleDown = false;
-                       if (event.key.keysym.sym == SDLK_RALT)
+                       else if (event.key.keysym.sym == SDLK_RALT)
                                closedAppleDown = false;
+                       else if ((event.key.keysym.mod & KMOD_CTRL)
+                               && (event.key.keysym.sym == SDLK_HOME))
+                               resetKeyDown = false;
+                       else
+                       {
+                               // Handle key buffering 'key up' event (2 key rollover)
+                               if ((keyDownCount == 1) && (event.key.keysym.sym == keysHeld[0]))
+                               {
+                                       keyDownCount--;
+                                       keyDelay = 0;   // Reset key delay
+                               }
+                               else if (keyDownCount == 2)
+                               {
+                                       if (event.key.keysym.sym == keysHeld[0])
+                                       {
+                                               keyDownCount--;
+                                               keysHeld[0] = keysHeld[1];
+                                               keysHeldAppleCode[0] = keysHeldAppleCode[1];
+                                       }
+                                       else if (event.key.keysym.sym == keysHeld[1])
+                                       {
+                                               keyDownCount--;
+                                       }
+                               }
+                       }
 
                        break;
+
                case SDL_MOUSEBUTTONDOWN:
                        GUI::MouseDown(event.motion.x, event.motion.y, event.motion.state);
                        break;
+
                case SDL_MOUSEBUTTONUP:
                        GUI::MouseUp(event.motion.x, event.motion.y, event.motion.state);
                        break;
+
                case SDL_MOUSEMOTION:
                        GUI::MouseMove(event.motion.x, event.motion.y, event.motion.state);
+
+                       // Handle mouse showing when the mouse is hidden...
+                       if (hideMouseTimeout == -1)
+                               SDL_ShowCursor(1);
+
+                       hideMouseTimeout = 60;
                        break;
+
                case SDL_WINDOWEVENT:
                        if (event.window.event == SDL_WINDOWEVENT_LEAVE)
                                GUI::MouseMove(0, 0, 0);
 
                        break;
+
                case SDL_QUIT:
                        running = false;
                }
        }
 
+       // Hide the mouse if it's been 1s since the last time it was moved
+       // N.B.: Should disable mouse hiding if it's over the GUI...
+       if ((hideMouseTimeout > 0) && !(GUI::sidebarState == SBS_SHOWN || DiskSelector::showWindow == true || Config::showWindow == true))
+               hideMouseTimeout--;
+       else if (hideMouseTimeout == 0)
+       {
+               hideMouseTimeout--;
+               SDL_ShowCursor(0);
+       }
+
+       // Stuff the Apple keyboard buffer, if any keys are pending
+       // N.B.: May have to simulate the key repeat delay too [yup, sure do]
+       //       According to "Understanding the Apple IIe", the initial delay is
+       //       between 32 & 48 jiffies and the repeat is every 4 jiffies.
+       if (keyDownCount > 0)
+       {
+               keyDelay--;
+
+               if (keyDelay == 0)
+               {
+                       keyDelay = 3;
+                       lastKeyPressed = keysHeldAppleCode[0];
+                       keyDown = true;
+               }
+       }
+
        // Handle power request from the GUI
        if (powerStateChangeRequested)
        {
@@ -904,8 +1082,13 @@ static void FrameCallback(void)
                powerStateChangeRequested = false;
        }
 
-       RenderVideoFrame();                             // Render Apple screen to buffer
-       RenderScreenBuffer();                   // Render buffer to host screen
+       blinkTimer = (blinkTimer + 1) & 0x1F;
+
+       if (blinkTimer == 0)
+               flash = !flash;
+
+       // Render the Apple screen + GUI overlay
+       RenderAppleScreen(sdlRenderer);
        GUI::Render(sdlRenderer);
        SDL_RenderPresent(sdlRenderer);
        SetCallbackTime(FrameCallback, 16666.66666667);
@@ -926,17 +1109,29 @@ if (counter == 60)
 #endif
 
 // This is the problem: If you set the interval to 16, it runs faster than
-// 1/60s per frame. If you set it to 17, it runs slower. What we need is to
-// have it do 16 for one frame, then 17 for two others. Then it should average
-// out to 1/60s per frame every 3 frames.
+// 1/60s per frame.  If you set it to 17, it runs slower.  What we need is to
+// have it do 16 for one frame, then 17 for two others.  Then it should average
+// out to 1/60s per frame every 3 frames.  [And now it does!]
+// Maybe we need a higher resolution timer, as the SDL_GetTicks() (in ms) seems
+// to jitter all over the place...
        frameCount = (frameCount + 1) % 3;
-       uint32_t waitFrameTime = 17 - (frameCount == 0 ? 1 : 0);
+//     uint32_t waitFrameTime = 17 - (frameCount == 0 ? 1 : 0);
+       // Get number of ticks burned in this frame, for displaying elsewhere
+#if 0
+       frameTicks = SDL_GetTicks() - startTicks;
+#else
+       frameTicks = ((SDL_GetPerformanceCounter() - startTicks) * 1000) / SDL_GetPerformanceFrequency();
+#endif
 
        // Wait for next frame...
-       while (SDL_GetTicks() - startTicks < waitFrameTime)
-               SDL_Delay(1);
+//     while (SDL_GetTicks() - startTicks < waitFrameTime)
+//             SDL_Delay(1);
 
+#if 0
        startTicks = SDL_GetTicks();
+#else
+       startTicks = SDL_GetPerformanceCounter();
+#endif
 #if 0
        uint64_t cpuCycles = GetCurrentV65C02Clock();
        uint32_t cyclesBurned = (uint32_t)(cpuCycles - lastCPUCycles);