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:

  1. 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.

  2. 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

      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

      Defining the connection information

    5. Click Next.

    6. Select SSH protocol file access.

      Figure 3. Defining the file system

      Defining the file system

    7. Click Next.

    8. Select the shell processes for Linux systems.

      Figure 4. Defining the processes

      Defining the processes

    9. Click Next.

    10. Select SSH shells.

      Figure 5. Defining the shell services

      Defining the shell services

    11. Click Next.

    12. Select SSH terminals.

      Figure 6. Defining the terminal services

      Defining the terminal services

    13. Click Finish.

  3. 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 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

      Modifying file properties from the Remote Systems view

  4. 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



      is the IP address of the host to display the Gnometris game


      is the connection port between gdbserver and the application, for example 5000.


      If the target has a display that you can use, then you do not need to export DISPLAY.

Show/hideSee also

Copyright © 2010, 2011 ARM. All rights reserved.ARM DUI 0478G