Difference between revisions of "Using the Eclipse Terminal View"

From wiki.emacinc.com
Jump to: navigation, search
m (Connection Types: Fixed typos.)
 
(26 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{todo|Review|Klint Youngmeyer|project=oe 4,oe 5,ky,review, md}}
+
{{todo|SEOKWREV; (10.29.13-23:20->MD+);(11.08.13-19:30->MD+);(03.04.14-16:40->BS-);(03.24.14-17:00->BS+)|Klint Youngmeyer|project=oe 4,oe 5,ky,SEOKWREV,md,bs}}
  
 +
{{#seo:
 +
|title=Using the Eclipse Terminal View
 +
|titlemode=append
 +
|keywords=Eclipse Terminal,Terminal Connection,Connection Types,Utilizing the Terminal Connection
 +
|description=Using the Eclipse Terminal View.
 +
}}
 
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 connection including SSH, telnet, and serial. These connections can be established within any of the Eclipse Perspectives.  
 
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 connection including SSH, telnet, and serial. These connections can be established within any of the Eclipse Perspectives.  
  
Line 8: Line 14:
 
# 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.  
 
# 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.  
 
<br />
 
<br />
[[File:Eclipse_New_Terminal_View.png|center|frame|Figure 1: New Terminal View]]
+
 
 +
::[[File:Eclipse_New_Terminal_View.png|600px|thumb|left|Figure 1: New Terminal View]]
 +
<br clear=all>
  
 
== Establish a Terminal Connection ==
 
== Establish a Terminal Connection ==
Line 30: Line 38:
 
{{mbox | type = warning | text = EMAC recommends using SSH rather than Telnet on shared ethernet or wireless connections since the SSH encryption helps prevent the use of packet analysis to read passwords and data sent over the network. Telnet and other insecure protocols use no encryption, allowing any packet sniffing to intercept the password and login information. This guide covers the use of Telnet under the assumption that customers will not use it over a public network.}}<br />
 
{{mbox | type = warning | text = EMAC recommends using SSH rather than Telnet on shared ethernet or wireless connections since the SSH encryption helps prevent the use of packet analysis to read passwords and data sent over the network. Telnet and other insecure protocols use no encryption, allowing any packet sniffing to intercept the password and login information. This guide covers the use of Telnet under the assumption that customers will not use it over a public network.}}<br />
  
The first step for any of the three connection types is to initiate a New Terminal Connection dialog as [[#Establish a Terminal Connection|described above]]. Any of the three methods will produce the same result, the only difference being the name of the resulting dialog window.  
+
The first step for any of the three connection types is to initiate a New Terminal Connection dialog as [[#Establish a Terminal Connection|described above]]. Any of the three methods will produce the same result, with the only difference being the name of the resulting dialog window.  
  
 
=== SSH ===
 
=== SSH ===
Line 39: Line 47:
 
# 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.
 
# 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.
 
<br />
 
<br />
[[File:Eclipse_New_Terminal_Connection_Dialog.png|center|frame|Figure 2: SSH Connection Dialog]]
+
 
 +
::[[File:Eclipse_New_Terminal_Connection_Dialog.png|600px|thumb|left|Figure 2: SSH Connection Dialog]]
 +
<br clear=all>
  
 
=== Serial ===
 
=== Serial ===
Line 45: Line 55:
 
# Initiate a new terminal connection dialog as [[#Establish a Terminal Connection|described above]].
 
# Initiate a new terminal connection dialog as [[#Establish a Terminal Connection|described above]].
 
# Choose ''Serial'' from the ''Connection Type:'' drop-down menu.
 
# Choose ''Serial'' from the ''Connection Type:'' drop-down menu.
# Fill in the information for your target EMAC product according to the [[EMAC OE Getting Started Guide#Initial Connections|Initial Connections section of the EMAC OE Getting Started Guide]]. Settings may differ between systems.
+
# Fill in the information for your target EMAC product according to [[Serial_Connections#Serial_Terminal|Table 1 on the Serial Connections page]]. Settings may differ between systems.
 
<br />
 
<br />
[[File:Eclipse_New_Terminal_Serial_Connection_Dialog.png|center|frame|Figure 3: Serial Connection Dialog]]
+
 
 +
::[[File:Eclipse_New_Terminal_Serial_Connection_Dialog.png|600px|thumb|left|Figure 3: Serial Connection Dialog]]
 +
<br clear=all>
  
 
=== Telnet ===
 
=== Telnet ===
Line 55: Line 67:
 
# Specify the target board's IP address or hostname in the ''Host:'' field.
 
# Specify the target board's IP address or hostname in the ''Host:'' field.
 
<br />
 
<br />
[[File:Eclipse_New_Terminal_Connection_Dialog_Telnet.png|center|frame|Figure 4: Telnet Connection Dialog]]
+
 
 +
::[[File:Eclipse_New_Terminal_Connection_Dialog_Telnet.png|600px|thumb|left|Figure 4: Telnet Connection Dialog]]
 +
<br clear=all>
  
 
== Utilizing the Terminal Connection ==
 
== Utilizing the Terminal Connection ==
Line 61: Line 75:
  
  
[[File:Eclipse_Open_Terminal_Login_Cmd.png|center|frame|Figure 5: Open Terminal Connection]]
+
::[[File:Eclipse_Open_Terminal_Login_Cmd.png|600px|thumb|left|Figure 5: Open Terminal Connection]]
 +
<br clear=all>
  
 
== Next Steps ==
 
== Next Steps ==
Line 67: Line 82:
  
 
<!--== See Also ==
 
<!--== See Also ==
* [[EMAC Eclipse Introduction|Introduction]]
+
* [[Eclipse Introduction|Introduction]]
* [[Installing EMAC Eclipse|Installation]]
+
* [[Installing Eclipse|Installation]]
* [[Configuring EMAC Eclipse|Configuration]]
+
* [[Configuring Eclipse|Configuration]]
* [[First Time Starting EMAC Eclipse]]
+
* [[First Time Starting Eclipse]]
 
* [[Using the Eclipse Terminal View]]
 
* [[Using the Eclipse Terminal View]]
 
* [[Importing the EMAC OE SDK Projects with Eclipse|Importing EMAC OE SDK Projects]]
 
* [[Importing the EMAC OE SDK Projects with Eclipse|Importing EMAC OE SDK Projects]]
 
* [[Using the EMAC OE SDK Projects with Eclipse|Using the EMAC OE SDK Projects]]
 
* [[Using the EMAC OE SDK Projects with Eclipse|Using the EMAC OE SDK Projects]]
* [[Creating New Projects with EMAC Eclipse|Creating New Projects]]
+
* [[Creating New Projects with Eclipse|Creating New Projects]]
* [[Remote System Explorer Configuration for EMAC Eclipse|Remote System Explorer Configuration]]
+
* [[Remote System Explorer Configuration for Eclipse|Remote System Explorer Configuration]]
** [[Remote System Explorer Setup for EMAC Eclipse|RSE Setup]]
+
** [[Remote System Explorer Setup for Eclipse|RSE Setup]]
** [[Remote System Explorer SFTP Setup for EMAC Eclipse|RSE SFTP Setup]]
+
** [[Remote System Explorer SFTP Setup for Eclipse|RSE SFTP Setup]]
 
** [[Remote System Explorer Shell and Terminal Setup|Remote Shell and Terminal Setup]]
 
** [[Remote System Explorer Shell and Terminal Setup|Remote Shell and Terminal Setup]]
* [[Executing Remote Applications with EMAC Eclipse|Executing Remote Applications]]
+
* [[Executing Remote Applications with Eclipse|Executing Remote Applications]]
* [[Debugging Remote Applications with EMAC Eclipse|Debugging Remote Applications]]-->
+
* [[Debugging Remote Applications with Eclipse|Debugging Remote Applications]]-->
  
[[Category:EMAC Eclipse]]
+
<!--[[Category:Eclipse]]-->

Latest revision as of 17:02, 24 March 2014

TODO: {{#todo:SEOKWREV; (10.29.13-23:20->MD+);(11.08.13-19:30->MD+);(03.04.14-16:40->BS-);(03.24.14-17:00->BS+)|Klint Youngmeyer|oe 4,oe 5,ky,SEOKWREV,md,bs}}

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 connection 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, Terminal View Connect Icon.
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, Terminal View Settings Icon.
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, Terminal View New Terminal Icon.
To move between the connections, use the Display Selected Connections button, Terminal View Switch Connections Icon.

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, with 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 Table 1 on the Serial Connections page. 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.