Everything

CHAPTER 14 CONFIGURATOR CF78V4


This chapter explains configurator CF78V4, which is provided by the RI78V4 as a utility tool useful for system construction.
14.1 Outline
To build systems (load module) that use functions provided by the RI78V4, the information storing data to be provided for the RI78V4 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 RI78V4 provides a utility tool (configurator CF78V4) that converts a system configuration file which excels in descriptiveness and readability into information files.
The CF78V4 reads the system configuration file as a input file, and then outputs information files.
The information files output from the CF78V4 are explained below.
- System information table file
An information file that stores data required for the operation of the RI78V4.
- System information header file
An information file that stores matching between ID numbers and object names (e.g. task, and semaphore names) described in the system configuration file.
The CF78V4 can output two types of system information header files for C and assembly languages.
- Interrupt information definition file
An information file that stores related interrupt handler described in the system configuration file.
14.2 Activation Method
14.2.1 Activating from command line
The following is how to activate the CF78V4 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 activation options enclosed in "[ ]" can be omitted.
 C> cf78v4.exe D [@command file] D [-cpu D <name>] D [-devpath=path]  
    D [-i D <SIT file> |-ni] D [-dc D <C header file> | -ndc]
    D [-da D <ASM header file> | -nda] D [-V] D [-help] D <CF file> <Enter>

The details of each activation option are explained below:
- @command file
Specifies the command file name to be input.
If omitted The activation options specified on the command line is valid.
Note 1 Specify the input file name "command file" within 255 characters including the path name.
Note 2 For the details about the command file, refer to "14.2.3 Command file".
- -cpu D <name>
Specifies type specification names of target device.
If omitted If this activation option is not specified, the CF78V4 does not load the device file. As a result, definitions using interrupt source names defined in the device file can no longer be used in the system configuration file.
- -devpath=path
Retrieves the device file corresponding to the target device specified with -cpu D <name> from the path folder.
If omitted The device file is retrieved for the current folder.
- -iD<SIT file>
Specifies the system information table file name to be output.
If omitted If omitted, the CF78V4 interprets it that -iDsit.asm is specified.
Note Specify the output file name "<SIT file>" within 255 characters including the path name.
- -ni
Disables output of the system information table file.
If omitted If omitted, the CF78V4 interprets it that -iDsit.asm is specified.
- -dcD<C header file>
Specifies the system information header file (for C language) name to be output.
If omitted If omitted, the CF78V4 interprets it that -dcDkernel_id.h is specified.
Note Specify the output file name "<SIT file>" within 255 characters including the path name.
- -ndc
Disables output of the system information header file (for C language).
If omitted If omitted, the CF78V4 interprets it that -dcDkernel_id.h is specified.
- -daD<ASM header file>
Specifies the system information header file (for assembly language) name to be output.
If omitted If omitted, the CF78V4 interprets it that -daDkernel_id.inc is specified.
Note Specify the output file name "<ASM header file>" within 255 characters including the path name.
- -nda
Disables output of the system information header file (for assembly language).
If omitted If omitted, the CF78V4 interprets it that -daDkernel_id.inc .inc is specified.
- -V
Outputs version information for the CF78V4 to the standard output.
Note If this activation option is specified, the CF78V4 handles other activation options as invalid options and suppresses outputting of information files.
- -help
Outputs the usage of the activation options for the CF78V4 to the standard output.
Note If this activation option is specified, the CF78V4 handles other activation options as invalid options and suppresses outputting of information files.
- <CF file>
Specifies the system configuration file name to be input.
Note 1 Specify the input file name "<CF file>" within 255 characters including the path name.
Note 2 This input file name can be omitted only when -V or -help is specified.
14.2.2 Activating from CS+
This is started when the CS+ performs a build, in accordance with the setting on the Property panel, on the [System Configuration File Related Information] tab.
14.2.3 Command file
The CF78V4 performs command file support from the objectives that eliminate specified probable activation option character count restrictions in the command lines.
Description formats of the command file are described below.
1 ) Comment lines
Lines that start with # are treated as comment lines.
2 ) Dilimiting activation options
Delimit activation options using a space code, tab code, or a linefeed code.
Note For activation options consist of the -xxx part and parameter part, like "-iD<SIT file>", "-dcD<C header file>", and "-daD<ASM header file>", delimit the -xxx part and parameter part using a space code, tab code, or a linefeed code.
When specifying a folder name that includes a space code in the parameter part, enclose the parameter part using double-quotation marks (") as shown in Figure 14-1.
3 ) Maximum number of characters
Up to 50 lines and up to 4,096 characters per line can be coded in a command file.
The following shows an example of activation option coding whereby "system configuration file CF_file.cfg is loaded from the current folder, system information table file sit_file.asm is output to a folder in C:\Program Files\tmp, system information header file C_header.h (for C) is output to a folder in C:\tmp, system information header file ASM_header.inc (for assembly language) is output to a folder in C:\tmp".
Figure 14-1 Example of Command File Description
 # Command File
 -i "C:\Program Files\tmp\sit_file.asm"
 -dc C:\tmp\C_header.h
 -da
 "C:\tmp\ASM_header.inc"
 CF_file.cfg

14.2.4 Command input examples
The following shows the CF78V4 command input examples.
In these examples, "C>" indicates the command prompt, "D" indicates the space key input, and "<Enter>" indicates the ENTER key input.
1 ) After loading command file cmd_file from the current folder, the activation option defined in cmd_file is executed.
 C> cf78v4.exe D @cmd_file <Enter>

2 ) After loading system configuration file CF_file.cfg from the current folder, system information table file sit_file.asm, the system information header file C_header.h (for C) and system information header file ASM_header.inc (for assembly language) are output to the current folder (specified device name is R5F10A6A,and the path for device file is "C:\Program Files\Renesas Electronics\CS+\CC\Device\RL78\Devicefile".
).
 C> cf78v4.exe D -cpu D R5F10A6A D
    -devpath="C:\Program Files\Renesas Electronics\CS+\CC\Device\RL78\Devicefile"
       D -iDsit_file.asm D -dc D C_header.h D -da D ASM_header.inc
       D CF_file.cfg<Enter>

3 ) After loading system configuration file CF_file.cfg from the current folder, system information table file sit.asm, the system information header file kernel_id.h (for C) and system information header file kernel_id.inc (for assembly language) are output to the current folder.
 C> cf78v4.exe D CF_file.cfg <Enter>

4 ) After loading system configuration file CF_file.cfg from a folder in C:\tmp, system information table file sit_file.asm, the system information header file C_header.h (for C) is output to a folder in C:\tmp.
 C> cf78v4.exe D -i D C:\tmp\sit_file.asm D -dc D C:\tmp\C_header.h D -nda D
    C:\tmp\CF_file.cfg <Enter>

5 ) After loading system configuration file CF_file.cfg from a folder in C:\tmp, the system information table file sit_file.asm is output to a folder in C:\Program Files\tmp.
 C> cf78v4.exeD-i D "C:\Program Files\tmp\sit_file.asm" D -ndc D -nda D
    C:\tmp\CF_file.cfg <Enter>

6 ) CF78V4 version information is output to the standard output.
 C> cf78v4.exe D -V <Enter>

7 ) Information related to the CF78V4 activation option (type, usage, or the like) is output to the standard output.
 C> cf78v4.exe D -help <Enter>