RZ/A1H Display It board (RZ/A1H RSK).

The following article explains all necessary steps to create an Embedded Wizard UI application suitable for the RZ/A1H Display It board from Renesas.

Please follow these instructions carefully and step by step in order to ensure that you will get everything up and running on your target. In case you are not familiar with Embedded Wizard, please read first the chapter basic concepts and the Quick Tour tutorial to understand the principles of Embedded Wizard and the GUI development workflow.

First, make sure you have all of the following items:

If you just want to run our GUI demos on your RZ/A1H Display It board without building the different examples, you can simply flash the binary file of the Embedded Wizard Master Demo.

The Embedded Wizard Master Demo combines a variety of examples within one huge demo application. It can be used for presentations and showcases. Each demo application can be activated from a common main menu. To return back from a demo application to the main menu, a small home button appears on top of every demo. Additionally, the Master Demo contains an auto-demo mode that presents one demo application after the other. The auto-demo starts automatically and stops as soon as the user touches the screen.

In order to flash the binary file to your target, please follow these steps:

'Master Demo' running on RZ/A1H Display It board.

The provided Embedded Wizard Build Environment for RZ/A1H Display It contains everything you need to create, compile, link and flash an Embedded Wizard UI application for the Renesas RZ/A1H target. After unpacking, you will find the following subdirectories and files:

The Renesas RZ/A1H target is configured to launch applications from the external QSPI flash memory. For that purpose, a small bootloader is necessary in order to intialize the system and to start the code execution from QSPI flash.

The following steps are necessary to build and flash the bootloader using the GCC ARM embedded toolchain:

If everything works as expected, the bootloader should be built and flashed to the Renesas RZ/A1H target. Now the code is executed from external memory (QSPI flash). You can now build and download any GUI application into the QSPI flash memory.

Flashing the bootloader is only necessary one time.

For the first bring up of your system, we recommend to use the example 'HelloWorld':

Example 'HelloWorld' within Embedded Wizard Studio.

The following steps are necessary to generate the source code of this sample application:

The following steps are necessary to build and flash the Embedded Wizard UI sample application using the GCC ARM embedded toolchain:

If everything works as expected, the application should be built and flashed to the Renesas RZ/A1H target.

Example 'HelloWorld' running on RZ/A1H Display It board.

All other examples can be created in the same way: Just open the desired example with Embedded Wizard Studio, generate code and rebuild the whole application using simply:

In order to create your own UI project suitable for the Renesas RZ/A1H target, you can create a new project and select the RZ/A1H Display It project template:

As a result you get a new Embedded Wizard project, that contains the necessary Profile attributes suitable for the RZ/A1H Display It board:

The following profile settings are important for your target:

Now you can use the template project in the same manner as it was used for the provided examples to compile, link and flash the binary.

After generating code, please follow these steps, in order to build your own UI application:

Most of the project settings are taken directly out of the generated code, like the color format or the screen orientation. All other settings can be made directly within the file ewconfig.h, which contains general configuration settings for the target system.

In order to receive error messages or to display simple debug or trace messages from your Embedded Wizard UI application, a serial terminal like 'Putty' or 'TeraTerm' should be used.

During a successful application startup, the console displays the following information:

This terminal connection can be used for all trace statements from your Embedded Wizard UI applications or for all debug messages from your C code.

If you want to use the Renesas e2 Studio toolchain instead of the GCC ARM embedded toolchain, please follow these instructions:

The subdirectory \Application\Project\e2Studio contains a template project that is commonly used for all provided Embedded Wizard examples. All Embedded Wizard examples will store the generated code within the common /Application/GeneratedCode folder.

The following steps are needed to establish this automatic project import:

After the Embedded Wizard code generation the installed post process will adapt the .cproject XML file. All necessary libraries and include paths (depending on the color format and screen rotation) will be set automatically.

The given e2 Studio example under \Application\e2Studio contains a workspace which has all adaptions for an Embedded Wizard project. For using this within Renesas e2 Studio do following steps:

If the color format or the screen orientation was changed, please do a clean in Renesas e2 Studio.

In order to bring-up an Embedded Wizard generated UI application on your Renesas RZ/A1H custom hardware, you can use the provided Embedded Wizard Build Environment for RZ/A1H Display It as a template. For general information about porting Embedded Wizard to custom hardware, please refer to the article Custom Hardware Integration.

For RZ/A1H Display It-based custom hardware, the following target-specific adaptations are typically necessary:

The following section contains the version history of the Build Environment (including Graphics Engine and Runtime Environment) for RZ/A1H Display It. These release notes describe only the platform specific aspects - for all general improvements and enhancements please see the Embedded Wizard release notes.