CHAPTER 18 CONFIGURATOR CF850V4

This chapter explains configurator CF850V4, which is provided by the RI850V4 as a utility tool useful for system construction.

18.1 Outline

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.

The information files output from the CF850V4 are explained below.

- 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.

- 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.

- 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.

18.2 Activation Method

18.2.1 Activating from command line

The following is how to activate the CF850V4 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> cf850v4.exe D [@<command file>] D [-peid=<id>] D [-cpu D <name>] D [-devpath=<path>] D [-i D <SIT file>] D [-e D <Entry file>] D [-d D <Header file>] D [-ni] D [-ne] D [-nd] D [-t D <TOOL name>] D [-T D <Compiler path>] D [-I D <Include path>] D [-np] D [-intbp=<Interrupt Base Address>] D [-ebase=<Exception Base Address>] 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 command file name <command file> within 255 characters including the path name.

Note 2 When the command file name (including the path) includes a space, surround <command file> by double-quotation marks (").

Note 3 For details about the command file, refer to "18.2.3 Command file".

- -peid=<id>
Specifies the target PE number for which the application with RI850V4 is allocated.

If omitted The CF850V4 performs processing with the assumption that -peid=1 is specified.

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.

Note 2 A value from 1 to the maximum PE number in the target device can be specified for <id>.

- -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").

If omitted When the CC-RH compiler is used, -ne must be specified as the CF850V4 activation option.

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.

If omitted The device file is retrieved for the current folder.

Note 1 Specify the search path <path> within 255 characters.

Note 2 When the search path includes a space, surround <path> by double-quotation marks (").

- -i D <SIT file>
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.

REL Compiler (CC-RH) is used : -i D sit.s

Green Hills Compiler (CCV850) is used : -i D sit.850

Note 1 Specify the output file name <SIT file> within 255 characters including the path name.

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.

- -e D <Entry file>
Specify the output file name (entry file name) while the CF850V4 is activated.

If omitted The CF850V4 assumes that the following activation option is specified, and performs processing.

REL Compiler (CC-RH) is used : -e D entry.s

Green Hills Compiler (CCV850) is used : -e D entry.850

Note 1 Specify the output file name <Entry file> within 255 characters including the path name.

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.

If omitted If omitted The CF850V4 assumes that -d D kernel_id.h is specified and performs processing.

Note 1 Specify the output file name <Header file> within 255 characters including the path name.

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.

- -ni
Disables output of the system information table file.

If omitted The system information table file is output.

Note If this activation option is specified together with -i D <SIT file>, the CF850V4 handles this activation option as the valid option.

- -ne
Disables output of the entry file.

If omitted The entry file is output.

Note If this activation option is specified together with -e D <Entry file>, the CF850V4 handles this activation option as the valid option.

- -nd
Disables output of the system information header file.

If omitted If omitted The CF850V4 assumes that -d D kernel_id is specified and performs processing.

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.

If omitted The CF850V4 assumes that -t D REL is specified and performs processing.

- -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>.

If omitted The CF850V4 searches commands from a folder specified by environment variable (such as PATH).

Note 1 Specify the command search path name <Compiler path> within 255 characters.

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.

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 1 Specify the command search path name <Include path> within 255 characters.

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.

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.

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.

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.

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.

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.

- -V
Outputs version information for the CF850V4 to the standard output.

Note If this activation option is specified, the CF850V4 handles other activation options as invalid options and suppresses outputting of information files.

- -help
Outputs the usage of the activation options for the CF850V4 to the standard output.

Note If this activation option is specified, the CF850V4 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 When the input file name includes a space, surround <CF file> by double-quotation marks (").

Note 3 This input file name can be omitted only when -V or -help is specified.

18.2.2 Activating from CS+

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.

18.2.3 Command file

The CF850V4 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 ) Character code
Create a command file using ASCII code.

Note Shift-JIS and EUC-JP codes can be used only for comments.

2 ) Comment
A line beginning with # is handled as a comment.

3 ) Delimiter
A space, a tab, or a new-line character is handled as a delimiter.

4 ) Maximum number of lines
Up to 50 lines can be coded in a command file.

5 ) Maximum number of characters
Up to 16,384 characters per line can be coded in a command file.

An example of a command file is shown below.

In this example, the following activation options are included.

Target processor name: r7f701z03

Device file search folder: C:\CS+\CC\Device\RH850\Devicefile

System information table file name: sit.s

Entry file name: entry.s

System information header file name: kernel_id.h

C compiler package type: REL

Command search path for C compiler package: C:\CS+\CC\CC-RH\V1.00.00\bin

Header file declaration search folder: C:\tmp\inc850, and C:\Program Files\Sample\include

Vector address: 0x200

System configuration file name: sys.cfg

Figure 18-1 Example of Command File Description

# Command File -cpu rf701z03 -devpath=C:\CS+\CC\Device\RH850\Devicefile -i sit.s -e entry.s -d kernel_id.h -t REL -T C:\CS+\CC\CC-RH\V1.00.00\bin -I C:\tmp\inc850 -I "C:\Program Files\Sample\include" -ebase=0x200 sys.cfg

18.2.4 Command input examples

The following shows CF850V4 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 ) 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.

1. C:\CS+\CC\CC-RH\V1.00.00\bin

2. Folders defined by environment variables (such as PATH)

File search processing for the header files specified in the header file information is performed in the following order.

1. C:\tmp\inc850

2. C:\Program Files\Sample\include

C> cf850v4 D -cpu D rf701z03 D -devpath=C:\CS+\CC\Device\RH850\Devicefile D -i D sit.s D -e D entry.s D -d D kernel_id.h D -t D REL D -T D C:\CS+\CC\CC-RH\V1.00.00\bin D -I D C:\tmp\inc850 D -I D "C:\Program Files\Sample\include" D -ebase=0x200 D sys.cfgEnter

2 ) CF850V4 version information is output to the standard output.

C> cf850v4 D -V [Enter]

3 ) Information related to the CF850V4 activation option (type, usage, or the like) is output to the standard output.

C> cf850v4 D -help [Enter]