C

RENESAS板子的命令行设置

本页提供了使用命令行设置您为 RENESAS 板开发环境的说明。

在开始之前

在配置命令行环境之前，请安装通用和板级特定的先决条件。有关更多信息，请参阅先决条件。

QUL_ROOT 和 QUL_TOOLS 在以下命令行示例中用作环境变量。例如

LinuxWindows

export QUL_ROOT=$HOME/Qt/QtMCUs/2.8.0
export QUL_TOOLS=$HOME/Qt/Tools/QtMCUs

set QUL_ROOT=C:\Qt\QtMCUs\2.8.0
set QUL_TOOLS=C:\Qt\Tools\QtMCUs

警告：使用 Ninja 生成器进行构建时，在 GHS 上的增量构建失败。Qt 建议使用 NMake Makefiles 或 NMake Makefiles JOM。

设置RH850/D1M1A的开发环境

为 RH850/D1M1A 配置以下 CMake 变量。有关更多信息，请参阅 CMake 手册。

变量	步骤
Qul_ROOT	将 `Qul_ROOT` 设置为 Qt for MCUs SDK 安装路径。 LinuxWindows -DQul_ROOT=$QUL_ROOT -DQul_ROOT=%QUL_ROOT% 注意：此 CMake 变量有意混写大小写，因为需要与包名匹配。
QUL_PLATFORM	平台名称必须指示您想要的目标板和操作系统。它是所选板的名称和您想要的目标操作系统的组合。以下示例中的平台名称表示目标为 `RH850/D1M1A` 和 `baremetal`。 -DQUL_PLATFORM=rh850-d1m1a-baremetal 注意：如果您想针对另一块板或操作系统，请参阅支持的平台了解更多信息。
CMAKE_TOOLCHAIN_FILE	将 `CMAKE_TOOLCHAIN_FILE` 设置为 GHS 工具链。 LinuxWindows -DCMAKE_TOOLCHAIN_FILE=$QUL_ROOT/lib/cmake/Qul/toolchain/ghs.cmake -DCMAKE_TOOLCHAIN_FILE=%QUL_ROOT%\lib\cmake\Qul\toolchain\ghs.cmake
QUL_TARGET_TOOLCHAIN_DIR	使用 `QUL_TARGET_TOOLCHAIN_DIR` 来设置工具链的位置。 LinuxWindows -DQUL_TARGET_TOOLCHAIN_DIR=/path/to/the/toolchain -DQUL_TARGET_TOOLCHAIN_DIR=C:\path\to\the\toolchain 注意：在给定的 `QUL_TARGET_TOOLCHAIN_DIR` 中定位的工具链必须与 `CMAKE_TOOLCHAIN_FILE` 中指定的工具链匹配。
QUL_COLOR_DEPTH	使用 `QUL_COLOR_DEPTH` 来设置平台支持的色彩深度。RH850/D1M1A的参考端口支持32bpp色彩深度。 -DQUL_COLOR_DEPTH=32 注意：如果没有设置此变量，配置平台时将使用默认色彩深度。
PROBE_TYPE	使用 `PROBE_TYPE` 来选择Renēsa调试探针类型，该类型被Renēsa闪存编程器用于烧写二进制文件。支持的探针类型包括 `E1`、`E2` 和 `E20`。 -DPROBE_TYPE=E2 注意：如果未设置此变量，Renēsa闪存编程器将使用默认的探针类型（`E1`）。
QUL_BOARD_SDK_DIR	将 CMake 缓存条目 `QUL_BOARD_SDK_DIR` 设置为 Renēsa 图形库的安装路径。例如： LinuxWindows -DQUL_BOARD_SDK_DIR=$HOME/Renesas_Electronics/D1x_RGL/rgl_ghs_D1Mx_obj_V2.1.0a -DQUL_BOARD_SDK_DIR=C:\Renesas_Electronics\D1x_RGL\rgl_ghs_D1Mx_obj_V2.1.0a
针对 RH850/D1M1A 的可选配置
RENESAS_FLASH_PROGRAMMER_PATH	将可选的 CMake 缓存条目 `RENESAS_FLASH_PROGRAMMER_PATH` 设置为 Renēsa闪存编程器的安装路径。例如： LinuxWindows -DRENESAS_FLASH_PROGRAMMER_PATH="$HOME/Renesas Electronics/Renesas Flash Programmer" -DRENESAS_FLASH_PROGRAMMER_PATH="C:\Program Files (x86)\Renesas Electronics\Renesas Flash Programmer" 注意：如果找到 Renēsa闪存编程器软件包，则创建闪存目标。

为 EK-RA6M3G 配置开发环境

请配置以下 CMake 变量以适用于 EK-RA6M3G。有关更多信息，请参阅CMake 手册。

变量	步骤
Qul_ROOT	将 `Qul_ROOT` 设置为 Qt for MCUs SDK 安装路径。 LinuxWindows -DQul_ROOT=$QUL_ROOT -DQul_ROOT=%QUL_ROOT% 注意：此 CMake 变量有意混写大小写，因为需要与包名匹配。
QUL_PLATFORM	使用 `ek-ra6m3g-baremetal` 来设置适用于 EK-RA6M3G 板的平台。 -DQUL_PLATFORM=ek-ra6m3g-baremetal
`FREERTOS_DIR`	FreeRTOS 源目录的绝对路径。仅当配置 FreeRTOS 目标时是必需的。有关 FreeRTOS 平台的更多信息，请参阅FreeRTOS 平台。 -DFREERTOS_DIR=< FreeRTOS directory path >
CMAKE_TOOLCHAIN_FILE	将 `CMAKE_TOOLCHAIN_FILE` 设置为 Arm GCC 或 IAR 工具链。LinuxWindows -DCMAKE_TOOLCHAIN_FILE=$QUL_ROOT/lib/cmake/Qul/toolchain/armgcc.cmake -DCMAKE_TOOLCHAIN_FILE=%QUL_ROOT%\lib\cmake\Qul\toolchain\armgcc.cmake
QUL_TARGET_TOOLCHAIN_DIR	使用 `QUL_TARGET_TOOLCHAIN_DIR` 来设置工具链的位置。 LinuxWindows -DQUL_TARGET_TOOLCHAIN_DIR=/path/to/the/toolchain -DQUL_TARGET_TOOLCHAIN_DIR=C:\path\to\the\toolchain
QUL_COLOR_DEPTH	使用 `QUL_COLOR_DEPTH` 来设置平台支持的颜色深度。EK-RA6M3G 候选端口支持 16bpp 颜色深度。 -DQUL_COLOR_DEPTH=16 注意：如果没有设置此变量，配置平台时将使用默认色彩深度。
QUL_BOARD_SDK_DIR	将此变量设置为 Renēsa 可灵活选择的软件包（FSP）的安装路径。例如 LinuxWindows -DQUL_BOARD_SDK_DIR=$QUL_TOOLS/Renesas/fsp-<version> -DQUL_BOARD_SDK_DIR=%QUL_TOOLS%\Renesas\fsp-<version>
JLINK_PATH	如果 SEGGER J-Link 未安装在默认位置，则将 CMake 缓存条目 `JLINK_PATH` 设置为 SEGGER J-Link 的安装路径。例如 LinuxWindows -DJLINK_PATH=/opt/SEGGER/JLink -DJLINK_PATH=C:\tools\SEGGER\JLink 注意确保入口值不包含空格。如果找到 J-Link 软件包，则创建闪存目标。

为 EK-RA8D1 配置开发环境

变量	步骤
QUL_PLATFORM	使用 `ek-ra8dm1-baremetal` 来设置适用于 EK-RA8D1 板的平台。 -DQUL_PLATFORM=ek-ra8dm1-baremetal

除板级特定的 QUL_PLATFORM 变量（ek-ra8dm1-baremetal）和 FREERTOS_DIR 以外，EK-RA6M3G 的 CMake 值也适用于 EK-RA8D1，因为 EK-RA8D1 只包含裸机平台适配。注意 FREERTOS_DIR 在 EK-RA8D1 上无效，因为它只包含裸机平台适配。

注意：在 Qt Quick Ultralite 项目中，默认将 CMAKE_BUILD_TYPE 设置为 MinSizeRel。MinSizeRel 是用于与 Qt Quick Ultralite 一起提供的预构建平台库的构建类型。要更改构建类型（例如，要更改为 Release），请使用 -DCMAKE_BUILD_TYPE=Release 选项调用 CMake。有关更多信息，请参阅CMAKE_BUILD_TYPE。

使用预构建 Qt Quick Ultralite 库构建示例应用程序

为 RH850/D1M1A 构建示例应用程序

以下命令用于构建RH850/D1M1A的minimal示例

LinuxWindows

cd $QUL_ROOT/examples/minimal
mkdir build
cd build
cmake .. -G "Ninja" -DCMAKE_BUILD_TYPE=MinSizeRel -DQul_ROOT=$QUL_ROOT -DCMAKE_TOOLCHAIN_FILE=$QUL_ROOT/lib/cmake/Qul/toolchain/ghs.cmake -DQUL_TARGET_TOOLCHAIN_DIR=/opt/ghs/comp_201815 -DQUL_PLATFORM=rh850-d1m1a-baremetal -DQUL_BOARD_SDK_DIR=$HOME/Renesas_Electronics/D1x_RGL/rgl_ghs_D1Mx_obj_V2.1.0a -DRENESAS_FLASH_PROGRAMMER_PATH="$HOME/Renesas Electronics/Renesas Flash Programmer"
cmake --build .

cd %QUL_ROOT%\examples\minimal
mkdir build
cd build
cmake .. -G "Ninja" -DCMAKE_BUILD_TYPE=MinSizeRel -DQul_ROOT=%QUL_ROOT% -DCMAKE_TOOLCHAIN_FILE=%QUL_ROOT%\lib\cmake\Qul\toolchain\ghs.cmake -DQUL_TARGET_TOOLCHAIN_DIR=C:\ghs\comp_201815 -DQUL_PLATFORM=rh850-d1m1a-baremetal -DQUL_BOARD_SDK_DIR=C:\Renesas_Electronics\D1x_RGL\rgl_ghs_D1Mx_obj_V2.1.0a -DRENESAS_FLASH_PROGRAMMER_PATH="C:\Program Files (x86)\Renesas Electronics\Renesas Flash Programmer"
cmake --build .

为EK-RA6M3G构建示例应用程序

以下命令用于为EK-RA6M3G构建minimal示例

LinuxWindows

cd $QUL_ROOT/examples/minimal
mkdir build
cd build
cmake .. -G "Ninja" -DCMAKE_BUILD_TYPE=MinSizeRel -DQul_ROOT=$QUL_ROOT -DCMAKE_TOOLCHAIN_FILE=$QUL_ROOT/lib/cmake/Qul/toolchain/armgcc.cmake -DQUL_TARGET_TOOLCHAIN_DIR=$QUL_TOOLS/arm_gcc_12_3_1 -DQUL_PLATFORM=EK-RA6M3G-baremetal -DQUL_BOARD_SDK_DIR=$QUL_TOOLS/Renesas/fsp-5.2.0 -DJLINK_PATH=/opt/SEGGER/JLink
cmake --build .

cd %QUL_ROOT%\examples\minimal
mkdir build
cd build
cmake .. -G "Ninja" -DCMAKE_BUILD_TYPE=MinSizeRel -DQul_ROOT=%QUL_ROOT% -DCMAKE_TOOLCHAIN_FILE=%QUL_ROOT%\lib\cmake\Qul\toolchain\armgcc.cmake -DQUL_TARGET_TOOLCHAIN_DIR=%QUL_TOOLS%\arm_gcc_12_3_1 -DQUL_PLATFORM=EK-RA6M3G-baremetal -DQUL_BOARD_SDK_DIR=%QUL_TOOLS%\Renesas\fsp-5.2.0 -DJLINK_PATH=%PROGRAMFILES%\SEGGER\JLink
cmake --build .

为EK-RA8D1构建示例应用程序

以下命令用于为EK-RA8D1构建minimal示例

LinuxWindows

cd $QUL_ROOT/examples/minimal
mkdir build
cd build
cmake .. -G "Ninja" -DCMAKE_BUILD_TYPE=MinSizeRel -DQul_ROOT=$QUL_ROOT -DCMAKE_TOOLCHAIN_FILE=$QUL_ROOT/lib/cmake/Qul/toolchain/armgcc.cmake -DQUL_TARGET_TOOLCHAIN_DIR=$QUL_TOOLS/arm_gcc_12_2_mpacbti_rel1 -DQUL_PLATFORM=EK-RA8D1-baremetal -DQUL_BOARD_SDK_DIR=$QUL_TOOLS/Renesas/fsp-5.2.0 -DJLINK_PATH=/opt/SEGGER/JLink
cmake --build .

cd %QUL_ROOT%\examples\minimal
mkdir build
cd build
cmake .. -G "Ninja" -DCMAKE_BUILD_TYPE=MinSizeRel -DQul_ROOT=%QUL_ROOT% -DCMAKE_TOOLCHAIN_FILE=%QUL_ROOT%\lib\cmake\Qul\toolchain\armgcc.cmake -DQUL_TARGET_TOOLCHAIN_DIR=%QUL_TOOLS%\arm_gcc_12_2_mpacbti_rel1 -DQUL_PLATFORM=EK-RA8D1-baremetal -DQUL_BOARD_SDK_DIR=%QUL_TOOLS%\Renesas\fsp-5.2.0 -DJLINK_PATH=%PROGRAMFILES%\SEGGER\JLink
cmake --build .

烧录示例应用程序

成功构建minimal示例应用程序后，使用以下命令进行烧录

cmake --build . --target flash_minimal

注意：相同的步骤适用于任何其他应用程序。

在瑞萨开始 EK-RA6M3G套件

在某些Qt许可下提供。
了解更多。