2014-03-31 23:31:30 +01:00
|
|
|
SixtyPical
|
|
|
|
|
==========
|
|
|
|
|
|
2014-04-01 13:01:27 +01:00
|
|
|
SixtyPical is a very low-level programming language, similar to 6502 assembly,
|
2015-10-16 09:30:24 +01:00
|
|
|
with static analysis through abstract interpretation.
|
2014-04-01 13:01:27 +01:00
|
|
|
|
2015-10-16 09:30:24 +01:00
|
|
|
In practice, this means it catches things like
|
2014-04-01 13:01:27 +01:00
|
|
|
|
2015-10-16 09:30:24 +01:00
|
|
|
* you forgot to clear carry before adding something to the accumulator
|
|
|
|
|
* a subroutine that you call trashes a register you thought was preserved
|
2015-10-22 19:20:48 +01:00
|
|
|
* you tried to write the address of something that was not a routine, to
|
|
|
|
|
a jump vector
|
2014-04-04 18:27:51 +01:00
|
|
|
|
2015-10-22 19:20:48 +01:00
|
|
|
and suchlike. It also provides some convenient operations and abstractions
|
|
|
|
|
based on common machine-language programming idioms, such as
|
|
|
|
|
|
|
|
|
|
* copying values from one register to another (via a third register when
|
|
|
|
|
there are no underlying instructions that directly support it)
|
|
|
|
|
* explicit tail calls
|
|
|
|
|
* indirect subroutine calls
|
|
|
|
|
|
|
|
|
|
The reference implementation can execute, analyze, and compile SixtyPical
|
|
|
|
|
programs to 6502 machine code.
|
2014-04-11 22:50:03 +01:00
|
|
|
|
2015-10-16 09:30:24 +01:00
|
|
|
It is a **work in progress**, currently at the **proof-of-concept** stage.
|
2014-04-12 12:55:33 +01:00
|
|
|
|
2015-10-23 16:37:18 +01:00
|
|
|
The current released version of SixtyPical is 0.6. The current development
|
|
|
|
|
version of SixtyPical, unreleased as of this writing, is 0.7-PRE.
|
2014-04-12 12:55:33 +01:00
|
|
|
|
2015-10-16 10:00:51 +01:00
|
|
|
Documentation
|
|
|
|
|
-------------
|
2014-04-01 14:33:57 +01:00
|
|
|
|
2015-10-16 10:00:51 +01:00
|
|
|
* Design Goals — coming soon.
|
2015-10-16 10:54:12 +01:00
|
|
|
* [SixtyPical specification](doc/SixtyPical.md)
|
2015-10-18 13:37:35 +01:00
|
|
|
* [SixtyPical history](HISTORY.md)
|
2015-10-17 18:31:15 +01:00
|
|
|
* [Literate test suite for SixtyPical syntax](tests/SixtyPical Syntax.md)
|
2015-10-16 10:54:12 +01:00
|
|
|
* [Literate test suite for SixtyPical execution](tests/SixtyPical Execution.md)
|
|
|
|
|
* [Literate test suite for SixtyPical analysis](tests/SixtyPical Analysis.md)
|
2015-10-17 18:31:15 +01:00
|
|
|
* [Literate test suite for SixtyPical compilation](tests/SixtyPical Compilation.md)
|
2015-10-16 19:15:01 +01:00
|
|
|
* [6502 Opcodes used/not used in SixtyPical](doc/6502 Opcodes.md)
|
2015-10-16 10:00:51 +01:00
|
|
|
|
|
|
|
|
TODO
|
|
|
|
|
----
|
|
|
|
|
|
2015-10-18 16:22:36 +01:00
|
|
|
For 0.7:
|
2015-10-17 12:30:45 +01:00
|
|
|
|
2015-10-22 20:01:02 +01:00
|
|
|
* always analyze before executing or compiling, unless told not to
|
2015-10-17 12:30:45 +01:00
|
|
|
* `word` type.
|
2015-10-22 19:20:48 +01:00
|
|
|
* `word table` type.
|
2015-10-23 16:37:18 +01:00
|
|
|
|
|
|
|
|
For 0.8:
|
|
|
|
|
|
2015-10-19 12:22:44 +01:00
|
|
|
* zero-page memory locations.
|
2015-10-18 19:02:07 +01:00
|
|
|
* indirect addressing.
|
2015-10-18 16:22:36 +01:00
|
|
|
|
2015-10-18 19:02:07 +01:00
|
|
|
At some point...
|
2015-10-18 16:22:36 +01:00
|
|
|
|
2015-10-23 16:37:18 +01:00
|
|
|
* `trash` instruction.
|
2015-10-19 13:04:08 +01:00
|
|
|
* `interrupt` routines.
|
2015-10-18 16:22:36 +01:00
|
|
|
* 6502-mnemonic aliases (`sec`, `clc`)
|
|
|
|
|
* other handy aliases (`eq` for `z`, etc.)
|
2015-10-19 13:04:08 +01:00
|
|
|
* have `copy` instruction able to copy a constant to a user-def mem loc, etc.
|
2015-10-18 19:02:07 +01:00
|
|
|
* add absolute addressing in shl/shr, absolute-indexed for add, sub, etc.
|
2015-10-18 19:41:26 +01:00
|
|
|
* check and disallow recursion.
|
