Preliminary Apple II support

README.md

@@ -23,6 +23,8 @@ Distributed under GPLv3 (see [LICENSE](LICENSE))
     * Commodore Vic-20 (stock or with RAM extensions)
     
     * Atari 8-bit computers
+    
+    * Apple II+/IIe/Enhanced IIe
 
 * inline assembly
 
@@ -42,4 +44,4 @@ Distributed under GPLv3 (see [LICENSE](LICENSE))
 
 * multi-part programs
 
-* more targets: Famicon/NES, BBC Micro/Electron, Oric computers, Apple II, PC-Engine/Turbografx-16, Atari Lynx
+* more targets: Famicon/NES, BBC Micro/Electron, Oric computers, PC-Engine/Turbografx-16, Atari Lynx

doc/api/command-line.md

@@ -10,7 +10,7 @@
 
 ## I/O options
 
-*  `-o <file>` – Output filename, without extension. Extension will be added automatically, `.prg` for Commodore and `.xex` for Atari.
+*  `-o <file>` – Output filename, without extension. Extension will be added automatically, `.prg` for Commodore, `.a2` for Apple and `.xex` for Atari.
 
 * `-s` – Generate also the assembly output. It is not compatible with any assembler, but it serves purely informational purpose. The file has the same nam as the output file and the extension is `.asm`.
 

doc/api/target-platforms.md

@@ -25,11 +25,30 @@ The following platforms are currently supported:
 
 * `a8` – Atari 8-bit computers
 
+* `apple2` – Apple II+/IIe/Enhanced IIe
+
 The primary and most tested platform is Commodore 64.
 
 Currently, all targets assume that the program will be loaded from disk or tape.
 Cartridge targets are not yet available.
 
+### A note about Apple II
+
+Apple II variants other than II+/IIe/Enhanced IIe (which means the original II, IIc and IIc+) 
+and later compatible computers (Apple III and IIgs) are untested.
+They may or may not work.
+
+The compiler output is a raw machine code file, which then has to be put on a disk. 
+You can do it using [CiderPress](http://a2ciderpress.com/), 
+[AppleCommander](https://applecommander.github.io/), 
+or some other tool.
+
+The file has to be loaded from $0C00. An example how to put such file onto a disk using AppleCommander:
+
+    java -jar AppleCommander-1.3.5.jar -p disk_image.dsk FILENAME B 0xc00 < compiler_output.a2
+    
+Creating a bootable disk is beyond the scope of this document.
+
 ## Adding a custom platform
 
 Every platform is defined in an `.ini` file with an appropriate name.

examples/README.md

@@ -16,7 +16,7 @@
 
 * [Panic](c64/panic_test.mfk) – how panic works on C64, showing the address of where it happened
 
-### Graphical examples:
+### Graphical examples
 
 * [Rasterbar](c64/rasterbar.mfk) – simple rasterbar effect
 
@@ -24,3 +24,6 @@
 
 * [Galencia starfield](c64/galencia.mfk) – a port of the starfield effect from the game *Galencia* 
 
+## Apple II examples
+
+* [Bell](apple2/bell.mfk) – a program that goes \*ding!\*

examples/apple2/bell.mfk

@@ -0,0 +1,3 @@
+void main() {
+    bell()
+}

include/apple2.ini

@@ -0,0 +1,21 @@
+[compilation]
+arch=strict
+modules=apple2_kernel,default_panic
+
+
+[allocation]
+main_org=$0C00
+; TODO
+zp_pointers=6,8,$EB,$ED,$FA,$FC
+;TODO
+himem_style=per_bank
+himem_start=after_code
+himem_end=$95FF
+
+[output]
+;TODO
+style=per_bank
+format=allocated
+extension=a2
+
+

include/apple2_kernel.mfk

@@ -0,0 +1,6 @@
+array hires_page_1 [$2000] @$2000
+array hires_page_2 [$2000] @$4000
+
+asm void bell() @$FBE4 extern
+
+asm void putchar(byte a) @$FDED extern