Overview

Data Flash Driver for RX Family

M3S-DATFRX (DATFRX) is a block-type device driver for handling storage in the flash memory (data flash) embedded in RX-family MCUs. Data can be updated or read by calling user API functions of the data management driver. The data management driver eases the construction of data management systems that use the flash memory (data flash).

Topics

M3S-DATFRX V2.01 have been released.

Release Information

Latest Ver.: V2.01 Release00

Released: Feb. 20, 2019

Operating Environment

Obtaining the Product

Features

  • Supports Firmware Integration Technology (FIT).
  • Handles the management of data in the data flash memory area.
  • API calls can be used to update and read data associated with user-specified data numbers.
  • The data to be updated or read are managed with assigned logical data numbers. You can configure the number of data and the data size for each data number.
  • During processing to update data, data are written to empty space in the target block.
  • In the case where a block in which data are being updated runs out of empty space, the valid data within the block are copied to another block. Through processing for block erasure, blocks which hold old data that are no longer required after updating of data are erased.
  • In cases where power is cut off or a reset is applied during processing to update data, the cutoff or reset will be detected by running of the initialization function following the restart. The data are judged for validity according to the condition of the updated data. If the data are not valid, they will be returned to the state that preceded updating. 1
  • In cases where power is cut off or a reset is applied during processing for block erasure, the cutoff or reset which occur while erasing the blocks being managed will be detected by running of the initialization function following the restart. If a block is judged to be invalid, it will be returned to the state that preceded the attempt at erasure. 2
  • User programs which are assigned to RAM or external memory can be run while executing data programming or block erasure commands for the code flash area in which data are being managed.
  • User programs which are assigned to RAM, ROM, or external memory can be run while executing data programming or block erasure commands for the data flash area in which data are being managed.
  • Support for operation using either big-endian or little-endian byte order.
  1. Return of the data to its state before the start of processing for updating by initialization processing is not certain. This depends on the timing with which power was cut off or a reset applied during data updating. Re-update the data immediately after the initialization function has run to make sure the data are the latest.
  2. Judgment regarding a block might be mistaken. This depends on the timing with which power was cut off or a reset applied during block erasure, since the condition of the block that was being erased at that point is not certain at the time of initialization processing. Thus, a case of one of the following types might arise.
    • Updating of data after the power was cut off or a reset applied during block erasure is not possible.
    • Old data are wrongly judged to be the latest data.
    • The latest data cannot be detected.

functions

Function Name Description
R_FLASH_DM_Open() DATFRX open processing
R_FLASH_DM_Close() DATFRX close processing
R_FLASH_DM_Init() Initialization processing (divided)
R_FLASH_DM_InitAdvance() Continuation of initialization processing (divided)
R_FLASH_DM_Format() Format processing
R_FLASH_DM_Read() Data read processing
R_FLASH_DM_Write() Data update processing
R_FLASH_DM_Erase() Block erase processing
R_FLASH_DM_Reclaim() Reclaim processing
R_FLASH_DM_Control() State check processing
R_FLASH_DM_GetVersion() Version acquisition

Components

  • Driver software for managing data(Source file for RX family)
  • Sample program (Project for e2 studio)
  • Application note

Modular Composition

Modular Composition

Operating Environment

The sizes taken up in ROM and RAM are estimates. They depend on the version of the driver and compiler in use.
For details, refer to the application notes for this product.

Applicable Compiler C/C++ Compiler Package for RX Family V.3.00.00 or later
Memory Sizes In the case of RX231
ROM 5039 bytes+ (4 bytes × n Number of blocks) + (2 bytes × m Number of management data)
RAM33 bytes+ (4 bytes × n Number of blocks) + (2 bytes × m Number of management data)
In the case of RX66T
ROM 4999 bytes
RAM 18 bytes + (3 bytes × n Number of blocks)

Obtaining the Product

Download

Target Devices

RX Family

Development Tools Support

Title Description
My Renesas Create a My Renesas account to use our tool download services,
receive e-newsletter/update notifications, and take advantage of our other services.
e-learning Information for studying and learning about microcontrollers and microprocessors.
FAQ Frequently asked questions and useful hints for development.
Forum A forum and community site to share technical information,
questions and opinions with others who use Renesas MCU's.
Tool News Tool release information and other important information.
Operating Environment Information on system requirements and operating environment for the latest
version of tools.
Info on Discontinued Products A list of Renesas software and tools that have been discontinued and
are no longer being offered for new projects.
您可以使用下方的筛选器来筛选样例程序和应用手册。

Action Needed