ARM DS-5 Getting Started with DS-5: Using an SSH connection to set up and run Gnometris on an ARM Linux target

Using an SSH connection to set up and run Gnometris on an ARM Linux target

On some targets you can use a Secure SHell (SSH) connection with the Remote System Explorer (RSE) provided with DS-5.

To set up a Linux SSH connection to an ARM Linux target and run the Gnometris application:

Add the Remote Systems view to the DS-5 Debug perspective:
1. Ensure that you are in the DS-5 perspective. To change perspective either use the perspective toolbar or select Window → Open perspective → DS-5 Debug from the main menu.
2. Select Window → Show View → Other... to open the Show View dialog box.
3. Select the Remote Systems view in the Remote Systems group.
4. Click OK.
In the Remote Systems view, set up a Linux connection to a remote target using SSH:
1. Click on Define a connection to remote system in the Remote Systems view toolbar.
2. In the Select Remote System Type dialog box, expand the General group and select Linux.
  Figure 1. Selecting a connection type
3. Click Next.
4. In the Remote Linux System Connection, enter the remote target IP address or name in the Host name field.
  Figure 2. Defining the connection information
5. Click Next.
6. Select SSH protocol file access.
  Figure 3. Defining the file system
7. Click Next.
8. Select the shell processes for Linux systems.
  Figure 4. Defining the processes
9. Click Next.
10. Select SSH shells.
  Figure 5. Defining the shell services
11. Click Next.
12. Select SSH terminals.
  Figure 6. Defining the terminal services
13. Click Finish.
In the Remote Systems view:
1. Right-click on the Linux target and select Connect from the context menu.
2. In the Enter Password dialog box, enter a User ID and Password if required.
3. Click OK to close the dialog box.
4. Copy the stripped version of the Gnometris application, gnometris, and the libgames-support.so library from the local file system on to the target file system.
5. Ensure that the files on the target have execute permissions. To do this, right-click on each file, select Properties from the context menu and change the checkboxes as required.
  Figure 7. Modifying file properties from the Remote Systems view
Open a terminal shell that is connected to the target and launch gdbserver with the application:
1. In the Remote Systems view, right-click on Ssh Terminals.
2. Select Launch Terminal to open a terminal shell.
3. In the terminal shell, navigate to the directory where you copied the gnometris application, then execute the following command:
```
export DISPLAY=ip:0.0
gdbserver :port gnometris
```
  where:
  ip
  is the IP address of the host to display the Gnometris game
  port
  is the connection port between gdbserver and the application, for example 5000.
  Note
  If the target has a display that you can use, then you do not need to export DISPLAY.

Copyright © 2010, 2011 ARM. All rights reserved.	ARM DUI 0478F
Non-Confidential	ID071411
PDF version

Using an SSH connection to set up and run Gnometris on an ARM Linux target

Note

See also