1
0
mirror of https://github.com/catseye/SixtyPical.git synced 2024-11-25 23:49:17 +00:00
A 6502-oriented low-level programming language supporting advanced static analysis
Go to file
2017-12-12 13:54:35 +00:00
bin Ability to --debug analysis. Make 16-bit addition test pass. 2017-12-07 11:49:15 +00:00
doc Prep for developing version 0.10. 2017-12-12 12:27:29 +00:00
eg Give the "game" a "title screen" of sorts; click to begin. 2017-12-12 10:58:59 +00:00
src/sixtypical Change how backpatching instructions is implemented. 2017-12-12 13:54:35 +00:00
tests Allow call and goto routines defined further down in the source. 2017-12-12 13:17:00 +00:00
.gitignore Check in test appliance (dcc6502-adapter) that was missed. 2017-12-11 13:46:06 +00:00
.hgignore Refactor to replace some sketchy code with code actually in use. 2015-10-16 10:40:38 +01:00
.hgtags Added tag 0.6 for changeset f89772f47de9 2015-10-23 16:37:22 +01:00
HISTORY.md Allow call and goto routines defined further down in the source. 2017-12-12 13:17:00 +00:00
LICENSE Add TODO to README, update license information. 2015-10-16 10:00:51 +01:00
loadngo.sh Add more notes and basically small cleanups in many places. 2017-12-11 15:21:40 +00:00
README.md Change how backpatching instructions is implemented. 2017-12-12 13:54:35 +00:00
test.sh Add syntax for extern routines, add syntax tests. 2015-10-17 13:50:21 +01:00

SixtyPical

SixtyPical is a very low-level programming language, similar to 6502 assembly, with static analysis through abstract interpretation.

In practice, this means it catches things like

  • you forgot to clear carry before adding something to the accumulator
  • a subroutine that you call trashes a register you thought was preserved
  • you tried to write the address of something that was not a routine, to a jump vector

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.

SixtyPical is a work in progress. The current released version of SixtyPical is 0.10 (not released yet).

Documentation

TODO

Demo game

Finish the little demo "game" where you can move a block around the screen with the joystick (i.e. bring it up to par with the original demo game that was written for SixtyPical)

copy (to vectors) routines that are defined further down in the source code

We might have a graph of states that refer to each other and that want to goto each other. Thus we need this. We have it for other things.

Allow branches to diverge in what they touch

For example, if the routine inputs and outputs foo, and one branch of an if sets foo and the other does not touch it, that should be OK.

vector table type

low and high address operators

To turn word type into byte.

Save registers on stack

This preserves them, so that, semantically, they can be used later even though they are trashed inside the block.

Range checking in the abstract interpretation

If you copy the address of a buffer (say it is size N) to a pointer, it is valid. If you add a value from 0 to N-1 to the pointer, it is still valid. But if you add a value ≥ N to it, it becomes invalid. This should be tracked in the abstract interpretation. (If only because abstract interpretation is the major point of this project!)

And at some point...

  • Compare word (constant or memory location) with memory location or pointer. (Maybe?)
  • copy x, [ptr] + y
  • Maybe even copy [ptra] + y, [ptrb] + y, which can be compiled to indirect LDA then indirect STA!
  • Check that the buffer being read or written to through pointer, appears in approporiate inputs or outputs set.
  • byte table and word table of sizes other than 256
  • initialized byte table memory locations
  • always analyze before executing or compiling, unless told not to
  • trash instruction.
  • interrupt routines -- to indicate that "the supervisor" has stored values on the stack, so we can trash them.
  • pre-initialized word variables
  • error messages that include the line number of the source code
  • have copy instruction able to copy a byte to a user-def mem loc, etc.
  • add absolute addressing in shl/shr, absolute-indexed for add, sub, etc.
  • check and disallow recursion.
  • automatic tail-call optimization (could be tricky, w/constraints?)
  • re-order routines and optimize tail-calls to fallthroughs