The 32 kb RAM machine that must be used with the default compiler settings is
<url url="http://www.pcjs.org/devices/c1p/machine/32kb/" name="here">.
-In addition the srec_cat program from the
+In addition to cc65 the srec_cat program from the
<url url="http://srecord.sourceforge.net/" name="SRecord">
tool collection must be installed. Some Linux distributions also provide the
-srecord package that can be installed directly from the distribution's
-repository.
+srecord package directly as an installable package.
-The osic1p runtime library directly returns to the boot prompt when the
+The osic1p runtime library returns to the boot prompt when the
main() program exits. Therefore the C file in the tutorial must be slightly
modified in order to see the results on the screen. Otherwise the program
would print the text string and then jump to the boot prompt, making it
impossible to see the results of running the tutorial program.
-In addition to that the cc65 target does not yet have support for stdio
+In addition to that the osic1p target does not yet have support for stdio
functions. Only the functions from the conio library are available.
-Therefore modify the main() function in hello.c as follows:
+Therefore modify the hello.c source file as follows:
-<tscreen>
+<tscreen><code>
#include <conio.h>
#include <stdlib.h>
int main (void)
{
- clrscr();
+ clrscr ();
cprintf ("%s\r\nPress <RETURN>\r\n", text);
- cgetc();
+ cgetc ();
return EXIT_SUCCESS;
}
-</tscreen>
+</code></tscreen>
Compile the tutorial with
</verb></tscreen>
Open the URL <url url="http://www.pcjs.org/devices/c1p/machine/32kb/" name="http://www.pcjs.org/devices/c1p/machine/32kb/">
-in your browser and wait until the emulator is loaded. Click on the BREAK
-button to display the boot prompt, then press the M key to enter the
-65V PROM monitor. Press the "Choose File" button and select the hello.c1p
-that was created as the output of the above invocation of the srec_cat
+and wait until the emulator has been loaded. Click on the "BREAK"
+button to display the boot prompt, then press the "M" key to enter the
+65V PROM monitor. Click the "Choose File" button and select the file "hello.c1p"
+that was created as the output of the above invocation of the "srec_cat"
command. Press the "Load" button. You should see the following text on the
screen:
After hitting the RETURN key you should see the boot prompt again.
The program can also be uploaded over the serial port to a real Challenger 1P
-computer.
+computer with 32 kB RAM. See the <url url="osi.html" name="Ohio Scientifc-specific documentation"> for instructions how to
+compile for other RAM sizes.
<sect1>Contributions wanted<p>
</descrip><p>
Example for building a program with start address $0300, stack size
-$0200 and RAM size $0200:
+$0200 and RAM size $2000:
<tscreen>
-cl65 --start-addr 0x300 -Wl -D,__HIMEM__=$2000,-D,__STACKSIZE__=$0300 -t osic1p hello.c
+cl65 --start-addr 0x300 -Wl -D,__HIMEM__=$2000,-D,__STACKSIZE__=$0200 -t osic1p hello.c
</tscreen>
<sect>Linker configurations<p>