RL78 Family
EEPROM Emulation Library Pack02 Ver.1.01
Release Note
R20UT2645EJ0100
Rev.1.00
Mar 28, 2014
Thank you for using the RL78 Family EEPROM Emulation Library Pack02 Ver.1.01.
This document contains notes and cautions for using the EEPROM Emulation Library Pack02 Ver.1.01.
Please read this document before use.
Contents
Chapter 1
Chapter 2
Chapter 3
Chapter 4
Chapter 5
5.1
5.2
5.3
Target Product.................................................................. 2
User’s Manual ................................................................... 2
Operating Environment........................................................... 2
Supported Tools................................................................. 3
Installation ................................................................... 3
Installation ....................................................................... 3
Uninstallation ..................................................................... 3
File organization .................................................................. 4
How To Build a Program.......................................................... 5
Chapter 6
6.1
Software to be used ................................................................ 5
6.2
Building using CubeSuite+........................................................... 5
6.2.1
Building a C program............................................................ 5
6.2.2
Building an assembly language program ........................................... 8
6.3
Notes at Build .................................................................... 10
Chapter 7
7.1
How To Debug a Program......................................................... 11
Notes at Debug .................................................................... 11
Sample Program................................................................. 12
Chapter 8
8.1
8.2
8.3
Initial Settings of the Sample Program ............................................. 12
Settings of Option Byte and On-Chip Debugging ...................................... 13
Definition of the On-Chip RAM Area ................................................. 14
R20UT2645EJ0100
Mar 28, 2014
Rev.1.00
Page 1 of 15
RL78 Family
EEPROM Emulation Library Pack02 Ver.1.01
Release Note
Chapter 1
Target Product
This shows the target product of release note.
Product Name
Ver.
V1.01
ZIP File Name
JP_R_EEL_RL78_P02_V1.01_A_E
Zip Ver.
V1.01A
RL78 Family
EEPROM Emulation Library Pack02
Chapter 2
User’s Manual
The following User’s Manual is available for this library:
Title
RL78 Family EEPROM Emulation Library Pack02
User’s Manual
Document Number
R01US0068EJ0100
Chapter 3
Operating Environment
Using the EEPROM Emulation Library Pack02 Ver. 1.01 requires the following environment, which supports the
development tools.
IBM PC/AT-compatibles (Windows™ based)
OS
:
WindowsXP,WindowsVista, Windows7
R20UT2645EJ0100
Mar 28, 2014
Rev.1.00
Page 2 of 15
RL78 Family
EEPROM Emulation Library Pack02 Ver.1.01
Release Note
Chapter 4
Supported Tools
Use the following tool version when using tools in combination with this library:
Tool Used
Integrated development environment CubeSuite+
Version
V1.00.00
or later
Chapter 5
Installation
This chapter describes how to install and uninstall the EEPROM Emulation Library Pack02.
5.1
Installation
Install the EEPROM Emulation Library Pack02 by using the following procedure:
(1) Start Windows.
(2) Decompress the folder that contains the EEPROM Emulation Library Pack02 files and copy the extracted
folders to any location.
5.2
Uninstallation
Uninstall the EEPROM Emulation Library Pack02 by using the following procedure:
(1) Start Windows.
(2) Delete the folder that contains the EEPROM Emulation Library Pack02 files.
R20UT2645EJ0100
Mar 28, 2014
Rev.1.00
Page 3 of 15
RL78 Family
EEPROM Emulation Library Pack02 Ver.1.01
Release Note
5.3
File organization
The file organization after this library is installed is shown below.
Installation folder
EELRL78 Pack02
V1.01
Read me
TERMS AND CONDITIONS FOR USING THE SOFTWARE.pdf :
Terms and conditions for using the software
doc
r01us0068ej0100_rl78.pdf
r20ut2645ej0100_rl78.pdf
: User’s Manual
: Release Note (this document)
librl78
eel.lib
fdl.lib
incrl78
eel.h
eel.inc
eel_types.h
eel_types.inc
fdl.h
fdl.inc
fdl_types.h
smprl78
asm
eel_descriptor.inc
eel_descriptor.asm
eel_sample_linker_file.dr
fdl_descriptor.inc
fdl_descriptor.asm
C
eel_descriptor.h
eel_descriptor.c
eel_user_types.h
eel_sample_linker_file.dr
fdl_descriptor.h
fdl_descriptor.c
r_eel_sample_c.c
r_eel_sample_c.dr
: EEL descriptor header file
: EEL descriptor source file
: EEL user-defined header file
: EEL sample directive file
: FDL descriptor header file
: FDL descriptor source file
: EEL sample program file
: EEL sample Link directive file
: EEL descriptor header file
: EEL descriptor source file
: EEL sample directive file
: FDL descriptor header file
: FDL descriptor source file
: EEL header file for C program
: EEL header file for assembler
: EEL header file that specifies definitions for C program
: EEL header file that specifies definitions for assembler
: FDL header file for C program
: FDL header file for assembler
: FDL header file that specifies definitions for C program
: EEPROM emulation library (EEL)
: Data flash library (FDL)
Note: When you use the sample program, use the combination of the program file (*.c) and the link directive file (*.dr).
R20UT2645EJ0100
Mar 28, 2014
Rev.1.00
Page 4 of 15
RL78 Family
EEPROM Emulation Library Pack02 Ver.1.01
Release Note
Chapter 6
How To Build a Program
This chapter describes how to build a program using the EEPROM Emulation Library Pack02.
6.1
Software to be used
Below are the system requirements for building programs using the EEPROM Emulation Library Pack02.
•
CubeSuite+ integrated development environment Version 1.00.00 or later
6.2
Building using CubeSuite+
This section describes how to include the EEPROM Emulation Library Pack02 in a user-created program and build the
user program by using CubeSuite+.
6.2.1
Building a C program
(1) Creating a project and specifying the source files
Create a project by using CubeSuite+. In the
Project Tree
window displayed on the left, right-click the
File
node,
click
Add,
and then click
Add File.
The
Add Existing File
dialog box is displayed (as shown in Figure 6-1).
Click the
Files of type
drop-down list, select
C source file (*.c),
and then register the user-created program file
and the descriptor files for the EEPROM emulation library and data flash library (eel_descriptor.c and
fdl_descriptor.c) as the source files.
Figure 6-1. Specifying the Source File
1
3
4
2
R20UT2645EJ0100
Mar 28, 2014
Rev.1.00
Page 5 of 15