COMMON/README.md

53 lines
2.3 KiB
Markdown
Raw Normal View History

2018-08-07 01:55:07 +00:00
# COMMON
2018-08-07 11:15:24 +00:00
Advances some ideas using Steve Wozniaks 6502 SWEET16 interpreted byte-code language as inspiration. While the goal of SWEET16 was brevity, the goal of COMMON is functionality. The intent is to make a platform suitable for many commercial, scientific, and engineering applications.
2018-08-07 02:02:52 +00:00
For example:
2018-08-07 02:11:51 +00:00
2018-08-15 12:02:31 +00:00
* native type is equivalent to fixed-point decimal ±######.###
* easier support for banked memory
* easier support for higher language compilers
* arithmetic operations add, subtract, multiply, divide, and modulus
* inherent overflow/underflow detection
2018-08-07 10:48:12 +00:00
* all control branching is 16-bit relative, for easier relocatable code
2018-08-07 12:06:28 +00:00
* support for custom system/user functions, akin to INT in x86
2018-08-07 02:10:00 +00:00
Why 6502 and not, for example, x86?
* 6502 assembler is very easy and has a large archive of existing functions
2018-08-07 11:15:24 +00:00
* existing 6502 SWEET16 already has the “hard work” done
2018-08-23 23:43:33 +00:00
* interesting to see it run in newer faster versions of 6502 processors
2023-07-09 10:59:15 +00:00
* how do you think [Bender](https://spectrum.ieee.org/the-truth-about-benders-brain) does what he does? (or the [Terminator](https://www.apl2bits.net/2016/07/18/terminator-6502/)!)
2018-09-18 00:43:33 +00:00
Completed:
2018-09-18 00:39:49 +00:00
* added all the instructions (see `common/common.h` for the list)
In progress:
2023-07-09 10:59:15 +00:00
* larger stack size, current stack size is only about 60 numbers, 250 or so would be better
2020-02-01 21:04:08 +00:00
* emulation of serial ports to allow standard I/O
* a unit test suite to ensure each instruction is correct
2018-09-18 00:39:49 +00:00
* a proof-of-concept application
The meat of the project:
* `common/common.h`: details of instructions
2018-08-07 11:07:36 +00:00
* `common/common.asm`: assembler code for the instructions
* `common/macros.h`: macros used to define the interpreted byte-code
* `common/appl.src`: sample source file using the macros
Auxiliary:
2018-08-07 11:15:24 +00:00
* `emulator/*`: 6502 emulator (borrowed Mike Chambers Fake6502 CPU emulator v1.1 ©2011)
2018-08-23 23:43:33 +00:00
* `xa-pre-process/*`: my utility `xapp` to convert 32-bit fixed decimal quantities so that `xa` can use them
Right now, for testing purposes, the code builds everything into one file `system.obj` and runs the code in the last block loaded, in this case, the code corresponding to `appl.src`. Eventually will support decoupling of system and application files. Application files will be inherently relocatable.
To build and run:
2018-08-15 12:02:31 +00:00
make all
make run
The makefiles use `re2c`, `flex`, `bison`, `gcc`, `cpp`, `xa`, `grep`, and `sed`. Will eventually provide a `./configure`.