CHAPTER 18 CONFIGURATOR CF850V4
This chapter explains configurator CF850V4, which is provided by the RI850V4 as a utility tool useful for system construction.
To build systems (load module) that use functions provided by the RI850V4, the information storing data to be provided for the RI850V4 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 RI850V4 provides a utility tool (configurator "CF850V4") that converts a system configuration file which excels in descriptiveness and readability into information files.
The CF850V4 reads the system configuration file as an input file, and then outputs information files.
- System information table file
An information file that contains data related to OS resources (base clock interval, maximum priority, management object, or the like) required by the RI850V4 to operate.
An information file that contains data related to OS resources (base clock interval, maximum priority, management object, or the like) required by the RI850V4 to operate.
- System information header file
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.
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.
- Entry file
A routine (Interrupt entry processing) dedicated to entry processing that holds processing to branch to the relevant processing (such as interrupt preprocessing "_kernel_int_entry") for the handler address to which the CPU forcibly passes control when an EI level maskable interrupt occurs.
A routine (Interrupt entry processing) dedicated to entry processing that holds processing to branch to the relevant processing (such as interrupt preprocessing "_kernel_int_entry") for the handler address to which the CPU forcibly passes control when an EI level maskable interrupt occurs.
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.
Note 2 When the command file name (including the path) includes a space, surround <command file> by double-quotation marks (").
Note 1 When the -cpu option is omitted, the CF850V4 ignores this activation option setting and outputs an information file for a single-core configuration.
- -cpu D <name>
Specifies the device specification name for the target device (the character string of the device file name excluding the first character "d" and extension ".dvf").
Specifies the device specification name for the target device (the character string of the device file name excluding the first character "d" and extension ".dvf").
Note 1 When the device file name is dr7f701007.dvf, the character string specified for <name> should be r7f701007.
Note 2 When -peid=<id> is specified, information regarding the specified PE number is read from the device 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.
- -i D <SIT file>
Specify the output file name (system information table file name) while the CF850V4 is activated.
Specify the output file name (system information table file name) while the CF850V4 is activated.
If omitted The CF850V4 assumes that the following activation option is specified, and performs processing.
Note 2 When the output file name includes a space, surround <SIT file> by double-quotation marks (").
Note 3 If this activation option is specified together with -ni, the CF850V4 handles -ni as the valid option.
If omitted The CF850V4 assumes that the following activation option is specified, and performs processing.
Note 2 When the output file name includes a space, surround <Entry file> by double-quotation marks (").
Note 3 If this activation option is specified together with -ne, the CF850V4 handles -ne as the valid option.
- -d D <Header file>
Specify the output file name (system information header file name) while the CF850V4 is activated.
Specify the output file name (system information header file name) while the CF850V4 is activated.
If omitted If omitted The CF850V4 assumes that -d D kernel_id.h is specified and performs processing.
Note 2 When the output file name includes a space, surround <Header file> by double-quotation marks (").
Note 3 If this activation option is specified together with -nd, the CF850V4 handles -nd as the valid option.
Note If this activation option is specified together with -i D <SIT file>, the CF850V4 handles this activation option as the valid option.
Note If this activation option is specified together with -e D <Entry file>, the CF850V4 handles this activation option as the valid option.
Note If this activation option is specified together with -d D <Header file>, the CF850V4 handles this activation option as the valid option.
- -t D <TOOL name>
Specifies the type of the C compiler package used.
Only REL and GHS can be specified for tool as the keyword.
Specifies the type of the C compiler package used.
Only REL and GHS can be specified for tool as the keyword.
- -T D <Compiler path>
Specifies the command search <Compiler path> folder for the C preprocessor of the C compiler package specified by -t D <TOOL name>.
Specifies the command search <Compiler path> folder for the C preprocessor of the C compiler package specified by -t D <TOOL name>.
If omitted The CF850V4 searches commands from a folder specified by environment variable (such as PATH).
Note 2 When the search path includes a space, surround <Compiler path> by double-quotation marks (").
- -I D <Include path>
Specifies the command search <Include path> folder for <Header file> specified by Header file declaration.
Specifies the command search <Include path> folder for <Header file> specified by Header file declaration.
If omitted The CF850V4 starts searching from a folder where the input file specified by <CF file> is stored, the current folder, default search target folder of the C compiler package specified by -t D <TOOL name> in that order.
Note 2 When the search path includes a space, surround <Include path> by double-quotation marks (").
- -np
Disables C preprocessor activation when the CF850V4 finished the analysis for syntax included in the system configuration file.
Disables C preprocessor activation when the CF850V4 finished the analysis for syntax included in the system configuration file.
If omitted The CF850V4 activates the C preprocessor of the C compiler package specified by -t D <TOOL name>.
- -intbp=<Interrupt Base Address>
Specifies the base address of the interrupt handler address table, which is necessary when the entry file is output with the table reference method.
Specifies the base address of the interrupt handler address table, which is necessary when the entry file is output with the table reference method.
If omitted If both this activation option and -ebase=<Exception Base Address> are omitted, the CF850V4 performs processing with the assumption that the direct vector method based on the reset vector address is selected as [Generate method] for the entry file.
The reset vector address is set to the default value defined in the device file that is specified in -cpu D <name>. If the reset vector address value cannot be obtained from the device file, an error will occur.
The reset vector address is set to the default value defined in the device file that is specified in -cpu D <name>. If the reset vector address value cannot be obtained from the device file, an error will occur.
Note 1 A value from 0x200 to 0xfffff800 can be specified as the base address <Interrupt Base Address>.
Note 2 If this activation option is specified together with -ebase=<Exception Base Address>, the CF850V4 handles this activation option as the valid option.
- -ebase=<Exception Base Address>
Specifies the exception handler vector address, which is necessary when the entry file is output with the direct vector method.
Specifies the exception handler vector address, which is necessary when the entry file is output with the direct vector method.
If omitted If both this activation option and -intbp=<Interrupt Base Address> are omitted, the CF850V4 performs processing with the assumption that the direct vector method based on the reset vector address is selected as [Generate method] for the entry file.
The reset vector address is set to the default value defined in the device file that is specified in -cpu D <name>. If the reset vector address value cannot be obtained from the device file, an error will occur.
The reset vector address is set to the default value defined in the device file that is specified in -cpu D <name>. If the reset vector address value cannot be obtained from the device file, an error will occur.
Note 1 A value from 0x200 to 0xfffffe00 can be specified as the vector address <Exception Base Address>.
Note 2 If this activation option is specified together with -intbp=<Interrupt Base Address>, the CF850V4 handles -intbp=<Interrupt Base Address> as the valid option.
Note If this activation option is specified, the CF850V4 handles other activation options as invalid options and suppresses outputting of information files.
Note If this activation option is specified, the CF850V4 handles other activation options as invalid options and suppresses outputting of information files.
This is started when CS+ performs a build, in accordance with the setting on the Property panel, on the [System Configuration File Related Information] tab.
The CF850V4 performs command file support from the objectives that eliminate specified probable activation option character count restrictions in the command lines.
In these examples, "C>" indicates the command prompt, "D" indicates the space key input, and "<Enter>" indicates the ENTER key input.
1 ) System configuration file sys.cfg is loaded from the current folder, the device file corresponding to the device specification name r7f701z03 is loaded from the C:\CS+\CC\Device\RH850\Devicefile folder as an input file, and system information table file sit.s, entry file entry.s for the direct vector method (vector address: 0x200), and system information header file kernel_id.h are then output. Command search processing for the preprocessor of the C compiler package from Renesas Electronics is done in the following order, and the relevant preprocessor is activated when the CF850V4 has finished the analysis for the syntax of the system configuration file.
File search processing for the header files specified in the header file information is performed in the following order.