Renesas SIMPLE DEMO Manual de usuario

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.

Tabla de contenidos

Otros manuales de Hardware de computadora de Renesas

Renesas

Renesas H8/3644 Series Manual de usuario

Renesas

Renesas Emulator MCU Board M38D29T2-RLFS Manual de usuario

Renesas

Renesas YROTATE-IT-RX62T Manual de usuario

Renesas

Renesas E200F Manual de usuario

Renesas

Renesas HD74CBT1G126 Manual de usuario

Renesas

Renesas M16C/64 Manual de usuario

Renesas

Renesas R8C/25 Manual de usuario

Renesas

Renesas RZ/V2M Guía del usuario

Renesas

Renesas FP-144 Manual de usuario

Renesas

Renesas R0E521174CDB00 Manual de usuario

Renesas

Renesas REJ06B0734-0100 Instrucciones de instalación y funcionamiento

Renesas

Renesas MCU Board for PC4504 Emulator System... Manual de usuario

Renesas

Renesas F-ZTAT H8 Series Manual de usuario

Renesas

Renesas SuperHTM Family SH72543R Manual de usuario

Renesas

Renesas H8S/2169 Series Manual de usuario

Renesas

Renesas Converter Board R0E5212BACFG00 Manual de usuario

Renesas

Renesas QB-RL78I1A Manual de usuario

Renesas

Renesas 9FGV100 Series Manual de usuario

Renesas

Renesas SH7147 Manual de usuario

Renesas

Renesas RL78/I1D Manual de usuario

Renesas

Renesas M3062PT-EPBM Manual de usuario

Renesas

Renesas SKP16C62P Manual de usuario

Renesas

Renesas Dummy IC M3T-SSOP36B-450 Manual de usuario

Renesas

Renesas M52757FP Manual de usuario

Manuales populares de Hardware de computadora de otras marcas

EMC2

EMC2 VNX Series Manual del propietario

Panasonic

Panasonic DV0PM20105 Manual de usuario

Mitsubishi Electric

Mitsubishi Electric Q81BD-J61BT11 Manual de usuario

Gigabyte

Gigabyte B660M DS3H AX DDR4 Manual de usuario

Raidon

Raidon iT2300 Manual de usuario

National Instruments

National Instruments PXI-8186 Manual de usuario

Hauppauge

Hauppauge WinTV-HVR-2250 Manual de usuario

Kontron

Kontron CP6002 Manual de usuario

Manhattan

Manhattan 702843 Manual de usuario

Aphex

Aphex 230 Manual de usuario

AMD

AMD Phenom II Manual operacional

Intel

Intel NUC 12 Pro Manual de usuario

dbx

dbx Zone Pro 1260 Manual de usuario

Galaxy

Galaxy GHDX2-2430S-24F4D Manual de usuario

Intel

Intel AXXRMFBU4 Manual de usuario

Kontron

Kontron DIMM-PC/MD Manual de usuario

ST X-NUCLEO-SAFEA1B Instrucciones de funcionamiento

STEINWAY LYNGDORF

STEINWAY LYNGDORF SP-1 Manual de usuario