Get Started with the Intel® oneAPI IoT Toolkit for Linux*

Get Started

  • 2022.3
  • 09/08/2022
  • Public Content
Contents

Run a Sample Project with
Eclipse*

Intel® oneAPI IoT Toolkit
If you are using
Eclipse*
 with FPGA see the FPGA Workflows on Third-Party IDEs for Intel® oneAPI Toolkits.
Starting with the 2021.3 release of the Intel® oneAPI IoT Toolkit, the Eclipse IDE for C/C++ Developers (Eclipse CDT) package will no longer be bundled with the Intel® oneAPI IoT Toolkit. Plug-ins to support Intel® oneAPI development in Eclipse will continue to be provided for integration into a user-provided copy of the Eclipse IDE for C/C++ Developers either during or after installation of the Intel® oneAPI IoT Toolkit.
The plug-ins support the past two Eclipse versions that were released as of one month before the toolkit was released. For example, the 2021.2 version toolkits supported Eclipse CDT versions 2020-09 and 2020-12.
The latest version of the Eclipse IDE for C/C++ Developers install package is available at https://www.eclipse.org/downloads/packages/.

Building a Project Using Eclipse* IDE

You can access the entire suite using Eclipse* (see the release notes for minimum required version).
An internet connection is required to download the samples for oneAPI toolkits. For information on how to use this toolkit offline, see Developing with Offline Systems in the Troubleshooting section.
To use the compilers installed with the
Intel® oneAPI IoT Toolkit
, you must set up your environment by sourcing the setvars script or by loading a module file before launching the Eclipse* IDE workspace. The Intel oneAPI Samples plugin creates individual projects from an existing code samples and uses the CMake build system. You can specify the compiler executable used by changing CMake configuration variables (e.g., CMAKE_CXX_COMPILER to specify the C++ compiler front end). The
Properties
C/C++ Build
Settings
 tab cannot be used to configure CMake projects.
To watch a video presentation of how to create a project, see Intel® oneAPI Eclipse Samples Plugin.
  1. Open a terminal session and source setvars.sh.
    For root or sudo installations: 
    . /opt/intel/oneapi/setvars.sh
    For normal user installations: 
    . ~/intel/oneapi/setvars.sh
  2. From the same terminal session, launch the copy of Eclipse that you will use to develop oneAPI applications.
  3. From the top level menu bar, select
    Intel
    Browse Intel Samples
    . The samples window appears.
    If you do not see an Intel menu in Eclipse, install the oneAPI Eclipse plugins, then return to this page for instructions on how to Build and Run a sample.
  4. Click
    oneAPI Tools
    .
  5. Click
    IoT Connection Tools
    .
  6. Click the
    Hello IoT World
     sample.
  7. Click
    Finish
    .
  8. To build the project, first exclude the build folder by right clicking on the build folder and selecting
    Resource Configurations
    Exclude from Build...
    .
  9. Click
    Project
    Build Project
    .
  10. To run the application, click
    Run
    Run
    .
    A "Hello IoT" message appears in the Eclipse console.
  11. Begin debugging the application.
    The debugger displays a breakpoint at the start of code.

Running a Remote Sample on an Up Squared* Device

  1. Create a Connection within Eclipse by selecting the
    New Connection
     option:
  2. Select the SSH Connection type and click
    Next
    :
  3. Enter the Hostname and Username for your remote target. You can either use Key-based authentication or Password, depending on the configuration of the remote device.
  4. You may also be then prompted to set an Eclipse Secure Storage password. This protects the password you entered when stored on the disk. Enter the password and click OK.
  5. When connecting to the device for the first time, you should be prompted to trust the device. Click Yes to continue.
  6. From the top level menu bar, select
    Intel
    Browse Samples
     and select the UP Squared Built-in LEDs sample.
  7. In the
    Project Explorer
     tree, right-click the Up Squared sample and then select
    Build Configurations
    Build All
    .
  8. After the build command executes, in the
    Project Explorer
     tree, expand
    Debug
     to see the binary. Right-click the
    up2-leds
     binary, and then select
    Run Configurations
    .
    The
    Run Configurations
     dialog box opens.
  9. To create a remote run configuration, double-click
    C/C++ Remote Applications
     to create the new run configuration, then populate the following fields.
    Some of the fields pre-populate based on your selection of the binary.
    1. For
      Connection
      , choose the new remote connection that you created.
    2. Choose a path for the binary on the remote UP Squared device (any directory that you can access will work).
    3. If multiple launchers are available, select the
      Legacy
       launcher to continue with SSH.
    4. Click
      Apply
       and then
      Run
      .
    After the remote application launches, the multi-color LEDs on the UP Squared board blink continuously.
    A message about authorization on the target device may appear, but authorization may not be required. Allow a few seconds for the application to launch on the target.
    run config dialog box
See Explore SYCL* Through Samples to learn more.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.