Tachyon Forth Files

COMPILING A NEW KERNEL:
Compile the kernel using a version of bstc suitable for your o/s
For Linux systems use the bake script which will combine all the include files
together into an output file which is compiled and then downloaded into the Prop chip
./bake tachyon <output file> <frequency> ttyUSB<port>

CONSOLE OUTPUT:
	22:34 KERNEL$ ./bake tachyon tachyon5v7 96MHZ 0
	Brads Spin Tool Compiler v0.15.3 - Copyright 2008,2009 All rights reserved
	Compiled for i386 Linux at 08:17:46 on 2009/07/20
	Loading Object tachyon5v7
	Program size is 32400 longs
	Compiled 2831 Lines of Code in 0.081 Seconds
	We found a Propeller Version 1
	Propeller Load took 7.682 Seconds


Once the compile and load is successful then proceed to the serial terminal
and connect to the Prop at 115200,8N1 with 3ms line delay.
Hit enter and the Tachyon prompt will appear such as TF5>

Tachyon will also respond to a ^C (control+C) or a line break as a reset.

CONSOLE OUTPUT:
	  Propeller .:.:--TACHYON--:.:. Forth V5r7 NEON 570190926.2300
	 Cold start - no user code - setting defaults

	--------------------------------------------------------------------------------
	TF5>


COMPILING EXTEND.FTH and other code on Tachyon:
Now that the prompt is available ensure that your terminal settings have at least 3ms line delay
for pasting text or sending raw ASCII text files.
Copy EXTEND.FTH and paste it into the terminal.
The console output will stop echoing input and go into fast load mode
returning a line number for every line received and only advancing to
another line every 100 lines or until it is done.
If all is well and there are no errors then it will BACKUP to EEPROM, report and reboot.

CONSOLE OUTPUT:
	2700
	2753  ---  ok

	   End of source code, 0000  errors found  Load time = 14.7
	Code bytes used = 8632
	Name bytes used = 3924

	CODE:$3C78 = 14968 bytes
	NAME:$5A4E = 6578 bytes
	DATA:$7601 = 241 bytes
	FREE:      = 7638 bytes
	 Data Stack (0)

	 ok
	TF5>
	TF5> \
	TF5> HERE $8000 + ' DEFAULTS 2 + W! ---  ok
	TF5> @NAMES $8000 + ' DEFAULTS W! ---  ok
	TF5> org@ $8000 + ' DEFAULTS 4 + W! ---  ok
	TF5>
	TF5> EEPROM ---  ok
	TF5> ?BACKUP --- BACKUP  ok
	TF5> REBOOT ---

	  Propeller .:.:--TACHYON--:.:. Forth V5r7 NEON 570190926.2300
	  *** MODULES ***  Propeller .:.:--TACHYON--:.:. Forth V5r7 NEON 570190926.2300
	300E: TOOLS            DEV TOOLS
	1AC0: EXTEND           Primary extensions to TACHYON V5 kernel  - 200514-0100


	FREQ = 100.00MHZ
	*** INITS ***
	*** ROMS ***
	C01C: HSUART      560
	C260: UART        464
	C444: VGA32x15    848
	C7A8: TV         1276
	CCB8: SIDCOG     1648
	D33C: F32        1900
	*** I2C ***
	$A0 EE/RTC
	I/O =  31 :UHUU 27 :~~~~ 23 :~~~~ 19 :~~~~ 15 :U~~~ 11 :~~~~ 7 :~~~~ 3 :~~~~
	INTERCOM: &05.78.32.55 @4,988

	CODE:$3C78 = 14968 bytes
	NAME:$5A4E = 6578 bytes
	DATA:$7601 = 241 bytes
	FREE:      = 7638 bytes
	 Data Stack (0)
	Mon, 01 Jan 2001 00:00:01 UTC
	--------------------------------------------------------------------------------
	TF5>


NOTES:

Regarding bstc, it is a command line compiler that may require 32-bit 386 libraries loaded
on a Linux system to run. A Windows and Mac version are available too.


SCRIPT for bake
	#./bake tachyon tachyon5v7 96MHZ port#
	m4 -I includes ./includes/$1.m4 > $2.spin
	./bstc -l -b -O x -d /dev/ttyUSB$4 -D $3 -p2 -f $2.spin

The frequency codes that are defined in config.spin are:

	#ifdef 80MHZ
	_clkmode        = xtal1 + pll8x
	_xinfreq        = 10_000_000            ' <--- AUTOMATIC 5 or 10MHz operation change at boot
	sysfreq         = 80_000_000
	#endif

	#ifdef 104MHZ
	_clkmode        = xtal1 + pll16x
	_xinfreq        = 6_500_000
	sysfreq         = 104_000_000
	#endif

	#ifdef 100MHZ
	_clkmode        = xtal1 + pll16x
	_xinfreq        = 6_200_000
	sysfreq         = 100_000_000
	#endif

	#ifdef 96MHZ
	_clkmode        = xtal1 + pll16x
	_xinfreq        = 6_000_000
	sysfreq         = 96_000_000
	#endif

	#ifdef P8X
	_clkmode        = xtal1 + pll8x
	_xinfreq        = 12_000_000
	sysfreq         = 96_000_000
	#endif

	#ifdef NOX
	_clkmode        = RCFAST
	_xinfreq        = 12_000_000
	sysfreq         = 12_000_000
	#endif