Once you set it up, your Digi Application Development Environment for Digi Embedded Yocto enables cross-platform application development for ConnectCore devices using a desktop Linux workstation with Eclipse and Digi plugins.

Follow these steps to install the software:

Before starting development for your ConnectCore platform, make sure your device is correctly connected, powered, and running. See Step 2 - Set up the hardware and Step 3 - Program the Yocto firmware.

1. Download and install the software

You can use either of the following methods to install the Digi Application Development Environment:

Install Digi Application Development Environment for Linux

Follow the steps below to download and install Digi Application Development Environment for Linux.

Requirements

To install Digi Application Development Environment for Linux, you need a development machine with at least:

  • Linux 64-bit system (Ubuntu 20.04)

  • 4 CPU cores

  • 4 GB of RAM

  • Free disk space:

    • Development environment: 600 MB for the development environment

  • Internet connection

Instructions

Follow the steps below to download and install Digi Application Development Environment for Linux:

  1. Download the installer file from: https://ftp1.digi.com/support/digiembeddedyocto/eclipse/eclipse-dey-4.0-r5.run.

  2. You must have write permissions in the selected installation path during the installation process. The default directory is /opt/eclipse. Use the install command to create the installation directory with write permissions:

    $ sudo install -o <your-user> -g <your-group> -d /opt/eclipse
    You can get your primary user and group using the id command.
  3. When the download is complete, double click the eclipse-dey-4.0-r5.run file. Follow the steps in the installer Setup Wizard.

    You can also run it using the Linux terminal.

    $ chmod +x eclipse-dey-4.0-r5.run
    $ ./eclipse-dey-4.0-r5.run

    A Readme dialog appears when the installation is complete.

  4. By default, the installer launches an Eclipse instance.

Install Digi Embedded Yocto plugins from Eclipse

The Digi Application Development Environment for Linux installer includes the Eclipse IDE for C/C++ Developers. To add the Digi plugins to an existing Eclipse installation:

Requirements

To install the Digi plugins from within Eclipse, you need:

Instructions

Once all the requirements are downloaded and installed, follow the steps below to download and install Digi plugins:

  1. Go to Help > Install New Software. The Install wizard is displayed.

  2. Click Add. The Add Repository dialog opens.

  3. Type Digi Embedded Yocto Eclipse Plug-ins in the Name text box.

  4. Type https://ftp1.digi.com/support/digiembeddedyocto/eclipse/2022-12-updates in the Location text box.

  5. Click OK. The search process begins. When it finishes, the available plugins are listed in the table.

  6. Expand Digi Embedded Yocto category and select Digi Embedded Yocto Feature item.

  7. Click Next and follow the instructions in the wizard.

    A Security Warning may appear before finishing the installation. Click Install anyway to proceed.
  8. When the installation process finishes, Eclipse asks you to restart. Click Restart Now. After the restart, the Digi plugins are available.

2. Install toolchains

The SDK provides a cross-development toolchain and libraries tailored to the contents of a specific image.

Digi provides a pre-compiled C/C++ toolchain that matches the dey-image-webkit image and contains the appropriate libraries for developing against that image.

The installed toolchain consists of several files and directories: an environment setup script, some configuration files, and host and target root file systems. For more information, see the Yocto Project Application Development and the Extensible Software Development Kit (eSDK) manual.

Digi Embedded Linux toolchain requires between 3 GB and 10 GB, depending on the platform.

Install a Digi toolchain

To install new Digi Embedded Yocto toolchains in your system, follow these steps:

  1. Select Window > Preferences.

  2. Select DEY Toolchains from the list on the left.

  3. Click Browse and select the directory where you want to install the new toolchains, which must have write permissions. The default directory is /opt/dey.

  4. Click Download new toolchains. The Install new DEY toolchains dialog opens listing all the available toolchains to install.

  5. Select the toolchains you want to install and click Install selected.

    You can filter the available toolchains by platform using the platform combo box.
  6. The installation process starts and the dialog displays the installation status.

    You can stop the installation process at any time by clicking Cancel.
  7. Once the process finishes, click Back to return to the available toolchains list and continue installing new toolchains, or click Close to close the dialog.

  8. The installed toolchains table is updated with the new toolchains. Select a new default.

  9. Click Apply and Close to save the changes.

The Close button closes the dialog and stops any active and pending toolchain installation. If you click the button and the install process has not yet finished, a popup message asks for confirmation.

Install your custom toolchain

You must manually install any custom toolchains generated with Digi Embedded Yocto. To do this, follow these steps:

  1. Copy the toolchain installer script to your host machine.

  2. Give execution permission to the installer and install the toolchain on your host PC.

    $ chmod +x dey-glibc-x86_64-dey-image-webkit-wayland-cortexa7t2hf-neon-vfpv4-ccmp15-dvk-toolchain-4.0-r5.sh
    $ ./dey-glibc-x86_64-dey-image-webkit-wayland-cortexa7t2hf-neon-vfpv4-ccmp15-dvk-toolchain-4.0-r5.sh

3. Configure installed toolchains

You can configure Digi Embedded Yocto toolchains and select a default toolchain in Eclipse preferences.

  1. In Eclipse, go to Window > Preferences.

  2. Select DEY Toolchains from the list on the left.

  3. Click Browse and navigate to the path containing the installed Digi Embedded Yocto toolchains. Eclipse looks for available toolchains in the specified path. All discovered toolchains are listed in the table.

    Click Search to perform a new toolchain search in the selected directory.
  4. Select a default toolchain to use.

  5. Click Apply and Close to save the changes.

If Digi Embedded Yocto toolchain settings are not properly configured on Eclipse startup, a popup dialog is displayed asking you to configure them.