How-To Guide - Embedded Wizard Studio (LAN-140e.A0)

Our partner, TARA Systems, developed a great GUI development tool called Embedded Wizard. With it, you can easily create your own high-performing GUI. This guide provides step-by-step documentation on how to use the Embedded Wizard tool with PHYTEC hardware and run a demo application.

Download Embedded Wizard Studio/Embedded Wizard Studio Free

Before we can begin, you must download the TARA Systems Development Environment, Embedded Wizard Studio. You can download it for free here: https://www.embedded-wizard.de/download.

Installation is easy, and then you can move on to the next step.

Download the Embedded Wizard Build Environment

Embedded Wizard regularly updates the CPUs and boards it supports. Currently, the following boards from PHYTEC are supported:

• phyBOARD-Pollux (i.MX8MPlus)
  Download the Build Environment directly here or the Embedded Wizard webpage https://doc.embedded-wizard.de/getting-started-phytec-imx8-opengl-wayland?v=15.00
• PHYTEC Development Kit Libra AM62Lx
  Download the Build Environment directly here or the Embedded Wizard webpage https://doc.embedded-wizard.de/getting-started-phytec-am62l-software-drm?v=15.00
• phyBOARD-Nash i.MX93
  Download the Build Environment directly here or the Embedded Wizard webpage https://doc.embedded-wizard.de/getting-started-phytec-imx93-software-drm?v=15.00

Set up Development Environment (WSL - Windows Subsystem for Linux, VM)

In order to cross-compile the embedded wizard code and use it on a PHYTEC board, a Linux system is required. If you already have a native Linux system or a working virtual machine (VM), you can skip this step and proceed to the next one. If you are using a Windows system, it is recommended that you use a VM or WSL.

WSL stands for Windows Subsystem for Linux.

This method is probably the easiest if you are a Windows user. To set up WSL, first install it on Windows. You can find instructions for doing so here: https://learn.microsoft.com/en-us/windows/wsl/install.

We recommend installing Ubuntu 24.04. To do so, open the Windows Command Prompt (press Win + R and type "cmd") and enter the following commands:

wsl --install Ubuntu-24.04 --name PHYTECwsl

After this, the WSL distribution should be installed. Use the Windows search bar, press the Windows button, type "PHYTECwsl," and press "Enter." You should then be able to open and start the WSL distribution.

Install and Set Up the SDK

In order to cross-compile the application to the phyBOARD later, you need to download and install the correct SDK. It's important that you download the SDK that matches your installed BSP version.

You can find all PHYTEC BSPs here: https://download.phytec.de/Software/Linux/. 

The folder structure is always the same: /Software/Linux/BSP-Yocto-/Product-/Release-/sdk/.  For example, for the i.MX8M Plus and PD24.10 release, the link is: https://download.phytec.de/Software/Linux/BSP-Yocto-i.MX8MP/BSP-Yocto-NXP-i.MX8MP-PD24.1.0/sdk/ampliphy-vendor-xwayland/.

To download and install the SDK, copy the link to the .sh file and run the following command in your Linux system:

~$ mkdir phytec_sdk
~$ cd phytec_sdk/
~/phytec_sdk$ wget <copied Link to SDK>

e.g.:
~/phytec_sdk$ wget https://download.phytec.de/Software/Linux/BSP-Yocto-i.MX8MP/BSP-Yocto-NXP-i.MX8MP-PD24.1.0/sdk/ampliphy-vendor-xwayland/phytec-ampliphy-vendor-xwayland-glibc-x86_64-phytec-qt6demo-image-cortexa53-crypto-toolchain-5.0.4.sh

The SDK should now be properly downloaded. To install and use it, enter the following command:

~/phytec_sdk$ chmod +x <SDK.sh file>
~/phytec_sdk$ ./<SDK.sh file>

e.g.:
~/phytec_sdk$ chmod +x phytec-ampliphy-vendor-xwayland-glibc-x86_64-phytec-qt6demo-image-cortexa53-crypto-toolchain-5.0.4.sh
~/phytec_sdk$ ./phytec-ampliphy-vendor-xwayland-glibc-x86_64-phytec-qt6demo-image-cortexa53-crypto-toolchain-5.0.4.sh

The SDK is now installed and ready to use. To use it, source the environment-setup file in the toolchain directory:

e.g.:
~/phytec_sdk$ source /opt/ampliphy-vendor-xwayland/5.0.4/environment-setup-cortexa53-crypto-phytec-linux

For more detailed information, please refer to the BSP manual for your specific BSP.

Open and Build an Embedded Wiazrd Studio Example

The next step is to open and build an existing Embedded Wizard example for a phyBOARD. To do so, open Embedded Wizard Studio and click "Open an Existing Project." The example project will open, and you can test it by clicking the "Start Prototype" button or pressing F5. To build this project, click "Build" and then "Build this profile." After a few seconds, the message "Done" should appear in the lower left corner of the file. 

The generated C code can be found in the Build Environment folder under "Application" and "Generated Code." 

Cross-Compile the Code

To bring the demo application to the board, you must cross-compile the generated code with the BSP's SDK. To do so, return to your Linux system and open the Build Environment folder of Embedded Wizard. If you are using a VM, make sure you can access this folder as a shared folder. If you are using WSL, you can access the Windows partition as an /mnt folder in your WSL system. 

Move into the Build Environment folder, then into the "Application" folder, and finally into the "Project" folder. Then use the "make" command to cross-compile the program.

~/$ cd /mnt/c/Users/phytec/PHYTEC-IMX8-OpenGL-Wayland-BuildEnvironment-V15.00.00.00/PHYTEC-IMX8-OpenGL-Wayland/Application/Project
~/$/mnt/c/Users/phytec/PHYTEC-IMX8-OpenGL-Wayland-BuildEnvironment-V15.00.00.00/PHYTEC-IMX8-OpenGL-Wayland/Application/Project make

The build sequence should end with the message, "EmbeddedWizard-Linux-OpenGL-Wayland was successfully built!" 

A file called "EmbeddedWizard-Linux-OpenGL-Wayland" should now be visible in the project folder.

Send the File via ssh to the Board and Run the Demo

The next step is to set up the phyBOARD. If it has not already happened, flash the SD card with the same BSP version from which you took the SDK. Connect your computer to the board via serial and find your IP address.

~/$ ip address

Now that you have this information, you can transfer the demo application to your board. For this, you will need to use the command line tool in Windows or the terminal in Linux.

~/$ cd /mnt/c/Users/phytec/PHYTEC-IMX8-OpenGL-Wayland-BuildEnvironment-V15.00.00.00/PHYTEC-IMX8-OpenGL-Wayland/Application/Project
~/$ scp EmbeddedWizard-Linux-OpenGL-Wayland root@172.25.32.174:/root

The file should now appear in the /root directory when you boot up. Finally, we can test the application and display it.

~/$ chmod +x EmbeddedWizard-Linux-OpenGL-Wayland
~/$ ./EmbeddedWizard-Linux-OpenGL-Wayland

If you are having trouble displaying something, please refer to the Display section of your chosen BSP manual.