https://github.com/jaromaz/dinospi
Apple-1, Apple ][, Apple ][+, Apple //e, Altair and IMSAI computers emulators for Raspberry Pi
https://github.com/jaromaz/dinospi
altair altair-8800 apple apple-1 apple2 applesoft basic commodore cpm cpm22 emulation emulator imsai imsai-8080 raspberry-pi raspberry-pi-3 raspberry-pi-4 raspberry-pi-zero raspberrypi
Last synced: 4 months ago
JSON representation
Apple-1, Apple ][, Apple ][+, Apple //e, Altair and IMSAI computers emulators for Raspberry Pi
- Host: GitHub
- URL: https://github.com/jaromaz/dinospi
- Owner: jaromaz
- License: gpl-2.0
- Created: 2023-07-23T19:34:44.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2023-07-23T20:55:19.000Z (almost 2 years ago)
- Last Synced: 2025-01-31T14:21:51.688Z (5 months ago)
- Topics: altair, altair-8800, apple, apple-1, apple2, applesoft, basic, commodore, cpm, cpm22, emulation, emulator, imsai, imsai-8080, raspberry-pi, raspberry-pi-3, raspberry-pi-4, raspberry-pi-zero, raspberrypi
- Language: Shell
- Homepage: https://jm.iq.pl
- Size: 1.85 MB
- Stars: 9
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# DinosPi
## Altair, IMSAI, Apple-1 and Apple \]\[ emulators for Raspberry Pi
This project consists of the following auto-compiling and installing bash scripts for Raspberry Pi:
* Apple-1 computer emulator **[pom1](http://pom1.sourceforge.net)**.
* Apple \]\[ computer emulator **[linapple](https://linapple.sourceforge.net/screenshots.html)** supporting Apple \]\[, Apple \]\[+ , Apple //e, and enhanced Apple //e computers.
* CP/M emulator
* Altair/IMSAI emulator **[z80pack](https://www.autometer.de/unix4fun/z80pack/)** supporting Altair 8800 system with 8080 or Z80 CPU, IMSAI 8080 system with 8080 or Z80 CPU, generic Z80/8080 CPU emulation, emulation of a complete system for running CP/M 1, CP/M 2, CPM 3 and MP/M 2.
* **[Information](dual-boot/README.md)** how to run *Raspberry Pi OS* in **dual-boot** with **[BMC64](https://accentual.com/bmc64/)**, the fastest *Commodore* emulator for *Raspberry Pi* (bare metal/low latency emulator).
Apple-1, Apple \]\[ and CP/M emulators can be run in CLI as well as in graphical mode:
Emulators can be installed on the latest version of Raspberry Pi OS Lite. The Altair-IMSAI part requires the full version of Raspberry Pi OS (but compilation is possible in the Lite version and then you can use CLI CP/M emulator).
This project runs on Raspberry Pi Zero, Zero W, Zero 2 W, 2, 2B, 3, 3B, 3B+, 4, 400. Combined with a Raspberry Pi zero, 4GB SD Card and Raspberry Pi OS Lite, this is probably the cheapest option for emulating an Apple \]\[ computer (is a great tool for learning Applesoft BASIC). However, I strongly recommend the Raspberry Pi Zero 2W as a minimum.
## Installation
This part of project can be installed on a latest *Raspberry Pi OS Lite/Full (32-bit)*.
*Raspberry Pi OS Lite (32-bit)* for 4GB SD card, can be installed from the *Raspberry Pi Imager* level by selecting: *Raspberry Pi OS (other) -> Raspberry Pi OS Lite (32-bit) -> CHOOSE STORAGE -> WRITE*.
*Raspberry Pi OS (32-bit)* for 8GB SD card, can be installed from the *Raspberry Pi Imager* level by selecting: *Raspberry Pi OS (32-bit) -> CHOOSE STORAGE -> WRITE*.
To activate the OpenGL drivers you need to run raspi-config from a terminal window.
Enter the comand: ```sudo raspi-config```
Select *Advance Options* -> *GL Driver*
You can now choose between
* Legacy - non-GL driver
* GL (Fake KMS) Desktop driver
* GL (Full KMS) Desktop driver
KMS refers to Kernel Mode-Setting, which should make the driver more efficient with better error handling. The Legacy option will revert the Raspberry Pi's back to the standard graphics driver mode.
Select *GL (Full KMS) Desktop driver* and then OK, second OK and *Finish and Reboot*.
Then You can clone and compile this repository with retro-computers emulators:
```
git clone https://github.com/jaromaz/DinosPi
cd DinosPi
./build_all.sh
```
Each of these sub-projects can be installed separately by running the corresponding compilation & installation script contained in the directory relevant to the sub-project concerned.
The process of compiling and installing packages can take a few tens of minutes.
## Start up
After installation the following commands run individual machines:
* ```apple1``` - Apple-1 emulator
* ```apple2``` - Apple ][ emulator
* ```cpm``` - CP/M emulator
* ```altair``` - Altair 8800 CP/M emulator (Xorg)
* ```imsai``` - IMSAI 8080 CP/M emulator (Xorg)
* ```imsaibasic``` - IMSAI 8080 Basic emulator (Xorg)
All emulators are pre-configured and have default images attached.
## Options
### Apple-1
pom1 has many options to configure and utilize the emulator. They are
accessed by Ctrl+\.
| Shortcut | Function |
| -------- | --------------------------------------------- |
| Ctrl+F | Switch to fullscreen or window. |
| Ctrl+L | Load memory from a binary or ascii file. |
| Ctrl+S | Save memory to a binary or ascii file. |
| Ctrl+Q | Quit the emulator. |
| Ctrl+R | Soft reset the emulator. |
| Ctrl+H | Hard reset the emulator. |
| Ctrl+P | Set the pixel size (1 or 2). |
| Ctrl+N | Turn scanlines on or off (pixel size 2 only). |
| Ctrl+T | Set the terminal speed (Range: 1 - 120). |
| Ctrl+B | Set the cursor to blink or not. |
| Ctrl+C | Set the cursor to block or @. |
### Apple ][
The window size can be defined in the ```/usr/share/dinospi/linapple/linapple.conf``` configuration file in the ```Screen factor``` variable.
Clicking in the LinApple window will capture the mouse. It may be
released by pressing any function key.
| Key/shortcut | Function |
| -------------- | ---------------------------------------------------------------- |
| F1 | Show help screen. |
| F6 | Toggle fullscreen mode. |
| Ctrl+F2 | Cold reboot, i.e. power off and back on. |
| Ctrl+F10 | Hot Reset (Control+Reset) |
| F12 | Quit. |
| F3 | Load disk image to slot 6 drive 1. |
| Alt+F3 | Load disk image to slot 6 drive 1 from FTP server. |
| Shift+F3 | Attach hard disk image to slot 7 drive 1. |
| Alt+Shift+F3 | Attach hard disk image to slot 7 from FTP server. |
| Ctrl+F3 | Eject disk image to slot 6 drive 1. |
| Ctrl+Shift+F3 | Eject hard disk image to slot 7 drive 1. |
| F8 | Save screenshot as a bitmap. |
| F9 | Cycle through video modes. |
| Pause | Pause/resume emulation. |
| Scroll Lock | Toggle full speed emulation. |
| Numpad + | Increase emulation speed. |
| Numpad - | Decrease emulation speed. |
| Numpad * | Reset emulation speed. |
Many disk images will boot straight into the application. Some disk
images only have files and you must find the correct application to
run. In this case you will need to execute BASIC commands to list the
files on the disk and run programs.
### Altair & IMSAI
Launching Altair or IMSAI machines first select ON and then RUN. Running IMSAI, you can switch to 3D model of this computer and open the presentation of peripherals through the site: http://localhost:8080 (1GB RAM required).