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

Run a Sample Project with Eclipse*

Intel® oneAPI IoT Toolkit

Note

If you are using Eclipse* with FPGA see the Intel® oneAPI DPC++ FPGA Workflows on Third-Party IDEs.

After you run your sample project, you can use Intel® System Debugger, a modern GUI-based architecture software debugger. This debugger is available as part of the Intel® System Bring-up Toolkit.

Building a Project Using Eclipse* IDE

You can access the entire suite using Eclipse* (see the release notes for minimum required version).

Note

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.

Note

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 version of Eclipse that you chose for integration during installation. The Intel-provided Eclipse option is in <install_dir>/intel/oneapi/intel-eclipse-ide/latest/eclipse/, where <install_dir> is typically /opt/intel/oneapi when installed as root or a super user, and $HOME/intel/oneapi otherwise.
  3. From the top level menu bar, select Intel > Browse Intel Samples. The samples window appears.

    Note

    If you do not see the Intel menu in Eclipse, see the section on Eclipse plugins in the Troubleshooting section.

  4. Click Intel® oneAPI IoT Tooklit.
  5. Click Intel® C++ Compiler Classic.
  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.

    Note

    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.

    Note

    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 Data Parallel C++ Through Samples to learn more.