Intel System Studio 2019 Get Started Guide for macOS*

Create a C/C++ Project for a Remote Linux* Target

Create a C++ Project for a Remote Linux Target

Follow the steps in this section to create an On-Board LED Blink or UP Squared* Built-in LEDs application to run on a remote Linux* target.

Step 1: Install Docker*

Before creating a new project, Docker* must be running on your host development system.

Follow the instructions in the Install Docker for Intel System Studio guide (links below). It includes links to installation steps as well as specific prerequisites and configuration steps for use with Intel System Studio.

Step 2: Create a new project

  1. Choose File > New > Project from the menu to start the new project wizard.

  2. Expand Intel Application Development and select C++ Project. Click Next.

  3. In the Code Samples list, expand the Get Started folder and select On-Board LED Blink or UP Squared Built-in LEDs.

    The sample project name appears in the New Project Name field. If you wish to change it, type over the displayed name.

  4. For Builder, select Managed Build.

  5. For Build Options, select Docker.

  6. Click Next.

  7. In the Select a Docker Container list, select the most recent version of Ubuntu Linux 16.04 64-Bit (GCC).

    Note

    For other projects, you may want to create and use custom Docker* images; for example, if you want to add a specific library to the image. For information about creating custom Docker images, see Create a New Custom Docker Image.

  8. Click Finish.

    Your project is created and built. The project files are shown in the Project Explorer. The build status is shown in the console.

Step 3: Create a new connection

CAUTION

When you connect to your target using the Eclipse* Target Communication Framework (TCF), Intel System Studio copies a TCF agent to your target, which is listening for connections from any computer on your local network. Even though the IDE asks for authentication credentials, the agent does NOT have any authentication. Therefore, any user can connect to it and can use the agent to run arbitrary code on your target device.

  1. Make sure your target device is physically connected to your host system and functioning properly.

    Note

    If your target is QEMU, start the QEMU simulator in your project directory by entering the command $ runqemu qemux86-64 nographic. When prompted, run ipconfig to get the IP address.
  2. Click the arrow next to the connection box on the toolbar and select New Connection.
  3. Select Connection for container based C/C++ applications or Java applications. Click Next.
  4. Type a name in the Connection Name field.
  5. Enter the board name or IP address in the Address field. Click Finish.
  6. When prompted, provide the appropriate credentials to access your device and click OK.

Step 4: Set up credentials

Set up credentials to access the target device. You can use either of the following authentication methods:

  • Public key login

    If the application accesses hardware sensors, LEDs, or requires elevated privileges, use public key based authentication for a higher level of security. Follow the steps in SSH Connection: Password-less Access to a Remote Linux Target Device.

  • Login with password

    If the application does not require elevated privileges, you can use login with password .

Step 5: Run or debug the application

  1. To run an application, click the arrow next to the green circle Run button and select the project in the drop-down list.

  2. If you are prompted, select Run as > Remote Intel IoT Application.
  3. Your project runs and results appear in the console. To stop the process, click the red Terminate icon on the console.

  4. To debug an application, click the arrow next to the green debug symbol on the toolbar and select the project in the drop-down list.