T-Monitor (tef_em1d use) Source Configuration

• 1. Introduction
• 2. Directory Configuration
• 3. include Directory
• 4. tmmain Directory
• 5. cmdsvc Directory
• 6. hwdepend Directory
• 7. driver Directory
• 8. bin Directory

1. Introduction

This section explains the T-Monitor source code configuration used with the T-Engine reference board (tef_em1d).

For more information about the T-Monitor functional specifications, please refer to the "T-Monitor Specifications" released by TRON Forum, and the "T-Kernel 2.0 (tef_em1d) Implementation Specification" for implementation dependencies.

2. Directory Configuration

The T-Monitor source code is included in the T-Kernel source code package.

The directory configuration diagram for the entire T-Monitor source is described below.

• The "include", "etc", and "bin" resources in the T-Monitor source directory are used to build T-Monitor.

• T-Monitor is highly dependent on the hardware that it runs on. Because it is hardware dependent for the most part, one aspect differs from the basic rules of the T-Kernel directory configuration.

• The <Model Name> is "tef_em1d".

• Some directories contain files with the name "_dmy". These are dummy files that are included for the archiver to avoid having empty directories and are not needed after extraction.

  tkernel_source
    |
    |-- ...               (T-Kernel source directory)
    |-- include                 Definition file (header file)
    |-- etc                     make rule, various scripts
    |-- bin                     Execution image file
    |
    |-- monitor           T-Monitor source directory
        |
        |-- include             Definition file (header file)
        |   `-- arm                    [Hardware dependent portion]
        |
        |-- tmmain              Overall build directory
        |   `-- build
        |       `-- <Model Name>
        |
        |-- cmdsvc              Command/service call process
        |   |-- build
        |   |   `-- <Model Name>
        |   `-- src
        |       `-- armv6             [Hardware (CPU) dependent portion]
        |
        |-- hwdepend            System dependent process [Hardware dependent portion]
        |   `-- <Model Name>
        |       |-- build
        |       `-- src
        |
        |-- driver              Device driver [Hardware dependent portion]
        |   |-- flash                 Flash ROM driver
        |   |   |-- build
        |   |   |   `-- <Model Name>
        |   |   `-- src
        |   |
        |   |-- memdisk               Memory disk driver
        |   |   |-- build
        |   |   |   `-- <Model Name>
        |   |   `-- src
        |   |
        |   `-- sio                   Serial I/O driver
        |       |-- build
        |       |   `-- <Model Name>
        |       `-- src
        |
        `-- bin                 Build result object
            `-- <Model Name>

3. include Directory

These are T-Monitor specific definition files.

The "arm" subdirectory is the hardware dependent portion.

4. tmmain Directory

This is the overall T-Monitor build directory.

Build and link all of the necessary modules together to create the T-Monitor execution image file.

The T-Monitor execution image file which is built is copied to the "tkernel_source/bin/<Model Name>" directory.

5. cmdsvc Directory

This source processes the T-Monitor commands and service calls.

The area directly below the "src" subdirectory is not hardware dependent, but the "src/armv6" subdirectory is hardware dependent (CPU only).

The object file created in the build directory is copied to the "bin/<Model Name>" directory.

6. hwdepend Directory

This source handles hardware dependent processing such as reset start, hardware initialization, exception/interrupt, and memory access.

The configuration places the "src" and "build" subdirectories under the "<Model Name>" subdirectory, because they are all hardware dependent.

The object file created in the build directory is copied to the "bin/<Model Name>" directory.

7. driver Directory

This is the source for the device drivers used by T-Monitor.

    flash directory:       Flash ROM driver
    memdisk directory:     Memory disk driver
    sio directory:         Serial I/O driver

Because these drivers may be used when interrupts are prohibited, their use is dedicated to T-Monitor, which does not perform interrupts.

Each driver object file created in its individual build directory is copied to the "bin/<Model Name>" directory.

8. bin Directory

The build result object files created in the build directories below are copied to the "<Model Name>" directory. At that time, the previous object file is backed up in the "!OLD" subdirectory.

    cmdsvc/build/<Model Name>
    hwdepend/<Model Name>/build
    driver/flash/build/<Model Name>
    driver/memdisk/build/<Model Name>
    driver/sio/build/<Model Name>

The object files placed here are used when building the final T-Monitor execution image in the "tmmain/build/<Model Name>" build directory.