Mikroe RA4M1 CLICKER User manual

RA4M1 CLICKER
Q U I C K S T A R T G U I D E

Thank you for choosing Mikroe!
We present you the ultimate solution for embedded development.
Elegant on the surface, yet extremely powerful on the inside, we have designed it to inspire outstanding achievements.
And now, it’s all yours.
Enjoy premium.
Time-saving embedded tools

Table of contents
Introduction 4
Requirements list 5
1. Connecting and powering up the board 6
1.1 Connect the USB-Type C 6
1.2 Connect the USB port of the host PC 6
1.3 J-Link drivers 6
2. Downloading and Installing Software and Development Tools 7
3. Downloading and Importing the Quick Start Example Project 8
3.1 Download and extract the Quick Start example project 8
3.2 Launch e2 studio 8
3.3 Enter a name in the Workspace dialog box 8
4. Building the Quick Start Example Project 9
4.1 Once the Quick Start example project is imported 9
4.2 If you wish for the compiler to generate an Intel hex 10
5. Programming and running the modified example project 11
6. Community 13
7. Support 13

P A G E 4
RA4M1 CLICKER Q U I C K S T A R T G U I D E
INTRODUCTION
Introduction
RA4M1 Clicker is an amazingly compact starter development
board which brings the innovative mikroBUS™socket to your
favorite microcontroller.
It features R7FA4M1AB3CFM, a 32-bit ARM®Cortex®-M4
microcontroller, two indication LEDs, two general purpose
buttons, a reset button, a USB Type-C connector and a single
mikroBUS™socket.
To make your prototyping experience as convenient as
possible, RA4M1 Clicker is equipped with J-Link OB, an
on-board debug probe. It allows you to fully use, test and
debug the target device right out of the box. RA4M1 Clicker
is compatible with e² studio, Integrated Development
Environment by Renesas, and can be used with Flexible
Software Package (FSP), a suite for drivers and middleware
for Renesas RA Microcontrollers.
RA4M1 CLICKER Q U I C K S T A R T G U I D E

P A G E 5
RA4M1 CLICKER Q U I C K S T A R T G U I D E
REQUIREMENTS
Requirements list
Hardware Requirements:
∫RA4M1 Clicker board
∫USB Type-C cable
∫A PC with a USB port
Software Requirements:
∫Windows®10 operating system
∫e² studio IDE (with compatible FSP version)
∫SEGGER J-Link® USB drivers
∫FSP
∫Quick Start example project
FSP

P A G E 6
RA4M1 CLICKER Q U I C K S T A R T G U I D E
CONNECTING THE BOARD
1. Connecting and
powering up the board
1.1 Connect the USB-Type C end of the USB cable to
connector CN1 (1).
312
1.2 Connect the other end of the cable to the USB port of
the host PC. A LED indicator labeled as PWR (2) lights up solid green,
indicating that the board is powered on. Clicker comes equiped with LED
blink example, on power up or RESET, LD1 and LD2 are blinking at 1 Hz
frequency.
1.3 If J-Link drivers are installed on the PC and detected by the
board, the LD4 (DBG) (3) blinks yellow with a very small duty cycle that is
barely noticeable. Otherwise, LD4 (DBG) blinks yellow prominently.
Figure 1: RA4M1 Clicker, connected

P A G E 7
RA4M1 CLICKER Q U I C K S T A R T G U I D E
INSTALLING TOOLS
2. Downloading and Installing Software
and Development Tools
Before the Quick Start example project can be modified, it is necessary to
download and install software and development tools on the host PC.
The FSP, J-Link USB drivers, and e2studio are bundled in a downloadable
platform installer available on the FSP webpage. New users are
recommended to use the Quick Install option provided in the installation
wizard, to minimize the amount of manual configuration needed.
There is no need to download and install software, development tools, and
drivers separately.

P A G E 8
RA4M1 CLICKER Q U I C K S T A R T G U I D E
EXAMPLE PROJECT
3. Downloading and Importing the Quick Start
Example Project
The Quick Start example project (source code and project files) is available
in the RA4M1 Clicker Example Projects Bundle, on the RA4M1 Clicker
Libstock page
Before booting up the e2studio, find the file called Mikroe.RA_board_
RA4M1_clicker.2.0.0.pack located at “ra4m1_clicker_other_arm” in the
E2_Studio_Pack folder of the Quick Start Example projects package.
After that copy the pack file into:
\Renesas\RA\e2studio_v2020-10_fsp_v2.0.0\internal\projectgen\ra\packs
3.3 Enter a name in the Workspace dialog box to create a new
workspace folder or browse to an existing one and click on the Launch
button. On the Welcome screen click on Import existing projects and
under Select Root Directory click on the Browse button (1) then navigate
to where you extracted the RA4M1 Clicker Example Projects and click on
Select folder. You should see all the example projects in the list below.
Click on Finish when you are done.
3.1 Download and extract the Quick Start example
project to a local directory on the host PC.
3.2 Launch e2studio
Figure 2: e2studio – Import Projects window
1
Please note that the version of FSP has to match the Clicker pack version, in
this guide we used the 2.0 version.

P A G E 9
RA4M1 CLICKER Q U I C K S T A R T G U I D E
EXAMPLE PROJECT
4. Modifying, Generating, and Building
the Quick Start Example Project
The Quick Start example project can be modified by editing the source
code and reconfiguring the properties of the MCU peripherals, pins, clocks,
interrupts, and so forth.
4.1 Once the Quick Start example project is imported,
double click the configuration.xml (1) file to open the configurator. The
configurator (2) provides an easy to use interface to configure the
properties of the MCU peripherals.
Figure 3: e2studio –Pins Configuration window
2
1

P A G E 10
RA4M1 CLICKER Q U I C K S T A R T G U I D E
Click on the BSP tab (1) in the bottom left corner of the FSP configuration
window and make sure that RA4M1_clicker is selected as Board.
You can now build the project by clicking on the build icon in the toolbar.
1
2
Figure 4: e2studio – FSP Configuration window
Figure 5: e2studio – FSP Properties window
4.2 If you wish for the compiler to generate an Intel hex from
your project, right click on the name of your project in the Project Explorer
and select Properties.
Go to C/C++ Build > Settings > Tool Settings > GNU ARM Cross Create Flash
Image > General and in the Output file format select Intel HEX (2). Click
Apply. Rebuild your project and the hex will appear in Debug and Release
folders.
This step is needed for the method we will use to program our Clicker board
later on.
EXAMPLE PROJECT

P A G E 11
RA4M1 CLICKER Q U I C K S T A R T G U I D E
PROGRAMMING
5. Programming and running
the modified example project
If you have followed the steps explained in 3.2 section, you will have a
generated hex file which you can use to program your MCU. For this we
need a software called J-Flash Lite. Make sure you have an up to date
version or you might not see the RA4M1 in the list.
Click on the button with three dots and find the R7FA4M1AB MCU in the list
and select it, then click OK.
In the new window click on the button with three dots (1) again and navigate
to the Release hex file generated from our project. Select it and click Open.
At this point you want to make sure that your Clicker is connected to your
PC via USB cable.
Click on the Erase Chip button (2), then click Program Device (3). After
the message Done appears, press the red RESET button on your Clicker to
start the code execution.
Figure 6: J-Flash Lite window
Figure 7: J-Flash Lite – Program Device window
1 23

P A G E 12
RA4M1 CLICKER Q U I C K S T A R T G U I D E
PROGRAMMING
It is also possible to debug your project from within e² studio without using
J-Flash Lite software for programming.
In that case, you simply have to have Debug (1) selected in your project and
click on Build button (2), followed by Launch in ‘Debug’ mode button (3).
12 3
Figure 8: e2studio – Project window

P A G E 13
RA4M1 CLICKER Q U I C K S T A R T G U I D E
COMMUNITY & SUPPORT
6. Community 7. Support
We invite you to join thousands of users of Mikroe development
tools. You will find useful projects and tutorials and get help
from a large user community. If you want to download free
projects and libraries, or share your own code, please visit the
Libstock website
Choose from a fast-growing number of Click boards™,
these ready-to-use boards require no additional hardware
configuration. They enhance rapid development and
accelerate time to market.
More information at www.mikroe.com/click
Shuttle click in combination with mikroBUS Shuttle provides
an easy and elegant solution for stacking multiple Click
boards™on a single mikroBUS™.
Mikroe offers free Tech Support to the end of its life span,
so if anything goes wrong, we are ready and willing to help.
Our Support Department, as one of the pillars upon which our
company is based, now also offers the Premium Technical
Support to business users, ensuring even shorter time frame
for solutions. For any hardware support you might need,
contact Mikroe Helpdesk
If you need any software support, your go-to source is
Renesas Support

All the products owned by MikroElektronika are protected by copyright law and international copyright treaty. Therefore, this manual is to be treated as any other copyright
material. No part of this manual, including product and software described herein, must be reproduced, stored in a retrieval system, translated or transmitted in any form or
by any means, without the prior written permission of MikroElektronika. The manual PDF edition can be printed for private or local use, but not for distribution. Any modification
of this manual is prohibited.
MikroElektronika provides this manual ‘as is’ without warranty of any kind, either expressed or implied, including, but not limited to, the implied warranties or conditions of
merchantability or fitness for a particular purpose.
MikroElektronika shall assume no responsibility or liability for any errors, omissions and inaccuracies that may appear in this manual. In no event shall MikroElektronika, its
directors, officers, employees or distributors be liable for any indirect, specific, incidental or consequential damages (including damages for loss of business profits and
business information, business interruption or any other pecuniary loss) arising out of the use of this manual or product, even if MikroElektronika has been advised of the
possibility of such damages. MikroElektronika reserves the right to change information contained in this manual at any time without prior notice, if necessary.
TRADEMARKS
The MikroElektronika name and logo, the MikroElektronika logo, mikroC, mikroBasic, mikroPascal, mikroProg, mikromedia, Fusion, Click boards™and mikroBUS™are trademarks
of MikroElektronika. All other trademarks mentioned herein are property of their respective companies.
All other product and corporate names appearing in this manual may or may not be registered trademarks or copyrights of their respective companies, and are only used for
identification or explanation and to the owners’ benefit, with no intent to infringe.
Copyright © MikroElektronika, 2020, All Rights Reserved.
HIGH RISK ACTIVITIES
The products of MikroElektronika are not fault – tolerant nor designed, manufactured or intended for use or resale as on – line control equipment in hazardous
environments requiring fail – safe performance, such as in the operation of nuclear facilities, aircraft navigation or communication systems, air traffic control, direct life
support machines or weapons systems in which the failure of Software could lead directly to death, personal injury or severe physical or environmental damage (‘High
Risk Activities’). MikroElektronika and its suppliers specifically disclaim any expressed or implied warranty of fitness for High Risk Activities.
D I S C L A I M E R

If you want to learn more about our products, please visit our website at www.mikroe.com
If you are experiencing some problems with any of our products or just need additional information,
please place your ticket at www.mikroe.com/support
If you have any questions, comments or business proposals, do not hesitate to contact us at offi[email protected]
Time-saving embedded tools