[417fcc73] | 1 | @c |
---|
[0660b4f8] | 2 | @c COPYRIGHT (c) 1988-1999. |
---|
[417fcc73] | 3 | @c On-Line Applications Research Corporation (OAR). |
---|
| 4 | @c All rights reserved. |
---|
| 5 | @c |
---|
| 6 | @c $Id$ |
---|
| 7 | @c |
---|
| 8 | |
---|
| 9 | @chapter Building the Sample Application |
---|
| 10 | |
---|
[57a736ff] | 11 | @section Unpack the Sample Application |
---|
[417fcc73] | 12 | |
---|
| 13 | Use the following command to unarchive the sample application: |
---|
| 14 | |
---|
| 15 | @example |
---|
| 16 | cd tools |
---|
[ae2e9f2] | 17 | tar xzf ../archive/hello_world_c.tgz |
---|
[417fcc73] | 18 | @end example |
---|
| 19 | |
---|
[57a736ff] | 20 | @section Set the Environment Variable RTEMS_MAKEFILE_PATH |
---|
[417fcc73] | 21 | |
---|
| 22 | It must point to the appropriate directory containing RTEMS build for our |
---|
| 23 | target and board support package combination. |
---|
| 24 | |
---|
| 25 | @example |
---|
| 26 | export RTEMS_MAKEFILE_PATH = \ |
---|
| 27 | <INSTALLATION_POINT>/rtems/<BOARD_SUPPORT_PACKAGE> |
---|
| 28 | @end example |
---|
| 29 | |
---|
[57a736ff] | 30 | Where <INSTALLATION_POINT> and <BOARD_SUPPORT_PACKAGE> are those used when |
---|
[bdec2709] | 31 | configuring and installing RTEMS. |
---|
[417fcc73] | 32 | |
---|
| 33 | @section Build the Sample Application |
---|
| 34 | |
---|
| 35 | Use the following command to start the build of the sample application: |
---|
| 36 | |
---|
| 37 | @example |
---|
[bdec2709] | 38 | cd tools/hello_world_c |
---|
[417fcc73] | 39 | gmake |
---|
| 40 | @end example |
---|
| 41 | |
---|
| 42 | If no errors are detected during the sample application build, it is |
---|
| 43 | reasonable to assume that the build of the GNU C/C++ Cross Compiler Tools |
---|
[bdec2709] | 44 | for RTEMS and RTEMS itself for the selected host and target |
---|
[417fcc73] | 45 | combination was done properly. |
---|
| 46 | |
---|
[57a736ff] | 47 | @section Application Executable |
---|
[417fcc73] | 48 | |
---|
[bdec2709] | 49 | If the sample application has successfully been build, then the application |
---|
[417fcc73] | 50 | executable is placed in the following directory: |
---|
| 51 | |
---|
| 52 | @example |
---|
[57a736ff] | 53 | tools/hello_world_c/o-<BOARD_SUPPORT_PACKAGE>/<filename>.exe |
---|
[417fcc73] | 54 | @end example |
---|
| 55 | |
---|
[bdec2709] | 56 | How this executable is downloaded to the target board is very dependent |
---|
| 57 | on the BOARD_SUPPORT_PACKAGE selected. |
---|