forked from Imagelibrary/rtems
Mostly correcting case of section headings although a few minor things
were corrected as the Getting Started with GNAT/RTEMS manual was created.
This commit is contained in:
@@ -50,7 +50,7 @@ intro.texi: intro.t versions.texi
|
|||||||
-n "Requirements" ${*}.t
|
-n "Requirements" ${*}.t
|
||||||
|
|
||||||
require.texi: require.t versions.texi
|
require.texi: require.t versions.texi
|
||||||
$(BMENU) -c -p "Introduction" \
|
$(BMENU) -c -p "Cross Development" \
|
||||||
-u "Top" \
|
-u "Top" \
|
||||||
-n "Building the GNU C/C++ Cross Compiler Toolset" ${*}.t
|
-n "Building the GNU C/C++ Cross Compiler Toolset" ${*}.t
|
||||||
|
|
||||||
@@ -65,12 +65,12 @@ buildrt.texi: buildrt.t versions.texi
|
|||||||
-n "Building the Sample Application" ${*}.t
|
-n "Building the Sample Application" ${*}.t
|
||||||
|
|
||||||
sample.texi: sample.t versions.texi
|
sample.texi: sample.t versions.texi
|
||||||
$(BMENU) -c -p "Generate RTEMS for a specific target and board support package" \
|
$(BMENU) -c -p "Generate RTEMS for a Specific Target and Board Support Package" \
|
||||||
-u "Top" \
|
-u "Top" \
|
||||||
-n "Building the GNU Debugger" ${*}.t
|
-n "Building the GNU Debugger" ${*}.t
|
||||||
|
|
||||||
gdb.texi: gdb.t versions.texi
|
gdb.texi: gdb.t versions.texi
|
||||||
$(BMENU) -c -p "Application executable" \
|
$(BMENU) -c -p "Application Executable" \
|
||||||
-u "Top" \
|
-u "Top" \
|
||||||
-n "" ${*}.t
|
-n "" ${*}.t
|
||||||
|
|
||||||
|
|||||||
@@ -13,13 +13,15 @@ source code for a GNU cross compiler toolset, apply
|
|||||||
any required RTEMS specific patches, compile that
|
any required RTEMS specific patches, compile that
|
||||||
toolset and install it.
|
toolset and install it.
|
||||||
|
|
||||||
@section Get all the pieces
|
@section Directory Organization
|
||||||
|
|
||||||
The tree structure in the figure below is assumed to be present in the
|
The tree structure in the figure below is assumed to be present in the
|
||||||
following discussions:
|
following discussions:
|
||||||
|
|
||||||
@center @b{XXX directory tree figure goes here}
|
@center @b{XXX directory tree figure goes here}
|
||||||
|
|
||||||
|
@section Get All the Pieces
|
||||||
|
|
||||||
Gather the components that will be required for the installation and place
|
Gather the components that will be required for the installation and place
|
||||||
them in an archive directory. Call this directory arc. Be sure that there
|
them in an archive directory. Call this directory arc. Be sure that there
|
||||||
is sufficient space to hold all necessary information. This will amount to
|
is sufficient space to hold all necessary information. This will amount to
|
||||||
@@ -52,14 +54,20 @@ approximately 20 megabytes.
|
|||||||
Directory: @value{RTEMS-FTPDIR}
|
Directory: @value{RTEMS-FTPDIR}
|
||||||
File: @value{RTEMS-TAR}
|
File: @value{RTEMS-TAR}
|
||||||
File: bit
|
File: bit
|
||||||
|
@ifset BINUTILS-RTEMSPATCH
|
||||||
File: @value{BINUTILS-RTEMSPATCH}
|
File: @value{BINUTILS-RTEMSPATCH}
|
||||||
|
@end ifset
|
||||||
|
@ifset NEWLIB-RTEMSPATCH
|
||||||
File: @value{NEWLIB-RTEMSPATCH}
|
File: @value{NEWLIB-RTEMSPATCH}
|
||||||
|
@end ifset
|
||||||
|
@ifset GCC-RTEMSPATCH
|
||||||
File: @value{GCC-RTEMSPATCH}
|
File: @value{GCC-RTEMSPATCH}
|
||||||
|
@end ifset
|
||||||
File: hello_world_c.tgz
|
File: hello_world_c.tgz
|
||||||
@end example
|
@end example
|
||||||
|
|
||||||
|
|
||||||
@section Create the tools directory
|
@section Create the tools Directory
|
||||||
|
|
||||||
Create a directory called tools that will serve as a working directory to
|
Create a directory called tools that will serve as a working directory to
|
||||||
perform the build of the cross compiler tools.
|
perform the build of the cross compiler tools.
|
||||||
|
|||||||
@@ -9,7 +9,7 @@
|
|||||||
|
|
||||||
@chapter Building RTEMS
|
@chapter Building RTEMS
|
||||||
|
|
||||||
@section Unpack the RTEMS source
|
@section Unpack the RTEMS Source
|
||||||
|
|
||||||
Use the following command sequence to unpack the RTEMS source into the
|
Use the following command sequence to unpack the RTEMS source into the
|
||||||
tools directory:
|
tools directory:
|
||||||
@@ -19,7 +19,7 @@ cd tools
|
|||||||
tar xzf ../arc/@value{RTEMS-TAR}
|
tar xzf ../arc/@value{RTEMS-TAR}
|
||||||
@end example
|
@end example
|
||||||
|
|
||||||
@section Add the bin directory under the install point to the default PATH
|
@section Add <INSTALL_POINT>/bin to Executable PATH
|
||||||
|
|
||||||
In order to compile RTEMS, you must have the cross compilation toolset
|
In order to compile RTEMS, you must have the cross compilation toolset
|
||||||
in your search patch. The following command appends the directory
|
in your search patch. The following command appends the directory
|
||||||
@@ -33,7 +33,7 @@ NOTE: The above command is in Bourne shell (@code{sh}) syntax and should work w
|
|||||||
the Korn (@code{ksh}) and GNU Bourne Again Shell (@code{bash}). It will not
|
the Korn (@code{ksh}) and GNU Bourne Again Shell (@code{bash}). It will not
|
||||||
work with the C Shell (@code{csh})or derivatives of the C Shell.
|
work with the C Shell (@code{csh})or derivatives of the C Shell.
|
||||||
|
|
||||||
@section Generate RTEMS for a specific target and board support package
|
@section Generate RTEMS for a Specific Target and BSP
|
||||||
|
|
||||||
Make a build directory under tools and build the RTEMS product in this
|
Make a build directory under tools and build the RTEMS product in this
|
||||||
directory. The ../@value{RTEMS-UNTAR}/configure
|
directory. The ../@value{RTEMS-UNTAR}/configure
|
||||||
@@ -58,9 +58,7 @@ cd build-rtems
|
|||||||
gmake all install
|
gmake all install
|
||||||
@end example
|
@end example
|
||||||
|
|
||||||
Where:
|
Where the list of currently supported of <TARGET_CONFIGURATION>'s and
|
||||||
|
|
||||||
The list of currently supported of <TARGET_CONFIGURATION>'s and
|
|
||||||
<BOARD_SUPPORT_PACKAGE>'s can be found in
|
<BOARD_SUPPORT_PACKAGE>'s can be found in
|
||||||
tools/@value{RTEMS-UNTAR}/README.configure.
|
tools/@value{RTEMS-UNTAR}/README.configure.
|
||||||
|
|
||||||
|
|||||||
@@ -20,7 +20,7 @@ successfully used with RTEMS applications:
|
|||||||
Other configurations of gdb have successfully been used by RTEMS users
|
Other configurations of gdb have successfully been used by RTEMS users
|
||||||
but are not documented here.
|
but are not documented here.
|
||||||
|
|
||||||
@section Unarchive the gdb distribution
|
@section Unarchive the gdb Distribution
|
||||||
|
|
||||||
Use the following commands to unarchive the gdb distribution:
|
Use the following commands to unarchive the gdb distribution:
|
||||||
|
|
||||||
@@ -76,7 +76,7 @@ The files that are found, have been modified by the patch file.
|
|||||||
|
|
||||||
@section GDB with Sparc Instruction Simulation (SIS)
|
@section GDB with Sparc Instruction Simulation (SIS)
|
||||||
|
|
||||||
@subheading Make the build directory
|
@subheading Make the Build Directory
|
||||||
|
|
||||||
Create a build directory for the SIS Debugger
|
Create a build directory for the SIS Debugger
|
||||||
|
|
||||||
@@ -85,7 +85,7 @@ cd tools
|
|||||||
mkdir build-sis
|
mkdir build-sis
|
||||||
@end example
|
@end example
|
||||||
|
|
||||||
@subheading Configure for the build
|
@subheading Configure for the Build
|
||||||
|
|
||||||
Configure the GNU Debugger for the
|
Configure the GNU Debugger for the
|
||||||
Sparc Instruction Simulator (SIS):
|
Sparc Instruction Simulator (SIS):
|
||||||
@@ -102,7 +102,7 @@ cd tools/build-sis
|
|||||||
Where <INSTALL_POINT_FOR_SIS> is a unique location where the gdb
|
Where <INSTALL_POINT_FOR_SIS> is a unique location where the gdb
|
||||||
with SIS will be created.
|
with SIS will be created.
|
||||||
|
|
||||||
@subheading Make the debugger
|
@subheading Make the Debugger
|
||||||
|
|
||||||
From tools/build-sis execute the following command sequence:
|
From tools/build-sis execute the following command sequence:
|
||||||
|
|
||||||
@@ -113,7 +113,7 @@ gmake all install
|
|||||||
|
|
||||||
@section GDB with PowerPC Instruction Simulator
|
@section GDB with PowerPC Instruction Simulator
|
||||||
|
|
||||||
@subheading Make the build directory
|
@subheading Make the Build Directory
|
||||||
|
|
||||||
Create a build directory for the SIS Debugger
|
Create a build directory for the SIS Debugger
|
||||||
|
|
||||||
@@ -122,7 +122,7 @@ cd tools
|
|||||||
mkdir build-ppc
|
mkdir build-ppc
|
||||||
@end example
|
@end example
|
||||||
|
|
||||||
@subheading Configure for the build
|
@subheading Configure for the Build
|
||||||
|
|
||||||
Configure the GNU Debugger for the PowerPC
|
Configure the GNU Debugger for the PowerPC
|
||||||
Instruction Simulator (PSIM):
|
Instruction Simulator (PSIM):
|
||||||
@@ -144,7 +144,7 @@ Where <INSTALL_POINT_FOR_PPC> is a unique location where the gdb
|
|||||||
with PSIM will be created.
|
with PSIM will be created.
|
||||||
|
|
||||||
|
|
||||||
@subheading Make the debugger
|
@subheading Make the Debugger
|
||||||
|
|
||||||
From tools/build-ppc execute the following command sequence:
|
From tools/build-ppc execute the following command sequence:
|
||||||
|
|
||||||
@@ -155,11 +155,7 @@ gmake all install
|
|||||||
|
|
||||||
@section GDB for DINK32
|
@section GDB for DINK32
|
||||||
|
|
||||||
@subheading Unarchive the gdb distribution
|
@subheading Make the Build Directory
|
||||||
|
|
||||||
Use the following commands to unarchive the gdb distribution:
|
|
||||||
|
|
||||||
@subheading Make the build directory
|
|
||||||
|
|
||||||
Create a build directory for the DINK32 Debugger
|
Create a build directory for the DINK32 Debugger
|
||||||
|
|
||||||
@@ -168,7 +164,7 @@ cd tools
|
|||||||
mkdir build-dink32
|
mkdir build-dink32
|
||||||
@end example
|
@end example
|
||||||
|
|
||||||
@subheading Configure for the build
|
@subheading Configure for the Build
|
||||||
|
|
||||||
Configure the GNU Debugger to communicate with
|
Configure the GNU Debugger to communicate with
|
||||||
the DINK32 ROM monitor:
|
the DINK32 ROM monitor:
|
||||||
@@ -184,7 +180,7 @@ cd tools/build-dink32
|
|||||||
Where <INSTALL_POINT_FOR_DINK32> is a unique location where the
|
Where <INSTALL_POINT_FOR_DINK32> is a unique location where the
|
||||||
gdb Dink32 will be created.
|
gdb Dink32 will be created.
|
||||||
|
|
||||||
@subheading Make the debugger
|
@subheading Make the Debugger
|
||||||
|
|
||||||
From tools/build-dink32 execute the following command sequence:
|
From tools/build-dink32 execute the following command sequence:
|
||||||
|
|
||||||
|
|||||||
@@ -8,7 +8,7 @@
|
|||||||
|
|
||||||
@chapter Building the Sample Application
|
@chapter Building the Sample Application
|
||||||
|
|
||||||
@section Unpack the sample application
|
@section Unpack the Sample Application
|
||||||
|
|
||||||
Use the following command to unarchive the sample application:
|
Use the following command to unarchive the sample application:
|
||||||
|
|
||||||
@@ -17,7 +17,7 @@ cd tools
|
|||||||
tar xzf ../arc/hello_world_c.tgz
|
tar xzf ../arc/hello_world_c.tgz
|
||||||
@end example
|
@end example
|
||||||
|
|
||||||
@section Set the environment variable RTEMS_MAKEFILE_PATH
|
@section Set the Environment Variable RTEMS_MAKEFILE_PATH
|
||||||
|
|
||||||
It must point to the appropriate directory containing RTEMS build for our
|
It must point to the appropriate directory containing RTEMS build for our
|
||||||
target and board support package combination.
|
target and board support package combination.
|
||||||
@@ -27,9 +27,7 @@ export RTEMS_MAKEFILE_PATH = \
|
|||||||
<INSTALLATION_POINT>/rtems/<BOARD_SUPPORT_PACKAGE>
|
<INSTALLATION_POINT>/rtems/<BOARD_SUPPORT_PACKAGE>
|
||||||
@end example
|
@end example
|
||||||
|
|
||||||
Where:
|
Where <INSTALLATION_POINT> and <BOARD_SUPPORT_PACKAGE> are those used when
|
||||||
|
|
||||||
<INSTALLATION_POINT> and <BOARD_SUPPORT_PACKAGE> are those used when
|
|
||||||
configuring and installing RTEMS.
|
configuring and installing RTEMS.
|
||||||
|
|
||||||
@section Build the Sample Application
|
@section Build the Sample Application
|
||||||
@@ -46,13 +44,13 @@ reasonable to assume that the build of the GNU C/C++ Cross Compiler Tools
|
|||||||
for RTEMS and RTEMS itself for the selected host and target
|
for RTEMS and RTEMS itself for the selected host and target
|
||||||
combination was done properly.
|
combination was done properly.
|
||||||
|
|
||||||
@section Application executable
|
@section Application Executable
|
||||||
|
|
||||||
If the sample application has successfully been build, then the application
|
If the sample application has successfully been build, then the application
|
||||||
executable is placed in the following directory:
|
executable is placed in the following directory:
|
||||||
|
|
||||||
@example
|
@example
|
||||||
tools/simple_app/o-<BOARD_SUPPORT_PACKAGE>/<filename>.exe
|
tools/hello_world_c/o-<BOARD_SUPPORT_PACKAGE>/<filename>.exe
|
||||||
@end example
|
@end example
|
||||||
|
|
||||||
How this executable is downloaded to the target board is very dependent
|
How this executable is downloaded to the target board is very dependent
|
||||||
|
|||||||
Reference in New Issue
Block a user