Data FLASH Editor: Data FLASH Editor Tool For 78K0R and V850 Based EEPROM Emulation
Data FLASH Editor: Data FLASH Editor Tool For 78K0R and V850 Based EEPROM Emulation
All information contained in these materials, including products and product specifications,
represents information on the product at the time of publication and is subject to change by
Renesas Electronics Corp. without notice. Please review the latest information published by
Renesas Electronics Corp. through various means, including the Renesas Technology Corp.
website (http://www.renesas.com).
Device availability
Ordering information
Product release schedule
Availability of related technical literature
Development environment specifications (for example, specifications for
third-party tools and components, host computers, power plugs, AC supply
voltages, and so forth)
Network requirements
In addition, trademarks, registered trademarks, export restrictions, and other legal issues may also vary
from country to country.
Visit
http://www.renesas.com
to get in contact with your regional representatives and distributors.
Chapter 1 Introduction
The Data FLASH Editor is a windows based tool that allows to visualize and
modify the EEPROM emulation data of a Data FLASH memory image of a 78K0R
or V850 based microcontroller. The Data FLASH Editor does support memory
images in the Intel-hex or Motorola-S record file format. The corresponding
memory image can be generated by the Data FLASH Converter or it can be
uploaded from a 78K0R or V850 based In-Circuit Emulator by using the IAR,
GHS or Renesas debugger.
The Data FLASH Editor supports to view, modify and to save EEPROM
emulation data of an existing Data FLASH memory image. In addition, the Data
FLASH Editor supports to add or remove EEPROM emulation data entries to
respectively from a existing Data FLASH memory image.
The Data FLASH Editor does distinguish between three different 78K0R and
V850 based device families and FLASH Technologies:
Different to V850E/ES device family, the Data FLASH Editor needs to read or to
create an XML based raw data management description file first, to support
78K0R and V850E2 devices accordingly. This is caused by the different
emulation library concepts of V850E/ES and V850E2, 78K0R. By reading or
creating the raw data management description file the Data FLASH Editor gets
the corresponding information about the data set IDs and data set length
information. Based on this information only the latest valid IDs and matched data
sets of a Data FLASH memory image file will be shown as validated data sets
within the Data FLASH Editor window. The remaining data sets will be shown as
invalidated data sets within the editor window.
1.1 Abbreviations
Abbreviations Description
Table 1 Abbreviations
1.3 Trademarks
Green Hills, the Green Hills logo, CodeBalance, GMART, GSTART, INTEGRITY,
and MULTI are registered trademarks of Green Hills Software, Inc. AdaMULTI,
EventAnalyzer, G-Cover, GHnet, GHnetLite, Green Hills Probe,Integrate, ISIM,
PathAnalyzer, Quick Start, ResourceAnalyzer, Safety Critical Products, Slingshot,
SuperTrace Probe, TimeMachine, and TotalDeveloper are trademarks of Green
Hills Software, Inc.
IAR Embedded Workbench, visualSTATE, IAR MakeApp and C-SPY are
registered trademarks of IAR Systems AB. Microsoft and Windows are registered
trademarks of Microsoft Corporation. Adobe and Acrobat Reader are registered
trademarks of Adobe Systems Incorporated.
Windows and Windows Vista are either registered trademarks or trademarks of
Microsoft Corporation in the United States and/or other countries.
PC/AT is a trademark of International Business Machines Corporation.
All other company, product, or service names mentioned in this documentation
may be trademarks or service marks of their respective owners.
Note: These XML values were not used by 78K0R(MF2) based devices. The values
were fixed to zero in case of 78K0R(MF2).
<?xml version="1.0"?>
<DataFlash>
<AdministrativeSection>
<FAL_CONFIG_DATAFLASH_SIZE>16</FAL_CONFIG_DATAFLASH_SIZE>
<FAL_CONFIG_BLOCK_SIZE>0x800</FAL_CONFIG_BLOCK_SIZE>
<EEL_CONFIG_BLOCK_START>2</EEL_CONFIG_BLOCK_START>
<EEL_CONFIG_BLOCK_CNT>6</EEL_CONFIG_BLOCK_CNT>
<EEL_CONFIG_DF_BASE_ADDRESS>0x2000000</EEL_CONFIG_DF_BASE_ADDRESS>
<EEL_CONFIG_BLOCK_CNT_REFRESH_THRESHOLD>0x2</EEL_CONFIG_BLOCK_CNT_REFRESH_THRESHOLD>
<EEL_CONFIG_ERASE_SUSPEND_THRESHOLD>10 </EEL_CONFIG_ERASE_SUSPEND_THRESHOLD>
</AdministrativeSection >
<Record>
<ID>0x80</ID>
<IDName>Name1</IDName>
<Length>2</Length>
<Data>0x20 0x30</Data>
</Record>
</DataFlash>
The approach of using IDs to identify a set of data is in-line with AUTOSAR, as
well as the ID size of 16 bits and length information of 16 bits.
Differing from Code FLASH with 32-bit width, the currently implemented Renesas
Data FLASH is 33-bit wide. The 33-rd bit is called the ID-Tag, indicating, that the
word is information and not part of the data set itself. The current implementation
in the EEPROM emulation layer sets this on the bottom ID-L, while keeping it un-
set on the data bits and on the top ID-L. Dedicated hardware on the Data FLASH
macro can search for a certain ID by using this ID-Tag.
5.1 Overview
A EEPROM emulation Data FLASH section consists of 3 parts:
Section Header
Data Zone
ID Zone
The erase counter word consists of the 16-bit counter and a 16-bit inverse value
for protection. It describes the number of erase cycles on the data section.
The active marker and / or the consumed marker have the value 0x55555555.
The value of a marker which is cleared is 0xFFFFFFFF (Blank Word). The
following section states are possible:
The following section states are possible:
Prepared:
The section has been erased. In the section header the erase counter is
written. Active marker and consumed marker are cleared. This section is
ready for activation by a Refresh operation.
Active:
The section contains the latest data sets. The EEPROM emulation can read
and write data to this section. In the section header, additionally to the erase
counter, also the active marker is set. Consumed marker is cleared.
Consumed:
The section is full, no more space was available to Write new data sets. After
activating the next section and copying the latest data sets there, the Refresh
operation marked the full section consumed. In the section header
additionally, to the erase counter and active marker, also the consumed
marker is set. Next step is to Prepare the section.
Invalid:
This is no valid state. During operation it can only occur in case of
interruption of a FLASH operation like erase to this section. The section
header may contain any other data except as described in the three states
before. Also a completely erased FLASH (default factory delivery state) is
invalid from EEPROM emulation point of view.
5.3 ID zone
The ID-zone is a list of IDs of the data sets written to the section so far. The ID-
list is dynamically generated during writing new data sets into the section. An ID-
List is required in order to simplify and to speed up Refresh operations (copying
data sets from a full data section to a prepared one). The solution to keep the ID-
list dynamically in the EEPROM Emulation FLASH space instead of keeping it
statically in the Code FLASH area has been chosen, in order to allow new/added
applications to store data sets with new IDs. The ID-zone grows by time in case
of writing new data sets with new IDs.
last
physical
block
1’st
physical
block
Section Header
Data Zone
Reference Zone
The references write pointer (RWP) points to the previous block separator
between REF zone and Data zone. By that, the EEL knows for each occupied
block the last REF zone entry. The RWP stability is ensured by the A - 1 word,
written afterwards in the activation process. If the A - 1 word is valid, the RWP is
electrically stable. Additionally, the RWP is checksum protected in order to be
robust against accidental overwriting due to application failures
The EEPROM emulation block header information decides the block status.The
following block states are possible:
Prepared:
I–0 = 0xFFFFFFFF
I–1 = 0xFFFFFFFF
P = 0x55555555
A–0 = 0xFFFFFFFF
A–1 = 0xFFFFFFFF
Active:
I–0 = 0xFFFFFFFF
I–1 = 0xFFFFFFFF
P = 0x55555555
A–0 = 0x55555555
A–1 = 0x55555555
Excluded:
I–0 = 0x55555555
I–1 = 0x55555555
Invalid.
I–0 = 0
I–1 = 0
When contemplate EEL-pool blocks clockwise the regions are always in the
same fixed chronological order:
“prepared region” is before “active region”
“active region” is before “invalid region”
“invalid region” is before “prepared region”
a) two symmetrical sections (where always 50% of data flash does not contain
valid data) are not needed anymore
b) the “active region” can grow and be adapted to the momentary need
c) the reference area is separated from the data inside the same EEL block
d) copy-processes are mostly much faster because reduced to the only last
active block has to be released from valid instances.
e) exclude functionality does not reduce performance of the driver
After the setup program has finished initialization a welcome screen appears.
Click the Next button to continue the installation.
In the next step of installation, the License Agreement window appears. Please
read the Software Program License Agreement carefully. To continue the
installation accept the License agreement and click the Next button. If you not
accepted the license agreement the installation procedure exits.
The Destination Folder window appears. You might exit the installation by clicking
the Cancel button. You can click the Change button to be able to change the
installation destination path. Press the Next button to proceed with the
installation.
After everything has been setup for installation, press the Install button to start
the copy process and to finalize the installation.
On the installation progress window you can follow the installation. You can
always abort the installation by pressing the Cancel button.
The program has been installed successfully and an entry has been made into
the program menu to start the Data FLASH Editor software.
The installation process is complete now and the setup utility has installed a new
program folder which holds the Data FLASH Editor GUI Software and a Data
FLASH Editor uninstall icon which allows you to remove the Data FLASH Editor
software from your personal computer.
<1> Menu bar <2> Tool bar <3> Data FLASH window
9.1 Toolbar
The toolbar contains buttons to configure the Data FLASH Editor. The following
buttons and corresponding functions are offered by the Data FLASH Editor.
By using the File menu a Data FLASH memory image can be loaded, stored or if
necessary closed. Additionally, the memory mapping of the Data FLASH area
can be controlled via the File menu.
(1)
(2)
(3)
(4)
(5)
(6)
(7)
(8)
The Open Device Parameter File menu allows selecting and loading an
existing Device Parameter File, which file name always includes the extension
*.pr5. The Data FLASH Editor gets the device FLASH type e.g.
V850E/ES(MF2/UX4), V850E2(UX6LF) or 78K0R(MF2) information from the
device parameter file. Additionally for a V850E2(UX6LF) or 78K0R(MF2) based
device more Data FLASH information like the block number, FLASH range, start
address will be read from the device parameter file.
By loading a new Device Parameter File the current configuration of the Data
FLASH Editor is set to default.
The Open XML File menu is only enabled for V850E2(UX6LF) and
78K0R(MF2) FLASH Technology based devices. It allows selecting and loading
an existing XML based raw data description by the Data FLASH Editor. The XML
file must fit to the selected Device Parameter File. Otherwise the Data FLASH
Editor generates a corresponding error message.
The Open… menu allows selecting and loading an existing Data FLASH
memory image by the Data FLASH Editor. After loading the Data FLASH memory
image the corresponding Data FLASH entries are shown in the Data FLASH
window.
Note: Before a Data FLASH memory image can be loaded the Data FLASH area must
be specified within the Settings menu.
In case of V850E/ES(MF2/UX4) the Data FLASH start address and size must be
specified first.
Note: When loading a Data FLASH memory image it must fit to the chosen Data
FLASH start address and the Data FLASH size. Otherwise the file loading will be
aborted and a corresponding error message is generated.
The most recently used directory a file has been loaded from will be offered in
this file open menu. The Data FLASH memory image can be loaded in two
different formats, the Intel-hex or Motorola-S record file format.
After a Data FLASH memory image is loaded, the corresponding EEPROM
emulation data entries, including ID-tag, length and data record information were
displayed in the Data FLASH window of the editor.
Additional to the Data FLASH memory the file reading process and the
corresponding file and address map information are displayed in the process
window.
The New HEX/SREC File menu is enabled only for V850E2(UX6LF) and
78K0R(MF2) FLASH Technology based devices. It allows preparing a new
HEX/SREC file by the Data FLASH Editor.
Via the Close… menu the working on a Data FLASH memory image can be
finished and the corresponding Data FLASH memory image will be closed. In
case the Data FLASH memory image was changed a file save dialog offers the
possibility to save the last changes.
The Save as… menu is enabled only for V850E2(UX6LF) and 78K0R(MF2)
FLASH Technology based devices. It allows saving of a modified or newly
created XML file by the Data FLASH Editor. Especially, the invalidated data sets
will be saved in the XML file and the memory space they occupied will be
included in the data FLASH memory check function.
The Save as HEX/SREC File menu allows saving of a modified Data FLASH
memory image by the Data FLASH Editor. Especially for V850E2(UX6LF) and
78K0R(MF2) FLASH Technology based devices, the invalidated data sets will be
ignored in the saved file.
(8) Exit
Via the Exit menu the Data FLASH Editor can be closed. In case the Data
FLASH memory image was changed a file save dialog offers the possibility to
save the last changes.
In addition, the current Data FLASH Editor configuration is stored in the
“CurrentSettings.xml” configuration file. The configuration file is located in the
installation folder of the Data FLASH Editor. By restarting the Data FLASH Editor
the latest settings are restored.
Note: Write permissions to the installation folder and to the “CurrentSettings.xml”file are
required to allow the storage of the current configuration settings by the Data
FLASH Editor.
The Setup Data FLASH menu allows to setup the corresponding Data FLASH
of the chosen device. According to the FLASH Technology of the specified
device V850E/ES(MF2/UX4) or V850E2(UX6LF) / 78K0R(MF2) two different
setup menus will be displayed.
For V850E/ES (MF2/UX4) based devices the Setup Data FLASH menu allows
to setup the start address and the size of the Data FLASH area. By selecting this
menu item the following dialog window appears and offers the possibility to
specify the Data FLASH mapping.
Within the Data FLASH Settings dialog the start address of the Data FLASH area
must be specified. Only hexadecimal input values are permissible. The entered
start address should be equal to the physical start address of the Data FLASH
area of the corresponding V850E/ES(MF2/UX4) device. The size of the Data
FLASH can be specified by the pull-down menu. Supported sizes are 4 KByte, 8
KByte, 16 KByte and 32 KByte.
Tip: After a Data FLASH memory image was loaded or edited, the Data FLASH Start
Address can be modified by the user. This offers the possibility to generate and
store the Data FLASH memory image for different memory locations. In case of
V850E/ES(MF2/UX4) the debugging address space or otherwise the FLASH
programmer address space can be specified.
Tip: After a Data FLASH memory image was loaded or edited, the Data FLASH Start
Address can be changed by the user, by modifying the
“EEL_CONFIG_DF_BASE_ADDRESS” entry. This offers the possibility to
generate and store the Data FLASH memory image for different memory
locations. In case of 78K0R(MF2) the debugging address space or otherwise the
FLASH programmer address space can be specified.
By using the View menu the configuration of the Data FLASH Editor can be
changed. The following functions are offered by the View menu.
(1)
(2)
(3)
(4)
(5)
(6)
(7)
The functionality of each View menu items is described in the following table.
The About Data FLASH Editor… command opens the “About Data FLASH
Editor” window as shown below and indicates the program version.
The meaning of the different colours of the displayed EEPROM data records can
be found in the following table.
By using the “Refresh” function in the Tools menu, all changes that have been
done will be written to the active Data FLASH section. After the active Data
FLASH section has been updated successfully, all EEPROM data records are
displayed in blue colour.
The functionality of each corresponding Data FLASH window button is described
in the following table.
(1)
(2)
(3)
(4)
(5)
The functionality of each Add menu item is described in the following table.
After a new EEPROM emulation data record has been entered, please press the
<OK> button.
The new EEPROM data record is now visible, highlighted in red colour, in the
Data FLASH window.
To make the changing valid and finally add the new EEPROM data record to the
active Data FLASH section, please execute the “Refresh” function within the
Tools menu.
After the active Data FLASH section has been updated successfully, the new
EEPROM data record is displayed in blue colour.
(1)
(2)
(3)
(4)
(5)
The Edit menu does only support the modification of the data record, the format
and the size. The ID and Length of the corresponding data record can not be
changed. The functionality of each Edit menu item is described in the following
table.
After an EEPROM emulation data entry has been modified, please press the
<OK> button.
The modified EEPROM data record is now visible, highlighted in green colour, in
the Data FLASH window.
To make the changing valid and finally add the new EEPROM data record to the
active Data FLASH section, please execute the “Refresh” function in the Tools
menu.
After the active Data FLASH section has been updated successfully, the new
EEPROM data record is displayed in blue colour.
To delete the selected EEPROM data record, please press the <OK> button. To
remove the selected EEPROM data record finally from the active Data FLASH
selection, please execute the “Refresh” function in the Tools menu.
The process window shows the executed tool commands and process
information. Additionally it stores the command history. You can use the scroll bar
to navigate through the command history.
Data size
(*) = Only by loading a new Data FLASH memory image the selected data format will
be taken under consideration. Changing the display format within the Settings
menu after a Data FLASH memory was loaded has no influence and does not
change the global format of the represented EEPROM emulation data entries.
You can change the display format of an individual EEPROM emulation data
entry in the Edit menu by double-clicking on it or using the “Edit” button within
the Data FLASH window.
The following table shows the error messages generated by the Data FLASH
Editor.
Error
Message / Description
Number
[E002] Could not open FLASH file!
[E003] Could not read FLASH file!
[E004] Could not save FLASH file!
[E005] Could not load program configuration file <CurrentSettings.xml>!
[E006] Could not write program settings XML file!
[E007] Could not save XML file!
[E008] The FLASH file contains checksum error!
[E009] The FLASH file contains unknown lines!
[E010] The FLASH file contains wrong Intel HEX lines!
[E011] The FLASH file contains wrong Motorola SREC lines!
[E012] The FLASH file contains wrong information!
[E013] The data record could not be found!
[E014] Active FLASH sector error when searching sector 0!
[E015] Active FLASH sector error when searching sector 1!
[E016] The active FLASH sector could not be found!
[E017] Error during memory copy!
[E018] FLASH file does not include data for RecordID <id>!
The RecordID <id> has been deleted. A refresh is needed before it can
[E019]
be used again!
[E020] The RecordID <id> is already used!
[E021] Illegal character, must be an integer value, use digits 0-9!
[E022] Error during decimal conversion, element=<id>!
[E023] Error during hexadecimal conversion, element=<id>!
[E024] The new data set does not fit in current FLASH!
[E025] Problem to update empty FLASH space size!
[E026] The length must be 4-65532
[E027] Error when ID should be inserted!
[E028] Error when data should be inserted!
Revision History
Description
Rev. Date
Page Summary
First Edition Issued. Replaces document
1.00 March 31, 2011 -
U19829EE2V0UM00.
R01UT0176ED0000