6502/cc65
1
0
Fork 0
mirror of https://github.com/cc65/cc65.git synced 2024-11-19 21:32:19 +00:00
Code Issues Projects Releases Wiki Activity

Sym-1 documentation updates

Browse Source
This commit is contained in:
Wayne Parham 2021-06-07 20:00:18 -05:00
parent 2635655e8c
commit 2a25921515
1 changed files with 5 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
doc/sym1.sgml
View File

@ -21,11 +21,11 @@ Please note that Sym-1 specific functions are just mentioned here, they are desc
<sect>Binary format<p> <sect>Binary format<p>
The standard binary output format generated by the linker for the Sym-1 target is a 4 kbyte machine language program. It is, of course, possible to change this behavior by using one of the different linker configs. The output format generated by the linker for the Sym-1 target is a raw binary BIN file, which is essentially a memory image. You can convert this to a HEX file using BIN2HEX, which is a popular open-source conversion utility program. A HEX file has ASCII representations of the hexadecimal byte values of the machine-language program.
<p> <p>
Included with this distribution is a 4k configuration file and a 32k config file. The Sym-1 on-board memory is limited to 4k but system memory can be increased to 32 kbytes of contiguous RAM with aftermarket add-on boards. So choose the config file that matches your system configuration before compiling and linking user programs. Included with this distribution is a 4k configuration file and a 32k config file. The Sym-1 on-board memory is limited to 4 kbytes but system memory can be increased to 32 kbytes of contiguous RAM with aftermarket add-on boards. So choose the config file that matches your system configuration before compiling and linking user programs.
<sect>Memory layout<p> <sect>Memory layout<p>
@ -41,8 +41,7 @@ Special locations:
The C runtime stack is located at &dollar;0FFF on 4KB Syms, or at &dollar;7FFFfor 32KB systems. The stack always grows downwards. The C runtime stack is located at &dollar;0FFF on 4KB Syms, or at &dollar;7FFFfor 32KB systems. The stack always grows downwards.
<tag/Heap/ <tag/Heap/
The C heap is located at the end of the program and grows towards the C The C heap is located at the end of the program and grows towards the C runtime stack.
runtime stack.
</descrip><p> </descrip><p>
@ -52,7 +51,7 @@ Programs containing Sym-1 code may use the <tt/sym1.h/ header file. See the hea
<sect1>Hardware access<p> <sect1>Hardware access<p>
The following pseudo variables declared in the <tt/sym1.inc/ include file allow access to hardware located in the address space. See the include file for more information. The pseudo variables declared in the <tt/sym1.inc/ include file allow access to hardware located in the address space. See the include file for more information.
<sect>Loadable drivers<p> <sect>Loadable drivers<p>
@ -103,7 +102,7 @@ As stated earlier, there are config files for 4KB and 32KB systems. If you have
<sect3>Sample programs<p> <sect3>Sample programs<p>
All the samples will run on the &quot;stock&quot; 4k Sym-1, except for symio.c, which requires 8k. Information on building and running it is in the samples/tutorial/sym1 directory. All the samples will run on the &quot;stock&quot; 4KB Sym-1, except for symIO and symNotepad, which require 32KB. Information on building and running the sample programs are in the targettest/sym1 directory.
<itemize> <itemize>
<item>helloworld is the traditional &quot;Hello World!&quot; program, using printf().</item> <item>helloworld is the traditional &quot;Hello World!&quot; program, using printf().</item>