CHAPTER 21 CONFIGURATOR cfg600px

---

This chapter explains configurator cfg600px.

21.1 Outline

To build systems (load module) that use functions provided by the RI600PX, the information storing data to be provided for the RI600PX is required.

Since information files are basically enumerations of data, it is possible to describe them with various editors.

Information files, however, do not excel in descriptiveness and readability; therefore substantial time and effort are required when they are described.

To solve this problem, the RI600PX provides a utility tool (configurator "cfg600px") that converts a system configuration file which excels in descriptiveness and readability into information files.

The cfg600px reads the system configuration file as a input file, and then outputs information files.

The information files output from the cfg600px are explained below.

- System information header file (kernel_id.h)
An information file that contains the correspondence between object names (task names, semaphore names, or the like) described in the system configuration file and IDs.

- Service call definition file (kernel_sysint.h)
The declaration for issuing service calls by using INT instruction is described in this file. This file is included by kernel.h.

- ROM definition file (kernel_rom.h), RAM definition file (kernel_ram.h)
These files contain the RI600PX management data. These files must be included only by the boot processing file. For details, refer to "17.2 Boot Processing File (User-Own Coding Module)".

- System definition file (ri600.inc)
The system definition file is included by the table file (ritable.src) which is generated by the mktitbl.

- Vector table template file (vector.tpl)
The vector table template file is input to the mkritblpx.

- CMT timer definition file (ri_cmt.h)
When either of CMT0, CMT1, CMT or CMT3 is specified for Selection of timer channel for base clock (timer) for in Base Clock Interrupt Information (clock), the Template file (template) is retrieved from the folder indicated by the environment variable "LIB600", and the retrieved file is output after it is renamed to "ri_cmt.h". The CMT timer definition file is used for the base clock timer initialization routine. For details, refer to "10.9 Base Clock Timer Initialization Routine (_RI_init_cmt_knl( ))".

21.2 Start cfg600px

21.2.1 Start cfg600px from command line

IIt is necessary to set the environment variable "LIB600" to "<ri_root>\lib600" beforehand.

The following is how to activate the cfg600px from the command line.

Note that, in the examples below, "C>" indicates the command prompt, "D" indicates pressing of the space key, and "<Enter>" indicates pressing of the enter key.

The options enclosed in "[ ]" can be omitted.

C> cfg600px.exe D [-U] D [-v] D [-V] D file <Enter>

The output files are generated to the current folder.

The details of each option are explained below:

- -U
When an undefined interrupt occurs, the system down is caused. When -U option is specified, the vector number will be transferred to the system down routine (refer to "CHAPTER 15 SYSTEM DOWN"). This is useful for debugging. However, the kernel code size increases by about 1.5 kB.

- -v
Show a description of the command option and details of its version.

- -V
Show the creation status of files generated by the cfg600px.

- file
Specifies the system configuration file name to be input. If the filename extension is omitted, the extension ".cfg" is assumed.

Note <ri_root> indicates the installation folder of RI600PX.
The default folder is C:Program FilesRenesas ElectronicsCubeSuite+RI600PX.

21.2.2 Start cfg600px from CubeSuite+

This is started when CubeSuite+ performs a build, in accordance with the setting on the Property panel, on the [System Configuration File Related Information] tab.