520966230076 - CYPRESS SEMICONDUCTOR

Rev.1.10 Feb 2018

Renesas Synergy™ Platform

Synergy Tools & Kits

Tools: Conne ct i vity

User’s Ma nual

www.renesas.com

All infor mation cont ained in these m aterials, inclu ding products a nd product sp ecifications, repr esents

informati on on the product at the time of publication and is sub ject to change by Rene sas Electron ics

Corp. without notice. Please review the latest information published by Renesas Electronics Corp.

through var ious means, in cluding the Renesas Electronics Corp. website (http: //www. r enesas. c om).

Synergy Enterprise Cloud Toolbox

for AE-

CLOUD1

Quick Start Guide

Notice

1. Descriptions of circuits, software and other related information in this document are provided only to illustrate the operation of

semiconductor products and application examples. You are fully responsible for the incorporation or any other use of the

circuits, software, and information in the design of your product or system. Renesas Electronics disclaims any and all liability

for any losses and damages incurred by you or third parties arising from the use of these circuits, software, or information.

2. Renesas Electronics hereby expre ss ly disclaims any warran ties against and liability for infringement or any oth er claims

involving patents, copyrights, or other intellectual property rights of third parties, by or arising from the use of Renesas

Electronics products or technical information described in this document, including but not limited to, the product data,

drawings, charts, programs, algorithms, and application exampl es.

3. No license, express, implied or otherwise, is granted hereby under any patents, copyrights or other intellectual property rights of

Renesas El ectron ics or others.

4. You shall not alter, modify, copy, or reverse engineer any Renesas Electronics product, whether in whole or in part. Renesas

Electronics disclaims any and all liability for any losses or damages incurred by you or third parties arising from such alteration,

modification, copying or reverse engineering.

5. Renesas Electronics products are classified according to the following two quality grades: "Standard" and "High Quality". The

intended applications for each Renesas Electronics product depends on the product’s quality grade, as indicated below.

"Standard": Computers; office equipment; communications equipment; test and measurement equipment; audio and visual

equipment; home electronic appliances; machin e tool s ; p er s onal electronic equipment; ind ustrial ro bots; etc.

"High Quality": Transportation equipment (automobiles, trains, ships, etc.); traffic control (traffic lights); large-scale

communication equipment; key financial terminal s ystems; safety control equipment; etc.

Unless expressly designated as a high reliability product or a product for harsh environments in a Renesas Electronics data sheet

or other Renesas Electronics document, Renesas Electronics products are not intended or authorized for use in products or

systems that ma y pose a direct threat to human life or b o dily injury (artificial life support devices or systems; surgical

implantation s; etc.), or may cause serio us propert y damage (space system; undersea repeaters; nuclear power control systems;

aircraft control systems; key plant systems; military equipment; etc.). Renesas Electronics disclaims any and all liability for any

dama ges or losses incurred by you or any third parties arising from the use of any Renesas Electronics product that is

inconsistent with any Renesas Electronics data sheet, user’s manual or other Renesas Electronics document.

6. When using Renesas Electronics products, refer to the latest product information (data sheets, user’s manuals, application notes,

"General Notes for Handling and Using Semiconductor Devices" in the reliability handbook, etc.), and ensure that usage

conditions are within the ranges specified b y Renesas Electronics with respect to maxi mum ratings, op erating po wer supply

voltage range, heat dissipation characteristics, installation, etc. Renesas Electronics disclaims any and all liability fo r any

malfunctions, failure or accident arising out of the use of Renesas Electronics products outside of such specified ranges.

7. Although Renesas Electronics endeavors to improve the quality and reliability of Renesas Electronics products, semiconductor

products have specific characteristics, such as the occurrence of failure at a cer tain rat e and malfunct ions und er certain use

conditions. Unless designated as a high reliability product or a product for harsh environments in a Renesas Electronics data

sheet o r ot her Renes as Electronics document, Renesas Electr onics products are not subject to radiation resi s tance desi gn. You

are responsible for implementing safety measures to guard against the possibility of bodily injury, injury or damage caused by

fire, and/or danger to the public in the event of a failure or malfunction of Renesas Electronics products, such as safety design

for hardware and software, including but not limited to redundancy, fire control and malfunction prevention, appropriate

treat ment fo r agi ng degrad ation or any other appropriate measures. Because the evaluation of microcomputer software alone is

very difficult and impractical, you are responsible for evaluating the safety of the final products or systems manufactured by

you.

8. Please contact a Ren es as Electronics sales office for details as to environmental matters such as the environmental compatibility

of each Renes as Electro nics product. You are responsib le for carefu lly and sufficien tly invest igating appl icable laws and

regulations that regulate the inclusion or use of controlled substances, including without limitation, the EU RoHS Directive, and

usin g Renesas Elect r onics pr oducts in compliance with all these applicable laws and regulations. Renesas Electr onics disclaims

any and all liability for damages or losses occurring as a result of your noncompliance with applicable laws and regulations.

9. Renesas Electronics products and technologies shall not be used for or incorporated into any products or systems whose

manufactu r e, use, or sale is prohibited under any applicable domestic or foreign laws or regulations. You shall comply with any

applicable export control laws and regulations promulgated and administered by the governments of any countries asserting

jurisdiction over the parties or transactions.

10. It is the responsibility of the buyer or distributor of Renesas Electronics products, or any other party who distributes, disposes

of, or otherwise sells or transfers the product to a third party, to notify such third party in advance of the contents and conditions

set forth in this document.

11. This document shall not be reprinted, reproduced or duplicated in any form, in whole or in part, without prior written consent of

Renesas El ectron ics.

12. Please contact a Ren esas Electronics sal es office if you have any questions regarding the information contained in this document

or Ren es as Electro nics products.

(Note 1) "Renesas Electro nics" as used in this document means Renesas Electronics Corporation and also includes its directly or

indirectly controlled subsidiaries.

(Note 2) "Renesas Electro nics pr oduct(s)" means any product developed or manufactured by or for Renesas Electronics.

(Rev.4.0-1 November 2017)

General Precautions

1. Precaution against Electrostatic Discharge (ESD)

A strong electrical field, when exposed to a CMOS device, can cause destruction of the gate oxi de and ultimately degrade the

device operation. Steps must be taken to stop t he generati on of static electr icit y as much as poss ible, and quickly dissipate it

when it occurs. Environmental control must be adequate. When it is dry, a humidifier should be used. This is recommended to

avoid using insulators that can easily build up static electricity. Semiconductor devices must be stored and transported in an anti-

static container, static shielding bag or conductive material. All test and measurement tools including work benches and floors

must be grounded. The operator must also be grounded using a wrist strap. Semiconductor devices must not be touched with bare

hands. Similar precautions must be taken for printed circuit boards with mounted semiconductor devices.

2. Processing at power-on

The state of the product is undefined at the time when power is supplied. The states of internal circuits in the LSI are

indeterminate and the states of register settings and pins are undefined at the time when power is supplied. In a finished product

where the reset signal i s appli ed to the external r eset pin, th e states of pins ar e not guaranteed from th e time when power is

supplied until the reset process is completed. In a similar way, the states of pins in a product that is reset by an on-chip power-on

reset funct ion ar e not guaranteed from th e time when p ower is supplied un til th e power reaches the level at which resetting is

specified.

3. Input of signal during power-off state

Do not input signals or an I/O pull-up power supply while the device is powered off. The current injection that results from input

of such a signal or I/O pull-up power supply may cause malfunction and th e abnormal curren t that passes in th e device at this

time may cause degradation of internal elements. Follow the guideline for input signal during power-off state as described in

your product documentation.

4. Handling of unused pins

Handle unused pins in accordance with the directions given under handling of unused pins in the manual. The input pins of

CMOS products are generally in the high-impedance state. In operation with an unused pin in the open-circuit state, extra

electromagnetic noise is induced in the vicinity of the LSI, an associated shoot-through current flows internally, and

malfunctions occur due to the false recognition of the pin state as an input signal become possible.

5. Cl ock signals

After applying a reset, onl y release the res et line after the operating clock signal b ecomes stab le. When switching the clock

signal during program execution, wait until the target clock signal is stabilized. When the clock signal is generated with an

external r esonator or from an external o scillator during a reset, ensure that the reset line is only released after full stabilization of

the clock signal. Additionally, when switching to a clock signal produced with an external resonator or by an external oscillator

whil e prog ram execution is in progress, wait until the target clock signal is stable.

6. Voltage application waveform at input pin

Waveform distortion due to input noise or a reflected wave may cause malfunction. If the input of the CMOS device stays in the

area between VIL (Max.) and VIH (Min.) due to noise, for example, the d evi ce may malfunct ion. Take care to prevent chattering

noise from entering the device when the input level is fixed, and also in the transition period when the input level passes through

the area between VIL (Max. ) and VIH (Min.).

7. Prohibition of access to reserved addresses

Access to reserved addresses is prohibited. The reserved addresses are provided for possible future expansion of functions. Do

not acces s these addresses as the correct operat ion of the LSI is not guaranteed.

8. Differences between products

Before changing from one product to another, for exa mple to a product with a different part number, confirm that the change will

not lead to problems. The characteristi cs of a microp r ocessin g unit or microcontroller unit products in the same group but having

a different part number might differ in terms of internal memory capacity, layout pattern, and other factors, which can affect the

ranges of electrical characteri stics, such as characteri stic values, operating margins, immunity to noise, and amount of radiated

noise. When changing to a product with a different part number, implement a system-evaluation test for the given product.

Quick Start Guide

R20QS0004EU0110 Rev.1.10 Page 1 of 19

Feb 21, 2018

Renesas Synergy™ Platform

Synergy Enterprise Cloud Toolbox

f or AE -CLOUD1

Contents

1. Introduction .............................................................................................................................. 2

2. Prerequisites............................................................................................................................ 2

3. Requirements .......................................................................................................................... 2

4. About the Demonstration ......................................................................................................... 3

5. Setting up the Hardware .......................................................................................................... 4

6. Setting up and executing the Demonstration ........................................................................... 5

6.1 Sett ing up the AE-CLOUD1 Project ........................................................................................................ 5

6.2 Setting up AE-CLOUD1 for Wi-Fi ............................................................................................................ 7

6.3 Setting up AE-CLOUD1 for Ethernet ....................................................................................................... 9

6.4 Signing up for the Synergy Enterprise Cloud Toolbox Dashboard ....................................................... 10

6.5 Adding a Device to the Synergy Enterprise Cloud Toolbox Dashboard ............................................... 11

6.6 Configuring User Credentials for AE-CLOUD1 ..................................................................................... 12

6.7 Provisioning for AE-CLOUD1 ................................................................................................................ 13

6.8 Start ing the Wind Turbine model on AE-CLOUD1 ................................................................................ 13

6.9 Remote Monitoring on the Synergy Enterprise Cloud Toolbox Dashboard .......................................... 14

6.10 Stimulating sensors on AE-CLOUD1 .................................................................................................... 14

6.11 Changing IoT cloud providers ............................................................................................................... 15

6.12 Resetting the system from the Synergy Enterprise Cloud Toolbox Dashboard .................................... 16

6.13 Notes and Limitations ............................................................................................................................ 17

7. Appendix — Downloading and running the Synergy Enterprise Cloud Toolbox ..................... 18

R20QS0004EU0110

Rev.1.10

Feb 21, 2018

Renesas Synergy™ Platform Synergy Enterprise Cloud Toolbox for AE-CLOUD1

R20QS0004EU0110 Rev.1.10 Page 2 of 19

Feb 21, 2018

1. Introduction

This Quick Start Guide for AE-CLOUD1 demonstrates t he Synergy™ Enterprise Cloud Toolbox application. This

application project is downloadable from www.renesas.com/cloudtoolbox and includes the following items:

• Embedded code

• Dashboard code

• Quick Start G uide

• Application Note

The application can be used as a reference solution for users to quickly get started on the Synergy Software Package

(SSP), Wi-Fi Framework, Ethernet connec tivity, and cloud connect ivity with different IoT Cloud Provider s us ing the

Renesas Synergy™ Enterprise Cloud Toolbox for AE-CLOUD1 Kit.

2. Prerequisites

As the reader of this quick start guide, you are assumed to have some experience with the IAR Embedded Workbench®

for Renesas Syner gy™ or Renesas Synergy e2 studio ISDE and SSP. The hardware and software requirements listed i n

the section 3 should be installed.

Note: The MCU board is not pre-progr ammed with firmware for the Synergy Enterprise Cloud Toolbox application

project. To run the bat file and flash the MCU board, see the instruction s in the Appendix — Downloading and

running the S yner gy Enterp ris e Cloud Too lbox.

You may also have the project software built and ready for flashing on the AE-CLOUD1 Development Kit (the Synergy

device). For i nstructions on ho w to build and flash the software on t he device, consult the Application Note provided

with t he Synergy Enterp rise Clo ud Toolbox. If you run into any problem whi l e going through the instructi ons i n this

quick start guide, refer to the limitations l isted in section 6.13 for guidance.

3. Requirements

• PC software requir ements:

 Microsoft® W indows® 7 or 10

 e2 studio ISDE v5.4.0.023

 IAR Embedded Workbench® for Renesas Synergy™ (IAR EW for Synergy) v7.71.3

 Synergy Standalone Configurator (SSC) v5.4.0.23

 Synergy Software Package (SSP) v1.3.3

• AE-Cloud1 kit (part# YSAECLOUD1) hardware requirements:

 Synergy MCU Boar d (part # YIOTFASTPROTOS5D9)

 Wi-Fi Board (part# YSAEWIFI-1)

 SEGGER J-Link® Lite for R enesas Synergy (part# YSJLINKLITE)

 Two micro USB connector cables

 Ethernet Cable

Renesas Synergy™ Platform Synergy Enterprise Cloud Toolbox for AE-CLOUD1

R20QS0004EU0110 Rev.1.10 Page 3 of 19

Feb 21, 2018

4. About the Demonstration

The demonstration application provides a reference design and implementation to get your S5D9 based platform

quickly o nto the cloud. The applic a tion uses NetX™ Secure and NetX™ MQTT to communicate with Amazon Web

Solutions (AWS), Azure, and Google IoT Cloud Providers. The ap plication showcases ho w to integrate functionality of

the on-board sensors including accelero meter, barometric pressure sensor, temperature, and humidity sensor, and send

this sensor data to the cloud over Ethernet or Wi-Fi network interfaces. How to send commands from the cloud to

devices in order to turn an LED ON or OFF is also shown.

The major components (see Figure 1) of the embedded application include:

• SSP components

 Wi-Fi fra mework

 NetX IP stack

 Cloud APIs (MQTT/TLS)

 Console framework

• Sensor drivers

Figure 1 System overview

Renesas Synergy™ Platform Synergy Enterprise Cloud Toolbox for AE-CLOUD1

R20QS0004EU0110 Rev.1.10 Page 4 of 19

Feb 21, 2018

5. Setting up the Hardware

For connection details, see Figure 2.

1. Connect the Wi-Fi module to PMOD.

2. Connect the J-Link debugger to port J2.

3. Set jumper J6 to 3V position.

Note: Do the next step o nly after all t he other modules and connectors are plugged in! Port J9 connector supplies

po wer to the AE-CLOUD1 board, in addition to the debugger.

4. Connect a micro USB cable to port J9 for the serial console.

Figure 2 Device Connections and Setup

Notes:

• After connecting the AE-CLOUD1 device to your computer, if it does not appear as a device, follow the

instructi ons given on the Renesas Synergy K nowledge Base page for manually assigning the SEG GER CDC

UART driver to the “EL Co mposite Device” in Windows. The Vendor ID and Product ID should be set to

0x0000 as shown in Figure 3.

• On Windows 10, and in cases where RFP is installed on the system, see Figure 3. T he figure s hows the

Vendor ID and Product ID fields of USBX Device Configuration in the IOT Kit Thread may have to be set to

0x0000.

Renesas Synergy™ Platform Synergy Enterprise Cloud Toolbox for AE-CLOUD1

R20QS0004EU0110 Rev.1.10 Page 5 of 19

Feb 21, 2018

Figure 3 USBX Device Configuration for Windo ws 10

6. Setting up and executing the Demonstration

The main compone nts o f the demonstration are the Renesas Synergy™ Enterprise Cloud Toolbox Dashboard and the

S5D9 Synergy MCU built on AE -CLOUD1 kit.

See Synergy Enterprise Cloud Toolbox Application Note for instructions to build and install (flas h) the embedded

application onto the AE-CLOUD1 d evice and run the Synergy Enterprise Cloud Toolbox Dashboard code. The setup

and execution o f the demonstration is explained in the following sections.

6.1 Setting up the AE-CLO UD1 Project

The MCU board is not pre-programmed with the firmware for the Synergy Enterprise Cloud Toolbox application

project. For quic k flashin g of the firmwar e to t he MCU board, r efer to the Appendix — Downloading a nd running the

Synergy Enterprise Cloud Toolbox to run the bat file that flashes the MCU board. You can also refer the Application

Note for i ns tructio ns on building the pro ject within the Synergy tool s and flas hin g the MCU board that wa y.

To access the co mmand console fro m the computer, install TeraTerm Pro (or equivalent serial terminal emulator) and

open the ter mi nal with the appropriate COM port configured. The default configuration for the terminal is 9600-8-N-1.

The application waits for a key to be pressed by the user before printing the banner on the serial console.

Press Enter to access the command prompt.

The following scr een s hows what the console wind ow looks like on a terminal emulator when the device boots up, the

application starts, and you press Enter to access the command prompt.

Figure 4 Sensor Initialization and c ommand prompt

Note: You can press Enter at any ti me t o re turn to the Main M enu.

****************************************************************************

* Synergy Enterprise Cloud Toolbox *

* Version 1.1.0, Released-2018/02/15 *

* Build 3.0 *

****************************************************************************

Initializing sensors: done

Initializing data flash: done

Renesas Synergy™ Platform Synergy Enterprise Cloud Toolbox for AE-CLOUD1

R20QS0004EU0110 Rev.1.10 Page 6 of 19

Feb 21, 2018

To see a list of available commands type: ?.

Figure 5 Help menu for commands

Obtain the Unique Kit ID using the command: ktid

Figure 6 ktid command output to get unique Kit ID

Note: T his unique Kit ID is the Serial Number used to register/add the device on the Synergy Enterprise Cloud

Toolbox Dashboard (see section 6.5).

Renesas Synergy™ Platform Synergy Enterprise Cloud Toolbox for AE-CLOUD1

R20QS0004EU0110 Rev.1.10 Page 7 of 19

Feb 21, 2018

6.2 Setting up AE-CLOUD1 for Wi-Fi

Configure the Wi-Fi interface as an active interface using command: cwiz

Figure 7 Setting Wi-Fi interface as active interface

This cwiz command displays supported network interfaces. To activate the Wi-Fi interface, enter command 2. Now

enter the SSID, passphrase, and security type associated with the network at each pro mpt.

If the Wi-Fi network is not secure, enter a ny value o ther than 1, 2 or 3. Wi-fi configuratio n d e ta ils will be displayed on

console for final user confirmation. Please type ‘y’ if configuration details are correct. This Wi-Fi provisioning

information fro m you is stored in inter nal flash for s ubsequent use.

Figure 8 IP Configuration

Renesas Synergy™ Platform Synergy Enterprise Cloud Toolbox for AE-CLOUD1

R20QS0004EU0110 Rev.1.10 Page 8 of 19

Feb 21, 2018

To configure the IP address, you are given two options: Static and DHCP. In Figure 8 the user selected DHCP, and the

screen shows the IP ad dress assigned to the device.

Figure 9 shows an alternate method to set up Wi-Fi a s the network i nterface , wh e r e you pr ovision the Wi-Fi module for

the first time on the network using t he command wif i <SSID><KEY ><SECURITY TYPE>.

Figure 9 Setting Wi-Fi interface as the active interface

SSID is t he SSID name, KEY is the password, and SECURITY TYPE is the security type of the Wi-Fi network that

can be set to wpa, wpa2, wep, or open. The Wi-Fi provisioning info rmation is s tored in internal flash fo r subs eq uent

use.

Set the Wi-Fi interface as active interface using the command: netif w if i

Figure 10 Setting Wi-Fi interface as the active interface

This command reads the provisio ning info rmation stored in the i nt er nal fl ash fr om t he pr evious step and tries to

provision it automatically.

Configure the IP address using the command: ipcf.

Figure 11 IP Configuration

The command must be used with either dhcp or static <IP> <MASK> <GW> <DNS>, de pending on whether the IP

address is be ing obtained via DHCP or is statically assigned.

To continue with the demonstration setup , proceed to section 6.4.

>wifi TEST_AP no-Wifi4u wpa2

Wifi settings saved in flash

>netif wifi

Selected Network Interface : Wi-Fi

Wi-Fi setup may take a few moments and may require a few retries.

Connecting to SSID "TEST_AP": connected.

>ipcf dhcp

Stopping DHCP client.done

Waiting for IP address.done

Interface Configuration

=======================

Interface : Wi-Fi

Mode : DHCP

IP Address : 192.168.1.251

Netmask : 255.255.255.0

Gateway : 192.168.1.1

DHCP Server : 192.168.1.7

DNS Server : 192.168.1.7

Renesas Synergy™ Platform Synergy Enterprise Cloud Toolbox for AE-CLOUD1

R20QS0004EU0110 Rev.1.10 Page 9 of 19

Feb 21, 2018

6.3 Setting up AE-CLOUD1 for Ethernet

To use Ethernet as the network interface, enter the command: cwiz

Figure 12 Setting Ethernet interface as the active interface and IP configuration

This cwiz command displays supported network interfaces. To activate the Ethernet interface, enter command 1.

To configure the IP address you are given two options: Static and DHCP. Select the desired option to configure the IP

address.

As an alternate method to configure Ethernet a s the network interface, use the command: netif eth

Figure 13 Setting Ethernet interface as the active interface

Con figure the IP addr ess using the command: ipcf

Figure 14 IP configuration

>netif eth

Selected Network Interface : Ethernet

>ipcf dhcp

Stopping DHCP client.done

Waiting for IP address.done

Interface Configuration

=======================

Interface : Ethernet

Mode : DHCP

IP Address : 192.168.1.241

Netmask : 255.255.255.0

Gateway : 192.168.1.1

DHCP Server : 192.168.1.7

DNS Server : 192.168.1.7

Renesas Synergy™ Platform Synergy Enterprise Cloud Toolbox for AE-CLOUD1

R20QS0004EU0110 Rev.1.10 Page 10 of 19

Feb 21, 2018

The command must be used with either DHCP or Static < IP> <MASK> <GW> <DNS>, depending on whether the I P

address is be ing obtained via DHCP or is statically assigned.

Continue to the following sections to sign up for the S ynergy Enterprise Cloud Toolbox Dashboard and add a device to

your dashboard.

6.4 Signing up for the Synergy Enterprise Cloud Toolbox Da shboard

The Synergy Enterprise Cloud Toolbox Dashboard is a hosted web application with the functionality to provision

devices on AWS, Microsoft Azure, o r Goo gle IoT Cloud Providers.

The Dashboard GUI provides:

• User Sign up

• Adding MQTT enabled devices to either AWS, Azure, or Google IoT

• A remote monitoring view to monito r the real-time sensor information of the connected devices

• Updating the device state

Note: The URL of the S ynergy Enterprise Cloud Toolbox Dashboard is: https://cloud.renesassynergy.com

Point your Internet browser to the Dashboard to display the Sign -in screen.

Figure 15 Sign up screen

Fill in the sign -up form and cli ck on Acc e pt and Continue. The hints given wh en you enter i nformation in each field

specify any constraints. For example, Full Name and Company information may contain spaces in between text,

whereas space is not a valid input for Phone and Password fields. Characters allowed in passwords include uppercase

and lowercase letters, numbers, and the following special characters:

Renesas Synergy™ Platform Synergy Enterprise Cloud Toolbox for AE-CLOUD1

R20QS0004EU0110 Rev.1.10 Page 11 of 19

Feb 21, 2018

^ $ * . [ ] { } ( ) ? - " ! @ # % & / \ , > < ' : ; | _ ~ `

Note: Spaces are not supported in both the use r name a nd passwo rd fields.

An activation email will be sent to the email addr e ss you used during registratio n. Clicking the link given in the email

will confirm and activate your account. You may then log in using the registered credentials.

6.5 Adding a Device to the S ynergy Enterprise Cl oud Toolbox Dashboard

After logging in, click Add Device from th e Device Management view to display an Add A Device view.

Figure 16 Adding a device

The following steps show how to add a device:

1. Enter a user-friendly Name for the device (for example, South Wind Turbine ).

2. Enter the device Serial Number.

The Serial Number is the Unique Kit ID obtained from the AE-CLOUD1 device in section 6.1.

3. Select the IoT Provider where the device is to be r egistered.

After a successful add operation, the device appears in the Device Management device-list. The device is added to the

IoT Cloud Provider and becom es available for monitor ing after the device has been provisioned (bootstrapped) with the

Dashboard (see section 6.7).

In case the user has any devices bootstrapped to Azure IoT, a pop-up message will be displayed on the Device

mana gement view as sho wn in the screens-capture below

Renesas Synergy™ Platform Synergy Enterprise Cloud Toolbox for AE-CLOUD1

R20QS0004EU0110 Rev.1.10 Page 12 of 19

Feb 21, 2018

The next step is to configure the device with the registered username (email) and password.

6.6 Configuring User Credentials for AE-CLOUD1

Switch to the device for the CLI and c onfigure your email address and password, using the command user <email _id>

<password>. Use the same email address and password you regi stered for your dashboard.

Figure 17 U s er registratio n

Notes:

1. This command should be triggered after adding the device to the Synergy Enterprise Cloud Toolbox Dashboard.

2. The user credentials should be the same as the ones us ed during Synergy E nterprise Cloud Toolbox Dashboard -

User-signup.

Renesas Synergy™ Platform Synergy Enterprise Cloud Toolbox for AE-CLOUD1

R20QS0004EU0110 Rev.1.10 Page 13 of 19

Feb 21, 2018

6.7 Provisioning for AE-CLOUD1

To provision the device with the connection credentials and details of the IoT Cloud Provider platform, do the

following:

Execute the command: boot.

Figure 18 Device bootstrapping

The boo t comma nd triggers a request to the Dashboard REST API to pas s the configured user credentials and device

unique ID . T he Dashboard authenticates the user and verifies that a device has been added to the users account. Based

on the IoT platform the device was added, the Dashboard responds to the boot request by sending the connection’s

identifiers and authenticat ion details.

Upon successful provis ioning, the information received from the Dashboard is saved on the device’s internal flash.

Note: For the chks command, it is mandato ry to run boot command first wi th the given \IoT service provide r . Failing

to do so will cause the chks command to fail.

6.8 Starting the Wind Turbine model on AE-CLOUD1

Figure 19 Start Wind Turbine model

To start the Wind Turbine model o n the device, enter the command: turb start.

The demonstration application star ts sending the sensor data to the Synergy Enterprise Cloud Toolbox Dashboard.

After the demonstration has started, you can press the Enter key to return to the pro mpt.

Note: Once the Wind Turbine model has been started, if you want to change the network interface or the IoT cloud

provider, the system MUST be power-cycled.

Renesas Synergy™ Platform Synergy Enterprise Cloud Toolbox for AE-CLOUD1

R20QS0004EU0110 Rev.1.10 Page 14 of 19

Feb 21, 2018

6.9 Remote Monitoring on the Synergy Enterprise Cloud Toolbox Dashboard

Switch to the Dashboar d vie w in the browser. Navigate to the Remote Monitoring tab to view the real-time device

status and the sensor data.

Th e LEDs as sociated with the controls are shown in the LED LIGHTS section of the user interface.

Figure 20 Remote Monitoring

The Turbine switch controls the red LED on the de vice, while the Power switch contro ls green LED, and t he

Ammeter controls the yellow LED.

Click the appr opriate switches to update the state of the LEDs on the device.

6.10 Stimulating sensors on AE-CLOUD1

AE-CLOUD1 board comes equipped with various on board sensors. These sensors can be stimulated and the updated

rea dings o bserved on t he Dashboard:

• Humidity sensor: Blow warm air on the device for 20 seconds. Observe the hu midity value chan ge on the

Dashboard.

• Temperature: Turn on the air conditioner and blow cold air towards the device for few minut es to observe the

tempe rature value change on the Dashboard.

• Pressure: Run the test at different altitud e s. For example, run the test on the ground or top floor of a high-rise

building, to note t he c hange in pre s sure o n the Dashboard.

• Accelerometer: Without tilting the de vice, move it in any direction and observe the X, Y, and Z Axis value change

based on the direction that you move t he device towards.

Renesas Synergy™ Platform Synergy Enterprise Cloud Toolbox for AE-CLOUD1

R20QS0004EU0110 Rev.1.10 Page 15 of 19

Feb 21, 2018

6.11 Changing IoT cloud providers

Devices bootstrapped with the dashboard, can be switched between the supported IoT cloud providers.

In the following example, the device is provisioned for the Azure IoT platform. Use the following steps to change the

IoT cloud provider to AWS:

1. Login to the Synergy Enterprise Cloud Toolbox Dashboard.

2. Navigate to Device Management view. Locate the device that must be switched to AWS, and click the Delete icon.

Figure 21 Deleting a device

3. Click on OK when asked to co nfi rm the opera tion.

4. Power cycle the device.

5. Follow the steps to add a device (see section 6.5) and choose AWS as the IoT cloud provider.

6. Run t he demonstration as instructed in either of section 6.2 or 6.3 and then fol lo w the instruc tions mentioned in

section, 6.7 and 6.8.

To switch a device provisioned for AWS to Azure, follow the same steps and choose Azure as the IoT cloud provider

when you add the device.

Notes:

1. At a given time only a s in gl e IoT cloud provider connection can be active on the system (dashboard and device).

2. Provisioning is a one-time operation for the Dashboard + Device-IoT Cloud Provider combination. Once the

device is provisioned for an IoT cloud provider, you do not need to re-provision unless the device is deleted and

added back again via t he dashboard.

3. Every time you switch IoT providers, the device needs to be power cycled. T his step is due to a limitatio n in the

MQTT c lie nt implementation. See the MQTT-TLS w orkarounds section of the Application Note for details.

Renesas Synergy™ Platform Synergy Enterprise Cloud Toolbox for AE-CLOUD1

R20QS0004EU0110 Rev.1.10 Page 16 of 19

Feb 21, 2018

6.12 Resetting the system from the Synergy Enterprise Cl oud Tool box Dashboard

The reset feature is available only to the admin user. Using the reset functionality, the admin user can delete all devices

and users from the system.

Note: Thi s is an irreversible action. To access the reset view, click the Settings icon on the UI’s top-right cor ner.

Clicking Rese t Syste m, o n th e reset view, resets the sys tem (see Figure 22 and Figure 23).

Figure 22 Device Management tab on th e Dashboard

Figure 23 Reset S ystem

Renesas Synergy™ Platform Synergy Enterprise Cloud Toolbox for AE-CLOUD1

R20QS0004EU0110 Rev.1.10 Page 17 of 19

Feb 21, 2018

6.13 Notes and Limita tions

1. It is mandatory that user compiles the IAR project in a different fo ld er from where the e2studio project has

been compiled.

2. After a network interface has been selected, if you wa nt to change it, the system MUST be power-cycled and a

new network interface selected .

3. If certificate pro visioning fail s for a device, then you need to delete the device from the dashboard and add it

back. In the case of a provi sioning failure, see section 6.1.

4. If the boot command fails for a device, you must delete the device from the dashboard and add it back. In the

case of a boot command failure, see 6.1 for instructions. The comma nd c ould fail with the following errors:

A. Starting T LS session: Could not start TLS session (0x109).

B. Parsing Bootstrap Response: IoT Provider not found. Aborting.

C. The command gets stuck after starting the TLS session and the bootstrap does not begin.

5. After changi ng t he LED status from Dashboard, it can take up to 10 seconds for the LED on the AE-CLOUD1

device to change.

6. Google-cloud IoT does not provide information regarding the connected state of the devices to its IoT

platform. As a result, on the Re mote Monitoring tab view, the ico n ind i cating t he connectivity status is gr ay,

instead of green, for the devi ce.

7. The Dashb oar d UI us es Server Sent Eve nts ( S SE).

SSE is part of the HTML5 standard. However, Microsoft (MSFT) does not support SSE in Int er net Explorer

(IE) and Edge. As an alternative, polling i s used to get events fr om the server. De pend ing on the polling

interval, the updates may appear to be delayed.

For de ta ils on SSE and the lack of support on MSFT browsers, visit https://en.wikipedia.org/wiki/Server-

sent_events and https://caniuse.com/#feat=eventsource.

8. In some corporate Ethernet and Wi-Fi connections, the browser refresh rate could be slow and may need

manual refreshing to receive updates. In certain cases, this error is indicated on the Dashboard with a warning

on the status of communication between the device and the Dashboard.

To mitigate thi s issue, ensure tha t the C orpor ate Networ k all ows the fo l lo wing ports to succes sful ly run the

Synergy Enter pris e Cloud To ol box:

TCP Ports: 80 (HTTP), 443 (HTTPS) and 8883 (MQTT over TLS)

UDP P orts: 123 (SNTP), 53 (DNS).

In cases wh en these solutions do not update the browsers, the firewall settings should be checked.

9. If the command line returns an Unsuppor ted Command error, check the format and retype the c omma nd

using the correct format.

10. Google-cloud IoT is not supported in Rev 1.0.

11. The Dashboard on Azure IoT for some kits does not get upd ated automatically and needs to be manually

refreshed to see any changes.

12. If ‘turb start’ command o n Go ogle-cloud fails with an error “U nable to initialize IoT service Google,” power

cycle the device and retry the co mmand .

Note: Google-cloud IoT is in Beta Launch stage. F or more i nformat ion, refer to t he li nk

https://cloud.google.com/terms/launch-stages

13. When upgrading from Rev 1.0 to Rev 1.1, user will need to re-bootstrap a device using “boot" command after

flas hing new version of fir mware.

14. For Synergy Enterprise Cloud Toolbox release build older than 1.1 ver 3.0, user will face issue during “turb

start” command to connect Azure IoT due to change in server certificate and will need to upgrade to SECT

release 1.1 rev 3.0.

Renesas Synergy™ Platform Synergy Enterprise Cloud Toolbox for AE-CLOUD1

R20QS0004EU0110 Rev.1.10 Page 18 of 19

Feb 21, 2018

7. Appendix — Downloading and runni ng the Synerg y Enterprise Cloud Toolbox

Use the following steps to download and run the Synergy Enterprise Cloud Toolbox.

1. Install the driver to enable the J-Link Debugger connected to J2 to be recognized by Windows.

The driver can be downloaded at https://www.segger.com/downloads/jlink.

2. Extract AE_Cloud1_bat.zip.

3. Make sure all the hardware connections have been made as listed in section 5.

4. Run the s1.bat file in the unzipped folder.

5. Make sure the download is complete as sho wn in the foll ow ing figur es.

For instructio ns on how to build and flash the software on the device using e2 studio ISDE and IAR EW for Synergy,

see the Application Note provided with the Synergy Enterprise Cloud Toolbox.

Renesas Synergy™ Platform Synergy Enterprise Cloud Toolbox for AE-CLOUD1

R20QS0004EU0110 Rev.1.10 Page 19 of 19

Feb 21, 2018

Website and S uppor t

Support: https://synergygallery.renesas.com/support

Technical Contact Details:

• America: https://www.renesas.com/en-us/support/contact.html

• Europe: https://www.renesas.com/en-eu/support/contact.html

• Japan: https://www.renesas.com/ja-jp/support/contact.html

All trademarks and registered trademarks are the property of their respective owners.

Revision History

Rev.

Date

Description

Page

Summary

1.00

Dec 18, 2017

—

Initial release

1.08

Jan 11, 2018

—

Changed FPK-S5D9 to AE-CLO UD 1 and upd ate d proc edur es .

1.10

Feb 21, 2018

—

Updated the following items in the document:

— Updated screen-shots

— Dashboard UI to display firmware upgrade message

for Azure devices.

— Pop-up message in Dashboard display for A zure

devices

Synergy Enter prise Cloud Toolbox for AE-CLOUD1

Quick Sta rt Guide

Publication Date: Rev.1.10 Feb 21, 2018

Published b y: Renesas Electronics Corporation

http://www.renesas.com

Refer to "http://www.renesas.com/" for the latest and detailed information.

Renesas Electronics America Inc.

1001 Murphy Ranch Road, Milpitas, CA 95035, U.S.A.

Tel: +1-408-432-8888, Fax: +1-408-434-5351

Renesas Electronics Canada Limited

9251 Yonge Street, Suite 8309 Richmond Hill, Ontario Canada L4C 9T3

Tel: +1-905-237-2004

Renesas Electronics Europe Limited

Dukes Meadow, Millboard Road, Bourne End, Buckinghamshire, SL8 5FH, U.K

Tel: +44-1628-651-700, Fax: +44-1628-651-804

Renesas Electronics Europe GmbH

Arcadiastrasse 10, 40472 Düsseldorf, Germany

Tel: +49-211-6503-0, Fax: +49-211-6503-1327

Renesas Electronics (China) Co., Ltd.

Room 1709 Quantum Plaza, No.27 ZhichunLu, Haidian District, Beijing, 100191 P. R. China

Tel: +86-10-8235-1155, Fax: +86-10-8235-7679

Renesas Electronics (Shanghai) Co., Ltd.

Unit 301, Tower A, Central Towers, 555 Langao Road, Putuo District, Shanghai, 200333 P. R. China

Tel: +86-21-2226-0888, Fax: +86-21-2226-0999

Renesas Electronic s Hong Kong Limite d

Unit 1601-1611, 16/F., Tower 2, Grand Century Place, 193 Prince Edward Road West, Mongkok, Kowloon, Hong Kong

Tel: +852-2265-6688, Fax: +852 2886-9022

Renesas Electronics Taiwan Co., Ltd.

13F, No. 363, Fu Shing North Road, Taipei 10543, Taiwan

Tel: +886-2-8175-9600, Fax: +886 2-8175-9670

Renesas Electronics Singapore Pte. Ltd.

80 Bendemeer Road, Unit #06-02 Hyflux Innovation Centre, Singapore 339949

Tel: +65-6213-0200, Fax: +65-6213-0300

Renesas Electronics Malaysia Sdn.Bhd.

Unit 1207, Block B, Menara Amcorp, Amcorp Trade Centre, No. 18, Jln Persiaran Barat, 46050 Petaling Jaya, Selangor Darul Ehsan, Malaysia

Tel: +60-3-7955-9390, Fax: +60-3-7955-9510

Renesas Electronics India Pvt. Ltd.

No.777C, 100 Feet Road, HAL 2nd Stage, Indiranagar, Bangalore 560 038, India

Tel: +91-80-67208700, Fax: +91-80-67208777

Renesas Electronics Korea Co., Ltd.

17F, KAMCO Yangjae Tower, 262, Gangnam-daero, Gangnam-gu, Seoul, 06265 Korea

Tel: +82-2-558-3737, Fax: +82-2-558-5338

SALES OFFICES

Colophon 5.0

Renesas Synergy™ Platform

Synergy Enterpris e Cloud Toolbo x

for AE-

CLOUD1

Quick S tart Guide

R20QS0004EU0110