Before creating your first application using Qt Creator, you must configure the IDE to work with your platform and the Digi Embedded Yocto toolchain.

1. Create a new device configuration

Follow these steps to create a new device configuration:

  1. Click Edit > Preferences.

  2. Select Devices from the list at the left.

  3. Click Add on the right panel. A new dialog is displayed listing all the available device configuration types.

  4. Select Remote Linux Device and click Start Wizard.

  5. Complete the New Remote Linux Device Configuration Setup wizard:

    1. In the Connection page:

      1. Enter a name to identify this configuration.

      2. Enter your device’s host name or IP address. See How to find the IP of your device.

        Your device and your host machine must be in the same network.
      3. Enter the device’s SSH port number; the default value is 22.

      4. Enter the username used to log in to the device; the default value is root.

      5. Click Next.

    2. In the Key Deployment page:

      1. Configure the private key file.

      2. Click Next.

    3. In the Summary page, click Finish to create the new device configuration. A connection test is performed against the device. Once it finishes, click Close.

      If the connection test fails, verify all the connection settings are correctly configured and the device is running properly.
  6. Click OK to save the new created device configuration and close the dialog.

2. Set up Digi Embedded Yocto compilers

2.1. Configure Digi Embedded Yocto Qt Compiler

Follow these steps to configure the Digi Embedded Yocto Qt compiler:

  1. Click Edit > Preferences.

  2. Select Kits from the list at the left.

  3. In the right pane, select the Qt Versions tab.

  4. If your toolchain qmake binary is not listed, add it:

    1. Click Add to add a new Qt compiler.

    2. Navigate through your file system and select the qmake binary installed within your platform toolchain, usually located at:

      <toolchain_installation_path>/sysroots/x86_64-deysdk-linux/usr/bin/qmake
  5. Click Apply to save the new Qt compiler.

If you receive a warning message stating that there was already a configured binary for the same Qt version, ignore it and close the popup.

2.2. Configure Digi Embedded Yocto C Compiler

Follow these steps to configure the Digi Embedded Yocto C compiler:

  1. Click Edit > Preferences.

  2. Select Kits from the list at the left.

  3. In the right pane, select the Compilers tab.

  4. Click Add and select GCC > C from the drop-down menu to add a new C native compiler.

  5. Enter a name to identify the new C compiler, for example ccimx8mn_dey_gcc.

  6. Click Browse to fill the C compiler path. A file system explorer dialog opens.

  7. Navigate through your file system and select the aarch64-dey-linux-gcc binary installed within your platform toolchain, usually located at:

    <toolchain_installation_path>/sysroots/x86_64-deysdk-linux/usr/bin/aarch64-dey-linux/aarch64-dey-linux-gcc
  8. Select arm-linux-generic-elf-32bit from the ABI drop-down.

  9. Click Apply to save the new C compiler.

2.3. Configure Digi Embedded Yocto C++ compiler

Follow these steps to configure the Digi Embedded Yocto C++ compiler:

  1. Click Edit > Preferences.

  2. Select Kits from the list at the left.

  3. In the right pane, select the Compilers tab.

  4. Click Add and select GCC > C++ from the drop-down menu to add a new C++ native compiler.

  5. Enter a name to identify the new C++ compiler, for example ccimx8mn_dey_g++.

  6. Click Browse to fill the C++ compiler path. A file system explorer dialog opens.

  7. Navigate through your file system and select the aarch64-dey-linux-g++ binary installed within your platform toolchain, usually located at:

    <toolchain_installation_path>/sysroots/x86_64-deysdk-linux/usr/bin/aarch64-dey-linux/aarch64-dey-linux-g++
  8. Select arm-linux-generic-elf-32bit from the ABI drop-down.

  9. Click Apply to save the new C++ compiler.

2.4. Configure Digi Embedded Yocto CMake tool

Follow these steps to configure the Digi Embedded Yocto CMake tool:

  1. Click Edit > Preferences.

  2. Select CMake from the list at the left.

  3. In the right pane, select the Tools tab.

  4. Click Add to add a new CMake tool.

  5. Enter a name to identify the new CMake tool, for example ccimx8mn_dey_cmake.

  6. Click Browse to fill the CMake tool path. A file system explorer dialog opens.

  7. Navigate through your file system and select the cmake binary installed within your platform toolchain, usually located at:

    <toolchain_installation_path>/sysroots/x86_64-deysdk-linux/usr/bin/cmake
  8. Click Apply to save the new CMake tool.

3. Set up Digi Embedded Yocto debugger

Follow these steps to configure the Digi Embedded Yocto debugger:

  1. Click Edit > Preferences.

  2. Select Kits from the list at the left.

  3. In the right pane, select the Debuggers tab.

  4. Click Add in the right pane to add a new debugger.

  5. Enter a name to identify the new debugger, for example ccimx8mn_dey_gdb.

  6. Click Browse to fill the debugger path. A file system explorer dialog opens.

  7. Navigate through your file system and select the aarch64-dey-linux-gdb binary installed within your platform toolchain, usually located at:

    <toolchain_installation_path>/sysroots/x86_64-deysdk-linux/usr/bin/aarch64-dey-linux/aarch64-dey-linux-gdb
  8. Click Apply to save the new debugger.

4. Create a new Kit configuration

Follow these steps to create a new Kit configuration for your device:

  1. Click Edit > Preferences.

  2. Select Kits from the list at the left.

  3. In the right pane, select the Kits tab.

  4. Click Add to create a new Kit configuration.

  5. Enter a name to identify the new Kit configuration, for example ccimx8mn_dey.

  6. In the Device type field, select Remote Linux Device.

  7. In the Device field, select the previously created device configuration.

  8. Fill the Sysroot path. To do so:

    1. Click Browse.

    2. Navigate through your file system and select the cortexa53-crypto-dey-linux folder within your platform toolchain, usually located at:

      <toolchain_installation_path>/sysroots/cortexa53-crypto-dey-linux/
  9. In the C Compiler field, select the previously configured C DEY Compiler.

  10. In the C++ Compiler field, select the previously configured C++ DEY Compiler.

  11. In the Debugger field, select the previously configured DEY Debugger.

  12. In the Qt Version field, select the previously configured Qt DEY Compiler.

  13. Fill the Qt mkspec field with your toolchain Qt mkspec path, usually located at:

    <toolchain_installation_path>/sysroots/cortexa53-crypto-dey-linux/usr/lib/mkspecs/linux-oe-g++
  14. In the CMake Tool field, select the previously configured DEY CMake tool.

  15. Click Make Default to set the new Kit configuration as default.

  16. Click OK to save the new Kit configuration and close the dialog.


How to find the IP of your device

You can find the IP of your device with the ifconfig command.

# ifconfig eth0
eth0      Link encap:Ethernet  HWaddr 00:40:9D:98:A6:37
          inet addr:192.168.42.30  Bcast:192.168.42.255  Mask:255.255.255.0
          inet6 addr: fe80::211:22ff:fe33:2211%lo/64 Scope:Link
          UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
          RX packets:1071204 errors:0 dropped:0 overruns:0 frame:0
          TX packets:81475 errors:0 dropped:0 overruns:0 carrier:0
          collisions:0 txqueuelen:1000
          RX bytes:119890110 (114.3 MiB)  TX bytes:16714042 (15.9 MiB)

In this example, the target IP address is 192.168.42.30.