beautypg.com

Renesas Emulator System M3T-MR100 User Manual

Page 141

background image

- 125 -

ref_dtq

Reference data queue status

iref_dtq

Reference data queue status (handler only)

[

[

[

[

C

C

L

L

a

a

n

n

g

g

u

u

a

a

g

g

e

e

A

A

P

P

I

I

]

]

]

]

ER ercd = ref_dtq( ID dtqid, T_RDTQ *pk_rdtq );
ER ercd = iref_dtq( ID dtqid, T_RDTQ *pk_rdtq );

z

z

P

P

a

a

r

r

a

a

m

m

e

e

t

t

e

e

r

r

s

s

ID

dtqid

ID number of the target data queue

T_RDTQ

*pk_rdtq

Pointer to the packet to which data queue status is returned

z

z

R

R

e

e

t

t

u

u

r

r

n

n

P

P

a

a

r

r

a

a

m

m

e

e

t

t

e

e

r

r

s

s

ER ercd Terminated

normally (E_OK)

T_RDTQ

*pk_rdtq

Pointer to the packet to which data queue status is returned


Contents of pk_rdtq
typedef struct

t_rdtq{

ID

stskid

+0

2

Transmission waiting task ID

ID

wtskid

+2

2

Reception waiting task ID

UINT

sdtqcnt

+4

4

Data bytes contained in data queue

} T_RDTQ;

[

[

[

[

A

A

s

s

s

s

e

e

m

m

b

b

l

l

y

y

l

l

a

a

n

n

g

g

u

u

a

a

g

g

e

e

A

A

P

P

I

I

]

]

]

]

.include mr100.inc
ref_dtq DTQID,

PK_RDTQ

iref_dtq DTQID, PK_RDTQ

z

z

P

P

a

a

r

r

a

a

m

m

e

e

t

t

e

e

r

r

s

s

DTQID

ID number of the target data queue

PK_RDTQ

Pointer to the packet to which data queue status is returned

z

z

R

R

e

e

g

g

i

i

s

s

t

t

e

e

r

r

c

c

o

o

n

n

t

t

e

e

n

n

t

t

s

s

a

a

f

f

t

t

e

e

r

r

s

s

e

e

r

r

v

v

i

i

c

c

e

e

c

c

a

a

l

l

l

l

i

i

s

s

i

i

s

s

s

s

u

u

e

e

d

d

Register name

Content after service call is issued

R0 Error

code

R2

ID number of the target data queue

A1

Pointer to the packet to which data queue status is returned

[

[

[

[

E

E

r

r

r

r

o

o

r

r

c

c

o

o

d

d

e

e

]

]

]

]

None

[

[

[

[

F

F

u

u

n

n

c

c

t

t

i

i

o

o

n

n

a

a

l

l

d

d

e

e

s

s

c

c

r

r

i

i

p

p

t

t

i

i

o

o

n

n

]

]

]

]

This service call returns various statuses of the data queue indicated by dtqid.

‹

stskid

Returned to stskid is the ID number of the task at the top of a transmission waiting queue (the next task to be de-
queued). If no tasks are kept waiting, TSK_NONE is returned.

‹

wtskid

Returned to wtskid is the ID number of the task at the top of a reception waiting queue (the next task to be de-
queued). If no tasks are kept waiting, TSK_NONE is returned.

‹

sdtqcnt

Returned to sdtqcnt is the number of data bytes stored in the data queue area.

If this service call is to be issued from task context, use ref_dtq; if issued from non-task context, use iref_dtq.