User Guide

  • 2020
  • 12/10/2019
  • Public Content

Importing Projects to
Intel® System Studio

This section contains steps to import a project you previously created in the Arduino Create* Web Editor into
Intel® System Studio
.
Intel® System Studio
includes a set of cross-development toolchains that allow you to build IoT applications for a variety of Linux* targets. Docker provides the Linux cross-host environments needed to host these target-specific native Linux toolchains directly on your host computer. Before creating a new project, make sure Docker is installed and configured on your machine.

Step 1. Export an Arduino Create* project

For steps to export a project from Arduino Create, see Exporting Projects to Intel® System Studio.
After building an imported project and switching build configurations (i.e. changing the build configuration from DEBUG to RELEASE or vice versa), you may find that your project does not build, and that no errors will appear in the Cmake console, Problems view, or Error Log.
To avoid this issue, before attempting to rebuild the project, do one of the following to ensure that your project builds properly:
  • Clean the project
  • Delete the build directory

Step 2. Before you import an Arduino Create project

Before you import an Arduino Create project, complete the following prerequisites:
  1. Install
    Intel® System Studio
    . Click here to get started.
  2. Install Docker* and configure it for use with
    Intel System Studio
    . See:
  3. Now you are ready to import the Arduino Create project that you previously exported.

Step 3. Import an Arduino Create project

  1. Launch
    Intel® System Studio
    using the Desktop shortcut.
    Intel System Studio
    opens in the Eclipse* Integrated Development Environment (IDE).
  2. Select
    File
    Import
    .
  3. Expand the Arduino Create folder. Select
    Import Arduino Create
    , then click
    Next
    .
  4. Under Select the Arduino Create archive, click
    Browse
    .
  5. Browse to and select the .zip file that contains your project. Click
    OK
    .
  6. In the
    Project Name
    field, type a name for your new project and click
    Finish
    .
  7. Wait for the project to be created.
  8. Until the first build is complete, errors may appear on the
    Problems
    tab, as shown below. Windows users should review Step 4 for additional errors.
  9. The errors go away once the build and indexing is complete, as shown on the
    Progress
    tab to the right of the
    Problems
    tab.
  10. You can also confirm that your project built without issue by checking the
    Console
    tab, as shown below.

Step 4. Windows users only (known bugs)

Because of known bugs, you might notice errors when you view your project in the Eclipse Project Explorer, for example:
  • "Errors occurred during build" popup window
  • Program g++ and gcc++ not found in PATH
  • Missing build artifacts
The errors are due to a known bug and do not indicate problems with the project. To resolve the temporary errors, complete the following steps:
"Errors occurred during build" popup window
This error occurs upon project creation and when you attempt to build or clean your project. In the Console, you will also see an error, 'Cannot run program "rm": Lauching failed'.
Eclipse is expecting Unix tools to be installed. To install them, download Git for Windows* at http://gitforwindows.org and during installation, select the option
Use Git and optional Unix tools from the Windows Command Prompt
.
Program g++ and gcc not found in PATH
In the Problems list, you will see two entries, 'Program g++ not found in PATH' and 'Program gcc not found in PATH'.
  1. Choose
    Project
    Properties
    .
  2. Expand
    C/C++ General
    and select
    Processor Include Paths, Macros etc
    .
  3. Select the
    Providers
    tab and clear the
    CDT GCC Built-in Compiler Settings
    check box.
  4. Then click
    Apply and Close
    .
Missing build artifacts
In the Problems list, you will an entry, 'cmake exited with status 1. See CDT global build...'
  1. Choose
    Project
    Properties
    .
  2. Expand
    C/C++ Builds
    . Then expand
    CMake
    and select
    Host OS overrides
    .
  3. Select the
    Windows
    tab, and in the
    Buildscript generator
    drop-down list, select
    Unix Makefiles
    .
  4. Click
    Apply and Close
    .
  5. Build the project again.
You will experience a build error upon your first build but subsequent builds should succeed.

Troubleshooting

Issue
: an imported project has the following lines:
' #line 1 "/tmp/115304058/Blink/Blink.ino" #line 1 "/tmp/115304058/Blink/Blink.ino" ' #line 26 "/tmp/115304058/Blink/Blink.ino" void setup(); #line 34 "/tmp/115304058/Blink/Blink.ino" void loop(); #line 26 "/tmp/115304058/Blink/Blink.ino"
Resolution
: These lines are not necessary and can be removed.

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804