R01US0079ED0103 Datasheet, PDF (51/66 Pages) Renesas Technology Corp – RENESAS 32-Bit MCU

Data Flash Access Library - Type T01, European Release
(2) _{R_FDL_Handler will never set this status code}
User Interface (API)
4.5.4 R_FDL_CMD_READ
The read operation will read a certain address range in the Data Flash and copy the data to the specified
target buffer.
A higher level EEPROM Emulation library may want to read Data Flash addresses which are possibly not
completely written or erased. Reading those addresses would most probably result in an ECC error
interrupt request which must be handled by the user application. This behaviour is usually not intended as
an emulation library would have to deal with the errors.
Based on these considerations, the read operation of the FDL temporarily disables the interrupt
generation for ECC errors. The status of ECC interrupt generation is restored when the operation is
finished. Errors detected during read operation are signalled to the user application by the request
structure status_enu variable and idx_u32 variable.
In case of single bit error the data read will be continued and the 1st occurrence of the ECC error will be
returned. In case of double bit error, the read operation is stopped and the fail address is returned. In
case of a previous single bit error detected, the fail address of the single bit error is overwritten.
Read command execution is synchronous to execution of R_FDL_Execute function. Therefore this
command cannot be suspended and does not need to be processed by R_FDL_Handler function.
The members of the request structure given to R_FDL_Execute are described in the following table:
Table 9: Request structure usage for read command
Structure member
command_enu
bufAddr_u32
Value
R_FDL_CMD_READ
{uint32_t number}
idx_u32
cnt_u16
accessType_enu
{uint32_t number}
{uint16_t number}
R_FDL_ACCESS_USER /
R_FDL_ACCESS_EEL
status_enu
-
Description
Request a read operation
Data destination buffer address in RAM.
Note: The buffer must be 32 bit aligned!
Data Flash virtual address from where to
read. Must be word (4 bytes) aligned.
Numbers of words (4 bytes) to read
Selects the Flash pool in which the command
will be able to operate.
This is an output member. It contains the
status of the operation during and after the
execution. Possible values are described in
the next table.
The following table describes all possible status returns:
Table 10: Read operation returned status
Status
Background and Handling
meaning _{Operation finished successfully}
R_FDL_OK
reason _{No problems during execution}
remedy _Nothing
R_FDL_ERR_PARAMETER
meaning _{Current command is rejected}
R01US0079ED0103
51
User Manual