aboutsummaryrefslogtreecommitdiff
path: root/amforth-6.5/readme.txt
blob: acf0eb13fdd7f781b56ad19774f58cc7eb1a8a3d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
Author:
    Matthias Trute <mtrute@users.sourceforge.net>

Major Contributors:
    Erich Waelde
    Michael Kalus
    Leon Maurer
    Ullrich Hoffmann
    Karl Lund
    Enoch
    Bradford Rodriguez (MSP430 code from Camelforth 0.5)

License: General Public License (GPL) Version 3 from 2007. See the
file LICENSE.txt or http://www.gnu.org/licenses/gpl.html. This
license applies to all files unless a file has some different
attribution in it.

AmForth is an interactive 16-bit Forth for Atmel ATmega and
Texas Instruments MSP430 microcontrollers. It does not need
additional hard or software. It works completely on the 
controller (no cross-compiler). AmForth uses the indirect
threading forth implementation technique.

ATmega:

  The forth dictionary is in the flash memory, new words are compiled
  directly into flash. Since no (widely available) bootloader supports
  an API to write to flash, AmForth uses the bootloader space itself.

MSP430
  
  The Forth dictionary is in the flash or FRAM memory, new words are
  compiled to it. Use SAVE to keep the code accessible across
  reboots. The flash devices cannot rewrite the flash cell once a 
  word is written.

AmForth is implemented in assembly and forth. The code is stable
and well tested. The MSP430 variant is newer and may have less
features.

All words have Forth 2012 (CORE and various extenion word sets)
stack diagrams, but not necessarily the complete semantics. Some
words from the standards are left out, ask for them if you need them.

Development hardware are evaluation boards running various Atmega's
between 2 and 20 MHz with various external hardware: none,
led, push-buttons, SD-card, ethernet controller, RF module etc.
The MSP430 code is tested with Launchpads.

Documentation can be found in the doc/ subdirectory and
on the homepage http://amforth.sourceforge.net/.

Contact, bug reports, questions, wishes etc:
    mailto:amforth-devel@lists.sourceforge.net