Adds support for building cartridge binaries.

This adds the linker and support files, but still needs a custom build
library and command line.

Fixes #33

Makefile

@@ -103,6 +103,7 @@ DOS=\
 # ASM files used in the RUNTIME
 RT_AS_SRC=\
     src/standalone.asm\
+    src/cartridge.asm\
 
 # ASM files used in the IDE and Command Line compiler
 COMPILER_AS_SRC=\
@@ -248,6 +249,7 @@ COMPILER_COMMON=\
 	 $(LIB_INT)\
 	 $(LIB_FP)\
 	 build/compiler/fastbasic.cfg\
+	 build/compiler/fastbasic-cart.cfg\
 	 build/compiler/fb$(SHEXT)\
 	 build/compiler/fb-int$(SHEXT)\
 	 build/compiler/USAGE.md\

compiler/fastbasic-cart.cfg

@@ -0,0 +1,57 @@
+#
+# FastBasic - Fast basic interpreter for the Atari 8-bit computers
+# Copyright (C) 2017-2019 Daniel Serpell
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License along
+# with this program.  If not, see <http://www.gnu.org/licenses/>
+#
+
+# Linker configuration file for placing the code in a CARTRIDGE
+# -------------------------------------------------------------
+
+FEATURES {
+    # This defines the start of RAM used for the program
+    STARTADDRESS: default = $2000;
+}
+SYMBOLS {
+    __STARTADDRESS__: type = export, value = %S;
+    __CARTFLAGS__:    type = weak,   value = $05;
+    _FASTBASIC_CART_: type = import;
+}
+
+MEMORY {
+# Interpreter in ZP
+    INTERP:  file = "",               start = $0082, size = $0012;
+# Non initialized ZP
+    ZP:      file = "", define = yes, start = $0094, size = $0040;
+# Main memory - used for writable DATA
+    MAIN:    file = "", define = yes, start = %S,    size = $8000;
+# Cartridge ROM
+    ROM:     file = %O, define = yes, start = $A000, size = $1FFA, fill = yes, fillval = $FF;
+# Cartridge header
+    CARTID:  file = %O,               start = $BFFA, size = 6;
+}
+
+SEGMENTS {
+    ZEROPAGE: load = ZP,                type = zp,  optional = yes;
+    JUMPTAB:  load = ROM,               type = ro,                  define = yes, align = $100;
+    RUNTIME:  load = ROM,               type = ro,                  define = yes;
+    BYTECODE: load = ROM,               type = ro,                  define = yes;
+    CODE:     load = ROM,               type = rw,                  define = yes;
+    INTERP:   load = ROM, run = INTERP, type = rw,                  define = yes;
+    RT_DATA:  load = ROM, run = MAIN,   type = rw,                  define = yes;
+    DATA:     load = ROM, run = MAIN    type = rw,  optional = yes, define = yes;
+    BSS:      load = MAIN,              type = bss, optional = yes, define = yes;
+    CARTHDR:  load = CARTID,            type = ro;
+}
+

src/cartridge.asm

@@ -0,0 +1,99 @@
+;
+; FastBasic - Fast basic interpreter for the Atari 8-bit computers
+; Copyright (C) 2017-2019 Daniel Serpell
+;
+; This program is free software; you can redistribute it and/or modify
+; it under the terms of the GNU General Public License as published by
+; the Free Software Foundation, either version 2 of the License, or
+; (at your option) any later version.
+;
+; This program is distributed in the hope that it will be useful,
+; but WITHOUT ANY WARRANTY; without even the implied warranty of
+; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+; GNU General Public License for more details.
+;
+; You should have received a copy of the GNU General Public License along
+; with this program.  If not, see <http://www.gnu.org/licenses/>
+;
+; In addition to the permissions in the GNU General Public License, the
+; authors give you unlimited permission to link the compiled version of
+; this file into combinations with other programs, and to distribute those
+; combinations without any restriction coming from the use of this file.
+; (The General Public License restrictions do apply in other respects; for
+; example, they cover modification of the file, and distribution when not
+; linked into a combine executable.)
+
+
+; Cartridge capable interpreter
+; -----------------------------
+
+        ; Export to force include from linker
+        .export         _FASTBASIC_CART_: absolute = 1
+        ; From standalone.asm
+        .import         start
+        ; Linker vars
+        .import         __CARTFLAGS__
+        .import         __BSS_RUN__, __BSS_SIZE__
+        .import         __INTERP_LOAD__, __INTERP_RUN__, __INTERP_SIZE__
+        .import         __RT_DATA_LOAD__, __RT_DATA_RUN__, __RT_DATA_SIZE__
+        .import         __DATA_LOAD__, __DATA_RUN__, __DATA_SIZE__
+        ; Move
+        .import         move_dwn
+        .importzp       move_dwn_src, move_dwn_dst
+
+        .include "atari.inc"
+
+        ; Use DATA segment, so it is available
+        .data
+
+        .code
+        ; Forces an error if compilation options allows self-modifying-code:
+.ifndef NO_SMCODE
+        .assert (start=0), error, "You must compile library with '--asm-define NO_SMCODE' to make cartridges."
+.endif
+
+cartridge_start:
+        ; Copies ROM to RAM
+
+        ; Copy ZP interpreter
+        lda     #<__INTERP_LOAD__
+        ldx     #>__INTERP_LOAD__
+        sta     move_dwn_src
+        stx     move_dwn_src+1
+        lda     #<__INTERP_RUN__
+        ldx     #0
+        sta     move_dwn_dst
+        stx     move_dwn_dst+1
+        lda     #<__INTERP_SIZE__
+        jsr     move_dwn
+
+        .assert (__INTERP_RUN__ < $100), error, "Interpreter must be in ZP"
+        .assert (__INTERP_SIZE__ < $100), error, "Interpreter must be in ZP"
+
+        lda     #<__RT_DATA_LOAD__
+        ldx     #>__RT_DATA_LOAD__
+        sta     move_dwn_src
+        stx     move_dwn_src+1
+        lda     #<__RT_DATA_RUN__
+        ldx     #>__RT_DATA_RUN__
+        sta     move_dwn_dst
+        stx     move_dwn_dst+1
+        lda     #<(__RT_DATA_SIZE__ + __DATA_SIZE__)
+        ldx     #>(__RT_DATA_SIZE__ + __DATA_SIZE__)
+        jsr     move_dwn
+
+        jmp     start
+
+        ; INIT not used
+cartridge_init:
+        rts
+
+        ; Include the cartridge header
+        .segment        "CARTHDR"
+
+        .word   cartridge_start
+        .byte   0
+        .byte   <__CARTFLAGS__
+        .word   cartridge_init
+
+; vi:syntax=asm_ca65