Difference between revisions of "Using the Eclipse Terminal View"

From wiki.emacinc.com
Jump to: navigation, search
m (Reassigned)
 
(32 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{todo|Polish this|Klint Youngmeyer|project=oe 4,oe 5,ky}}
+
{{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.  
  
 
== Open the Eclipse Terminal View ==
 
== Open the Eclipse Terminal View ==
 
To open the Eclipse Terminal View from within any Perspective:
 
To open the Eclipse Terminal View from within any Perspective:
# Click ''Window -> Show View -> Other'' to open the Show View dialog.
+
# Click ''Window Show View Other'' to open the Show View dialog.
# 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. [[File:Eclipse_New_Terminal_View.png|center|frame|Figure 1: New Terminal View]]
+
# 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 />
 +
 
 +
::[[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 19: Line 29:
 
; New Terminal Connection
 
; 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, [[File:Terminal_View_New_Terminal_Connection_Icon.png|Terminal View New Terminal Icon]]. <br> To move between the connections, use the ''Display Selected Connections'' button, [[File:Terminal_View_Switch_Connection_Icon.png|Terminal View Switch Connections Icon]].
 
: 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, [[File:Terminal_View_New_Terminal_Connection_Icon.png|Terminal View New Terminal Icon]]. <br> To move between the connections, use the ''Display Selected Connections'' button, [[File:Terminal_View_Switch_Connection_Icon.png|Terminal View Switch Connections Icon]].
 
=== Working with Connections ===
 
The next section describes the different connection types that are available when using one of these three methods to establish a Terminal Connection.
 
  
 
== Connection Types ==
 
== Connection Types ==
This guide covers three different remote 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.
 
* SSH - Secure Shell provides encrypted communications over TCP/IP networks.
 
* Serial - Transfers data over a serial cable, typically through an RS-232 port.
 
* 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.
 
* Telnet - Transfers data over a TCP/IP network in plain text format.
 +
<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 />
  
{{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.}}
+
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.  
 
 
The first step for any of the three connections 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.  
 
  
 
=== SSH ===
 
=== SSH ===
Line 39: Line 46:
 
# Enter the target machine's IP address or hostname in the ''Host:'' text field.
 
# Enter the target machine's IP address or hostname in the ''Host:'' text field.
 
# 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 />
  
[[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 46: 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 />
  
[[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 66:
 
# Choose ''Telnet'' from the ''Connection Type:'' drop-down menu.
 
# Choose ''Telnet'' from the ''Connection Type:'' drop-down menu.
 
# 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 />
  
[[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 ==
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.
+
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.<br />
  
[[File:Eclipse_Open_Terminal_Login_Cmd.png|center|frame|Figure 4: 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 ==
 
Once a Terminal Connection has been established with the target machine, use that connection to interact with the board while working with the [[Importing the EMAC OE SDK Projects with Eclipse|EMAC SDK projects]].
 
Once a Terminal Connection has been established with the target machine, use that connection to interact with the board while working with the [[Importing the EMAC OE SDK Projects with Eclipse|EMAC SDK projects]].
  
[[Category:EMAC Eclipse]]
+
<!--== See Also ==
 +
* [[Eclipse Introduction|Introduction]]
 +
* [[Installing Eclipse|Installation]]
 +
* [[Configuring Eclipse|Configuration]]
 +
* [[First Time Starting Eclipse]]
 +
* [[Using the Eclipse Terminal View]]
 +
* [[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]]
 +
* [[Creating New Projects with Eclipse|Creating New Projects]]
 +
* [[Remote System Explorer Configuration for Eclipse|Remote System Explorer Configuration]]
 +
** [[Remote System Explorer Setup for Eclipse|RSE Setup]]
 +
** [[Remote System Explorer SFTP Setup for Eclipse|RSE SFTP Setup]]
 +
** [[Remote System Explorer Shell and Terminal Setup|Remote Shell and Terminal Setup]]
 +
* [[Executing Remote Applications with Eclipse|Executing Remote Applications]]
 +
* [[Debugging Remote Applications with Eclipse|Debugging Remote Applications]]-->
 +
 
 +
<!--[[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.