Apple-2-Tools/apple2ix
1
0
Fork 0
mirror of https://github.com/mauiaaron/apple2.git synced 2024-12-26 00:31:44 +00:00
Code Issues Projects Releases Wiki Activity
Apple //e emulator
1,590 Commits 5 Branches 15 Tags 25 MiB
C 85.6%
Java 5.2%
Objective-C 4.2%
Assembly 1.8%
Shell 1.3%
Other 1.8%
18d831b04c
Go to file
Aaron Culliney 18d831b04c Fast disk loading is enabled from a pref
2018-11-07 06:49:16 -08:00
Android Fast disk loading is enabled from a pref 2018-11-07 06:49:16 -08:00
Apple2Mac Refactor video/display rendering 2018-11-04 14:07:30 -08:00
disks Improve display testing 2018-08-11 16:32:13 -07:00
docs Merge branch 'develop' ... latest Linux, Android, and Mac variant 2015-11-14 11:10:11 -08:00
external Rename external directory to something GitHub recognizes 2016-09-24 12:44:50 -07:00
src Fast disk loading is enabled from a pref 2018-11-07 06:49:16 -08:00
.gitignore Reference external ROM directory 2016-09-10 16:21:38 -06:00
ASM Refactor to use GNU build tools 2014-01-22 20:51:50 -08:00
AUTHORS Refactor to use GNU build tools 2014-01-22 20:51:50 -08:00
ChangeLog Refactor to use GNU build tools 2014-01-22 20:51:50 -08:00
configure.ac First cut at implementing conformant video scanner 2018-07-29 18:33:17 -07:00
COPYING Upgrade to GPLv3 "or later" and update copyrights 2015-10-22 21:09:13 -07:00
external-disks Enable testing of 3rd-party disk images 2016-08-27 09:17:23 -07:00
externals Rename external directory to something GitHub recognizes 2016-09-24 12:44:50 -07:00
Makefile.am First cut at implementing conformant video scanner 2018-07-29 18:33:17 -07:00
NEWS Refactor to use GNU build tools 2014-01-22 20:51:50 -08:00
PROBLEMS Refactor to use GNU build tools 2014-01-22 20:51:50 -08:00
README initial source drop, apple2-emul-0.7.4.tar.gz 2013-06-11 00:08:15 -07:00
README.debugger initial source drop, apple2-emul-0.7.4.tar.gz 2013-06-11 00:08:15 -07:00
README.md Update README.md 2018-07-29 19:00:30 -07:00
reconf.sh Refactor to use GNU build tools 2014-01-22 20:51:50 -08:00
TODO initial source drop, apple2-emul-0.7.4.tar.gz 2013-06-11 00:08:15 -07:00
valgrind.suppress Fix shutdown codepaths 2015-05-31 13:43:51 -07:00

README.md

Apple //ix

Apple2ix is an Apple //e (8bit 65c02 CPU) emulator designed to work on various POSIX platforms.

Lineage

Apple2ix derives from the apple2-emul-linux project originally coded by various developers in the mid 1990's and FTP-uploaded as source tarballs to the original tsx-11.mit.edu Linux archive.

The original software was designed to work from the Linux console rendering via SVGAlib. It ran on par to the 1MHz Apple //e on an i386 (Pentium 100 class) or better machine. Later ports added X11 graphics support based on the original X11 DOOM source code drop, ty JC!

As of October 2016, the resurrected Apple2ix runs on x86 and ARM Android devices, x64 MacOSX 10.9+, and x64 GNU/Linux

Project Goals

  • Portability and code resilience across a wide range of modern POSIXy systems including MacOSX, desktop Linux/BSD, iOS, Android. If you are on Windows, just use the excellent AppleWin emulator!
  • Language/platform/API minimalism for core emulation modules (prefer coding to POSIX APIs and using C99 over all other choices)
  • Reasonable emulation fidelity to the original Apple //e machine (timing, video, audio, etc...)
  • Good platform citizenship for each port (prefer coding in language-of-choice promoted by platform--e.g.: Objective-C/Swift on Darwin, Java on Android, ...)

Project Tech

  • C99 dialect of the C programming language for the majority of the project
  • x86 and ARM assembly language for 65c02 CPU emulation loop
  • Extensive tests for 65c02 CPU, Apple //e VM, disks, and display (expected framebuffer output)
  • OpenGLES 2.x graphics with simple portable GLSL shaders
  • OpenAL and OpenSLES audio (emulated speaker and emulated Mockingboard/Phasor soundcards)
  • Objective-C and Cocoa APIs (Mac/iOS variant)
  • Java and Android APIs (Android app)

Android

Available on Google Play.

Running at 30FPS on ancient Gingerbread (Android 2.3.3) devices: Apple2ix on Samsung Galaxy Y running Gingerbread

Running at 60FPS on modern Android devices: Apple2ix on Nexus 6

Other Maintained Ports

  • Desktop GNU/Linux (GNU build)
  • macOS/iOS (Xcode build)

Semi-Ordered TODO

  • Improve graphics by emulating NTSC artifacts
  • CPU module ports: aarch64, Clang IR (bitcode)
  • macOS/iOS ports. (Apple does not allow publishing emulators in App Store, so we don't give these ports precedence)
  • Net/Open/Free-BSD port
  • OpenGL shaders/tricks for style (possibly emulating of various NTSC screen artifacts)
  • Emulation features ... (mouse, printer, 3.5" disk, AppleHD, Phasor, ethernet?, ...)
  • Debugger rewrite with tests ... improved debugger routines (CLI/curses debugger? GDB/LLDB module?)
  • Port to web assembly

DOS 3.3