6502/PLASMA
1
0
Fork 0
mirror of https://github.com/dschmenk/PLASMA.git synced 2025-01-03 04:32:52 +00:00
Code Issues Projects Releases Wiki Activity

Created Installation Guide (markdown)

David Schmenk 2018-07-14 08:44:55 -07:00
parent c4fa55be9b
commit 97a7befecd
1 changed files with 30 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
Installation-Guide.md Normal file

@ -0,0 +1,30 @@
PLASMA is the Grand Unifying Environment for many 6502 platforms. Each platform has its own installation locations, but for the full install, a fixed disk(hard disk/compact flash/SD card) mass storage is required. Floppy disks just don't have enough storage for a satisfying experience.
# Apple II and ///
The directory structure for both machines is identical. Assuming the fixed disk named HARDDISK, the structure would look like:
```
/HARDDISK/SYS - System modules
/HARDDISK/BLD - Source files and build tools for PLASMA development
/HARDDISK/BLD/INC - Source include files for system modules
/HARDDISK/DEMOS - Demo modules
/HARDDISK/DEMOS/ROGUE - Unique Rogue-like game using visibility algorithms
/HARDDISK/DEMOS/MUSIC - Note sequencer demos
/HARDDISK/DEMOS/SDUTILS - Copy files to/from SD card+Ardiuno over gameport.
/HARDDISK/DEMOS/NET - Network programs using ethernet card
```
To install from a standard floppy disk, a file copy utility is required. I've used the System Utilities program on both the II and /// to recursively move the files over. Here is how the floppy images map to fixed disk directories:
```
PLASMA-SYS2.PO -> /HARDDISK - System modules
PLASMA-FPSOS.PO -> /HARDDISK - Floating point and Apple /// system modules
PLASMA-BLD2.PO -> /HARDDISK/BLD - Source files and build tools
PLASMA-DEM2.PO -> /HARDDISK/DEMOS - Demo modules
```
## Apple II 800K image
There is a 800K disk image, `PLASMA.2mg`, that has a full, bootable installation of PLASMA and the EDASM assembler. This makes for a complete development environment. It can be booted as-is, or copied en-mass to fixed disk.
## Apple /// boot floppy
The Apple /// can only boot from a floppy disk. The `PLASMA-FPSOS.PO` image has the `SOS.INTERP` and `SOS.CMD` files needed to boot PLASMA on the Apple ///. These should be copied to a bootable SOS floppy to boot the Apple ///. Once booted, enter:
```
S /HARDDISK
```
to set the system directory for PLASMA. This can be automated by placing the above command into the `AUTORUN` file on the boot floppy.