Apple-2-HW/Apple2-IO-RPi
2
0
Fork 1
mirror of https://github.com/tjboldt/Apple2-IO-RPi.git synced 2024-12-17 14:30:17 +00:00
Code Issues Projects Releases Wiki Activity
Apple II expansion card using a Raspberry Pi for I/O
298 Commits 1 Branch 6 Tags 26 MiB
Go 44.8%
Assembly 24.2%
Shell 11.8%
C 6.1%
Batchfile 5.2%
Other 7.8%
53377e2dc0
Go to file
Terence Boldt 53377e2dc0 Add bill of materials
2023-03-08 09:26:35 -05:00
.cicd Add ld65 config 2021-10-31 14:35:55 -04:00
.github Add live drive regeneration and loading (#122) 2023-01-25 22:32:47 -05:00
Apple2 Fix hang after shell exit (#131) 2023-01-30 20:45:24 -05:00
Hardware Add bill of materials 2023-03-08 09:26:35 -05:00
RaspberryPi Update library for security fix (#135) 2023-03-01 05:33:15 -07:00
.gitignore Ignore KiCAD backups 2022-02-18 10:03:49 +01:00
CODE_OF_CONDUCT.md Fix Codacy lint/security warnings 2021-11-03 05:33:09 -04:00
CONTRIBUTING.md Fix Codacy lint/security warnings 2021-11-03 05:33:09 -04:00
LICENSE Add graphics conversion 2023-01-14 10:51:39 -05:00
README.md Update README.md 2023-01-28 10:23:27 -05:00
SECURITY.md Update version numbers 2022-03-01 22:46:03 -05:00

README.md

Apple2-IO-RPi

Apple II expansion card using a Raspberry Pi for I/O

Image of Board

Purpose

The purpose of this project is to provide I/O for an Apple II series 8 bit computer via a Raspberry Pi Zero W which is powered by the Apple II expansion bus. This includes using the attached RPi Zero W for it's storage, network and processor to provide new functionality for the Apple II.

Features

  1. Boot message which waits for RPi to be ready
  2. ProDOS bootable drive from image stored on RPi
  3. Linux bash shell to the RPi from the Apple II including some VT100 support via -SHELL from ProDOS
  4. Load binary files directly from the RPi to the II (via dynamic virtual drive of current working directory on the RPi)
  5. Update Apple II firmware in place from image on RPi (note, this is done per slot)
  6. Supports two drive images at the same time
  7. Supports "RPI" command from BASIC to execute Linux commands from the command prompt or inside BASIC programs: 10 PRINT CHR$(4);"RPI ls -al /"

Project Status

So far, this is still a project and not a finished product. The current prototype is on the sixth revision. I have sold about 60 boards including previous prototypes. There are more than 100 in the wild between self made and ones purchased in places like eBay that were made by others. The sixth prototype is functionally equivalent to the fifth, other than a new jumper to select internal/external power.

The card enables the Apple II to boot from and write to virtual hard drive images stored on the RPi in any slot (except slot 3), execute Linux commands from Applesoft BASIC and run a bash shell with VT100 emulation. The code has very few tests and is incomplete. Note that currently the firmware assumes an 80 column card is in slot 3 and than you have lowercase support. Most development has been done with an enhanced Apple //e with the card in slot 7. If you have other drive controllers earlier in the boot cycle, you can still boot from the Apple2-IO-RPi. For example, if the card was in slot 4, you could type PR#4 from the BASIC prompt to boot the card. Note that the Raspberry Pi Zero W (and W 2) consume 170 - 250 mA and there is only 500 mA available to all expansion slots according to Apple. It is not recommended to have a lot of other cards in the system at the same time. With the sixth revision of the prototype, it is possible to remove the power jumper and run the RPi on an external USB power source. If configured for external power, note that the card's firmware will hang on boot without USB power on as the latch chips are powered by the 3.3V output of the RPi.

If you have a problem or idea for enhancement, log an issue here or start a discussion. I recommend starring/watching the project for updates on GitHub. You are welcome to fork the project and submit pull requests which I will review. The latest version has an in-memory virtual drive representing current working directory in Linux for ease of copying files between Linux and ProDOS when the drive 1 is not specified as a file.

Roadmap

See List of issues tagged roadmap

Setup

Setup card from scratch

Setup if you received a complete board from me

Update to latest

Contributions/Thanks

  • Hans Hübner (@hanshuebner) for help cleaning up schematics
  • Scott (@figital) for assembling early prototypes and recommending the AT28C64B chip
  • Brokencodez for help with 3.3V conversion
  • David Schmenk (@dschmenk) for creating his Apple2Pi project, proving that Raspberry Pi can be powered by the Apple II expansion bus
  • Wyatt Wong (@wyatt-wong) for testing with multiple cards
  • (@Abysmal) for shell and rpi.command testing
  • (@bfranske) for suggesting adding the 5V jumper
  • Tim Boldt (@timboldt) for recommending removing sysfs based GPIO code

Similar Project

If you prefer having Apple II peripherals control a Raspberry Pi rather than simply using the Raspberry Pi to provide storage, network access and processing to the Apple II, have a look at David Schmenk's excellent Apple2Pi project. I am often asked about differences between these two projects. They are similar in some ways but essentially opposite. The Apple2Pi is meant for the primary machine to be the RPi, using the Apple II for it's peripherals. The Apple2-IO-RPi is meant to have the Apple II as the primary machine and just use the RPi for its processing, storage and network.