1 | @c |
---|
2 | @c COPYRIGHT (c) 1988-1999. |
---|
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 | |
---|
11 | @section Unpack the Sample Application |
---|
12 | |
---|
13 | Use the following command to unarchive the sample application: |
---|
14 | |
---|
15 | @example |
---|
16 | cd tools |
---|
17 | tar xzf ../archive/hello_world_ada.tgz |
---|
18 | @end example |
---|
19 | |
---|
20 | @section Create a BSP Specific Makefile |
---|
21 | |
---|
22 | Provided are example Makefiles for multiple BSPs. Copy one of these to |
---|
23 | the file Makefile.<BOARD_SUPPORT_PACKAGE> and edit it as appropriate for |
---|
24 | your local configuration. |
---|
25 | |
---|
26 | Use the <INSTALLATION_POINT> and <BOARD_SUPPORT_PACKAGE> specified when |
---|
27 | configuring and installing RTEMS. |
---|
28 | |
---|
29 | @section Build the Sample Application |
---|
30 | |
---|
31 | Use the following command to start the build of the sample application: |
---|
32 | |
---|
33 | @example |
---|
34 | cd tools/hello_world_ada |
---|
35 | make -f Makefile.<BOARD_SUPPORT_PACKAGE> |
---|
36 | @end example |
---|
37 | |
---|
38 | NOTE: GNU make is the preferred @code{make} utility. Other @code{make} |
---|
39 | implementations may work but all testing is done with GNU make. |
---|
40 | |
---|
41 | If the BSP specific modifications to the Makefile were correct and |
---|
42 | no errors are detected during the sample application build, it is |
---|
43 | reasonable to assume that the build of the GNAT/RTEMS Cross Compiler Tools |
---|
44 | for RTEMS and RTEMS itself for the selected host and target |
---|
45 | combination was done properly. |
---|
46 | |
---|
47 | @section Application Executable |
---|
48 | |
---|
49 | If the sample application has successfully been build, then the application |
---|
50 | executable is placed in the following directory: |
---|
51 | |
---|
52 | @example |
---|
53 | tools/hello_world_ada/o-optimize/<filename>.exe |
---|
54 | @end example |
---|
55 | |
---|
56 | How this executable is downloaded to the target board is very dependent |
---|
57 | on the BOARD_SUPPORT_PACKAGE selected. |
---|