6502
/
symon
mirror of https://github.com/sethm/symon.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Clarify how to load ROMs in README files

This commit is contained in:
Seth Morabito 2023-07-23 10:12:16 -07:00
parent 4a8a803472
commit 5a25750f46
3 changed files with 13 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
.gitignore vendored
View File

@ -1,4 +1,5 @@
*~ *~
*.jar
*# *#
target target
.DS_Store .DS_Store

7
README.md
View File

@ -227,10 +227,9 @@ properly. Without a ROM in memory, the simulator will not be able to
reset, since the reset vector for the 6502 is located in the ROM reset, since the reset vector for the 6502 is located in the ROM
address space. address space.
By default, any file named `rom.bin` that exists in the same directory ROM images can be loaded with the `-rom` argument when running
where Symon is launched will be loaded as a ROM image. ROM images can Symon from the command line. ROM images can also be swapped out at
also be swapped out at run-time with the "Load ROM Image..." in the run-time with the "Load ROM..." item in the File menu.
File menu.
The "samples" directory contains a ROM image for the Symon The "samples" directory contains a ROM image for the Symon
architecture named 'ehbasic.rom', containing Lee Davison's Enhanced architecture named 'ehbasic.rom', containing Lee Davison's Enhanced

17
samples/README
View File

@ -11,7 +11,6 @@ Sample Programs
When loaded at address $0300, this program will echo back to the console When loaded at address $0300, this program will echo back to the console
anything typed. anything typed.
Both hello.prg and echo_poll.prg were assembled with the Ophis assembler: Both hello.prg and echo_poll.prg were assembled with the Ophis assembler:
https://hkn.eecs.berkeley.edu/~mcmartin/ophis/ https://hkn.eecs.berkeley.edu/~mcmartin/ophis/
@ -19,23 +18,25 @@ Both hello.prg and echo_poll.prg were assembled with the Ophis assembler:
3. echo_irq.rom 3. echo_irq.rom
This is another echo program, and behaves identically to echo_poll.prg, This is another echo program, and behaves identically to echo_poll.prg,
except it is interrupt-driven. except it is interrupt-driven. This ROM can be loaded either through the
"File->Load ROM..." menu in Symon, or by specifying the path to
"echo_irq.rom" with the "-jar" command line option when running Symon,
for example: `java -jar symon-1.3.2.jar -rom samples/echo_irq.rom`
4. ehbasic.rom 4. ehbasic.rom
This is Lee Davison's Enhanced 6502 BASIC. This is Lee Davison's Enhanced 6502 BASIC.
To use this ROM image, just copy the file 'ehbasic.rom' into the directory The EhBASIC ROM can be loaded either through the "File -> Load ROM..."
where you run Symon. Rename the file to 'rom.bin'. When you start Symon, menu in Symon, or by specifying the path to "ehbasic.rom" with
the ROM file will be automatically loaded at address $d000. the "-jar" command line option when running Symon, for example:
`java -jar symon-1.3.2.jar -rom samples/ehbasic.rom`
Click the "Run" button and EhBASIC should automatically start running. Click the "Run" button and EhBASIC should automatically start running.
Type 'C' to do a cold start. Type 'C' to do a cold start.
Then, type $C000 when prompted for the memory size. Then, type '49152' (without the quotes) when prompted for the memory size.
NOTE: EhBASIC only wants upper-case input. This confused me at first!
More information can be found in the 'ehbasic' directory, and by visiting More information can be found in the 'ehbasic' directory, and by visiting
the EhBASIC web page: the EhBASIC web page: