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

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 Installing Docker* for Intel® System Studio - macOS* Host.

Step 1: Start Intel System Studio

  1. Double-click the Intel System Studioicon in your Applications folder. The Intel System Studio Eclipse Launcher opens.
  2. Create the workspace in the user home directory, or ensure that the location is shared with Docker Toolbox.
  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 Gold 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'll be prompted to select a toolchain that matches your target platform's OS. Ubuntu Linux is automatically selected, so click Next.

  4. When prompted to select a project type, select Intel® IoT C/C++ Project. Click Next.

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

  6. Click Finish.

  7. Your project is created and displayed.

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: Run a Project

The connection that your project uses when you run or debug the project is called the target connection. By default, all projects in the Intel® System Studio use the same target connection. Follow the steps below to set the target connection for the selected project.

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.

Follow these steps to select a target connection and run or debug the project:

  1. Click on the arrow next to the connection drop-down list and select your connection.

    If this is your first project, you'll need to create a new connection. Click the arrow next to the connection drop-down list and select New Connection. For detailed instructions see Getting Started > Running the project in Intel® System Studio 2018 Gold User Guide for Project Building in Containers and Running on Linux* with C/C++.

  2. Ensure that your target is selected in the drop-down list.

  3. To run a project, click theRun drop-down list in the toolbar, select the name of your project.

    To debug a project, click the Debugdrop-down list in the toolbar and select the name of your project.

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

  5. Your project runs. When finished, click the Terminate icon from the Console panel to end the IoT application that is running on your target device.

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

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

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

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