6502/PLASMA
1
0 Fork 0
mirror of https://github.com/dschmenk/PLASMA.git synced 2026-04-27 03:18:02 +00:00
Code Issues Projects Releases Wiki Activity

Updated Installation Guide (markdown)

David Schmenk committed 2020-01-10 18:22:04 -08:00
1 parent 3751afccb1
commit 09388c65e0
1 file changed
+51 -7
Download Patch File Download Diff File Expand all files Collapse all files
Installation-Guide.md
+51 -7
@@ -4,27 +4,71 @@ PLASMA is the Grand Unifying Environment for many 6502 platforms. Each platform
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 - Build tools for PLASMA development
/HARDDISK/BLD/INC - Source include files for system modules
/HARDDISK/BLD/SAMPLES - Source files for sample programs
/HARDDISK/DEMOS - Demo modules
/HARDDISK/DEMOS/ROGUE - Unique Rogue-like game using visibility algorithms
/HARDDISK/DEMOS/SPIDERS - Hi-Res shooter-up arcade game
/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
PLASMA2-SYS.PO -> /HARDDISK - System modules
PLASMA2-FPSOS.PO -> /HARDDISK - Floating point and Apple /// system modules
PLASMA2-BLD.PO -> /HARDDISK/BLD - Source files and build tools
PLASMA2-DEM.PO -> /HARDDISK/DEMOS - Demo modules
PLASMA2-INET.PO -> /HARDDISK/SYS - TCP/IP modules, drivers and utilities
```
## 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:
The Apple /// can only boot from a floppy disk. The `PLASMA2-FPSOS.PO` image has the `SOS.INTERP` & `SOS.CMD` files for a non-JIT VM, freeing up 4K of global memory and 'SOS.INTERPJIT' and 'SOS.CMDJIT' files for a JIT enabled environment (when renamed to the standard names). One set of those files are needed to boot PLASMA on the Apple ///. These should be copied to a bootable SOS floppy to boot the Apple ///. Once booted, replace the PLASMA2-SYS floppy in the drive and enter:
```
S /PLASMA.SYS
```
to set the system directory to the PLASMA SYStem floppy. Now you can copy the files to your hard disk, named ```'/HARDDISK'``` in this example. To copy the baseline system modules:
```
+COPY -R SYS /HARDDISK
```
To copy the Apple /// specific system modules and floating point modules:
```
+COPY -R * /HARDISK
```
For the build environment and demos, you first need to create their respective directories:
```
+NEWDIR /HARDDISK/BLD
+NEWDIR /HARDDISK/DEMOS
```
Insert the PLASMA2-BLD floppy and type:
```
+COPY -R * /HARDDISK/BLD
```
After the copying is done, insert the PLASMA2-DEM floppy in the drive and type:
```
+COPY -R * /HARDDISK/DEMOS
```
To create the boot floppy, choose a JIT enabled environment or a non-JIT environment that frees up 4K of global memory. Copy ```'/HARDDISK/SOS.INTERP'``` and ```'/HARDDISK/SOS.CMD'``` to the boot floppy for a non-JIT environment:
```
+COPY /HARDISK/SOS.INTERP /BOOTFLOPPY
+COPY /HARDISK/SOS.CMD /BOOTFLOPPY
```
For a JIT enabled environment, use:
```
+COPY /HARDDISK/SOS.INTERPJIT /BOOTFLOPPY/SOS.INTERP
+COPY /HARDDISK/SOS.CMDJIT /BOOTFLOPPY
```
To automatically boot and set the system directory to the ```'/HARDISK'```, create an ```'AUTORUN'``` file on the boot floppy with:
```
+ED /BOOTFLOPPY/AUTORUN
```
and enter this into the text file:
```
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.
Save it and quite be pressing the ```ESC``` key, then ```W <RETURN>``` and ```Q <RETURN>```.