Apple-2-Tools/apple2ix
1
0
Fork 0
mirror of https://github.com/mauiaaron/apple2.git synced 2024-12-26 15:29:19 +00:00
Code Issues Projects Releases Wiki Activity
Apple //e emulator
1,027 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%
84fe0dd479
Go to file
Aaron Culliney 84fe0dd479 Fix crash on Nexus 10 device due to regfree()ing something not regcomp()ed
2015-10-30 23:12:12 -07:00
Android Hopefully improve crash reporting on older devices by sending a crash summary (possibly in addition to the attachment) 2015-10-30 00:13:14 -07:00
Apple2Mac Upgrade to GPLv3 "or later" and update copyrights 2015-10-22 21:09:13 -07:00
disks hax0r edits ;-) 2015-10-22 21:09:54 -07:00
docs New Android variant images 2015-10-25 13:09:35 -07:00
externals FWIW, also attempt to crash on SIGTRAP 2015-10-24 14:30:21 -07:00
src Fix crash on Nexus 10 device due to regfree()ing something not regcomp()ed 2015-10-30 23:12:12 -07:00
.apple2 Interface menu changes 2014-03-25 23:42:05 -07:00
.gitignore moar Android ignores 2015-10-20 21:19:39 -07: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 Refactor out abusive traces into different test file 2015-09-06 22:57:51 -07:00
COPYING Upgrade to GPLv3 "or later" and update copyrights 2015-10-22 21:09:13 -07:00
Makefile.am Add function-call time tracing for Linux/Android 2015-10-04 14:22:26 -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 2015-10-28 00:04:03 -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 emulator implemented primarily in C with x86, x86-64, and ARM assembly language for the 65c02 CPU emulation module. In addition you will find a smattering of interface code in Objective-C/Cocoa, Java/Android, and GLSL.

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 November 2015, the resurrected Apple2ix runs on x64 MacOSX 10.9+, x64 Debian GNU/Linux, and ARM Android

Project Goals

  • Portability and code resilience across a wide range of modern platforms including MacOSX, desktop Linux/BSD, iOS, Android -- But not Windows, just use the excellent AppleWin emulator if you're on Windows!
  • Reasonable emulation fidelity to the original Apple //e machine (timing, video, audio, etc...)
  • Language minimalism for core emulation modules (prefer coding in POSIX C over all else), except for CPU module which should be in assembly
  • Good platform citizenship for menu system (prefer coding in language-of-choice promoted by platform--e.g.: Objective-C/Swift on Darwin, Java on Android, ...)

Android

Available on Google Play.

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

Running at 60FPS on Nexus 6 running Lollipop (Android 5.1.1): Apple2ix on Nexus 6

Mac Package

Apple2Mac

A binary package for Macintosh is available at deadc0de.org
Size : 10240000 (10MB)
SHASUM : 81f2d55c2daaa0d3f9b33af9b50f69f6789738bf

Alt Size : 76820480 (75MB)
ALTSUM : 488a40d7f1187bcfd16d0045258f606a95f448cb

Linux+ Package

For Linux and *BSD, I do not personally relish being a package/port maintainer, so you should ./configure --prefix=..., make, make install like it's 1999 ;-)

You will need GCC or Clang compiler and other tools as determined by the configure script. Use the source!

Apple //ix

Project Tech

  • C language for the majority of the project (still the most portable/reliable language after all these years ;-)
  • x86 and ARM assembly language for 65c02 CPU tightloop
  • Extensive tests for 65c02 CPU, Apple //e VM, disks, and display (expected framebuffer output)
  • OpenGLES 2.x graphics with 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)

DOS 3.3

Semi-Ordered TODO

  • DHIRES graphics are ugly, fix 'em
  • iOS/iWatch ports
  • Proper VBL timing and vSync matching to the device (if available)
  • OpenGL shaders/tricks for style (various screen artifacts) and functionality (Disk ][ status overlays, etc)
  • Emulator save/restore and image compatibility with AppleWin
  • Other feature parity with AppleWin
  • Improved debugger routines (CLI/curses debugger?)
  • CPU module variants as-needed in aarch64, plain C, Clang IR, ...
  • Emscripten/web frontend?