high level programming language and compiler targeting 6502 machines such as the C-64 and CommanderX16
Go to file
2022-10-28 22:40:36 +01:00
.idea refactor IR codegen into separate module 2022-09-19 19:24:24 +02:00
codeCore ir: adding register usage inspections 2022-09-30 20:25:00 +02:00
codeGenCpu6502 fix: array[x] = ~array[x] no longer crashes the codegen 2022-10-27 23:56:38 +02:00
codeGenExperimental make IRFileReader's file source more general 2022-09-26 14:47:28 +02:00
codeGenIntermediate replace rnd()/rndw() builtin functions by regular routines in math module 2022-10-22 17:02:43 +02:00
codeOptimizers ir: adding register usage inspections 2022-09-30 20:25:00 +02:00
compiler fix: array[x] = ~array[x] no longer crashes the codegen 2022-10-27 23:56:38 +02:00
compilerAst replace rnd()/rndw() builtin functions by regular routines in math module 2022-10-22 17:02:43 +02:00
dbusCompilerService reducing dependencies 2022-03-10 23:46:43 +01:00
docs lowlevel -> low-level 2022-10-28 22:40:36 +01:00
examples fix: array[x] = ~array[x] no longer crashes the codegen 2022-10-27 23:56:38 +02:00
gradle/wrapper getting rid of directives in new Ast 2022-03-13 00:30:20 +01:00
httpCompilerService vm: fix crashes when array contains pointers/strings 2022-09-24 14:42:07 +02:00
intermediate ir: replace RND opcode by syscalls 2022-10-22 17:20:46 +02:00
parser added '%ir' to write inline IR code, '%asm' is now only for real 6502 assembly. 2022-09-30 15:12:26 +02:00
scripts ir: adding register usage inspections 2022-09-30 20:25:00 +02:00
syntax-files mention syntax highlighting files in the docs 2022-10-25 21:24:38 +02:00
virtualmachine ir: replace RND opcode by syscalls 2022-10-22 17:20:46 +02:00
.gitignore libs updated to maven 2021-10-12 03:33:52 +02:00
.readthedocs.yaml attempt to fix ReadTheDocs build issue 2021-11-07 00:37:31 +01:00
build.gradle simplified gradle config, automatically run installDist task after build 2021-10-30 12:01:52 +02:00
CompilerDevelopment.md doc 2022-02-11 00:16:39 +01:00
gradle.properties kotlin 1.7.20 2022-09-29 18:41:20 +02:00
gradlew getting rid of directives in new Ast 2022-03-13 00:30:20 +01:00
gradlew.bat updated gradle scripts (fixed warnings), updated some library dependencies 2021-06-13 18:10:07 +02:00
LICENSE removed confusing GPL software license reference and copyright header from library files. (because of exclusion in output files) 2022-05-30 20:12:20 +02:00
README.md mention syntax highlighting files in the docs 2022-10-25 21:24:38 +02:00
settings.gradle moved codeGenVirtual module into virtualmachine module 2022-09-26 20:00:40 +02:00

Documentation

Prog8 - Structured Programming Language for 8-bit 6502/65c02 microprocessors

Written by Irmen de Jong (irmen@razorvine.net)

This is a structured programming language for the 8-bit 6502/6510/65c02 microprocessor from the late 1970's and 1980's as used in many home computers from that era. It is a medium to low level programming language, which aims to provide many conveniences over raw assembly code (even when using a macro assembler).

Documentation

Full documentation (syntax reference, how to use the language and the compiler, etc.) can be found at: https://prog8.readthedocs.io/

Software license

GNU GPL 3.0 (see file LICENSE), with exception for generated code:

  • The compiler and its libraries are free to use according to the terms of the GNU GPL 3.0
  • exception: the resulting files (intermediate source codes and resulting binary program) created by the compiler are excluded from the GPL and are free to use in whatever way desired, commercially or not.

What does Prog8 provide?

  • reduction of source code length over raw assembly
  • fast execution speed due to compilation to native assembly code. It's possible to write certain raster interrupt 'demoscene' effects purely in Prog8.
  • modularity, symbol scoping, subroutines
  • various data types other than just bytes (16-bit words, floats, strings)
  • floating point math is supported if the target system provides floating point library routines (C64 and Cx16 both do)
  • strings can contain escaped characters but also many symbols directly if they have a petscii equivalent, such as "♠♥♣♦π▚●○╳". Characters like ^, _, , {, } and | are also accepted and converted to the closest petscii equivalents.
  • automatic static variable allocations, automatic string and array variables and string sharing
  • subroutines with input parameters and result values
  • high-level program optimizations
  • small program boilerplate/compilersupport overhead
  • programs can be run multiple times without reloading because of automatic variable (re)initializations.
  • conditional branches
  • when statement to provide a concise jump table alternative to if/elseif chains
  • in expression for concise and efficient multi-value/containment check
  • many built-in functions such as sin, cos, rnd, abs, min, max, sqrt, msb, rol, ror, swap, sort and reverse
  • various powerful built-in libraries to do I/O, number conversions, graphics and more
  • convenience abstractions for low level aspects such as ZeroPage handling, program startup, explicit memory addresses
  • inline assembly allows you to have full control when every cycle or byte matters
  • supports the sixteen 'virtual' 16-bit registers R0 - R15 from the Commander X16, and provides them also on the C64.
  • encode strings and characters into petscii or screencodes as desired (C64/Cx16)

Rapid edit-compile-run-debug cycle:

  • use a modern PC to do the work on, use nice editors and enjoy quick compilation times
  • can automatically run the program in the Vice emulator after succesful compilation
  • breakpoints, that let the Vice emulator drop into the monitor if execution hits them
  • source code labels automatically loaded in Vice emulator so it can show them in disassembly

Multiple supported compiler targets (contributions to improve these or to add support for other machines are welcome!):

  • "c64": Commodore-64 (6502 like CPU)
  • "c128": Commodore-128 (6502 like CPU - the Z80 cpu mode is not supported)
  • "cx16": CommanderX16 (65c02 CPU)
  • If you only use standard kernal and prog8 library routines, it is possible to compile the exact same program for different machines (just change the compiler target flag)

Additional required tools

64tass - cross assembler. Install this on your shell path. A recent .exe version of this tool for Windows can be obtained from my clone of this project. For other platforms it is very easy to compile it yourself (make ; make install).

A Java runtime (jre or jdk), version 11 or newer is required to run a prepackaged version of the compiler. If you want to build it from source, you'll need a Java SDK + Kotlin 1.3.x SDK (or for instance, IntelliJ IDEA with the Kotlin plugin).

It's handy to have an emulator (or a real machine perhaps!) to run the programs on. The compiler assumes the presence of the Vice emulator for the C64 target, and the x16emu emulator for the CommanderX16 target.

Syntax highlighting: for a few different editors, syntax highlighting definition files are provided. Look in the syntax-files directory in the github repository to find them.

Example code

This code calculates prime numbers using the Sieve of Eratosthenes algorithm::

%import textio
%zeropage basicsafe

main {

    ubyte[256] sieve
    ubyte candidate_prime = 2       ; is increased in the loop

    sub start() {
        sys.memset(sieve, 256, false)   ; clear the sieve
        txt.print("prime numbers up to 255:\n\n")
        ubyte amount=0
        repeat {
            ubyte prime = find_next_prime()
            if prime==0
                break
            txt.print_ub(prime)
            txt.print(", ")
            amount++
        }
        txt.nl()
        txt.print("number of primes (expected 54): ")
        txt.print_ub(amount)
        txt.nl()
    }

    sub find_next_prime() -> ubyte {
        while sieve[candidate_prime] {
            candidate_prime++
            if candidate_prime==0
                return 0        ; we wrapped; no more primes
        }

        ; found next one, mark the multiples and return it.
        sieve[candidate_prime] = true
        uword multiple = candidate_prime

        while multiple < len(sieve) {
            sieve[lsb(multiple)] = true
            multiple += candidate_prime
        }
        return candidate_prime
    }
}

when compiled an ran on a C-64 you'll get:

c64 screen

One of the included examples (wizzine.p8) animates a bunch of sprite balloons and looks like this:

wizzine screen

Another example (cube3d-sprites.p8) draws the vertices of a rotating 3d cube:

cube3d screen

If you want to play a video game, a fully working Tetris clone is included in the examples:

tehtriz_screen

There are a couple of examples specially made for the CommanderX16 compiler target. For instance here's a well known space ship animated in 3D with hidden line removal, in the CommanderX16 emulator:

cobra3d