Using the Eclipse Terminal View

TODO: {{#todo:Review; (10.29.13-23:20->MD+)|Klint Youngmeyer|oe 4,oe 5,ky,FinalDraft, md}}

The EMAC distribution of Eclipse includes a terminal view plugin which allows the developer to connect to a remote machine from within Eclipse. This feature supports multiple types of connections including SSH, telnet and serial. These connections can be established within any of the Eclipse Perspectives.

Open the Eclipse Terminal View

To open the Eclipse Terminal View from within any Perspective:

1. Click Window → Show View → Other to open the Show View dialog.
2. Select Terminal → Terminal then click OK in the Show View dialog. See Figure 1 below for an example of a newly-opened Terminal View, outlined in red. The example assumes that the View is opened from within the default C/C++ Perspective.

Figure 1: New Terminal View

Establish a Terminal Connection

There are three ways to establish a terminal connection: new connection, change settings (for the current connection), and new terminal connection. Each of these methods is described in detail below.

New Connection

This method creates a new connection. This can only be used when no connection is currently established. To create a new connection this way use the Connect button, .

Change Settings

When you change the settings for the current connection the current connection will automatically switch over to the new settings. To change the current connection this way use the Settings button, .

New Terminal Connection

When you create a New Terminal Connection, you keep the existing connection(s) and add a new one. This new connection will show up within the same Terminal View as the existing connection(s). To create a new terminal connection this way, use the New Terminal button, .
To move between the connections, use the Display Selected Connections button, .

Connection Types

This section uses any of the three methods listed in the previous section to establish a Terminal Connection through the following three remote connection types:

• SSH - Secure Shell provides encrypted communications over TCP/IP networks.
• Serial - Transfers data over a serial cable, typically through an RS-232 port.
• Telnet - Transfers data over a TCP/IP network in plain text format.

The first step for any of the three connection types is to initiate a New Terminal Connection dialog as described above. Any of the three methods will produce the same result, the only difference being the name of the resulting dialog window.

SSH

SSH, or Secure Shell, is a protocol by which encrypted data is exchanged between two applications over a network connection. From the Eclipse Terminal View, SSH can be used to send commands to and receive output from a remote machine. The following procedure references Figure 2 to configure SSH settings:

1. Initiate a new terminal connection dialog as described above.
2. Choose SSH from the Connection Type: drop-down menu.
3. Enter the target machine's IP address or hostname in the Host: text field.
4. Enter one of the target machine's user names in the User: text field and the associated password in the Password: text field. The default username and password for EMAC products are root and emac_inc, respectively.

Figure 2: SSH Connection Dialog

Serial

Many EMAC products have a serial port available for accessing a login terminal. Refer to the documentation for your specific hardware to determine the appropriate settings. The following procedure references Figure 3 to configure Serial settings:

1. Initiate a new terminal connection dialog as described above.
2. Choose Serial from the Connection Type: drop-down menu.
3. Fill in the information for your target EMAC product according to the Initial Connections section of the EMAC OE Getting Started Guide. Settings may differ between systems.

Figure 3: Serial Connection Dialog

Telnet

While not recommended by EMAC, it is possible to establish a Telnet session over a network connection between the development and the target machines. This setup is similar to that used for SSH, except the username and password are passed to the target machine in plaintext form after the Telnet session has been initiated. Figure 4 below demonstrates the settings dialog for establishing a Telnet session.

1. Initiate a new terminal connection dialog as described above.
2. Choose Telnet from the Connection Type: drop-down menu.
3. Specify the target board's IP address or hostname in the Host: field.

Figure 4: Telnet Connection Dialog

Utilizing the Terminal Connection

After establishing a terminal connection using one of the methods described above, the terminal view will be connected to a shell on the remote system. You may enter commands directly in the terminal view window in Eclipse. Figure 5 below demonstrates an open terminal serial terminal connection after logging in to the target board.

Figure 5: Open Terminal Connection

Next Steps

Once a Terminal Connection has been established with the target machine, use that connection to interact with the board while working with the EMAC SDK projects.