Renesas REJ10J1822-0101 Manuel d'utilisateur

Revision Date: Mar. 17, 2008 Renesas Microcomputer Development Environment System Rev.1.01 REJ10J1822-0101 Stub Generator V.1.00User’s Manual

vi

Section 7 Server Functions Not Supported by RPCGEN Rev. 1.01 Mar. 17, 2008 Page 90 of 128 REJ10J1822-0101 (2) Multiple-level pointers RPCGEN onl

Section 7 Server Functions Not Supported by RPCGEN Rev. 1.01 Mar. 17, 2008 Page 91 of 128 REJ10J1822-0101 7.2 Return Value (1) Pointer If

Section 7 Server Functions Not Supported by RPCGEN Rev. 1.01 Mar. 17, 2008 Page 92 of 128 REJ10J1822-0101

Section 8 Application Interface Rev. 1.01 Mar. 17, 2008 Page 93 of 128 REJ10J1822-0101 Section 8 Application Interface 8.1 Client-Stub F

Section 8 Application Interface Rev. 1.01 Mar. 17, 2008 Page 94 of 128 REJ10J1822-0101 (2) When SVR_AUTH has been specified Each of the client-s

Section 8 Application Interface Rev. 1.01 Mar. 17, 2008 Page 95 of 128 REJ10J1822-0101 8.2 Server-Stub Functions Generated by RPCGEN RPCGE

Section 8 Application Interface Rev. 1.01 Mar. 17, 2008 Page 96 of 128 REJ10J1822-0101 8.3 Server-Initialization Function The server-initializa

Section 8 Application Interface Rev. 1.01 Mar. 17, 2008 Page 97 of 128 REJ10J1822-0101 • Specification The server is started up by calling

Section 8 Application Interface Rev. 1.01 Mar. 17, 2008 Page 98 of 128 REJ10J1822-0101 (3) With SVR_NOSTUBTBL and without SVR_NOINIT RPCGEN does

Section 8 Application Interface Rev. 1.01 Mar. 17, 2008 Page 99 of 128 REJ10J1822-0101 8.5 Server-Shutdown Function The server-shutdown fu

Section 1 Overview Rev. 1.01 Mar. 17, 2008 Page 1 of 128 REJ10J1822-0101 Section 1 Overview 1.1 Overview The stub generator (hereafter r

Section 8 Application Interface Rev. 1.01 Mar. 17, 2008 Page 100 of 128 REJ10J1822-0101 8.6 Client-Initialization Function The client-initializ

Section 8 Application Interface Rev. 1.01 Mar. 17, 2008 Page 101 of 128 REJ10J1822-0101 8.7 Client-Shutdown Function The client-shutdown f

Section 8 Application Interface Rev. 1.01 Mar. 17, 2008 Page 102 of 128 REJ10J1822-0101 8.8 rpc_retval_adr() rpc_retval_adr() is a client funct

Section 8 Application Interface Rev. 1.01 Mar. 17, 2008 Page 103 of 128 REJ10J1822-0101 • Example of implementation (for the HI7200/MP) #d

Section 8 Application Interface Rev. 1.01 Mar. 17, 2008 Page 104 of 128 REJ10J1822-0101 8.9 <Config file>_public.h The following macro de

Section 9 Notes Rev. 1.01 Mar. 17, 2008 Page 105 of 128 REJ10J1822-0101 Section 9 Notes (1) Check that the source program generated by RP

Section 9 Notes Rev. 1.01 Mar. 17, 2008 Page 106 of 128 REJ10J1822-0101

Section 10 Error Messages Rev. 1.01 Mar. 17, 2008 Page 107 of 128 REJ10J1822-0101 Section 10 Error Messages RPCGEN shows an error message

Section 10 Error Messages Rev. 1.01 Mar. 17, 2008 Page 108 of 128 REJ10J1822-0101 10.2 General Cannot open configuration file. RPCGEN cannot ac

Section 11 Samples Rev. 1.01 Mar. 17, 2008 Page 109 of 128 REJ10J1822-0101 Section 11 Samples This section introduces samples of the code

Section 1 Overview Rev. 1.01 Mar. 17, 2008 Page 2 of 128 REJ10J1822-0101 1.2 Operating Environment RPCGEN is provided as a Perl script file. Ta

Section 11 Samples Rev. 1.01 Mar. 17, 2008 Page 110 of 128 REJ10J1822-0101 11.1 Config File (sample.x) /***************************************

Section 11 Samples Rev. 1.01 Mar. 17, 2008 Page 111 of 128 REJ10J1822-0101 { // stdlib.h [RETEXT] double ret = atof ([IN STR] const

Section 11 Samples Rev. 1.01 Mar. 17, 2008 Page 112 of 128 REJ10J1822-0101 11.2 sample_clnt.h /************************************************

Section 11 Samples Rev. 1.01 Mar. 17, 2008 Page 113 of 128 REJ10J1822-0101 #endif #endif /* End of _RPC_SMPL_CLNT_H */ 11.3 sample_privat

Section 11 Samples Rev. 1.01 Mar. 17, 2008 Page 114 of 128 REJ10J1822-0101 11.4 sample_clnt.c /************************************************

Section 11 Samples Rev. 1.01 Mar. 17, 2008 Page 115 of 128 REJ10J1822-0101 UINT32 __ulOutputParamCount = 0UL; IOVEC __output[1];

Section 11 Samples Rev. 1.01 Mar. 17, 2008 Page 116 of 128 REJ10J1822-0101 UINT32 __ulInputParamCount = 0UL; IOVEC __input[1]; int ret;

Section 11 Samples Rev. 1.01 Mar. 17, 2008 Page 117 of 128 REJ10J1822-0101 __info.ulMarshallingType = 0UL; __info.ulServerID

Section 11 Samples Rev. 1.01 Mar. 17, 2008 Page 118 of 128 REJ10J1822-0101 __info.ulMarshallingType = 0UL; __info.ulServerID

Section 11 Samples Rev. 1.01 Mar. 17, 2008 Page 119 of 128 REJ10J1822-0101 }

Section 2 Installation Rev. 1.01 Mar. 17, 2008 Page 3 of 128 REJ10J1822-0101 Section 2 Installation 2.1 Downloading RPCGEN can be downlo

Section 11 Samples Rev. 1.01 Mar. 17, 2008 Page 120 of 128 REJ10J1822-0101 11.5 sample_svr.h /*************************************************

Section 11 Samples Rev. 1.01 Mar. 17, 2008 Page 121 of 128 REJ10J1822-0101 UINT32 rpcsvr_SMPL_ref_sem2( rpc_server_stub_info * __pInfo ); I

Section 11 Samples Rev. 1.01 Mar. 17, 2008 Page 122 of 128 REJ10J1822-0101 11.6 sample_svr.c /*************************************************

Section 11 Samples Rev. 1.01 Mar. 17, 2008 Page 123 of 128 REJ10J1822-0101 nptr = ( const char *)( __pInfo->pucParamArea + __ulInput

Section 11 Samples Rev. 1.01 Mar. 17, 2008 Page 124 of 128 REJ10J1822-0101 T_RTSK * pk_rtsk; UINT32 __ulInputParamOffset = 0UL; UIN

Section 11 Samples Rev. 1.01 Mar. 17, 2008 Page 125 of 128 REJ10J1822-0101 pk_rsem = ( T_RSEM *)( __pInfo->pucParamArea + __ulInputP

Section 11 Samples Rev. 1.01 Mar. 17, 2008 Page 126 of 128 REJ10J1822-0101 __server_info.ulRPCServerVersion = RPCSVR_VERS_SMPL; _

Section 11 Samples Rev. 1.01 Mar. 17, 2008 Page 127 of 128 REJ10J1822-0101 11.7 sample_public.h /*****************************************

Section 11 Samples Rev. 1.01 Mar. 17, 2008 Page 128 of 128 REJ10J1822-0101

Renesas Microcomputer Development Environment SystemUser's Manual Stub Generator V.1.00Publication Date: Rev.1.01, March 17, 200

Section 2 Installation Rev. 1.01 Mar. 17, 2008 Page 4 of 128 REJ10J1822-0101

Sales Strategic Planning Div. Nippon Bldg., 2-6-2, Ohte-machi, Chiyoda-ku, Tokyo 100-0004, Japanhttp://www.renesas.comRefer to

Stub GeneratorV.1.00 User’s Manual

Section 3 Functions and Files Generated by RPCGEN Rev. 1.01 Mar. 17, 2008 Page 5 of 128 REJ10J1822-0101 Section 3 Functions and Files Gen

Section 3 Functions and Files Generated by RPCGEN Rev. 1.01 Mar. 17, 2008 Page 6 of 128 REJ10J1822-0101 3.1.1 Client (1) Client-initialization

Section 3 Functions and Files Generated by RPCGEN Rev. 1.01 Mar. 17, 2008 Page 7 of 128 REJ10J1822-0101 3.2 Files Generated by RPCGEN RPCG

Section 3 Functions and Files Generated by RPCGEN Rev. 1.01 Mar. 17, 2008 Page 8 of 128 REJ10J1822-0101 (3) <config file>_private.h (inter

Section 4 Executing RPCGEN Rev. 1.01 Mar. 17, 2008 Page 9 of 128 REJ10J1822-0101 Section 4 Executing RPCGEN 4.1 Executing RPCGEN RPCGEN

Section 4 Executing RPCGEN Rev. 1.01 Mar. 17, 2008 Page 10 of 128 REJ10J1822-0101 4.2 Options 4.2.1 PUBI Format: PUBI="<path>"

Section 4 Executing RPCGEN Rev. 1.01 Mar. 17, 2008 Page 11 of 128 REJ10J1822-0101 4.2.4 SVRS Format: SVRS="<path>" Descri

Section 4 Executing RPCGEN Rev. 1.01 Mar. 17, 2008 Page 12 of 128 REJ10J1822-0101 4.3 Executing RPCGEN as a Build Phase in the High-performance

Section 4 Executing RPCGEN Rev. 1.01 Mar. 17, 2008 Page 13 of 128 REJ10J1822-0101 (2) Adding a File Extension To make execution as a custom

Section 4 Executing RPCGEN Rev. 1.01 Mar. 17, 2008 Page 14 of 128 REJ10J1822-0101 Figure 4.3 [Add File Extension] Dialog Box

Section 4 Executing RPCGEN Rev. 1.01 Mar. 17, 2008 Page 15 of 128 REJ10J1822-0101 (3) Creating the RPCGEN Custom Build Phase Select [Build-

Section 4 Executing RPCGEN Rev. 1.01 Mar. 17, 2008 Page 16 of 128 REJ10J1822-0101 Figure 4.5 [New Build Phase - Step 1 of 4] Dialog Box Click

Section 4 Executing RPCGEN Rev. 1.01 Mar. 17, 2008 Page 17 of 128 REJ10J1822-0101 At step 2, select [Multiple phase]. Then select [RPCGEN c

Section 4 Executing RPCGEN Rev. 1.01 Mar. 17, 2008 Page 18 of 128 REJ10J1822-0101 Figure 4.8 [New Build Phase - Step 4 of 4] Dialog Box Altho

Section 4 Executing RPCGEN Rev. 1.01 Mar. 17, 2008 Page 19 of 128 REJ10J1822-0101 Now settings must be made so that the files output by RPC

1. This document is provided for reference purposes only so that Renesas customers may select the appropriate Renesas products for their use.

Section 4 Executing RPCGEN Rev. 1.01 Mar. 17, 2008 Page 20 of 128 REJ10J1822-0101 (4) Settings in the [Build Phases] Dialog Box The created RPCG

Section 4 Executing RPCGEN Rev. 1.01 Mar. 17, 2008 Page 21 of 128 REJ10J1822-0101 Figure 4.13 [Build Phases] Dialog Box - [Build File Or

Section 4 Executing RPCGEN Rev. 1.01 Mar. 17, 2008 Page 22 of 128 REJ10J1822-0101

Section 5 Specifications of a Config File Rev. 1.01 Mar. 17, 2008 Page 23 of 128 REJ10J1822-0101 Section 5 Specifications of a Config Fil

Section 5 Specifications of a Config File Rev. 1.01 Mar. 17, 2008 Page 24 of 128 REJ10J1822-0101 (3) Server information • SVR_NAME{…}; Server

Section 5 Specifications of a Config File Rev. 1.01 Mar. 17, 2008 Page 25 of 128 REJ10J1822-0101 5.3 File Locations Use the statements lis

Section 5 Specifications of a Config File Rev. 1.01 Mar. 17, 2008 Page 26 of 128 REJ10J1822-0101 5.3.2 CLNT_SOURCEPATH Format: CLNT_SOURCEPATH

Section 5 Specifications of a Config File Rev. 1.01 Mar. 17, 2008 Page 27 of 128 REJ10J1822-0101 5.3.4 SVR_SOURCEPATH Format: SVR_SOURCEP

Section 5 Specifications of a Config File Rev. 1.01 Mar. 17, 2008 Page 28 of 128 REJ10J1822-0101 5.4 Controlling the Output of #include Directi

Section 5 Specifications of a Config File Rev. 1.01 Mar. 17, 2008 Page 29 of 128 REJ10J1822-0101 5.4.1 Order of #Include Directives RPCGEN

Section 5 Specifications of a Config File Rev. 1.01 Mar. 17, 2008 Page 30 of 128 REJ10J1822-0101 5.4.2 GLOBAL_INCFILE Format: GLOBAL_INCFILE{&

Section 5 Specifications of a Config File Rev. 1.01 Mar. 17, 2008 Page 31 of 128 REJ10J1822-0101 5.4.4 SVR_INCFILE Format: SVR_INCFILE{&l

Section 5 Specifications of a Config File Rev. 1.01 Mar. 17, 2008 Page 32 of 128 REJ10J1822-0101 5.5 Server Information The following types of

Section 5 Specifications of a Config File Rev. 1.01 Mar. 17, 2008 Page 33 of 128 REJ10J1822-0101 5.5.2 SVR_ID Format: SVR_ID {<ID num

Section 5 Specifications of a Config File Rev. 1.01 Mar. 17, 2008 Page 34 of 128 REJ10J1822-0101 5.5.3 SVR_VERSION Format: SVR_VERSION {<s

Section 5 Specifications of a Config File Rev. 1.01 Mar. 17, 2008 Page 35 of 128 REJ10J1822-0101 5.5.5 SVR_NOSTUBTBL Format: SVR_NOSTUBTB

Section 5 Specifications of a Config File Rev. 1.01 Mar. 17, 2008 Page 36 of 128 REJ10J1822-0101 5.5.6 SVR_NOSHUTDOWN Format: SVR_NOSHUTDOWN;

Section 5 Specifications of a Config File Rev. 1.01 Mar. 17, 2008 Page 37 of 128 REJ10J1822-0101 5.5.7 SVR_STATIC Format: SVR_STATIC{<

Section 5 Specifications of a Config File Rev. 1.01 Mar. 17, 2008 Page 38 of 128 REJ10J1822-0101 5.5.8 SVR_AUTH Format: SVR_AUTH; Description:

Section 5 Specifications of a Config File Rev. 1.01 Mar. 17, 2008 Page 39 of 128 REJ10J1822-0101 Client applicationServer applicationSer ve

iPreface This manual describes how to use the stub generator. Read this manual and understand it well before using the stub generator. Notes on De

Section 5 Specifications of a Config File Rev. 1.01 Mar. 17, 2008 Page 40 of 128 REJ10J1822-0101 (2) Model 2 Model 2 applies when SVR_AUTH has b

Section 5 Specifications of a Config File Rev. 1.01 Mar. 17, 2008 Page 41 of 128 REJ10J1822-0101 Client application Server applicationSer v

Section 5 Specifications of a Config File Rev. 1.01 Mar. 17, 2008 Page 42 of 128 REJ10J1822-0101 5.5.9 SVR_SECTION Format: SVR_SECTION{<sec

Section 5 Specifications of a Config File Rev. 1.01 Mar. 17, 2008 Page 43 of 128 REJ10J1822-0101 5.6 Client Information The following defi

Section 5 Specifications of a Config File Rev. 1.01 Mar. 17, 2008 Page 44 of 128 REJ10J1822-0101 5.6.2 CLNT_NOSHUTDOWN Format: CLNT_NOSHUTDOWN

Section 5 Specifications of a Config File Rev. 1.01 Mar. 17, 2008 Page 45 of 128 REJ10J1822-0101 5.6.3 CLNT_CALLCHK Format: CLNT_CALLCHK;

Section 5 Specifications of a Config File Rev. 1.01 Mar. 17, 2008 Page 46 of 128 REJ10J1822-0101 5.6.4 CLNT_SECTION Format: CLNT_SECTION{<s

Section 5 Specifications of a Config File Rev. 1.01 Mar. 17, 2008 Page 47 of 128 REJ10J1822-0101 5.7 Server Functions The following defini

Section 5 Specifications of a Config File Rev. 1.01 Mar. 17, 2008 Page 48 of 128 REJ10J1822-0101

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 49 of 128 REJ10J1822-0101 Section 6 Definitions of Server Function

ii Trademarks All trademarks and registered trademarks belong to their respective owners. 1. TRON is an acronym formed from "The Real Time Op

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 50 of 128 REJ10J1822-0101 Example 2: Specification of a server function v

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 51 of 128 REJ10J1822-0101 Example 3: Specification of a server funct

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 52 of 128 REJ10J1822-0101 6.2 Function-Type Directives 6.2.1 Function w

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 53 of 128 REJ10J1822-0101 6.2.2 Function without a Return Value Des

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 54 of 128 REJ10J1822-0101 6.2.3 When the Return Value is not Representab

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 55 of 128 REJ10J1822-0101 6.3 Function Names Description: Type the

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 56 of 128 REJ10J1822-0101 6.4 Parameters Parameters must be defined in t

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 57 of 128 REJ10J1822-0101 6.5 Keywords for Input/Output The followi

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 58 of 128 REJ10J1822-0101 6.5.2 OUT (Output) Description: This keyword d

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 59 of 128 REJ10J1822-0101 6.5.3 INOUT (Input and Output) Descriptio

iiiContents Section 1 Overview...1 1.1 Overview...

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 60 of 128 REJ10J1822-0101 6.5.4 REF (Passing by Reference) Description:

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 61 of 128 REJ10J1822-0101 Without the REF specification, the data in

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 62 of 128 REJ10J1822-0101 6.5.5 DESC (Specified Parameter is not Passed

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 63 of 128 REJ10J1822-0101 6.6 Keywords for Data Types Select one of

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 64 of 128 REJ10J1822-0101 6.6.2 STR (String) Input/Output Keywords Avail

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 65 of 128 REJ10J1822-0101 6.6.3 PTR (Pointer) Input/Output Keywords

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 66 of 128 REJ10J1822-0101 6.6.4 ARY (Array) Input/Output Keywords Availa

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 67 of 128 REJ10J1822-0101 6.6.5 COUNT (Number of Elements in an Arr

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 68 of 128 REJ10J1822-0101 UINT32 rpcsvr_SMPL_func( rpc_server_stub_info *

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 69 of 128 REJ10J1822-0101 Example 2 Specification of a server functi

iv 5.4.3 CLNT_INCFILE... 30 5.4.4 SVR_INCFILE ...

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 70 of 128 REJ10J1822-0101 Example 5 Specification of a server function in

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 71 of 128 REJ10J1822-0101 (2) When the input/output keyword selecte

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 72 of 128 REJ10J1822-0101 int func (struct INF * inf, struct ST * ptr ) {

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 73 of 128 REJ10J1822-0101 UINT32 rpcsvr_SMPL_func( rpc_server_stub_i

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 74 of 128 REJ10J1822-0101 Examples: Example 1 Specification of a server f

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 75 of 128 REJ10J1822-0101 Example 4 Specification of a server functi

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 76 of 128 REJ10J1822-0101 Example 6 Specification of a server function in

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 77 of 128 REJ10J1822-0101 Example 8 Specification of a server functi

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 78 of 128 REJ10J1822-0101 int func (struct INF * inf, struct ST * ptr ) {

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 79 of 128 REJ10J1822-0101 UINT32 rpcsvr_SMPL_func( rpc_server_stub_i

v6.7 Optional Keywords... 83 6.7.1 SVRS

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 80 of 128 REJ10J1822-0101 Examples: Example 1 Specification of a server f

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 81 of 128 REJ10J1822-0101 Example 4 Specification of a server functi

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 82 of 128 REJ10J1822-0101 Example 6 Specification of a server function in

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 83 of 128 REJ10J1822-0101 Example 8 Specification of a server functi

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 84 of 128 REJ10J1822-0101 Table 6.2 shows the available combinations of o

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 85 of 128 REJ10J1822-0101 6.7.2 SVRFUNC (Server Function Name) Form

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 86 of 128 REJ10J1822-0101 6.7.3 CLNTSTUB (Client Stub) Format: [CLNTSTU

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 87 of 128 REJ10J1822-0101 6.7.4 UNACK (Asynchronous Call) Format:

Section 6 Definitions of Server Functions Rev. 1.01 Mar. 17, 2008 Page 88 of 128 REJ10J1822-0101 6.7.5 CLNTCOPYCBK (RPC Call by rpc_call_copycb

Section 7 Server Functions Not Supported by RPCGEN Rev. 1.01 Mar. 17, 2008 Page 89 of 128 REJ10J1822-0101 Section 7 Server Functions Not