RH850 D1M1A Setup Instructions

This topic helps you setup the development environment for Renesas' RH850.

Setting up development environment

  • Ensure that the common Renesas prerequisites are met
  • Install Green Hills Multi IDE. Qt for MCUs is tested against version 7.1.6 together with Compiler 2018.1.5 and Probe 5.6.4 for V800.
  • Install Renesas Graphics Library for D1M1/2(H) for Green Hills Compiler. Qt for MCUs is tested against version 1.9.1a

Qt Creator IDE

  • Launch Qt Creator and select Tools > Options > Devices > MCU.
  • Select the Qt for MCUs 1.3 - RH850-D1M1A from the drop-down list for Target supported by the Qt for MCUs SDK.
  • Ensure that the Green Hills Compiler and Renesas Graphics Library path are correct.
  • Select Create Kit to create a kit for the selected target. if a kit already exists, remove it first using Remove Kit.

    Note: If you don't see the option to create a kit, check your settings in the Requirements section.

  • Click Apply.

Command line setup

To get started from the command line, ensure that the following environment variables are set:

  • Qul_DIR to the Qt for MCUs SDK install path.


    • <QT_INSTALL_PATH> is the Qt install directory,
    • and <VERSION> is the directory containing the Qt Quick Ultralite version you are using, for example 1.1.0.
  • ARMGCC_DIR to the ARM Toolchain install path.
  • Add the CMake and Ninja tools to your system PATH. If you installed these tools using the Qt online installer, they are installed under <QT_INSTALL_PATH>\Tools.
  • Create the GHS_COMPILER_DIR environment variable and set it to the GHS Compiler installation path. For example:
  • Create the RGL_DIR environment variable and set it to the Renesas Graphics Library installation path. For example:

Build configuration

Qt Creator provides a build configuration with the kit that you created created earlier for the Qt for MCUs 1.3 - RH850-D1M1A target. If you are using a command line setup, configure using the following CMake variables. For more information, see the CMake Manual.


    The platform to build for must be set to rh850-d1m1a for this board.


    This platform supports ghs compiler.


    The supported color depth by this platform is 32-bit.

    Note: If this variable is not set, default color depth is used while configuring for the platform.


Board configuration

Connect the Mango Adapter to the Main Board, and ensure that all jumpers and switches are set exactly as described.

Enable HDMI Output

To enable HDMI video output, follow jumper and dip-switch configuration.

On the Mango Main Board:

  • Connect the JP96 pins
  • Open JP98 pins 2 and 3, and connect pin PJ99 to JP98-2.
  • DSW31.7 switch set to OFF

On the Mango Adapter Board:

  • DSW1.1 switch set to OFF

Enable Flashing

To enable flashing and debugging, ensure that the following switch configuration is set:


Enable HMI section

To be able to use HMI section on the board (HMI knob and 4-direction switch), open JP30 and set the DWS29.1-1 switches to ON.

Note: This setup can interfere with CAN. See Mango Main Board reference docs for more details.

Demos and examples

Qt for MCUs provides the source code of several demos and examples. You can modify, build, and flash custom binaries onto the target device.

Source code for supported demos and examples is organized in the following directory structure:

  • demos
  • examples
    • charts
    • chess
    • freertos_multitask
    • image_cache
    • interrupt_handler
    • minimal
    • redbutton
    • styling
    • translation

Note: Demos or examples that are highlighted in bold are the only ones supported on this board.

Building applications with prebuilt Qt Quick Ultralite libraries

Qt Creator IDE

Open the CMake project file for the example you want to build and configure it with the kit you created earlier. Once the project is configured, select Run or press Ctrl+r on your keyboard to build and flash the binary to the target.

Command line

The following example builds the automotive demo for RH850 D1M1A:

cd %Qul_DIR%\demos\automotive
mkdir build
cd build
cmake .. -G "Ninja" -DCMAKE_BUILD_TYPE=Release -DCMAKE_TOOLCHAIN_FILE=%Qul_DIR%\lib\cmake\Qul\toolchain\ghs.cmake -DQUL_PLATFORM=RH850-D1M1A
cmake --build .

The same procedure applies to any other application.

Platform-specific CMake options

Following CMake options are available exclusively for this platform:

CMake OptionDescription
QUL_USE_DEFAULT_RH850_STARTUP_FILEBy default Qt Quick Ultralite is using startup file that comes with the RGL library. Set this global variable to OFF to disable this behavior. Then you are able to add your custom startup file to the executable target sources.

Building Qt Quick Ultralite

If your license provides access to the Qt Quick Ultralite sources, build it with all of supported demos/examples. Run the following commands from the terminal window:

cd %Qul_DIR%
mkdir build
cd build
cmake .. -G "Ninja" -DCMAKE_BUILD_TYPE=Release -DCMAKE_TOOLCHAIN_FILE=%Qul_DIR%\lib\cmake\Qul\toolchain\ghs.cmake -DQUL_GENERATORS=%Qul_DIR%\lib\cmake\Qul\QulGenerators.cmake -DQUL_PLATFORM=RH850-D1M1A
cmake --build .

Building applications using a custom built Qt Quick Ultralite

This section describes how to build an application, using a custom Qt Quick Ultralite build.

  • First, you must set up the development environment as described earlier.
  • Build Qt Quick Ultralite from the modified sources and install it to a custom location.
    mkdir some\path\custom_builds\qul
    cd some\path\custom_builds\qul
    mkdir qul-build
    cd qul-build
    cmake <PATH_TO_INSTALLED_QT_SDK>\QtMCUs\<version> \
          -G "Ninja" \
          -DCMAKE_INSTALL_PREFIX=some\path\custom_builds\qul \
          -DCMAKE_BUILD_TYPE=Release \
          -DCMAKE_TOOLCHAIN_FILE=<PATH_TO_INSTALLED_QT_SDK>\QtMCUs\<version>\lib\cmake\Qul\toolchain\armgcc.cmake \
          -DQUL_GENERATORS=<PATH_TO_INSTALLED_QT_SDK>\QtMCUs\<version>\lib\cmake\Qul\QulGenerators.cmake \
    ninja install
  • Use the custom Qt Quick Ultralite to build your application, which is not part of the Qt Quick Ultralite source tree:
    cd some\path\custom_builds
    mkdir app # Put your application here. You can use the redbutton example from the SDK.
    cd app
    mkdir build
    cd build
    set QUL_DIR=some\path\custom_builds\qul
    cmake .. \
          -G "Ninja" \
          -DCMAKE_BUILD_TYPE=Release \
          -DCMAKE_TOOLCHAIN_FILE=some\path\custom_builds\qul\lib\cmake\Qul\toolchain\armgcc.cmake \
          -DQUL_GENERATORS=<PATH_TO_INSTALLED_QT_SDK>\QtMCUs\<version>\lib\cmake\Qul\QulGenerators.cmake \
    ninja flash_<YOUR_APP_NAME>


You can use Renesas Flash Programmer in order to flash the Automotive demo binary to the RH850 D1M1A board. The binary can be found in the following location build_rh850\demos\automotive\automotive.run

  1. Launch Renesas Flash Programmer
  2. Create new project by using menu File > New Project...

  3. Enter desired project name and location. Click Connect button

  4. When Set Clock window appears, enter 8 MHz as Main Clock Frequency and click OK button

  5. When the setup completes, you should see Operation Completed message in the output window
  6. In main window, ensure that the Operation tab is selected. Click the Browse... button, and navigate to directory that contains the compiled binary and select it.
  7. Click the Start button and wait for the operation to complete
  8. Disconnect Renesas flash programmer from the board


You can use Renesas e2 studio to debug applications built with QUL.

  1. Open Renesas e2 studio
  2. Create new C/C++ Project
  3. Select Renesas Debug Only Project
  4. Enter Project name and click Next >
  5. Select Debug hardware depends on which debug probe you have E1 (RH850) or E2 (RH850)
  6. Select RH850 > RH850/D1M1A-V2 > R7F701462 as a Target Device
  7. Provide executable path to binary you want debug, e.g. %Qul_DIR%\build_rh850\examples\chess\chess.run
  8. Select Finish
  9. Select Launch in 'Debug' mode
  10. GDB server will upload your binary to the target and start debugging

Available under certain Qt licenses.
Find out more.