1
0
mirror of https://github.com/catseye/SixtyPical.git synced 2024-11-08 03:07:29 +00:00
A 6502-oriented low-level programming language supporting advanced static analysis
Go to file
2018-03-05 10:34:49 +00:00
bin Always analyze before compiling. 2018-02-06 16:14:44 +00:00
doc Documentation/notes changes for the 0.13 branch. 2018-02-16 09:51:24 +00:00
eg Remove need for forward keyword in forward reference in copy. 2018-02-12 15:59:20 +00:00
src/sixtypical Make tests pass. 2018-02-16 15:46:55 +00:00
tests Add some more tests (failing currently). 2018-02-16 12:28:11 +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 Documentation/notes changes for the 0.13 branch. 2018-02-16 09:51:24 +00:00
LICENSE Add TODO to README, update license information. 2015-10-16 10:00:51 +01:00
loadngo.sh More statics in demo game. 2018-02-09 16:57:49 +00:00
README.md Add notes for for-like loop. 2018-03-05 10:34:49 +00:00
test.sh The evaluator doesn't add much and keeps falling behind; remove it. 2018-02-05 13:17:23 +00:00

SixtyPical

Version 0.13. Work-in-progress, everything is subject to change.

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 analyze and compile SixtyPical programs to 6502 machine code.

Documentation

TODO

for-like loop

We have range-checking in the abstract analysis now, but we lack practical ways to use it.

We can and a value to ensure it is within a certain range. However, in the 6502 ISA the only register you can and is A, while loops are done with X or Y. Insisting this as the way to do it would result in a lot of TXAs and TAXs.

What would be better is a dedicated for loop, like

for x in 0 to 15 {
    // in here, we know the range of x is exactly 0-15 inclusive
    // also in here: we are disallowed from changing x
}

However, this is slightly restrictive, and hides a lot.

However however, options which do not hide a lot, require a lot of looking at (to ensure: did you increment the loop variable? only once? etc.)

The leading compromise so far is an "open-faced for loop", like

ld x, 15
for x downto 0 {
    // same as above
}

This makes it a little more explicit, at least, even though the loop decrementation is still hidden.

Save registers on stack

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

Re-order routines and optimize tail-calls to fallthroughs

Not because it saves 3 bytes, but because it's a neat trick. Doing it optimally is probably NP-complete. But doing it adeuqately is probably not that hard.

And at some point...

  • Confirm that and can be used to restrict the range of table reads/writes.
  • low and high address operators - to turn word type into byte.
  • consts that can be used in defining the size of tables, etc.
  • Tests, and implementation, ensuring a routine can be assigned to a vector of "wider" type
  • Related: can we simply view a (small) part of a buffer as a byte table? If not, why not?
  • Check that the buffer being read or written to through pointer, appears in approporiate inputs or outputs set. (Associate each pointer with the buffer it points into.)
  • static pointers -- currently not possible because pointers must be zero-page, thus @, thus uninitialized.
  • Question the value of the "consistent initialization" principle for if statement analysis.
  • interrupt routines -- to indicate that "the supervisor" has stored values on the stack, so we can trash them.
  • Error messages that include the line number of the source code.
  • Add absolute addressing in shl/shr, absolute-indexed for add, sub, etc.
  • Automatic tail-call optimization (could be tricky, w/constraints?)
  • Possibly ld x, [ptr] + y, possibly st x, [ptr] + y.
  • Maybe even copy [ptra] + y, [ptrb] + y, which can be compiled to indirect LDA then indirect STA!