Renesas SIMPLE DEMO User manual

SIMPLE DEMO

Rev.1.00 Page

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

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

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

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

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

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

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

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

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

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 H8/3001 TFP-80C User manual

Renesas

Renesas RL78/G11 User manual

Renesas

Renesas 8V19N49 Series User manual

Renesas

Renesas RSKH836079 User manual

Renesas

Renesas F-ZTAT H8 Series User manual

Renesas

Renesas RX23W Series User manual

Renesas

Renesas CPU Board M3A-HS19 User manual

Renesas

Renesas RZ/T2M User manual

Renesas

Renesas Converter Board R0E53033ACFG90 User manual

Renesas

Renesas Single-Chip Microcomputer H8/36079 Operation instructions

Renesas

Renesas H8/3937 Series User manual

Renesas

Renesas Dummy IC M3T-SSOP36B-450 User manual

Renesas

Renesas RL78/G13 Installation and operating instructions

Renesas

Renesas M30220T-PRB User manual

Renesas

Renesas M16C/50 Series User manual

Renesas

Renesas SH2/7137 User manual

Renesas

Renesas R0E001000PKZ00 User manual

Renesas

Renesas RH850 Series User manual

Renesas

Renesas M16C/29 User manual

Renesas

Renesas H8SX/1500 Series User manual

Renesas

Renesas Emulation Probe M306V8T-EPB User manual

Renesas

Renesas SKP16C62P User manual

Renesas

Renesas User System Interface Board HS7047ECH61H User manual

Renesas

Renesas M3A-HS25 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

Hauppauge

Hauppauge WinTV-HVR-2250 Quick installation guide

Kontron

Kontron CP6002 user guide

Manhattan

Manhattan 702843 user manual

Aphex

Aphex 230 instruction manual

AMD

AMD Phenom II Product data sheet

Intel

Intel NUC 12 Pro user guide

dbx

dbx Zone Pro 1260 user manual

Galaxy

Galaxy GHDX2-2430S-24F4D Installation and hardware reference manual

Intel

Intel AXXRMFBU4 Quick installation user's guide

Kontron

Kontron DIMM-PC/MD product manual

ST X-NUCLEO-SAFEA1B How to use

STEINWAY LYNGDORF

STEINWAY LYNGDORF SP-1 installation manual