Renesas 70 - page 101

Chapter 5 Detailed Applications

- 91 -

5.9.1 Section Allocation of start.a30

The section allocation of the sample startup program for the assembly language "start.a30" is defined in

"asm_sec.inc".

Edit "asm_sec.inc" if section reallocation is required.

The following explains each section that is defined in the sample section definition file "asm_sec.inc".

• MR_RAM_DBG section

This section stores the MR308's Debug functions RAM data.

This section must be mapped the internal area.

• MR_RAM_NE section

• MR_RAM_NO section

This section is where the RAM data, MR308's system management data, is stored that is referenced in

absolute addressing.

This section must be mapped between 0 and 0FFFFH (near area).

• MR_RAM section

This section is where the RAM data, MR308's system management data, is stored that is referenced in

absolute addressing.

• stack section

This is the section for the default user stack of each task and for the system stack.

• MR_HEAP section

This is the section in which the variable-size memory pool, fixed-size memory pool, and data queue

area are stored.

• MR_KERNEL section

This section stores MR308 kernel program..

• MR_CIF section

This section stores the MR308 C language interface library.

• MR_ROM section

This section stores data such as task start addresses that area referenced by the MR308 kernel.

• program section

This section stores user programs.

This section is not used by the MR308 kernel at all. Therefore, you can use this section as desired.

• program_S section

This section stores the functions invoked by aspecial page call.

This section is not used by the MR308 kernel at all.

• fvector section

This section stores the vector address of special page calls.

This section is not used by the MR308 kernel at all.

• INTERRUPT_VECTOR section

• FIX_INTERRUPT_VECTOR section

This section stores interrupt vectors. The start address of this section varies with the type of M16C/80

series microcomputer used. The address in the sample startup program is provided for use by the

M16C/80 series micro-computers. This address must be modified if you are using a microcomputer of

some other group.

Contents

Main Page Preface Requirements for MR308 Use C-compiler package M3T-NC308WA(abbreviated as NC308) for M16C/70,80 M32C/80 series micro- Document List Release Note Page Contents Page Page List of Figures Page List of Tables Page Page Page 2.1 Objective of MR308 Development Page 2.2 Relationship between TRON Specification and MR308 2.3 MR308 Features Page Chapter 3 Introduction to MR308 3.1 Concept of Real-time OS 3.1.1 Why Real-time OS is Necessary Page Page 3.1.2 Operating Principles of Real-time OS Time Page Page 3.2 Service Call 3.2.1 Service Call Processing 3.2.2 Task Designation in Service call 3.3 Task 3.3.1 Task Status Page Page 3.3.2 Task Priority and Ready Queue TCB TCBTCB TCBTCB 3.3.3 Task Priority and Waiting Queue taskB taskC Page TCB the timeout function is used. 3.4 System States 3.4.1 Task Context and Non-task Context 1. Interrupt Handler 2. Cyclic Handler 3. Alarm Handler 3.4.2 Dispatch Enabled/Disabled States 3.4.3 CPU Locked/Unlocked States 3.4.4 Dispatch Disabled and CPU Locked States 3.5 MR308 Kernel Structure 3.5.1 Module Structure 3.5.2 Module Overview Scheduler 3.5.3 Task Management Function Activate Task (act_tsk, iact_tsk) Ter mi na te d Activate Task (sta_tsk, ista_tsk) Terminate Invoking Task (ext_tsk) Terminate Task (ter_tsk) Reference task priority (get_pri, iget_pri) Reference task status (simple version) (ref_tst, iref_tst) Reference task status (ref_tsk, iref_tsk) 3.5.4 Synchronization functions attached to task Put Task to sleep (slp_tsk,tslp_tsk) Wakeup task (wup_tsk, iwup_tsk) Wake up r eque st c oun t 0 0 1 0 0 Wakeup request count 0 0 1 2 1 Forcibly resume suspended task (frsm_tsk, ifrsm_tsk) Release task from waiting (rel_wai, irel_wai) Delay task (dly_tsk) 3.5.5 Synchronization and Communication Function (Semaphore) Semaphore Task A Release Semaphore Resource(sig_sem, isig_sem) Acquire Semaphore Resource(wai_sem, twai_sem) Acquire Semaphore Resource(pol_sem, ipol_sem) Reference Semaphore Status (ref_sem, iref_sem) 3.5.6 Synchronization and Communication Function (Eventflag) Set Eventflag (set_flg, iset_flg) Clear Eventflag (clr_flg, iclr_flg) Wait for Eventflag (wai_flg, twai_flg) Wait for Eventflag (polling)(pol_flg, ipol_flg) Reference Eventflag Status (ref_flg, iref_flg) Chapter 3 Introduction to MR308 - 40 - TaskF TaskD TaskB Send to Data Queue(snd_dtq, tsnd_dtq) Send to Data Queue (psnd_dtq, ipsnd_dtq) Forced Send to Data Queue (fsnd_dtq, ifsnd_dtq) Receive from Data Queue (rcv_dtq, trcv_dtq) Receive from Data Queue (prcv_dtq,iprcv_dtq) 3.5.8 Synchronization and Communication Function (Mailbox) Message Message TaskB TaskA Message queue Message A Message B Message C Send to Mailbox (snd_mbx, isnd_mbx) Receive from Mailbox (rcv_mbx, trcv_mbx) Receive from Mailbox (polling) (prcv_mbx, iprcv_mbx) Reference Mailbox Status (ref_mbx, iref_mbx) 3.5.9 Memory pool Management Function Acquire Fixed-size Memory Block (polling) (pget_mpf, ipget_mpf) Release Fixed-size Memory Block (rel_mpf, irel_mpf) Reference Fixed-size Memory Pool Status (ref_mpf, iref_mpf) Acquire Variable-size Memory Block (pget_mpl) Release Acquire Variable-size Memory Block (rel_mpl) Reference Acquire Variable-size Memory Pool Status (ref_mpl, iref_mpl) 3.5.10 Time Management Function Place a task in a finite time wait state by specifying a timeout value Page 3.5.11 Cyclic Handler Function Start Cyclic Handler Operation (sta_cyc, ista_cyc) Stop Cyclic Handler Operation (stp_cyc, istp_cyc) Reference Cyclic Handler Status (ref_cyc, iref_cyc) 3.5.12 Alarm Handler Function Start Alarm Handler Operation (sta_alm, ista_alm) Stop alarm Handler Operation (stp_alm, istp_alm) Reference Alarm Handler Status (ref_alm, iref_alm) Page 3.5.14 Interrupt Management Function Returns from interrupt handler (ret_int) 3.5.15 System Configuration Management Function References Version Information(ref_ver, iref_ver) 3.5.16 Extended Function (Short Data Queue) Send to Short Data Queue (vsnd_dtq, vtsnd_dtq) Send to Short Data Queue (vpsnd_dtq, vipsnd_dtq) Forced Send to Short Data Queue (vfsnd_dtq, vifsnd_dtq) Page 3.5.18 Service calls That Can Be Issued from Task and Handler Page Page Page Chapter 4 Applications Development Procedure Overview 4.1 Overview 1. Generating a project 2. Coding the application program 3. Creating a configuration file 4. Executing the configurator HEW Figure 4.1 MR308 System Generation Detail Flowchart Page Chapter 4 Applications Development Procedure Overview Figure 4.2 Program Example - 63 - Chapter 4 Applications Development Procedure Overview - 64 - 4.2.2 Configuration File Preparation Figure 4.3 Configuration File Example 4.2.3 Configurator Execution 4.2.4 System generation 4.2.5 Writing ROM Page Chapter 5 Detailed Applications Chapter 5 Detailed Applications - 68 - 5.1 Program Coding Procedure in C Language 5.1.1 Task Description Procedure 1. Describe the task as a function. Page 5.1.2 Writing a Kernel (OS Dependent) Interrupt Handler 5.1.3 Writing Non-kernel (OS-independent ) Interrupt Handler 5.1.4 Writing Cyclic Handler/Alarm Handler 5.2 Program Coding Procedure in Assembly Language 5.2.1 Writing Task Page 5.2.2 Writing Kernel(OS-dependent) Interrupt Handler 5.2.3 Writing Non-kernel(OS-independent) Interrupt Handler 5.2.4 Writing Cyclic Handler/Alarm Handler 5.3 The Use of INT Instruction 5.4 The Use of registers of bank 5.5 Regarding Interrupts 5.5.1 Types of Interrupt Handlers High Kernel(OS-dependent) interrupt handler Non-kernel(OS-independent) interrupt handler For service calls that can be issued from only task context. Page Page Page Page Chapter 5 Detailed Applications - 85 - 5.8.1 C Language Startup Program (crt0mr.a30) Chapter 5 Detailed Applications - 86 - Chapter 5 Detailed Applications - 87 - Chapter 5 Detailed Applications - 88 - Figure 5.14 C Language Startup Program (crt0mr.a30) Page 5.9 Memory Allocation asm_sec.inc c_sec.inc Page Page Page 5.10 Using in M16C/70 Series Page 6.1 Configuration File Creation Procedure 6.1.1 Configuration File Data Entry Format Comment Statement End of statement Numerical Value 123 123 + 0x23 (23/4 + 3) 100B + 0aH Symbol _TASK1 IDLE3 Function Name main() func() Page 6.1.2 Configuration File Definition Items Maximum value of priority ; Timeout function Task Pause Time tick denominator Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Chapter 6 Using Configurator - 119 - 6.1.3 Configuration File Example The following is the configuration file example. Chapter 6 Using Configurator - 120 - Chapter 6 Using Configurator - 121 - Page 6.2 Configurator Execution Procedures 6.2.1 Configurator Overview 1. Executing the configurator requires the following input files: Configuration file (XXXX.cfg) Default configuration file (default.cfg) cfg308 Page 6.2.3 Configurator Start Procedure Command Options -v Option -V Option -m Option 6.2.4 makefile generate Function 1. Examine the source file's dependency relationship. 2. Write the file dependency relationship to makefile Page 6.2.6 Configurator Error Indications and Remedies Error messages Page Warning messages Other messages 6.3 Editing makefile 6.4 About an error when you execute make mr308tbl Warning : You need not specify systime.timeout YES in configuration file tslp_tsk, twai_flg, trcv_mbx, twai_sem, tsnd_dtq, trcv_dtq, vtsnd_dtq, vtrcv_dtq Page Page 7.1 Processing Procedures for System Calls from Handlers 7.1.1 System Calls from a Handler That Caused an Interrupt during Task Execution 7.1.2 System Calls from a Handler That Caused an Interrupt during System Call Processing 7.1.3 System Calls from a Handler That Caused an Interrupt during Handler Execution 7.2 Stacks 7.2.1 System Stack and User Stack User Stack System Stack Page 8.1 Overview of Sample Program task2 operates in order of the following. Chapter 8 Sample Program Description - 143 - 8.2 Program Source Listing Chapter 8 Sample Program Description - 144 - 8.3 Configuration Fil e Page 9.1 How to Form Separate ROMs Programs to be located in the kernel ROM Programs to be located in the application ROM How to locate individual programs is given below. Page Page Page 2005. Renesas Technology Corp. and Renesas Solutions Corp.,