6502/VolksForth
1
0
Fork 0
mirror of https://github.com/forth-ev/VolksForth.git synced 2024-11-22 20:34:07 +00:00
Code Issues Projects Releases Wiki Activity
6870cc1383
VolksForth/AtariST/README.ORG
Carsten Strotmann 5f2eecc2ba Atari ST: Documentation: building new kernel
2020-07-22 00:50:20 +02:00

2.5 KiB
Raw Blame History

VolksForth Atari ST Notes

How to re-compile the Atari ST VolksForth kernel

Requirements:

  • Atari ST computer (or an emulator such as Hatari) running VolksForth
  • Floppy Disk (for a real computer) or a Disk-Image (for the Emulator)

Files:

  • FORTH83.FB- The VolksForth Kernel source
  • ASSEMBLE.FB- M68000 Forth Assembler
  • TARGET.FB- VolksForth Target Compiler
  • PATCH.FB- The Patch Tool to patch the kernel and load the Fileinterface
  • FILEINT.FB - The File-Interface
  • C.FB - Target Compile "script"

Step 1: Compiling a new kernel

  • make your changes to the VolksForth kernel (FORTH83.FB)
  • start a fresh copy of VolksForth (File 4TH.PRG)
  • enter: include c.fb. This will compile the kernel. It will load the files ASSEMBLE.FB, TARGET.FB and FORTH83.FB and will write the generated new kernel as 4THIMG.PRG. This new Forth image is very very basic, it does not contain the file interface and can only load source for blocks (sector I/O) from the floppy disks A: or B:
  • exit the VolksForth (BYE)

Step 2: adding the file interface to the new Kernel

  • format a new floppy (360 KB or 720 KB floppy, HD floppies will not work) in drive A:
  • copy the following files exactly in this order. The order is important, as the new VolksForth kernel need to find the source code at the correct block/sector locations!: PATCH.FB, ASSEMBLE.FB and FILEINT.FB. PATCH.FB must be in Block 1, ASSEMBLE.FB must start at Block 6 and FILEINT.FB must start at Block 24 ($18).
  • execute the new VolksForth kernel (4THIMG.PRG).
  • select drive A: 0 drive
  • test that PATCH.FB is in Block 1: 1 list should show the PATCH.FB load screen
  • test that ASSEMBLE.FB is in Block 6: 6 list should show the ASSEMBLE.FB load screen
  • test that FILEINT.FB is in Block 24: 24 list should show the FILEINT.FB load screen
  • load the patch tool: 1 load
  • save the new VolksForth Image to disk: save-system 4THCORE.PRG. 4THCORE.PRG is now the kernel plus the file interface. This is a minimal but useable Forth system

Step 3: build a full VolksForth system

  • edit the file STARTUP.FB, add or remove features you want to have in your VolksForth system
  • start 4THCORE.PRG created in step 2
  • load STARTUP.FB: include startup.fb
  • save the new image under a new name (be careful not to overwrite your original VOLKS4TH.PRG, make a backup first!): save-system myforth.prg
  • your new VolksForth system is now ready!

Have fun.