| Both sides previous revision Previous revision Next revision | Previous revision |
| systems:apple2 [2022/10/10 06:04] – add new information for newer versions of batocera, removal of linapple atari | systems:apple2 [2025/10/14 16:26] (current) – [Controls] wizzard |
|---|
| <WRAP round box twothirds column> | <WRAP round box twothirds column> |
| {{ https://raw.githubusercontent.com/fabricecaruso/es-theme-carbon/master/art/logos/apple2.svg?nolink&360 }} | {{ https://raw.githubusercontent.com/fabricecaruso/es-theme-carbon/master/art/logos/apple2.svg?nolink&360 }} |
| {{ https://raw.githubusercontent.com/fabricecaruso/es-theme-carbon/master/art/logos/apple2gs.svg?nolink&400 }} | |
| |
| ====== Apple ][ line ====== | ====== Apple ][ line ====== |
| |
| The Apple ][ is a family of 8-bit computers developed by Apple (primarily [[wp>Steve_Wozniak|Steve Wozniak]]) dating back to 1977. The most recent model is the Apple IIc Plus, which was discontinued on November 1993. | The Apple ][ is a family of 8-bit computers developed by Apple (primarily [[wp>Steve_Wozniak|Steve Wozniak]]) dating back to 1977. The most recent model is the Apple IIc Plus, which was discontinued on November 1993. |
| |
| * **%%Apple //e%%** Even more RAM (64KB), a full ASCII keyboard and better display modes. | * **%%Apple //e%%** Even more RAM (64KB), a full ASCII keyboard and better display modes. |
| * **Apple IIc** The first CPU upgrade, opting to use a 65C02 CPU at 1.023 MHz and 128KB of RAM. | * **Apple IIc** The first CPU upgrade, opting to use a 65C02 CPU at 1.023 MHz and 128KB of RAM. |
| * **Apple IIGS** Has [[#apple_iigs|its own section]] in this article. | * **Apple IIGS** Has [[systems:apple2gs|its own page]] in this wiki. |
| * **%%Apple //e Enhanced%%** The Apple %%//e%% but with the 65C02 CPU. | * **%%Apple //e Enhanced%%** The Apple %%//e%% but with the 65C02 CPU. |
| * **%%Apple //e Platinum%%** The Apple %%//e%% Enhanced with extra RAM (128KB). | * **%%Apple //e Platinum%%** The Apple %%//e%% Enhanced with extra RAM (128KB). |
| {{ https://raw.githubusercontent.com/fabricecaruso/es-theme-carbon/master/art/consoles/apple2.png?nolink&350 |The Apple II.}} | {{ https://raw.githubusercontent.com/fabricecaruso/es-theme-carbon/master/art/consoles/apple2.png?nolink&350 |The Apple II.}} |
| {{ https://raw.githubusercontent.com/fabricecaruso/es-theme-carbon/master/art/consoles/apple2e.png?nolink&350 |The Apple IIe.}} | {{ https://raw.githubusercontent.com/fabricecaruso/es-theme-carbon/master/art/consoles/apple2e.png?nolink&350 |The Apple IIe.}} |
| {{ https://raw.githubusercontent.com/fabricecaruso/es-theme-carbon/master/art/consoles/apple2gs.png?nolink&350 |The Apple IIGS.}} | |
| </WRAP> | </WRAP> |
| </WRAP> | </WRAP> |
| |
| ==== Quick reference ==== | ==== Quick reference ==== |
| |
| * **Accepted ROM formats:** ''.nib'', ''.do'', ''.po'', ''.dsk'', ''.mfi'', ''.dfi'', ''.rti'', ''.edd'', ''.woz'', ''.wav'', ''.zip'', ''.7z'' | * **Accepted ROM formats:** ''.nib'', ''.do'', ''.po'', ''.dsk'', ''.mfi'', ''.dfi'', ''.rti'', ''.edd'', ''.woz'', ''.wav'', ''.zip'', ''.7z'' |
| * **Folder:** ''/userdata/roms/apple2'' | * **Folder:** ''/userdata/roms/apple2'' |
| | [[#mame|MAME]] | ''.nib'', ''.do'', ''.po'', ''.dsk'', ''.mfi'', ''.dfi'', ''.rti'', ''.edd'', ''.woz'', ''.wav'', ''.zip'', ''.7z'' | | | [[#mame|MAME]] | ''.nib'', ''.do'', ''.po'', ''.dsk'', ''.mfi'', ''.dfi'', ''.rti'', ''.edd'', ''.woz'', ''.wav'', ''.zip'', ''.7z'' | |
| | [[#gsplus|GSplus]] | ''.nib'', ''.do'', ''.po'', ''.dsk'' | | | [[#gsplus|GSplus]] | ''.nib'', ''.do'', ''.po'', ''.dsk'' | |
| | [[#linapple|LinApple]] | ''.nib'', ''.do'', ''.po'', ''.dsk'', ''.2mg'' | | |
| |
| ===== BIOS ===== | ===== BIOS ===== |
| |
| ^ MD5 checksum ^ Share file path ^ Description ^ | ^ MD5 checksum ^ Share file path ^ Description ^ |
| | ''4431aea380185e3f509285540d7cb418'' | ''bios/apple2e.zip'' | | | | ''4431aea380185e3f509285540d7cb418'' | ''bios/apple2e.zip'' | | |
| |
| ===== ROMs ===== | ===== ROMs ===== |
| |
| Place your Apple ][ ROMs in ''/userdata/roms/apple2''. | Place your Apple ][ ROMs in ''/userdata/roms/apple2''. |
| |
| Place your Apple IIGS ROMs in ''/userdata/roms/apple2gs''. | |
| |
| ''.2mg'' ROMs will only be recognized in the ''apple2gs'' folder. | |
| |
| ===== Emulators ===== | ===== Emulators ===== |
| |
| ==== RetroArch ==== | ==== RetroArch ==== |
| |
| RetroArch has [[emulators:retroarch|its own page]]. | RetroArch has [[emulators:retroarch|its own page]]. |
| |
| |
| === libretro: mame === | === libretro: mame === |
| |
| == libretro: mame configuration == | == libretro: mame configuration == |
| |
| Standardized features for this core: ''apple2.autosave'', ''apple2.netplay'' | Standardized features for this core: ''apple2.autosave'', ''apple2.netplay'' |
| |
| |
| ==== MAME ==== | ==== MAME ==== |
| |
| [[https://www.mamedev.org/|MAME]], the Multiple Arcade Machine Emulator, is a multi-purpose emulation framework which facilitates the emulation of vintage hardware and software. Originally targeting vintage arcade machines, MAME has since absorbed the sister-project [[http://mess.redump.net/start|MESS]] (Multi Emulator Super System) to support a wide variety of vintage computers, video game consoles and calculators as well. MAME doesn't use an individual "core" for each system like RetroArch does, instead the ROM itself usually contains the necessary information to accurately emulate it, thus making it specific to the version of MAME it was made for. Overall it's a very complicated subject, we have a [[:arcade|guide specific to arcade]] just for it. | [[https://www.mamedev.org/|MAME]], the Multiple Arcade Machine Emulator, is a multi-purpose emulation framework which facilitates the emulation of vintage hardware and software. Originally targeting vintage arcade machines, MAME has since absorbed the sister-project [[http://mess.redump.net/start|MESS]] (Multi Emulator Super System) to support a wide variety of vintage computers, video game consoles and calculators as well. MAME doesn't use an individual "core" for each system like RetroArch does, instead the ROM itself usually contains the necessary information to accurately emulate it, thus making it specific to the version of MAME it was made for. Overall it's a very complicated subject, we have a [[:arcade|guide specific to arcade]] just for it. |
| |
| === MAME configuration === | === MAME configuration === |
| |
| MAME offers a **[[https://docs.mamedev.org/usingmame/ui.html|Menu]]** in-game (''[HOTKEY]'' + {{:wiki:south.png?nolink&20|South button (B SNES)}} or ''[Tab]'' on the keyboard). This can be used to manually adjust inputs or game settings. If you're having issues with a specific game, check the [[https://wiki.mamedev.org/index.php/FAQ:Games|MAMEdev FAQ for that game here.]] For MESS systems specifically, you might find more information on [[http://mess.redump.net/start|MESS's wiki]]. All options can also be edited by opening the ''mame.ini'' file. | MAME offers a **[[https://docs.mamedev.org/usingmame/ui.html|Menu]]** in-game (''[HOTKEY]'' + {{:wiki:south.png?nolink&20|South button (B SNES)}} or ''[Tab]'' on the keyboard). This can be used to manually adjust inputs or game settings. If you're having issues with a specific game, check the [[https://wiki.mamedev.org/index.php/FAQ:Games|MAMEdev FAQ for that game here.]] For MESS systems specifically, you might find more information on [[http://mess.redump.net/start|MESS's wiki]]. All options can also be edited by opening the ''mame.ini'' file. |
| |
| |
| ==== GSplus ==== | ==== GSplus ==== |
| |
| [[https://apple2.gs/plus/|GSplus]] is an open source, cross-platform Apple ][/IIGS emulator, based on the KEGS and GSPort emulators. | [[https://apple2.gs/plus/|GSplus]] is an open source, cross-platform Apple ][/IIGS emulator, based on the KEGS and GSPort emulators. |
| |
| |
| === GSplus configuration === | === GSplus configuration === |
| |
| Standardized features available to all cores of this emulator: ''apple2.videomode'', ''apple2.padtokeyboard'', ''apple2.decoration'' | Standardized features available to all cores of this emulator: ''apple2.videomode'', ''apple2.padtokeyboard'', ''apple2.decoration'' |
| |
| ==== LinApple ==== | |
| |
| <WRAP center round alert> | |
| LinApple is no longer available on newer versions of Batocera (FIXME when exactly?) since around **v30**. | |
| </WRAP> | |
| |
| [[http://linapple.sourceforge.net/|LinApple]] is a cross-platform Apple ][%%///e%% emulator. It is probably not capable of running Apple IIGS software. | |
| |
| The Pi port of it has a [[https://github.com/dabonetn/linapple-pie/blob/master/README|readme]]. | |
| |
| === LinApple configuration === | |
| |
| Standardized features available to all cores of this emulator: ''apple2.videomode'', ''apple2.ratio'', ''apple2.padtokeyboard'', ''apple2.decoration'' | |
| |
| ===== Apple IIGS ===== | |
| |
| About halfway through the life of the Apple ][ family line, Apple released the Apple IIGS which was a significant change in hardware to the previous Apple 8-bit computers, using a 16-bit 65C816 microprocessor, 256KB or 1MB of RAM (expandable up to 1MB) and the highest resolution display (up to 640x200) and state-of-the-art sound capabilities with the Ensoniq ES5503 DOC 8-bit wavetable synthesis sound chip. Among all the other computers in the line, the Apple IIGS remained the most performant of the bunch, and for this reason it is usually the "default" system that Apple ][ emulators will use for running its software. | |
| |
| However, the Apple IIGS was only around 95% backwards compatible with software designed for the original Apple ][ computers. | |
| |
| <WRAP center round todo> | |
| How do you change it back to emulating an Apple ][? Or is this limitation not imposed by the emulator (like with Game Boy software)? | |
| </WRAP> | |
| |
| ===== Controls ===== | ===== Controls ===== |
| |
| Here are the default Apple II's controls shown on a [[:configure_a_controller|Batocera RetroPad]]: | Here are the default Apple II's controls shown on a [[:configure_a_controller|Batocera RetroPad]]: |
| |
| {{https://raw.githubusercontent.com/batocera-linux/batocera-controller-overlays/master/solid-4k/apple2.png}} | |
| |
| ===== Troubleshooting ===== | ===== Troubleshooting ===== |
| |
| ==== Further troubleshooting ==== | ==== Further troubleshooting ==== |
| |
| For further troubleshooting, refer to the [[:support|generic support pages]]. | For further troubleshooting, refer to the [[:support|generic support pages]]. |
| |