Renesas RL78 Smart Configurator User Manual
APPLICATION NOTE
R20AN0580EC0100
Rev.1.00
Apr.01.21
RL78 Smart Configurator
User's Guide: CS+
Introduction
This application note describes the basic usage of the RL78 Smart Configurator (hereafter called the Smart
Configurator), and the procedure for adding its output files to CS+ projects.
References to the Smart Configurator and CS+ integrated development environment in this application note
apply to the following versions.
• CS+ (CS+ for CC) V8.05.00 and later
• RL78 Smart Configurator V1.0.0 and later
• CS+ RL78 Smart Configurator Communication Plugins V1.00.00 and later
Target Devices
Refer to the following URL for the range of supported devices:
https://www.renesas.com/smart-configurator
R20AN0580EC0100 Rev.1.00 Page 1 of 60
Apr.01.21
RL78 Smart Configurator User's Guide: CS+
Contents
Overview .......................................................................................................................... 4
Purpose ......................................................................................................................................... 4
Features ........................................................................................................................................ 4
Software Components ................................................................................................................... 4
Before Using the Smart Configurator ................................................................................ 5
Preparing the CS+ (CS+ for CC) Integrated Development Environment ..................................... 5
Installing the Smart Configurator................................................................................................... 5
Setting the CS+ Integrated Development Environment ................................................................ 5
Checking the Plug-in Settings ................................................................................................. 5
Checking the Setting of the Execution Path ........................................................................... 6
Uninstalling the Smart Configurator .............................................................................................. 6
Operating the Smart Configurator ..................................................................................... 7
Procedure for Operations .............................................................................................................. 7
Starting the Smart Configurator .................................................................................................... 8
File to be Saved as Project Information ........................................................................................ 8
Window .......................................................................................................................................... 9
Main Menu ............................................................................................................................ 10
Toolbar .................................................................................................................................. 10
Smart Configurator View ....................................................................................................... 11
MCU Package View .............................................................................................................. 11
Console View ........................................................................................................................ 12
Configuration Problems View ................................................................................................ 12
Setting of Peripheral Modules ......................................................................................... 13
Board Settings ............................................................................................................................. 13
Selecting the Device ............................................................................................................. 13
Selecting the Board ............................................................................................................... 13
Exporting Board Settings ...................................................................................................... 15
Importing Board Settings ...................................................................................................... 15
Clock Settings ............................................................................................................................. 16
System Settings .......................................................................................................................... 17
Component Settings .................................................................................................................... 19
Switching Between the Component View and Hardware View ............................................ 19
Adding a Software Component ............................................................................................. 20
Removing a Software Component ........................................................................................ 22
Setting a Code Generator Component ................................................................................. 23
Changing the Resource for a Code Generator Component ................................................. 24
Setting SNOOZE Mode Sequencer (SMS) Component ....................................................... 26
Update SMS Data Files ........................................................................................................ 29
Logic Event Link Controller (ELCL) Modules Download ....................................................... 30
Setting an ELCL Component ................................................................................................ 31
Downloading RL78 Software Integration System Modules .................................................. 32
Setting a RL78 Software Integration System Module ........................................................... 33
Changing Version of BSP Configuration ............................................................................... 33
R20AN0580EC0100 Rev.1.00 Page 2 of 60
Apr.01.21
RL78 Smart Configurator User's Guide: CS+
Configure General Setting of Component ............................................................................. 35
Pin Settings ................................................................................................................................. 37
Changing the Pin Assignment by PIOR Function ................................................................. 38
Changing the Pin Assignment of a Software Component .................................................... 39
Assigning Pins Using the MCU Package View ..................................................................... 40
Exporting Pin Settings ........................................................................................................... 41
Importing Pin Settings ........................................................................................................... 41
Pin Setting Using Board Pin Configuration Information ........................................................ 42
Pin Filter Feature................................................................................................................... 42
Interrupt Settings ......................................................................................................................... 43
Changing Interrupt Priority Setting ........................................................................................ 43
Changing Interrupt Bank Setting ........................................................................................... 44
Managing Conflicts ......................................................................................................... 45
Resource Conflicts ...................................................................................................................... 45
Resolving Pin Conflicts ............................................................................................................... 45
Generating Source Code ................................................................................................ 47
Registering Generated Source Code with CS+ .......................................................................... 47
Configuration of Generated Files and File Names ...................................................................... 48
Initializing Clocks ......................................................................................................................... 51
Initializing Pins............................................................................................................................. 52
Initializing Interrupts .................................................................................................................... 53
Creating User Programs ................................................................................................. 54
Adding Custom Code .................................................................................................................. 54
Backing up Generated Source Code .............................................................................. 56
Generating Reports ........................................................................................................ 57
Report on All Configurations (PDF or Text File) ......................................................................... 57
Configuration of Pin Function List and Pin Number List (in csv Format) .................................... 58
Image of MCU Package (in png Format) .................................................................................... 58
Help ................................................................................................................................ 59
Documents for Reference ............................................................................................... 60
R20AN0580EC0100 Rev.1.00 Page 3 of 60
Apr.01.21
RL78 Smart Configurator User's Guide: CS+
Overview
Purpose
This application note describes the basic usage of the Smart Configurator and CS+ integrated development
environment, including the procedure for creating a project and adding Smart Configurator output to CS+
projects.
Refer to the User’s Manual of CS+ for how to use CS+.
Features
The Smart Configurator is a utility for combining software to meet your needs. It handles the following three
functions to support the embedding of drivers from Renesas in your systems: importing middleware in the
form of SW integration feature, generating driver code, and making pin settings.
Software Components
The Smart Configurator supports three types of software components: Code Generator, Graphical
Configurator, and RL78 Software Integration System:
(1) Code Generator drivers (DTC, A/D Converter, Interrupt Controller, etc.)
The Code Generator drivers is a control program for peripheral functions of microcomputer such as
DTC, A/D converter, Interrupt Controller, etc. It is convenient to embed a software component using
code generation function.
(2) Graphical Configurator (SMS, ELCL)
The Graphical Configurator module makes it easy to set up complex configurations by providing a
graphical GUI compared to other drivers. It provides software components for SNOOZE mode
sequencer (SMS) and logic and event link controller (ELCL).
(3) RL78 Software Integration System (CAPACITIVE SENSING UNIT (CTSU2L), etc.)
The RL78 Software Integration System module is a software component of drivers, middleware SW that
provides a simple GUI for generating code.
R20AN0580EC0100 Rev.1.00 Page 4 of 60
Apr.01.21
RL78 Smart Configurator User's Guide: CS+
Before Using the Smart Configurator
Preparing the CS+ (CS+ for CC) Integrated Development Environment
To create or build a program in the CS+ integrated development environment with the use of source code
generated by the Smart Configurator, you will need to install CS+ to handle building for the target device.
Installing the Smart Configurator
Download the RL78 Smart Configurator and CS+ RL78 Smart Configurator Communication plug-in from the
URL below. The CS+ RL78 Smart Configurator communication plug-in is required for registering source code
generated by the Smart Configurator with CS+.
https://www.renesas.com/smart-configurator
After activating the installer, install the Smart Configurator and the plug-in by following the procedure of the
installer. You will require administrator privileges to do this.
Setting the CS+ Integrated Development Environment
Source files the Smart Configurator generates can be registered with CS+, and CS+ can be set to the
configuration required to build the registered source files. This is set up automatically at the time the Smart
Configurator is installed; however, you will need to check the settings against the following and modify them
as required.
Checking the Plug-in Settings
Select [Plug-in Manager] from [Tool] of CS+ menu and confirm that there is a tick against “Smart
Configurator for RL78 Communication Plug-in”. Tick it if it is not.
Figure 2-1. Plug-in Manager
R20AN0580EC0100 Rev.1.00 Page 5 of 60
Apr.01.21
RL78 Smart Configurator User's Guide: CS+
Checking the Setting of the Execution Path
[Smart Configurator (Design Tool)] is displayed under [Project name (Project)] in the Project Tree when you
open the CS+ project for the target device of the Smart Configurator.
Click on [Smart Configurator (Design Tool)], and the Smart Configurator Property panel is displayed.
Figure 2-2. Displaying the Property
“Smart Configurator for RL78 executable file path” shows the executable file of the Smart Configurator. The
following path is set when the Smart Configurator is installed with the default setting (where “CS+” and
“SmartConfigurator” are in the same level).
32-bit environment:
“C:¥Program Files¥Renesas Electronics¥SmartConfigurator¥RL78¥eclipse¥SmartConfigurator.exe”
64-bit environment:
“C:¥Program Files (x86)¥Renesas Electronics¥SmartConfigurator¥RL78¥eclipse¥SmartConfigurator.exe”
When manually specifying the path of the executable file, “Smart Configurator for RL78 executable file path”
can be set as either a relative or an absolute path.
Uninstalling the Smart Configurator
If you wish to uninstall the Smart Configurator, select “Smart Configurator for RL78” and “CS+ Smart
Configurator Communication Plugins for RL78” from [Apps & features] in your PC’s Windows Settings Apps
control panel and uninstall them.
R20AN0580EC0100 Rev.1.00 Page 6 of 60
Apr.01.21
RL78 Smart Configurator User's Guide: CS+
Operations in CS+
Operations in the Smart Configurator
Starting CS+
Creating and loading a CS+ project
Starting the Smart Configurator
Setting of peripheral modules
Generating source code
Creating user programs
Building
Execution and debugging
Setting of pins
Refer to section 3.2, Starting
Refer to chapter 7, Creating User
Refer to chapter 4, Setting of
Peripheral Modules.
Refer to section 4.5, Pin
Refer to chapter 6,
Device information
Toolchain information
Registering source files
Generating reports
Refer to chapter 9,
Setting of interrupts
Refer to section 4.6, Interrupt
Settings
Operating the Smart Configurator
Procedure for Operations
Figure 3-1 shows the procedure for using the Smart Configurator to generate files for setting up peripheral
modules, and to use them in building after registration with CS+. Refer to the related documents on CS+ for
the operation of CS+.
the Smart Configurator.
Settings
Generating Source Code.
Programs.
R20AN0580EC0100 Rev.1.00 Page 7 of 60
Apr.01.21
Generating Reports.
Figure 3-1. Procedure for Operations
RL78 Smart Configurator User's Guide: CS+
Starting the Smart Configurator
Double-click on [Smart Configurator (Design Tool)] under [Project name (Project)] in the Project Tree of CS+
to start the Smart Configurator. You do not need to select a device or toolchain for the Smart Configurator,
since the settings of the project for CS+ are passed over to the Smart Configurator.
Figure 3-2 Activation of Smart Configurator
Note: The settings of CS+ are not passed over to the Smart Configurator in the following cases: when the Smart
Configurator is activated from its executable file, when a new project is created from [File] menu of the Smart
Configurator, or when an existing file from the Smart Configurator is opened.
File to be Saved as Project Information
The Smart Configurator saves the setting information such as the target MCU for the project, build tool,
peripheral modules, and pin functions in a project file (*.scfg), and refers to this information.
When the Smart Configurator is activated from CS+, the project file from the Smart Configurator is saved in
“project name.scfg”, which is at the same level as the project file (*.mtpj) of CS+.
R20AN0580EC0100 Rev.1.00 Page 8 of 60
Apr.01.21
RL78 Smart Configurator User's Guide: CS+
(1)
(2)
(3)
(4)
(5)
(6)
Window
The main window is displayed when the Smart Configurator is started. The configuration of the window is
shown in Figure 3-3, Main Window.
(1) Menu bar
(2) Main toolbar
(3) Smart Configurator view
(4) MCU Package view
(5) Console view
(6) Configuration Problems view
Figure 3-3 Main Window
R20AN0580EC0100 Rev.1.00 Page 9 of 60
Apr.01.21
RL78 Smart Configurator User's Guide: CS+
Menu
Details
displayed.
Save
Saves a project with the same name.
handed over from CS+.
Exit
Execution of the Smart Configurator is terminated.
Window
Preference
Show View
The dialog box [Show view], which is used to set the view of the window, is displayed.
Help
Help Contents
The help menu is displayed.
Home Page
The home page is opened.
Release Notes
The release note is opened.
Tool News
The tool news is opened.
API Manual
The API manual is opened.
About
The version information is displayed.
Toolbar button
Related menu item
Main Menu
Table 3-1, Main Menu Items, lists the items of the main menu.
Table 3-1. Main Menu Items
File New The dialog box [New Smart Configurator File], which is used to create a new project, is
Open The dialog box [Open], which opens an existing project, is displayed.
Restart Smart Configurator is restarted.
Do not use this menu item in general, as it leads to deletion of the project settings
The dialog box [Preference], which is used to specify the properties of the project, is
displayed.
Toolbar
Some functions of the main menu are allocated to the buttons on the toolbar. Table 3-2, Toolbar Buttons and
Related Menu Items, shows the description of those tool buttons.
Table 3-2. Toolbar Buttons and Related Menu Items
[File] → [New]
[File] → [Open]
[File] → [Save]
R20AN0580EC0100 Rev.1.00 Page 10 of 60
Apr.01.21
RL78 Smart Configurator User's Guide: CS+
Smart Configurator View
The Smart Configurator view consists of seven pages: [Overview], [Board], [Clocks], [System],
[Components], [Pins], and [Interrupts]. Select a page by clicking on a tab; the displayed page will be
changed.
Figure 3-4. Smart Configurator View
MCU Package View
The states of pins are displayed on the figure of the MCU package. The settings of pins can be modified from
here.
Two types of package view can be switched between [Assigned] and [Default Board]. [Assigned] displays the
assignment status of the pin setting, and [Default Board] displays the initial pin setting information of the
board. The initial pin setting information of the board is the pin information of the board selected by [Board:]
on the [Board] page (refer to "4.1.2 Selecting the Board").
Figure 3-5
R20AN0580EC0100 Rev.1.00 Page 11 of 60
Apr.01.21
. MCU Package View
RL78 Smart Configurator User's Guide: CS+
Console View
The Console view displays details of changes to the configuration made in the Smart Configurator or MCU
Package view.
Figure 3-6. Console View
Configuration Problems View
The Configuration Problems view displays the details of conflicts between driver used interrupts, configured
peripherals, used pins, used settings.
Figure 3-7. Configuration Problems View
R20AN0580EC0100 Rev.1.00 Page 12 of 60
Apr.01.21
RL78 Smart Configurator User's Guide: CS+
Button
Operation explanation
Yes
Change to the selected device.
No
It does not change the device.
Save and continue
(Note*1)
After saving the current configuration contents to the configuration file, change to the
selected device.
Continue
(Note*1)
Changes to the selected device without saving the current configuration contents to
the configuration file.
Cancel
(Note*1)
It does not change the device.
Setting of Peripheral Modules
You can select peripheral modules from the Smart Configurator view.
Board Settings
You can change the board and device on the [Board] page. For information on changing the device of the
project, refer to the CS+ User's Guide.
Selecting the Device
Click on the [ ] button to select a device.
Figure 4-1. Selecting the Device
The following message is displayed when changing the device. For each button operation, refer to "Table
4-1, Device Change Confirmation Operation List".
Figure 4-2. Confirm Device Change
Table 4-1. Device Change Confirmation Operation List
Note *1: Smart Configurator view is marked with dirty *.
Note *2: Device change is not reflected to the device (micro controller) of CS+ project.
R20AN0580EC0100 Rev.1.00 Page 13 of 60
Apr.01.21
RL78 Smart Configurator User's Guide: CS+
Button
Operation explanation
Save and continue
After saving the current configuration contents to the configuration file, change to the
selected device.
Continue
Changes to the selected device without saving the current configuration contents to
the configuration file.
Cancel
It does not change the device.
Selecting the Board
By selecting a board, the following settings can be changed at one time.
• Pin assignment (Initial pin setting)
• Frequency of the main clock
• Frequency of the subsystem clock
• Target device
The board setting information is defined in the Board Description File (.bdf).
The .bdf file of Renesas made board (e.g. Renesas Starter Kit) can be downloaded from website and
imported.
In addition, by downloading the .bdf file provided by the alliance partner from website and importing it, it is
possible to select alliance part boards.
Figure 4-3. Selecting the Board
If you change the board, the message will be displayed. For each button operation, refer to "Table 4-2, Board
Change Confirmation Operation List".
Figure 4-4. Confirm Board Change
Table 4-2. Board Change Confirmation Operation List
Note: Depending on the board selected, the device will change, Device change is not reflected to the target device of
CS+ project.
R20AN0580EC0100 Rev.1.00 Page 14 of 60
Apr.01.21
RL78 Smart Configurator User's Guide: CS+
(1)
(2)
(1)
Exporting Board Settings
Follow the procedure below to export the board settings.
(1) Click on the [ (Export board setting)] button on the [Board] page.
(2) Select the output location and specify a name (Display Name) for the file to be exported.
Figure 4-5. Exporting Board Settings (bdf Format)
Importing Board Settings
Follow the procedure below to import board settings.
(1) Click on the [ (Import board setting)] button and select a desired bdf file.
(2) The board of the imported settings is added to the board selection menu.
Figure 4-6. Importing Board Settings (bdf Format)
Once a board setting file is imported, the added board is also displayed in the board selection menu of other
projects for the same device group.
R20AN0580EC0100 Rev.1.00 Page 15 of 60
Apr.01.21
RL78 Smart Configurator User's Guide: CS+
(1)
(2)
(3)
(4)
(4)
(4)
(4)
Clock Settings
You can set the system clock on the [Clocks] page. The settings made on the [Clocks] page is used for all
drivers.
Follow the procedure below to modify the clock settings.
(1) Specify the operation mode and EVDD setting.
(2) Select the clocks required for device operations on the board (the high-speed on-chip oscillator is
selected by default).
(3) Specify the frequency of each clock in accordance with the board specifications (note that the frequency
is fixed for some internal clocks).
(4) For the multiplexer symbol, select the clock source for the output clocks.
Figure 4-7. [Clocks] Page
R20AN0580EC0100 Rev.1.00 Page 16 of 60
Apr.01.21
RL78 Smart Configurator User's Guide: CS+
(2)
(1)
(3)
(4)
System Settings
You can set the on-chip debug setting on the [System] page. This setting is reflected in the CS + build option
settings via the communication plugin.
For example, below figure shows the default CS+ link option settings:
Figure 4-8. CS+ Default Link Options View
After you click on [System] page of Smart Configurator, make desired setting as in below figure for
illustration:
Figure 4-9. Smart Configurator [System] Page Setting
Note: The security ID setting is reflected in the security ID of Build Tool Common Options.
Other items are not reflected, so you need to set the Build Tool property in the same way.
R20AN0580EC0100 Rev.1.00 Page 17 of 60
Apr.01.21
RL78 Smart Configurator User's Guide: CS+
Please follow steps from (1) to (3) to make setting on [System] page, after that click on [ Generate
Code] button as in step (4), a dialog window will be prompted out as in below figure, to confirm with you for
the linker option update in CS+ IDE:
Please click [OK] button in the dialog, go back CS+ to check linker options updated as below:
Note: Depending on the MCU type selection or chip part numbers, these setting values varies. Please refer to the latest
device HUM for the detail setting configuration
Figure 4-10. Confirm Linker Option Dialog
Figure 4-11. CS+ Updated Link Options View
.
R20AN0580EC0100 Rev.1.00 Page 18 of 60
Apr.01.21
RL78 Smart Configurator User's Guide: CS+
Tree view for components
(1)
(2)
Component Settings
CG drivers, Graphical Configurator and RL78 Software Integration System module can be combined as
software components on the [Components] page. Added components are displayed in the tree view at the
left of the page.
Figure 4-12. [Components] Page
Switching Between the Component View and Hardware View
The Smart Configurator provides two tree view: Component View and Hardware View. You can Switch two
view by clicking the following icons:
(1) Click on the [ (Component View)] icon. The tree view will display the components by component
category.
(2) Click on the [ (Hardware View)] icon. The tree view will display the components in a hardware
resource hierarchy.
Figure 4-13. Switching to the Hardware View
R20AN0580EC0100 Rev.1.00 Page 19 of 60
Apr.01.21
Loading...