Getting Started with Intel® System Studio 2018 on a macOS* Host

Prerequisites

Before you create a project for the first time, follow the steps in this section. Then, continue to the next section for instructions to create and run a project.

Create a Target Connection Using Root Privileges

Applications that use MRAA/UPM libraries need to be run with root privileges so that they can control the hardware (GPIOs, I2C and SPI buses). Follow the steps in this section to create the target connection and ensure that for all future connections, your application will run as root.

To use TCF

The following steps are needed to use TCF regardless of MRAA/UPM usage.

  1. Connect both the host and the target system to the network
  2. Install OpenSSH server on the target: sudo apt install openssh-server

For a macOS* host

  1. Generate the key with an empty passphrase:

    ssh-keygen -t rsa -f ~/.ssh/id_rsa_tcf

    Press Enter when prompted for a passphrase.

  2. Copy public key to the target: scp ~/.ssh/id_rsa_tcf.pub {username}@{target_host}:
  3. Connect to the target system: ssh {username}@{target_host}
  4. Run sudo su - on the target system
  5. Create ~/.ssh directory if it doesn't already exist: mkdir ~/.ssh
  6. Update ~/.ssh directory permissons to 700: chmod 700 ~/.ssh
  7. Add public key to the ~/.ssh/authorized_keys file: cat ~{username}/id_rsa_tcf.pub >> ~/.ssh/authorized_keys
  8. Next, configure the TCF connection. See the instructions in the Configure the TCF connection section below.

Configure the TCF connection

Follow these steps to configure the TCF connection using SSH keys.

  1. In the toolbar, click New Connection.
  2. Select Connection for building in a container and running on Linux and click Next.
  3. On the New Connection window, enter a Connection Name and IP address. Click Finish.
  4. On the Login window, select the Public key login tab.
  5. For Username, enter root
  6. Browse to the Private Key: The path is /home/{username}/.ssh/id_rsa_tcf

    Note

    You will need to press CMD + Shift + . to show hidden directories such as .ssh

CAUTION

When you connect to your target system this way, Intel System Studio copies a TCF agent to your target, which is listening for connections from any computer on your local network. The IDE target connection dialog asks for authentication credentials to facilitate transferring and starting the TCF agent on your target device; however, once running, the TCF agent does NOT require authentication to perform its actions. Therefore, any user that has network access to your target device can connect to it and use the TCF agent to run arbitrary code on your target device. If you start the agent as root as described in this section, then anyone with network access to your device can run arbitrary code on your device without any authentication.

Configure network proxy settings

Follow these steps to set up network proxy settings in Intel System Studio. If you're on an open network, skip these steps.

  1. Start Intel System Studio.
  2. Choose Window > Preferences > General > Network Connections to open the Network Connections page.
  3. From the Active Provider drop-down list, select Manual.
  4. Provide the appropriate proxy information for your network, as shown in the image below.
  5. Click OK.

Creating and Running a Project

The Intel® System Studio project workflow on a macOS* host uses Docker* container technology. For information about using Docker containers with Intel System Studio, see Intel® System Studio 2018 User Guide for Project Building in Containers and Running on Linux* with C/C++.

Step 1: Start Intel System Studio

  1. In your Applications folder, navigate to Intel System Studio 2018 for Linux and Android Targets and double-click Intel System Studio. The Intel System Studio Eclipse Launcher opens.
  2. Create the workspace in the user home directory.
  3. Click OK to launch Intel System Studio.

If this is not the first time you've installed Intel System Studio, you may need to update the Docker images used to build your projects. See the detailed instructions for macOS* under Getting Started > Running the Intel® System Studio in Intel® System Studio 2018 User Guide for Project Building in Containers and Running on Linux* with C/C++.

Step 2: Create a Project

  1. From the top menu, choose File > New > Project. The New Project wizard opens.

  2. Expand Application Development and select Project for building in a container and running on Linux. Click Next.

  3. Next, you will be prompted to select a toolchain that matches your target platform's OS. Ubuntu Linux is automatically selected, so click Next.

  4. Type a name for the project in the Name field. In the Examples list, browse for and select the type of project to create, such as C++ > Basic > Hello World. A short description of the selected project type is displayed in the Description area.

  5. Click Finish.

  6. Your project is created and displayed. However, if this is your first project, you will be prompted to download the Docker image. You must click Yes to finish creating the project.

    It can take more than ten minutes to download and build the Docker image, depending on the speed of your internet connection.

Note

If you receive an error message saying that Docker has failed, you need to install Docker and configure the Eclipse proxy. For detailed instructions, see Installing Docker* for Intel® System Studio - macOS* Host.

Step 3: Select a Target Connection

The connection that your project uses when you run or debug the project is called the target connection. Projects in the Intel® System Studio use the currently selected target connection.

CAUTION

When you connect to your target system this way, Intel System Studio copies a TCF agent to your target, which is listening for connections from any computer on your local network. The IDE target connection dialog asks for authentication credentials to facilitate transferring and starting the TCF agent on your target device; however, once running, the TCF agent does NOT require authentication to perform its actions. Therefore, any user that has network access to your target device can connect to it and use the TCF agent to run arbitrary code on your target device.

  1. Select an existing target connection or, if this is your first project, create a new connection:
    1. Existing connection: Click on the arrow next to the connection drop-down list and select a target connection.



    2. New connection for first project: Click New Connection.

      Then, select Connection for building in a container and running on Linux.

      Finish setting up the new connection. For detailed instructions, see Getting Started > Running the project in Intel® System Studio 2018 User Guide for Project Building in Containers and Running on Linux* with C/C++.

Step 4. Run or Debug a Project

  1. To run a project, click the Run button and select the name of your project from the drop-down list.

    To debug a project, click the Debug button and select the name of your project from the drop-down list.

  2. If a warning message about host authenticity displays, click Yes to upload and run your project.

  3. Your project runs.

    If the project does not exit automatically, click the red Terminate icon that appears on the Console panel.

For more information on running and debugging programs in Eclipse*, see the documentation on the Eclipse web site.

Find More

Resource

Description

Building with Docker* containers with Intel® System Studio 2018

Find out how to install and configure Docker* and how to develop projects using container technology:

Intel System Studio log files

Intel System Studio writes pairs of log files to a subdirectory in /tmp. The subdirectory name has the format iss_env_$USER_$TIMESTAMP. The iss_env.log file contains environment settings. The eclipse.log file contains a session log. For example: /tmp/iss_env_auser_20171025141933/eclipse.log and /tmp/iss_env_auser_20171025141933/iss_env.log

The Intel System Studio installer writes log files to the system temp directory (echo $TMPDIR), one for the user and one for root (when the installer is run with sudo). These log file names start with intel.pset, end with a timestamp, and have the extension *.log. To locate these files, type "cd $TMPDIR", then look for files matching the pattern. For example: $TMPDIR/intel.pset.auser.samukawi_mobl1.my.corp.domain_10.25.22.00.13.2017.log

Additional Documentation

Use the online documentation for the latest content.

A downloadable ZIP file containing all Intel® System Studio documentation is available for offline use from https://software.intel.com/en-us/articles/download-documentation-intel-system-studio-current-previous.

Intel® System Studio product page

Visit this page for support and the latest online documentation.

Legal Information

Intel, VTune Amplifier, and the Intel logo are trademarks of Intel Corporation in the U.S. and/or other countries.

macOS and the Apple logo are trademarks, or registered trademarks of Apple Inc. in the United States and/or other countries.

*Other names and brands may be claimed as the property of others.

© Intel Corporation

Para obtener información más completa sobre las optimizaciones del compilador, consulte nuestro Aviso de optimización.