Create a RTV Project

Create an RTV project to test the source files that exist in the RTV environment.

When building source files in the RTV environment, you can extract the information needed to create the RTV project.
This chapter describes how to create an RTV project by using pre-extracted source file build information(using the Controller Tester RTV Server Utility) in the RTV environment, or extracting information at the same time as building the source file.

To create an RTV project, run the [Create Project Wizard].
Click [File] -> [New] or Shortcut.

C/C++ Project from RTV Build

It is selected when creating an RTV project using pre-extracted source file build information (using the Controller Tester RTV Server Utility) in the RTV environment.

1. Enter the project name in [Project name].
   

2. A list of RTV Toolchains appears in the [Select Toolchain]. Select the RTV toolchain to use.
3. After selecting the toolchain, then click the [Next] button. You can see the list of source file builds pre-extracted from the RTV server.
   

*Among the generated projects, ‘All_Sources_Project Name’ is a project that combines all the source files of the modules captured by csbuild. Since this project is a combined project without considering whether it is built or not, it may not be able to perform the test normally.

4. In the [Build Project List], select the item for which you want to create the RTV project and click the [Next] button.
   

5. After selecting source files to be tested, click the [Finish] button to create the project.

C/C++ Project from RTV Build Command

It is selected when creating an RTV project by extracting information at the same time as building the source file. The user builds the source file on the RTV server using the build command and then creates the RTV project.

1. Enter the project name in [Project name].
   

2. A list of RTV Toolchains appears in the toolchain list. Select the RTV toolchain to use.
3. After selecting the toolchain, click the [Next] button. The build will be performed on the RTV server from which the selected toolchain was imported.
   

4. Enter the path to build from the RTV server (for example, the directory where the make file is located), and enter the build command.
5. In [Build Log], specify the path to the build results file.
   The default location is the .metadata directory of the workspace. If you uncheck [Use default location], you can change the path.
6. After entering the required information for the build, click the [Next] button. It builds the source file on the RTV server with the entered build command (depending on the build target, it can take a lot of time).
7. When the build is complete, a list of built projects appears.
   

*Among the generated projects, ‘All_Sources_Project Name’ is a project that combines all the source files of the modules captured by csbuild. Since this project is a combined project without considering whether it is built or not, it may not be able to perform the test normally.

8. In the [Build Project List], select the item for which you want to create the RTV project and click the [Next] button.
   

9. When creating the RTV project, select the source file to be included and click the [Finish] button to create the project.

RTV build command

To create a project from build information, you must use the csbuild command on the build command.

csbuild command

The cs is a utility that automatically extracts the Controller Tester project configuration information of the source files that are built so that the Controller Tester RTV project can be created.

How to use csbuild

Prefix the existing build command with csbuild.

• Ex) make → csbuild capture make
  

csbuild option

new: Generate the necessary information before extracting build commands. Specify the toolchain with the --toolchain option and the project name with the --project option.

• Ex) csbuid new --toolchain=gcc5.4 --project=PRJ
  

!The --toolchain option is required.

capture: Creates an RTV project by performing build command extraction.

• Ex) csbuild capture make
  

convert: Convert a STATIC project to an RTV project.

• Ex) csbuild convert