Skip to content

Commit

Permalink
Updated readme
Browse files Browse the repository at this point in the history
  • Loading branch information
stefan-b-jakobsson committed Dec 12, 2020
1 parent 16d44d6 commit 0ebeaa1
Showing 1 changed file with 1 addition and 25 deletions.
26 changes: 1 addition & 25 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,31 +41,7 @@ Loading and saving files in X16 Edit require that the emulator is started with a

There are a few more steps to set up and try the ROM version.

The ROM version build script generates a 16KB image to be stored in one of the ROM banks. To get a working system, you need to append this image to the ROM image distributed with
the emulator ("rom.bin"). This may be done with the following command (Linux/MacOS):

cat rom.bin x16edit-rom.bin > customrom.bin

On starting the emulator you need to specify the custom rom image as follows:

x16emu -rom customrom.bin -sdcard sdcard.img

To start the ROM version of the editor you need to type in a small startup routine in the built-in monitor, for example:

.A1000 LDA $9F60
.A1003 PHA
.A1004 LDA #$07
.A1006 STA $9F60
.A1009 LDX #$01
.A100B LDY #$FF
.A100D JSR $C000
.A1010 PLA
.A1011 STA $9F60
.A1014 RTS

To run this from BASIC, symply type SYS $1000.

A short explanation of the startup program. $9F60 is the ROM select. The original value is first stored on the stack, and then we switch to ROM bank 7 where X16Edit is stored. The ROM version of the editor requires that the first and last RAM bank used by the program are specified (X=first bank and Y=last bank). Thereafter it calls the subroutine at $C000, which is the start of ROM and the entry point of the editor. When exiting from the editor the initial ROM bank is read from the stack stored in the ROM select.
Please see the supplemented file docs/romnotes.pdf for details.


# X16 Community
Expand Down

0 comments on commit 0ebeaa1

Please sign in to comment.