summaryrefslogtreecommitdiffstats
path: root/hello_world_ada/README.ERC32
diff options
context:
space:
mode:
Diffstat (limited to 'hello_world_ada/README.ERC32')
-rw-r--r--hello_world_ada/README.ERC3288
1 files changed, 88 insertions, 0 deletions
diff --git a/hello_world_ada/README.ERC32 b/hello_world_ada/README.ERC32
new file mode 100644
index 0000000..d058c31
--- /dev/null
+++ b/hello_world_ada/README.ERC32
@@ -0,0 +1,88 @@
+
+In this directory, there are the following files:
+
+ Makefile - Example Makefile file
+ README - the file you are reading.
+ hello.adb - simple hello world file
+ init.c - RTEMS initialization thread which invokes the Ada main
+
+The following make stanza are included:
+
+ all - This stanza builds the executable hello.
+
+ run - This invokes the SPARC Instruction Simulator (SIS) on hello.
+
+ gdb - This invokes gdb with the integrated SPARC Instruction
+ Simulator (SIS) on hello.
+
+ clean - This stanza removes all generated files.
+
+The tool directory must be in your path for this to work.
+
+SAMPLE SESSION WITH SIS
+=======================
+
+The following is a sample session with sis:
+
+ $ gmake run
+ /home/joel/gnat-3.10b/sparc-rtems//bin/sis hello
+
+ SIS - SPARC intruction simulator 2.7.4, copyright Jiri Gaisler 1995
+ Bug-reports to jgais@wd.estec.esa.nl
+
+ loading hello:
+ section .text at 0x02000000 (159152 bytes)
+ section .data at 0x02026db0 (4384 bytes)
+ section .bss at 0x02027ed0 (30948 bytes)(not loaded)
+ serial port A on stdin/stdout
+ sis> go
+ resuming at 0x02000000
+ Hello World
+ IU in error mode (257)
+ 712144 02000800 91d02000 ta 0
+ sis> quit
+
+Note that the user typed "go" to start the executable and "quit" to
+exit the simulator. The normal exit message is "IU in error mode (257)"
+because the program exits by generating an unhandled trap.
+
+
+SAMPLE SESSION WITH GDB
+=======================
+
+The following is a sample session with sis:
+
+ $ gmake gdb
+ /home/joel/gnat-3.10b/sparc-rtems//bin/sis-gdb hello
+ GNU gdb 4.16.1a
+ Copyright 1996 Free Software Foundation, Inc.
+ GDB is free software, covered by the GNU General Public License, and you are
+ welcome to change it and/or distribute copies of it under certain conditions.
+ Type "show copying" to see the conditions.
+ There is absolutely no warranty for GDB. Type "show warranty" for details.
+ This GDB was configured as "--host=i486-linux --target=sparc-erc32-aout"...
+
+ SIS - SPARC instruction simulator 2.7.4
+ Bug-reports to Jiri Gaisler ESA/ESTEC (jgais@wd.estec.esa.nl)
+ serial port A on stdin/stdout
+ Connected to the simulator.
+ loading /usr1/rtems/work/tools_ada/example/hello:
+ section .text at 0x02000000 (159152 bytes)
+ section .data at 0x02026db0 (4384 bytes)
+ section .bss at 0x02027ed0 (30948 bytes)(not loaded)
+ (gdb) run
+ Starting program: /usr1/rtems/work/tools_ada/example/hello
+ Hello World
+
+ Program exited normally.
+ (gdb) quit
+
+Note that the user typed "run" to start the executable and "quit" to
+exit the debugger. Other gdb commands function the same as when gdb
+is used natively.
+
+The program "sis-gdb" is a script which always invokes a command file
+to initialize the simulator and load the executable into the simulator's
+memory.
+
+