diff options
| author | Clyne Sullivan <clyne@bitgloo.com> | 2023-10-14 19:17:59 -0400 |
|---|---|---|
| committer | Clyne Sullivan <clyne@bitgloo.com> | 2023-10-14 19:17:59 -0400 |
| commit | 3d7a45e5cddc94d7bd5a3433a561f16fdb5e18a0 (patch) | |
| tree | 341b4ac9279a250bd5f807a62d27fa16c48d761e /msp430/README.md | |
| parent | 5991370657b48f5b44fbcc7877a7c26acf07d99e (diff) | |
msp430.fth
Diffstat (limited to 'msp430/README.md')
| -rw-r--r-- | msp430/README.md | 20 |
1 files changed, 20 insertions, 0 deletions
diff --git a/msp430/README.md b/msp430/README.md new file mode 100644 index 0000000..34d2ddb --- /dev/null +++ b/msp430/README.md @@ -0,0 +1,20 @@ +# msp430 implementation + +This is the MSP430 port of Alee Forth. It produces a binary that enters a REPL made available on the UART peripheral at 115200 baud. The specific target is MSP430G2553. + +## Building + +1. `make clean` (just in case) +2. `make msp430-prep`: Builds `alee` for the host computer and uses it to create an `alee.dat` blob containing bytecode for `forth/core.fth` and `forth/msp430.fth`. +3. `make msp430`: Produces `alee-msp430`, a standalone binary for the MSP430 with built-in core and msp430 word-sets. + +The final binary is < 11 kB and provides 150 bytes for user dictionary in RAM (assuming 512 bytes of total RAM). + +## msp430.fth + +The msp430 word-set makes programming for the MSP430 easier: + +* All register names are defined (P1OUT, ADC10MEM, etc.). +* `r!` and `r@` to write and read device memory (i.e. registers). +* `rset`, `rclr`, `rtgl` work like `r!` but set, clear, or toggle the given value/mask instead. + |