Configuring EMAC OE 4.0 SDK

TODO: {{#todo:Fix and finish; default password is not emac_inc_90210|Michael Gloff|oe 4,oe 5,mg}}

Table 1: Conventions
/download/directory/	The directory to which the SDK archive will be downloaded.
/path/to/sdk/	The directory to which the SDK will be extracted.
EMAC-OE-arm-linux-gnueabi-SDK_XX.YY.rZZ.tar.bz2 EMAC-OE-arm-linux-gnueabi-SDK_XX.YY	XX - the SDK major version YY - the SDK minor version ZZ - the SDK current revision
target_program	The program executable created to run on the target device.
developer@ldc:~$	Prompt and commands to be run on a development machine that will run compliation tasks.
root@emac-oe:~#	Prompt and commands to be run on a target machine.

When Eclipse generates a Makefile to use for building a project, the generated Makefile includes a file named global.properties before it performs any other steps. This file is located in the projects directory, which is the root directory for Eclipse projects. The projects directory is located within the EMAC SDK directory provided by the EMAC SDK package (or installed on the LDC).

The global.properties file provides information needed to build projects and upload them to the target machine (the board supplied by EMAC). The following information is provided by this file:

Configuration variable	Description
SDKBASE	The base directory for the SDK .
CC, CXX	Exectuable binaries to use for compiling for the C and C++ compiler, respectively.
LD_LIBRARY_PATH	The path the linker should use to search for shared library files.
CFLAGS	The flags passed to the compiler to specify target processor architecture, debugging flags, etc.
OFLAGS	The flags passed to the compiler to specify optimization options to use.
TARGET_IP	The IP Address of the target machine (needed for uploading the compiled binary to the target machine).
LOGIN	The user name to use for logging into the target machine.
PASSWORD	The password to use for logging into the target machine.*
WPUT	The location of the wput command, along with options to pass to wput.

*NOTE The password is stored in plain text in this file. However, read permission is required to view this password. In most development environments, this should not be an issue. If development is taking place in a shared environment (such as a University lab) and secrecy of this password is required, simply ensure that only trusted users have read permission for this file.

The global.properties file is actually a type of virtual file, called a softlink. This softlink acts as a pointer which points to another file. The file it points to is chosen when the CPU architecture is chosen. To see why it works this way, see the above information about the flags specified for the processor architecture, and note that different library and compiler paths may be required to support different hardware. The softlink is updated when the hardware to use for the development project is selected.

Configuration Steps

The following configuration steps are necessary to begin using the EMAC OE SDK.

Before cross-compiling source code on the development machine for the target machine:

• A set up script linking global.properties to an architecture-specific global.properties file must be run.
• The TARGET_IP variable in the global.properties file must be changed to the IP address or hostname belonging to the target board.

SDK Set Up Script

Before compiling source code for the target machine, toolchain libraries for the target machine must be specified by running setmachine.sh.

Procedure

1. Navigate to the SDK directory.

   developer@ldc:~$ cd /path/to/sdk/EMAC-OE-arm-linux-gnueabi-SDK_XX.YY/
   

2. Run the script using the command shown below to produce a menu as shown in Figure 1 with options for the target machine for which the source will be compiled.

   developer@ldc:~$ ./setmachine.sh
   

Remote Upload Set-up

In the global.properties file there is a variable, IP which must be set to the target board IP address as shown in Listing 1 below. This step is necessary to ensure that the Make target, 'upload' will work as expected.

Procedure

1. Navigate to the projects directory within the SDK.

   developer@ldc:~$ cd /path/to/sdk/EMAC-OE-arm-linux-gnueabi-SDK_XX.YY/projects
   

2. The global.properties file should be listed in the current directory. The relevant lines from global.properties are shown in Listing 1 below. Listing 1. global.properties snippet

   TARGET_IP=
   LOGIN=root
   PASSWORD=emac_inc_90210
   

3. Change the value of TARGET_IP to the target system's IP address. This can be found using the following command from a shell on the target system:

   root@emac-oe:~# /sbin/ifconfig eth0 | grep inet
   

   For more information on how to connect to the remote system, see the initial connections of the EMAC OE Getting Started Guide.

4. Change the value of PASSWORD to whatever value was set in the system login of the EMAC OE Getting Started Guide. Listing 1 shows the default user name and password.