CHAPTER 13 SYSTEM CONFIGURATION FILE


This chapter explains the coding method of the system configuration file required to output information files (system information table file, system information header file and interrupt information definition file) that contain data to be provided for the RI78V4.

13.1 Notation Method

The following shows the notation method of system configuration files.

- Character code
Create the system configuration file using ASCII code.
The CF78V4 distinguishes lower cases "a to z" and upper cases "A to Z".



Note For japanese language coding, Shit-JIS codes can be used only for comments.

- Comment
In a system configuration file, parts between /* and */ and parts from two successive slashes (//) to the line end are regarded as comments.


- Numeric
In a system configuration file, words starting with a numeric value (0 to 9) are regarded as numeric values.
The CF78V4 distinguishes numeric values as follows.



Octal: Words starting with 0

Decimal: Words starting with a value other than 0

Hexadecimal: Words starting with 0x or 0X

Note Elements of a word are limited to numeric values 0 to 9.

- Object name
In a system configuration file, words starting with a letter of "a to z, A to Z", or underscore "_", within 24 characters, are regarded as object names.


Note Elements of a word are limited to alphanumeric characters "a to z, A to Z, 0 to 9", and underscore "_".

- Symbol name
In a system configuration file, words starting with a letter of "a to z, A to Z", or underscore "_", within 30 characters, are regarded as symbol names.


Note 1 Elements of a word are limited to alphanumeric characters "a to z, A to Z, 0 to 9", and underscore "_".

Note 2 The CF78V4 distinguishes the object name and symbol name according to the context in the system configuration file.

- Keywords
The words shown below are reserved by the CF78V4 as keywords.
Using these words for any other purpose specified is therefore prohibited.



CLK_INTNOCRE_CYCCRE_DTQCRE_FLGCRE_MBXCRE_MPFCRE_SEMCRE_TSKDEF_INH.kernel_work0.kernel_work1.kernel_work2.kernel_work3MAX_PRInullNULLSYS_STKTA_ACTTA_ASMTA_CLRTA_DISINTTA_ENAINTTA_FARTA_HLNGTA_MFIFOTA_MPRITA_NEARTA_PHSTA_RSTRTA_STATA_TFIFOTA_TPRITA_WMULTA_WSGL

Note The CF78V4 does not call C preprocessors. Coding of preprocessing directives (#include, #define, #if, or the like) in the system configuration file is therefore prohibited.

13.2 Configuration Information

The configuration information that is described in a system configuration file is divided into the following two main types.

- System Information
This information consists of fundamental data required for the RI78V4 operation.

- System stack information

- Task priority information

- Clock timer interrupt source

- Static API Information
This information consists of data for management objects required to implement the functions probided by the RI78V4.

- Task information

- Semaphore information

- Eventflag information

- Data queue information

- Mailbox information

- Fixed-sized memory pool information

- Cyclic handler information

- Interrupt handler information

13.2.1 Cautions

The following describes a system configuration file description format.

Figure 13-1 System Configuration File Description Format

 -- System Information (System stack information, etc.) descriptin
 /* ............ */
 
 -- Static API Information(Task information, etc.) description
 /* ............ */


Note Up to 40,000 lines and up to 1,000 characters per line can be written in a system configuration file.