Renesas RH850 User Manual
APPLICATION NOTE
R20AN0536EJ0100
RH850 Smart Configu rat or
Rev.1.00
User’s Guide: IAREW, MUL TI
Introduction
This application note describes the basic usage of the RH850 Smart Configurator (hereafter called the Smart
Configurator), and the procedure for importing its output files to IAR Embedded Workbench / GHS MULTI.
References to the Smart Configurator and Integrated Development Environment (IDE) in this application note app ly to
the followi ng versions.
• RH850 Smart Configurator V1.10
• IAR Embedded Workbench for RH850 V2.10
• GHS MULTI V7.16
Target device and support compiler
Refer to the following U RL for the range of supported devices:
https://www.renesas.com/smart-configurator
Jan 25, 2019
Sample project
The sample project for RH850/F1KM is also included in the installation folder of Smart Configurator.
• Sample Project for IAR and IAR ICC
• Sample Project for MULTI and GHS CCRH850
Refer to the following instructions .
Smart Configurator: Guide on Sample Project for RH850/F1KM Device (R01AN4422)
Contents
1. Overview ......................................................................................................................... 4
1.1 Purpose ........................................................................................................................................ 4
1.2 Features ....................................................................................................................................... 4
2. Installation and uninstallation ....................................................................................... 5
2.1 Installing the Smart Configurator .............................................................................................. 5
2.2 Uninstalling the Smart Configurator ......................................................................................... 5
3. Operating the Smart Configurator ................................................................................. 6
R20AN0536EJ0100 Rev.1.00 Page 1 of 43
Jan 25, 2019
3.1 Procedure for Operations ........................................................................................................... 6
3.2 Starting the Smart Configurator ................................................................................................ 7
3.3 Create and loading a configuration file .................................................................................... 8
3.3.1 Creating a New Configuration File ...................................................................................... 8
3.3.2 Opening an Existing Configuration File ............................................................................. 8
RH850 Smart Configurator User’s Guide: IAREW, MULTI
3.4 Window ......................................................................................................................................... 9
3.4.1 Main menu ........................................................................................................................... 10
3.4.2 Toolbar ................................................................................................................................. 10
3.4.3 Smart Configurator view .................................................................................................... 11
3.4.4 MCU Package view ............................................................................................................. 11
3.4.5 Console view ....................................................................................................................... 12
3.4.6 Configuration Problems view ............................................................................................ 12
4. Setting of Peripheral Modules ..................................................................................... 13
4.1 Board setting ............................................................................................................................. 13
4.1.1 Selecting the device ........................................................................................................... 13
4.1.2 Selecting the board ............................................................................................................. 14
4.1.3 Import board configuration ................................................................................................ 15
4.1.4 Export board configuration ................................................................................................ 15
4.2 Clock settings ............................................................................................................................ 16
4.3 Software component settings .................................................................................................. 17
4.3.1 Adding component ............................................................................................................. 17
4.3.2 Switching between the component view and hardware view ........................................ 18
4.3.3 Deleting a software component......................................................................................... 19
4.3.4 Component configuration settings ................................................................................... 20
4.3.5 Component resource change ............................................................................................ 21
4.4 Pin settings ................................................................................................................................ 24
4.4.1 Assign pins to resources ................................................................................................... 25
4.4.2 Pin setting using MCU package ........................................................................................ 26
4.4.3 Export pin settings ............................................................................................................. 27
4.4.4 Import pin settings .............................................................................................................. 27
4.5 Interrupt settings ....................................................................................................................... 28
4.5.1 Changing the interrupt priority level and OS management setting ............................... 28
5. Managing Conflicts ...................................................................................................... 29
5.1 Resource conflicts .................................................................................................................... 29
5.2 Resource pin conflicts .............................................................................................................. 30
6. Generating Source Code ............................................................................................. 31
6.1 Generating Source Code File ................................................................................................... 31
6.2 Configuration of Generated Files and File Names................................................................. 31
6.3 Initializing Clocks ...................................................................................................................... 33
6.4 Initializing Pins .......................................................................................................................... 34
6.5 Initializing Interrupts ................................................................................................................. 35
6.6 Backing up Generated Source Code ....................................................................................... 35
7. Loading generated files in Integrated development environment ............................ 36
7.1 Loading in IAR Embedded Workbench ................................................................................... 36
R20AN0536EJ0100 Rev.1.00 Page 2 of 43
Jan 25, 2019
RH850 Smart Configurator User’s Guide: IAREW, MULTI
7.2 Loading in GHS MULTI ............................................................................................................. 36
8. Creating User Programs .............................................................................................. 37
8.1 Adding Custom Code in the Case of Code Generator .......................................................... 37
9. Generating Reports ...................................................................................................... 39
9.1 Report on Configuration ........................................................................................................... 39
9.2 Configuration of Pin Function List and Pin Number List (in csv Format) ........................... 40
9.3 Image of MCU Package (in png Format) ................................................................................. 40
10. Help ............................................................................................................................... 41
10.1 Help ............................................................................................................................................. 41
11. Documents for Reference ............................................................................................ 42
R20AN0536EJ0100 Rev.1.00 Page 3 of 43
Jan 25, 2019
RH850 Smart Configurator User’s Guide: IAREW, MULTI
1. Overview
1.1 Purpose
This application note describes the basic usage of the RH850 Smart Configurator (hereafter called the Smart
Configurator), and the procedure for importing its output files to IAR Embedded Workbench / GHS MULTI.
Refer to the User’s Manual of IAR Embedded Workbench / GHS MULTI fo r how to use them.
1.2 Features
The Smart Configurator is a utility for combining software to meet your needs. It handles the following tow functions to
support the embedding of drivers from Renesas in your systems: Generating driver code and making pin settings.
R20AN0536EJ0100 Rev.1.00 Page 4 of 43
Jan 25, 2019
RH850 Smart Configurator User’s Guide: IAREW, MULTI
2. Installation and uninstallation
This section describes the insta lla tion and uninstallation.
2.1 Installing the Smart Configurator
Download the Smart Configurator from the URL below.
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.
2.2 Uninstalling the Smart Configurator
If you wish to uninstall the Smart Configurator, select “Smart Configurator for RH850” from [Programs and Features]
in the control panel.
R20AN0536EJ0100 Rev.1.00 Page 5 of 43
Jan 25, 2019
RH850 Smart Configurator User’s Guide: IAREW, MULTI
Operations in the Smart Configuration
Operations in
Starting the Smart Configurator
Create and loading a configuration file
Setting of peripheral modules
Generating source code
Setting of interr upts
Refer to ‘3.2 Starting the Smart
Configurator’
Refer to ‘4 Setting of Peripheral Modules’
Refer to ‘4.5 Interrupt settings’
Refer to ‘6 Generating Source Code’
Creating the user program
Refer to ‘8 Creating User Programs’
Building
Execution and debugging
Generating reports
Refer to ‘9 Generating Reports’
Setting pins
Refer to ‘4.4 Pin settings’
Refer to ‘3.3 Create and loading a
Loading generated files in IDE
Refer to ‘7 Loading generated files in
3. Operating the Smart Configurator
3.1 Procedure for Operations
Figure 3-1 Operating procedure, shows the procedure for generating a source file using Smart Configurator and loading
it into IAR Embedded Workbench. To use the sample project, refer to " Smart Configurator: Guide on Sample Project
for RH850/F1KM Device (R01AN 4422)". For the operation of IAR Embedded Workbench and GHS MULTI, refer to
relevant document of IAR or GHS.
IAR Embedded Workbench,
GHS MULTI
configuration file’
Integrated developme nt environ ment’
R20AN0536EJ0100 Rev.1.00 Page 6 of 43
Jan 25, 2019
Figure 3-1 Operating Procedure
RH850 Smart Configurator User’s Guide: IAREW, MULTI
3.2 Starting the Smart Configurator
Select [Smart Configurator for RH850 Vx.x.x] of [Renesas Electronics Smart Configura tor] from the Windows start
menu. The main window of the Smart Configurator will be starting.
Note: Please replace Vx.x.x with your versio n.
Figure 3-2 Starting of Smart Configurator
R20AN0536EJ0100 Rev.1.00 Page 7 of 43
Jan 25, 2019
RH850 Smart Configurator User’s Guide: IAREW, MULTI
(1)
(2)
(3)
(4)
(5)
(6)
(6)
3.3 Create and loading a configuration file
Smart Configurator saves and refers to the configuration file (*. scfg) the configuration information of the
microcontroller, build tool, peripheral function, pin function etc. used in the project.
3.3.1 Creating a New Configuration File
On the main windo w, click the [New Configuration File] b utto n to display the [New Smart Configuration File]
dialog box.
(1) In [Platform:], select the device.
(2) In [Toolchain:], select the toolchain.
To use the IAR compiler, select "IAR RH850 Toolchain".
To use the GHS compiler, select "GHS RH850 Toolchain".
(3) In [File name:], enter the file name.
(4) Confirm [Location:]. If you want to change it, click [Bro wse] and sele c t the save destination.
(5) To set the RTOS, click [Next]. When “IAR RH850 Toolchain" is selected, RTOS can’t be set.
(6) Click [Finish] to create the configuration file.
Figure 3-3 Create a Configuration File
If you select [RIV] in the RTOS setting, you can select non-OS management inte rrupts / OS ma na ge me nt int er r upt s fo r
component interrupts. For details, refer to "4.5.1, Interrupt prio rity level and OS management s ettings".
3.3.2 Opening an Existing Configuration File
On the main windo w, click the [Opening an Existing Configuration File] button to display the [Open] dialog box.
Figure 3-4 Opening an Existing Configuration File
R20AN0536EJ0100 Rev.1.00 Page 8 of 43
Jan 25, 2019
RH850 Smart Configurator User’s Guide: IAREW, MULTI
(1)
(2)
(3)
(4)
(5)
(6)
3.4 Window
The main window is displ ayed when the Smart Configurator is started . The configur ation of the window is shown in
Figure 3-5, Ma in Window.
(1) Menu bar
(2) Main tool bar
(3) Smart Configurator view
(4) MCU Package view
(5) Console view
(6) Configuration Problems view
Figure 3-5 Main Window
R20AN0536EJ0100 Rev.1.00 Page 9 of 43
Jan 25, 2019
RH850 Smart Configurator User’s Guide: IAREW, MULTI
Menu
Details
File
New
The dialog box [New Smart Configuration File], whic h is used to create a
new configuration file, is displayed.
Open
The dialog box [Open], which opens an existin g configuration file, is
displayed.
Save
Saves a configuration file with the same name.
Restart
Smart Configurator is re-started.
Exit
Execution of the Smart Configurator is terminated.
Window
Preference
The dialog box [Preference], which is used to specify the properties of the
configuration file, is displayed.
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.
About
The version information is displayed.
Toolbar button
Related menu item
[File] → [New Smart Configuration File]
[File] → [Open]
[File] → [Save]
3.4.1 Main menu
Table 3-1, Main Menu Items, lists the items of the mai n me nu.
Table 3-1 Main Menu Items
3.4.2 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
R20AN0536EJ0100 Rev.1.00 Page 10 of 43
Jan 25, 2019
RH850 Smart Configurator User’s Guide: IAREW, MULTI
3.4.3 Smart Configurator view
The Smart Configurator view consists of six pages: [Overvie w i nformation], [Board], [Clocks], [Components], [Pins],
and [Interrupts]. Select a page by clicking on a tab; the displayed page will be changed.
Figure 3-6 Smart Configurator View
3.4.4 MCU Package view
Display the MCU package. You can save r otation, enla rgement, r ed uction, and MCU package view of the display to the
image file. You can also confirmation pin assignment and change it.
Figure 3-7 MCU Package View
R20AN0536EJ0100 Rev.1.00 Page 11 of 43
Jan 25, 2019
RH850 Smart Configurator User’s Guide: IAREW, MULTI
3.4.5 Console view
The console displays details of changes to the configuration made in the Smart Configurator or MCU Package view.
Figure 3-8 Console View
3.4.6 Configuration Problems view
The Configuration Problems view displays problems with peripheral functions, interrupts, and pin conflicts.
Figure 3-9 Configuration Problems View
R20AN0536EJ0100 Rev.1.00 Page 12 of 43
Jan 25, 2019
RH850 Smart Configurator User’s Guide: IAREW, MULTI
Button
Operation explanation
Yes
Change to the selected device.
No
It does not change the device.
Save and continue
After savi ng the current configurat ion 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.
4. Setting of Peripheral Modules
You can select peripheral modules from the Smart Configurator view.
4.1 Board setting
On the [Board] page, you can select boards and change devices.
4.1.1 Selecting the device
Click on the [ ] button to select a device.
Figure 4-1 Selecting the Device
The following message i s 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
R20AN0536EJ0100 Rev.1.00 Page 13 of 43
Jan 25, 2019
RH850 Smart Configurator User’s Guide: IAREW, MULTI
Button
Operation explanation
Save and continue
After savi ng the current configurat ion 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.
4.1.2 Selecting the board
Click on the [ ] b ut ton to select a device. When peripheral functions are configured by board selection, pins are
automatically set according to board connection.
Figure 4-3 Selecting the Board
The following items are changed according to the configuration of the selected board.
• Pin assignment
• Frequency of the main clock
• Frequency of the sub-clock
• Target device
If you change the board , the message s hown in “Figure 4-2” or the following 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
R20AN0536EJ0100 Rev.1.00 Page 14 of 43
Jan 25, 2019
Loading...