Renesas SIMPLE DEMO User manual
SIMPLE DEMO
Rev.1.00 Page
1
of 13
Mar, 2022
Wi-Fi MQTT Client Simple Demo
Quick Start Guide of MQTT Client Simple Demo
Introduction
This quick start guide describes the setup and use of MQTT client running on DA16200 Wi-Fi module. This guide
mainly focuses on describing how to make Wi-Fi module as MQTT client by AT command for connecting MQTT
broker, and how to publish a message to MQTT server. Meanwhile, a simplest button pressed operation will be
recorded by MQTT server through publishing a message by MQTT client.
Through this guide and related demo, you can easily start your development on DA16200, a Wi-Fi module, using AT
command and EK-RA6M4, an evaluation kit for RA6M4 MCU group.
Target Device
EK-RA6M4 (R7FA6M4AF3CFB)
DA16200 PMOD
Contents
1. Kit Contents....................................................................................................................2
1.1 Hardware components ...............................................................................................................2
1.2 Software components.................................................................................................................2
2. Features..........................................................................................................................3
3. Set Up the Demo.............................................................................................................3
3.1 Prerequisite..................................................................................................................................3
3.2 Connect the solution kit ............................................................................................................. 7
3.3 Debug and download code to EK-RA6M4 ................................................................................7
3.4 Run the solution........................................................................................................................10
4. Reference Documents..................................................................................................13
Rev.1.00
Mar, 2022
DA16200 Wi-Fi MQTT Client Simple Demo
Rev.1.00 Page
2
of 13
Mar, 2022
1. Kit Contents
To set up this demo, the following components are needed.
1.1 Hardware components
•EK-RA6M4
•DA16200 PMOD (US159-DA16200MEVZ)
•Micro USB cable
•A UART-USB bridge cable (if possible and optional for AT command observation)
1.2 Software components
Below software components are needed:
Category
Item
Remark
Firmware
RA6M4_DA16200_MQTT_CLIENT.zip
Compressed project file
RA6M4_DA16200_MQTT_CLIENT.mot
Motorola S-record file for programming
RA6M4 chip
Software
e2 studio 2021-10, SSP v3.5.0
A GUI and related software package for
RA6M4 development
SEGGER J-Link V7.52a
A flash programmer for downloading file
to RA6M4, meanwhile a tool using J-Link
RTT function to observe the state of the
system.
mosquitto-2.0.14-install-windows-x64.exe
An open source (EPL/EDL licensed)
message broker that implements the
MQTT protocol versions 5.0, 3.1.1 and
3.1.
DA16200 Wi-Fi MQTT Client Simple Demo
Rev.1.00 Page
3
of 13
Mar, 2022
2. Features
•Supply power to the kit by micro-USB cable
•Set the necessary modules of RA6M4 to establish connection between EK and DA16200 PMOD
•Use Mosquitto software, a message broker implementing the MQTT protocol on PC, to make a laptop a MQTT
Server
•Initialize and control Wi-Fi module (DA16200) by AT command to act as a MQTT client
•The topic of button with message is published to MQTT Server when the button (S1) on EK board is pressed
•Make a smartphone a MQTT client subscribing button topic, getting the status of button from MQTT Server.
3. Set Up the Demo
3.1 Prerequisite
Step 1. Connect your PC (set as a MQTT Server later) to a Wi-Fi Router.
Open Windows Settings, click Network & Internet, go to WLAN. Set it to ON, click “show available networks” and
select “Renesas Test Router” as an example. Here a password of “12345678” is assigned to this router.
Step 2. Confirm the IP address of PC which is distributed by Wi-Fi Router.
DA16200 Wi-Fi MQTT Client Simple Demo
Rev.1.00 Page
4
of 13
Mar, 2022
Step 3. Setup a MQTT Server on PC.
Download Eclipse Mosquitto software that can run on your PC system and install it.The URL of Mosquitto
downloading is show below.
https://mosquitto.org/download/
Here use Mosquitto installed on windows 64-bit system as an example.
Then modify some information in the configuration file.
Find out file of mosquitto.conf and open it.
Search “# listener port-number [ip address/host name/unix socket path]”, add line of “listener 1883” below it, signifying
that the listening port number is 1883.
Search “# allow_anonymous false”, delete “#” to not allow anonymous logins.
Search “# password_file”, change it to “password_file pwfile.example”, setting the file location which involving
account name and log in password.
Then set users name and password. In the installation path, right click mouse when holding down “Shift”, select “Open
PowerShell window here” from the pop-up menu.
Input “./mosquitto_passwd -c pwfile.example admin”. This command is to add an account named admin. Input
password twice to confirm this setting, then the count is created successfully. Here use “Renesas” as the password.
DA16200 Wi-Fi MQTT Client Simple Demo
Rev.1.00 Page
5
of 13
Mar, 2022
File of “pwfile.example” can be opened for confirming this setting. Close this PowerShell window means the setting
has been finished.
Reopen a PowerShell window following the previous step, input command “.\mosquitto -c .\mosquitto.conf -v” to run
this tool using mosquitto.conf as a configuration file, while enabling detailed log mode.
At this point, the MQTT broker (MQTT server) setup on PC is running.
Note: The MQTT message send by client cannot be displayed on the MQTT Server entirely, so a smartphone is
necessary to subscribe this message for monitoring the entire information.
Step 4. Download MQTTool from App Store, which is a MQTT client software on Iphone, or something like this from
Google Shop. Here use MQTTool running on Iphone as an example.
Firstly, open “settings” in Iphone, select “WLAN” and choose the name of AP which is projected a Wi-Fi signal by Wi-
Fi Router. After connecting successfully, the bridge between PC and the smartphone is established.
Then open MQTTool, input IP address of MQTT Server (Host) and select Port number 1883, define a Client Id, input
Username and Password to log in MQTT Server. The username and password for logging in MQTT Server has been set
by step3 through mosquitto.conf file. Click “Connect” to realize connection with MQTT Server.
DA16200 Wi-Fi MQTT Client Simple Demo
Rev.1.00 Page
6
of 13
Mar, 2022
After click “Connect” button, Mosquitto receives connecting command and displays that a new connection from
smartphone has been established.
Click “Subscribe” tab, input “button” in topic blank, which is designed by sample code, click “subscribe” to subscribe
to message based on this topic. All message based on this topic sent by MQTT server will be received by MQTTool.
DA16200 Wi-Fi MQTT Client Simple Demo
Rev.1.00 Page
7
of 13
Mar, 2022
3.2 Connect the solution kit
Power off the solution kit, insert DA16200 PMOD board into J25 (PMOD2 on EK), establishing the whole system just
as the picture at chapter 1.1.
3.3 Debug and download code to EK-RA6M4
The EK-RA6M4 features a SEGGER J-Link On-Board debugger, using Renesas S124 Debug MCU and SEGGER J-
Link® firmware to provide the on-board debug functionality, so all the customer needs for debugging is a Micro USB
cable.
Step 1. Insert Micro USB cable into Debug USB Micro-B connector (J10), establishing a debug channel.
Step 2. Modify the project according to the actual internet environment.
Import project into e2 studio, open project->src->da16200_AT.c, find the array variables associated with the internet
environment, such as the current country, ssid and password of Wi-Fi Router, IP address of MQTT Broker and ssid and
password for logging in.
DA16200 Wi-Fi MQTT Client Simple Demo
Rev.1.00 Page
8
of 13
Mar, 2022
Compile the project to get the object file which can be downloaded to the chip. Then use debug function to test the
sample code.
Note: about how to use e2studio and import the project, you can refer to “5. Customizing the Quick Start Example
Project” chapter of EK-RA6M4 Quick Start Guide.
https://www.renesas.com/jp/zh/document/qsg/ek-ra6m4-quick-start-guide?language=en
If the project doesn’t need to be modified, or it has been updated and only needs to be downloaded to the target MCU,
please find the “*.srec” file in the debug folder under the project and modify the suffix to “mot”to get the type of file
that can be downloaded to target MCU by SEGGER J-Link.
DA16200 Wi-Fi MQTT Client Simple Demo
Rev.1.00 Page
9
of 13
Mar, 2022
Unzip “Download_Tool.zip” file, replace the file of the same name under JLink folder with this file. Back to
Download_Tool folder and click “bmp.bat” file to program MCU. This folder combines the version of J-Link v7.52a in
JLink folder, involving all files at software installation and realizing all J-Link operations.
Once programming begins, “Flash download” interface appears, like the picture below.
DA16200 Wi-Fi MQTT Client Simple Demo
Rev.1.00 Page
10
of 13
Mar, 2022
After programming, J-Link operation interface will exit automatically.
(Note: If you want the latest SEGGER J-Link version, please download from link below:
https://www.segger.com/downloads/jlink)
3.4 Run the solution
Step 1. Restart the system by pressing RESET button (S3) on EK-RA6M4 or powering off and on the system, causing
the program to run again. While under debugging, restart the program is necessary.
Step 2. Open “JLinkRTTViewer.exe” in JLink folder, which is unzipped at chapter 3.3 step 2, specify target device as
R7FA6M4AF, change RTT Control Block from “Auto Detection” to “Search Range” and input “0x20000604 0x1000”
to the blank block shown below.
The first address of “Search Range” can be found in “*.map”file after the demo code is built. Please open “*.map” file
and search “_SEGGER_RTT”, then copy the address assigned by compiler to this place.
Table of contents
Other Renesas Computer Hardware manuals
Renesas
Renesas M65881AFP User manual
Renesas
Renesas E2 Lite User manual
Renesas
Renesas ClockMatrix 8A3 Series Installation and operating instructions
Renesas
Renesas M3S-UFLA32R User manual
Renesas
Renesas M32173T-PTC User manual
Renesas
Renesas Single-Chip Microcomputer M306NKT3 User manual
Renesas
Renesas SuperH RISC SH7040 Series Owner's manual
Renesas
Renesas RL78 Series User manual
Renesas
Renesas H8 Series User manual
Renesas
Renesas M-Station User manual
Renesas
Renesas X 600 Series User manual
Renesas
Renesas RAA306012 User manual
Renesas
Renesas CK-RX65N User manual
Renesas
Renesas FP-80A User manual
Renesas
Renesas HD74HC1G66 User manual
Renesas
Renesas M3T-FLX-120NSE User manual
Renesas
Renesas M34553T-PTCB User manual
Renesas
Renesas SH7201 User manual
Renesas
Renesas CE2000-H8S Series User manual
Renesas
Renesas M3062PT-EPB User manual
Popular Computer Hardware manuals by other brands
EMC2
EMC2 VNX Series Hardware Information Guide
Panasonic
Panasonic DV0PM20105 Operation manual
Mitsubishi Electric
Mitsubishi Electric Q81BD-J61BT11 user manual
Gigabyte
Gigabyte B660M DS3H AX DDR4 user manual
Raidon
Raidon iT2300 Quick installation guide
National Instruments
National Instruments PXI-8186 user manual
