Elmo HARmonica, HARSFEN0602 software manual 210, Toc, Compilation Done Flag

ElmoHARSFEN0602HARmonicaSoftwareManual PRELIMINARYDRAFT

The user code partition can be read by the LS command. The data in this partition is:

TOC (Table Contents) "Compilation done" flag virtual machine code segment

text backup segment. The text backup includes virtual code counter references. function symbol table

A variable symbol table

•An automatic function table

Each partition starts at a page (264 bytes) boundary.

16.5.1The TOC

The table of contents is located at the starting address of user code partition.

Each of the items below is relative to the start of the user code partition.

The length of the TOC is one flash page (264 byte).

The TOC includes:

Item	Address	Size	Comment
Compilation done	0	unsigned	Points to the fixed address 264
		long
Virtual machine code	4	unsigned	Points to the fixed address 2*264.
segment start address		long	The length of this segment is less
			then 63k.
Virtual machine code	8	unsigned
segment length		long
Text backup segment	12	unsigned
start address		long
Text backup segment	16	unsigned
length		long
Function symbol table	20	unsigned
start address		long
Function symbol table	24	unsigned
length		long
Variable symbol table	28	unsigned
start address		long
Variable symbol table	32	unsigned
length		long
Automatic function table	36	unsigned
start address		long
Automatic function table	40	unsigned
length		long
Last used address	44	unsigned	The checksum for the user code
		long	partition is checked from Address 0
			in the serial flash to that address.
			Must be in the range
			[2*264,100000]

All unused TOC items are set to zero.

16.5.2The Compilation Done Flag

The Compilation Done Flag tells the Harmonica if a program is ready to run. This means that a program image has been successfully downloaded to the Harmonica and its checksum verified, and also that the symbol tables has been copied to the local data flash of the Harmonica.

210