Punch is a virtual computer system that draws inspiration from iconic computing platforms such as the Commodore 64, Amiga 500, and Atari ST. Notable features include:

• Utilization of the MC6809 CPU using the MC6809 library
• A total of 16MB of video RAM, 64KB directly accessible by the CPU
• Screen resolution of 320x180 pixels, refresh rate of 60Hz
• Blitter chip for fast graphics processing

• Memory Model
• Blitter

• $000-$0ff direct page (default after reset)
• $100-$3ff available ram and system stack pointer (768 bytes)
• $0400-$0fff input/output area
  • $400-$4ff blitter surface descriptors (16 in total, 16 bytes each)
    • $x0/$x1: x position (16 bit signed)
    • $x2/$x3: y position (16 bit signed)
  • $500-$5ff blitter surface color tables (16) for 1, 2 and 4 bit color modes
  • $600-$7ff reserved area
  • $800-$8ff core
    • $800 status register
    • $801 control register
    • $802-$803 vram peek page (16bits, bit 8 to bit 23)
    • $804-$807 framebuffer base address (24 bits, $804 always #$00)
  • $900-$9ff keyboard
  • $a00-$aff timer
  • $b00-$bff scripting ic
  • $c00-$dff sound
  • $e00-$eff blitter
    • $e00 status register (unused)
    • $e01 control register
      • write 0b00000001: blit source to destination surface
      • write 0b00000010: tile blit source/dest/tile
      • write 0b00000100: clear destination surface with drawing color
    • $e02 source surface pointer (lowest nibble only)
    • $e03 destination surface pointer (lowest nibble only)
    • $e04 tile surface pointer (lowest nibble)
    • $e05 drawing color
    • $e08/$e09 x0 for drawing operations (16 bit signed)
    • $e0a/$e0b y0 for drawing operations (16 bit signed)
    • $e0c/$e0d x1 for drawing operations (16 bit signed)
    • $e0e/$e0f y1 for drawing operations (16 bit signed)
  • $f00-$fff vram peek (see $802/$803 as well)
• $1000-$fbff 59kb ram
• $fc00-$ffff 1kb kernel + vectors

• $010000-$feffff available vram (16.256kb)
• $ff0000-$ffe0ff default framebuffer vram (57.600 bytes)
• $ffe100-$ffffff available vram (7.936 bytes)

• CCS64 - A Commodore 64 Emulator by Per Håkan Sundell.
• Commander X16 - The Commander X16 is a modern 8-bit computer currently in active development. It is the brainchild of David "the 8 Bit Guy" Murray.
• Commander X16 emulator - Software version of Commander X16.
• E64
• freeverb - Free, studio-quality reverb SOURCE CODE in the public domain
• Hatari - Hatari is an Atari ST/STE/TT/Falcon emulator.
• lib65ce02 - CSG65CE02 emulator written in C.
• Lua - Lua is a powerful, efficient, lightweight, embeddable scripting language.
• MC6809 - MC6809 cpu emulator written in C++.
• Mega65 - The 21st century realization of the C65 heritage.
• Moira - Motorola 68000 cpu emulator written in C++ by Dirk W. Hoffmann.
• reSID - ReSID is a Commodore 6581 or 8580 Sound Interface Device emulator by Dag Lem.
• SDL Simple DirectMedia Layer - A cross-platform development library by Sam Lantinga designed to provide low level access to audio, keyboard, mouse, joystick, and graphics hardware.
• stb - single-file public domain (or MIT licensed) libraries for C/C++
• TIC-80 - TIC-80 is a free and open source fantasy computer for making, playing and sharing tiny games.
• vAmiga - An Amiga 500, 1000, or 2000 on your Apple Macintosh by Dirk W. Hoffmann.
• VICE - The Versatile Commodore Emulator.
• VirtualC64 - A Commodore 64 on your Apple Macintosh by Dirk W. Hoffmann.
• visual6502 - Visual Transistor-level Simulation of the 6502 CPU and other chips.

Copyright (c) 2023 elmerucr

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.