R01US0068EJ0100 Datasheet, PDF (46/56 Pages) Renesas Technology Corp – EEPROM Emulation Library

RL78 Family
EEPROM Emulation Library Pack02
EEL_GetSpace
Chapter 5 User Interface
[Function]
This obtains the free EEL block space.
[Format]
<C language>
eel_status_t __far EEL_GetSpace(__near eel_u16* space_pu16)
<Assembler>
CALL !EEL_GetSpace or CALL !!EEL_GetSpace
Remark Call this function by using ! if placing the EEL at 00000H to 0FFFFH or by using !! if not.
[Pre-conditions]
The FDL_Init,FDL_Open,EEL_Init, and EEL_Open functions, and theEEL_Execute
function(EEL_CMD_STARTUP command ) must have finished normally.
[Post-conditions]
None
[Cautions]
1. When the EEL pool has been exhausted, 0 is always returned to indicate that there is no free space.
2. When an error value is returned, the free space information remains unchanged.
[Register status after calling this function]
Return value: C
Corrupted register: AX (argument)
[Arguments]
Argument
space_pu16
Type
eel_u16* (near)
Description
The address at which the free space information of the current
active block is input
[Return values]
Type
Symbol Definition
eel_status_t EEL_OK
EEL_ERR_INITIALIZATION
EEL_ERR_ACCESS_LOCKED
EEL_ERR_REJECTED
Description
Normal end
EEL_Init has not been executed.
The EEL_CMD_STARTUP command has not finished normally.
A command is being executed.
Remark Assembly language return values are stored in register C.
R01US0068EJ0100 Rev.1.00
Mar. 28, 2014
Page 46 of 53