apple2pi/README.md

43 lines
1.4 KiB
Markdown
Raw Normal View History

2022-08-25 23:30:36 +00:00
# Apple II Pi
2013-05-24 01:22:02 +00:00
2024-01-04 20:26:03 +00:00
1. See the [upstream repo](https://github.com/dschmenk/apple2pi) for the original, full info.
2. This fork is based on [A2Pico](https://github.com/oliverschmidt/a2pico).
2013-10-21 20:27:35 +00:00
2022-08-25 23:30:36 +00:00
## Installing
2013-05-24 16:19:55 +00:00
2024-02-20 18:24:07 +00:00
1. Flash [Apple-II-Pi.uf2](https://github.com/oliverschmidt/apple2pi/releases/latest/download/Apple-II-Pi.uf2) to the A2Pico.
2013-05-24 16:19:55 +00:00
2024-02-20 18:30:13 +00:00
2. Connect the [Raspberry Pi Zero 2 W](https://www.raspberrypi.com/products/raspberry-pi-zero-2-w/) to the A2Pico via a USB OTG cable.
2013-05-24 16:19:55 +00:00
2024-02-20 18:24:07 +00:00
3. Activate the USB Power on the A2Pico.
4. Connect the HMDI monitor to the Raspberry Pi Zero 2 W:
![Setup](https://github.com/oliverschmidt/apple2pi/assets/2664009/ac5e954a-3c80-4ab0-974b-b3e2394cd747)
5. Install [Raspberry Pi OS](https://www.raspberrypi.org/software/).
6. Execute
2022-08-25 23:30:36 +00:00
```
2022-08-29 11:59:39 +00:00
sudo apt install git libfuse-dev -y
git clone https://github.com/oliverschmidt/apple2pi.git
2022-08-25 23:30:36 +00:00
cd apple2pi
make
sudo make install
```
2013-09-11 20:31:12 +00:00
2024-02-20 18:24:07 +00:00
7. Execute `sudo systemctl start a2pi.service` to run the Apple II Pi Daemon right away.
2013-09-11 20:31:12 +00:00
2022-08-25 23:30:36 +00:00
## Using
2013-09-11 20:31:12 +00:00
2022-08-25 23:30:36 +00:00
1. Start Apple II Pi either via cold boot or `PR#n`.
2013-05-27 22:27:40 +00:00
2022-08-25 23:30:36 +00:00
2. Make sure to check out `a2term` in a Raspberry Pi shell.
2013-05-27 22:27:40 +00:00
2022-08-25 23:30:36 +00:00
## Building
2013-05-27 22:27:40 +00:00
2024-01-04 20:17:19 +00:00
1. Build the project in `/pipico` (requires the [Raspberry Pico C/C++ SDK](https://www.raspberrypi.com/documentation/microcontrollers/c_sdk.html)).
2013-05-27 22:27:40 +00:00
2024-01-04 20:17:19 +00:00
2. Execute `make` in `/src` (requires [libfuse-dev](https://packages.debian.org/en/sid/libfuse-dev)).