I-51-01E-005

ITRON Newsletter No.5
ITRON Technical Committee, TRON Association

Katsuta Building 5F, 3-39, Mita 1-chome, Minato-ku, Tokyo 108, JAPANTEL: (03) 3454-3191
FAX: (03) 3454-3224

The ITRON Registration System for
Products and Applications

HI8-3H

Product in Outline
Hitachi's HI8-3H real-time OS was developed for use
with that rm's H8/300H Series 8-bit single-chip microcontrollers in advanced mode, i.e., supporting 16
MB of memory space1 .

The product listed in another page was newly registered in the period from September 1 through November 1, 1993. Details of the product registration system, and an updated list of registered products, can beobtained by contacting the TRON Association. Previously registered products are also listed in ITRON
Newsletter Nos.1 to 3.

Features Conforms to ITRON Speci cation Ver 2.0.

{ Application programs can readily be ported

among di erent systems running a ITRONspeci cation OS.
{ Supports a wealth of functions (43 system calls).

ITRON-related Publications
Listed in another page are the publications preparedand issued by the ITRON Technical Committee asof October 1, 1993. The ITRON-ITRON Standard Handbook is a one-volume compilation of theITRON (Ver 2.0) and ITRON2 speci cations. Eachof the publications can be obtained directly from thesources indicated.
An English-language edition of the ITRON3.0
speci cation is currently being prepared and will beavailable on-line when the translation work is completed, along with earlier versions.

 Emphasis on real-time performance{ Maximum interrupt mask time in the OS: 10.5s{ Task switching time (from issuing of wup tsk
system call until next task is executed): 35s

 Highly compact OS{ An optimum OS con guration can be achievedby selecting only the system calls necessary forthe application system.
{ Program size: 0.5KB { 8.9KB{ The system calls to be used are incorporated in
the system simply by linkage with an OS library.

Revisions to ITRON3.0 Speci cation
The ITRON3.0 speci cation has been revised as indicated in another page. These revisions correct problems that were discovered after the ITRON3.0 Standard Handbook was issued. The version number ofthe speci cation with these revisions is Ver 3.01.00.

 C language support{ The entire user program can be written in C.
{ A system call language interface library is provided.

 On-line debugging by in-circuit emulator

New Product{ Task-level debugging is supported, with task

control and status reference performed from theICE. (Hitachi's E7000 and Hitachi Microcomputer System's MY-ICE support this function.)

The HI8-3H OS recently registered in the ITRON Registration System for Products and Applications is introduced brie y below.

1 A version for normal mode, supporting a memory space ofy This newsletter is reprinted from TRONWARE vol.24 andTRON PROJECT BIMONTHLY No.30.

64 KB, is now under development.

1

I-51-01E-005

Newly Registered Products (Sep. 1, 1993 { Nov. 1, 1993)
Speci cation
ITRON2.0

Product Name
HI8-3H

Supported Processor
H8/300H SeriesCompany
Hitachi, Ltd.

ITRON-related Publications
Name
TypePrice
Publisher
ISBN No.
ITRON-ITRON Standard Handbook Speci cation(Japanese)
4,800Yen Personal Media Co. 4-89362-079-7
ITRON3.0 Standard Handbook
Speci cation(Japanese)
4,000Yen Personal Media Co. 4-89362-106-8
ITRON/FILE Standard Handbook
Speci cation(Japanese)
3,000Yen Personal Media Co. 4-89362-092-4ITRON Standard Guidebook '92-'93
Textbook (Japanese)
3,500Yen Personal Media Co. 4-89362-197-6
ITRON Speci cation Ver 2.01.00.00
Speci cation (English) 12,000Yen TRON Association{ITRON2 Speci cation Ver 2.02.00.10
Speci cation (English) 15,000Yen TRON Association{NOTES:- Prices do not include consumption tax.
- TRON Association members may purchase Association publications at a special discount price.
- English-language speci cations are also distributed free of charge via the Internet. The method for downloading is
explained in Newsletter No.2.

2I-51-01E-005

Revisions to ITRON3.0 Speci cation (Ver 3.00.00 ! Ver 3.01.00)
1. The following addition is made to the supplementary explanation of system call cre mbf (p.162).
[Supplementary explanation]
When some tasks are waiting in a queue to send messages, it is an implementation-dependent matter
whether priority is given to the task with the shortest message to be sent or to the task at the headof the queue. Suppose, for example, that task A with a message size of 40 and task B with a message
size of 10 are waiting, in that order, to send their message to a message bu er, and that a bu er
space of 20 becomes available after another task performs a rcv mbf. In this case it is up to theimplementor whether or not to give priority to task B, which has the smaller message size but is notat the head of the queue.
2. The following addition is made to the supplementary explanation of system call rcv mbf (p.173).
When a message is received from a message bu er to which two or more tasks are waiting to send
messages, depending on the size of the message it is possible that two or more of the waiting tasks
will be able to send their messages at the same time, exiting from the wait state. In this case thesequence of messages in the message bu er is implementation dependent. Likewise, the sequence oftasks in the ready queue after exiting from the wait state is implementation dependent in the caseof tasks having the same priority.
3. The C language interface for the system calls get blk, pget blk, and tget blk is revised as follows(p.239 and p.382).
ER ercd = get blk ( VP *p blk, ID mplid, INT blksz ) ;ER ercd =pget blk ( VP *p blk, ID mplid, INT blksz ) ;ER ercd =tget blk ( VP *p blk, ID mplid, INT blksz, TMO tmout ) ;4. The explanation of E PAR error in the error code explanation for system calls get blk, pget blk,
and tget blk is revised as follows (p.242).
parameter error (tmout)(-2), blksz is negative or illegal)
E PAR
5. The explanation of E PAR error in the error code explanation for system call act cyc is revised asfollows (p.278).
E PAR
parameter error (cycno cannot be used, cycact is illegal)
6. The explanation of E PAR error in the error code explanation for system call ref cyc is revised asfollows (p.280).
parameter error (cycno cannot be used, the packet address for the return parameter is
E PAR
a value that cannot be used)
7. The following statement is added to the exposition of system call def alm (p.284).
The de nition of an alarm handler is canceled automatically when the designated time occurs andthat handler is started.
8. The following addition is made to the supplementary explanation of system call def alm (p.285).
At the time an alarm handler is started, the de nition of that handler is considered as alreadycanceled. Thus if ref alm is used to refer to information on the started handler in the handler, aE NOEXS error will result. It is possible to rede ne an alarm handler with the same number in thehandler.
9. The explanation of E PAR error in the error code explanation for system call ref alm is revised asfollows (p.287).
E PARparameter error (almno cannot be used or the packet address for the return parameteris a value that cannot be used)
10. The comment on tmmode in the t dalm structure of the C language interface is revised as follows(p.394).
UINTtmmode;/* start time designation mode*/3