USBB17RX78K4-XXX NEC Electronics, USBB17RX78K4-XXX Datasheet - Page 65

• Manufacturer Part Number: USBB17RX78K4-XXX
• Description: 78K/4 series realtime OS
• Manufacturer: NEC Electronics

4.3.1 pget_blk (Poll and Get Fixed-Length Memory Block)
56
[Function]
[Remarks]
[System call ID number]
[Parameter]
[Return parameter]
[Assembler format]
[C format]
Gets a memory block of a fixed length.
Gets a memory block of a fixed length from a memory pool indicated by mplid. This memory block can be
used as a message area for communication between tasks. The size of the memory block is determined on
creation of the system and is fixed. When a memory block can be gotten, the top address of the memory block
is set in an address specified by the parameter. If the memory block cannot be gotten, an error code
“E_PLFAIL” is returned. In either case, the task is not placed in the WAIT state.
The area for p-blk should be allocated by the user.
pget_blk = 22
mplid (Memory Pool Identifier)
p_blk (Pointer of Block Start Address)
E_OK
E_PLFAIL
[Large model]
MOV
MOVW
MOV
MOVW
MOV
CALLT
C register = return parameter
ret = pget_blk (p_blk,mplid);
char
char
bnk0_b, #22
bnk0_d, #mplid
bnk0_e, #p_blk
[40H]
:
**p_blk;
*mplid;
bnk0_up, #mplid
bnk0_vp, #p_blk
CHAPTER 4
Memory pool ID
(Memory pool top address)
Address of area storing the top
address of the memory block
Normal termination
Polling failed
[Small model]
MOV
MOVW
MOVW
CALLT
C register = return parameter
RX78K/IV SYSTEM CALL LIST
bnk0_b, #22
[40H]
:
bnk0_up, #mplid
bnk0_vp, #p_blk
- 24 bits (large model)
- 16 bits (small model)
- 24 bits (large model)
- 16 bits (small model)