CHAPTER 14 CONFIGURATOR CF78V4
This chapter explains configurator CF78V4, which is provided by the RI78V4 as a utility tool useful for system construction.
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.
- System information table file
An information file that stores data required for the operation of the RI78V4.
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.
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.
An information file that stores related interrupt handler described in the system configuration file.
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.
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> |
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.
Retrieves the device file corresponding to the target device specified with -cpu D <name> from the path folder.
- -dcD<C header file>
Specifies the system information header file (for C language) name to be output.
Specifies the system information header file (for C language) name to be output.
- -daD<ASM header file>
Specifies the system information header file (for assembly language) name to be output.
Specifies the system information header file (for assembly language) name to be output.
Note Specify the output file name "<ASM header file>" within 255 characters including the path name.
Note If this activation option is specified, the CF78V4 handles other activation options as invalid options and suppresses outputting of information files.
Note If this activation option is specified, the CF78V4 handles other activation options as invalid options and suppresses outputting of information files.
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.
The CF78V4 performs command file support from the objectives that eliminate specified probable activation option character count restrictions in the command lines.
2 ) Dilimiting activation options
Delimit activation options using a space code, tab code, or a linefeed code.
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.
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.
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".
# 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 |
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.
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.
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.