R20qs0004eu0210 Synergy Ae Cloud2
R20qs0004eu0210 Synergy Ae Cloud2
All information contained in these materials, including products and product specifications, represents
information on the product at the time of publication and is subject to change by Renesas Electronics
Corp. without notice. Please review the latest information published by Renesas Electronics Corp.
through various means, including the Renesas Electronics Corp. website (http://www.renesas.com).
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 is applied to the external reset pin, the states of pins are not guaranteed from the 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 function are not guaranteed from the time when power is supplied until the power reaches the level at which resetting is
specified.
5. Clock signals
After applying a reset, only release the reset line after the operating clock signal becomes stable. 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 resonator or from an external oscillator 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
while program execution is in progress, wait until the target clock signal is stable.
1. Introduction .............................................................................................................................. 2
2. Prerequisites............................................................................................................................ 2
3. Requirements .......................................................................................................................... 2
7. Appendix — Downloading and running the Synergy Enterprise Cloud Toolbox Demo ........... 30
The demo can be used as a reference solution for users to quickly get started on the Synergy Software Package (SSP),
Wi-Fi Framework, and Cellular Framework as well as Ethernet connectivity, and cloud connectivity with different IoT
Cloud Providers using the Renesas Synergy™ Enterprise Cloud Toolbox Demo for AE-CLOUD2 Kit.
2. Prerequisites
The hardware and software requirements listed in the section 3 should be installed.
Note: The MCU board is not pre-programmed with firmware for the Synergy Enterprise Cloud Toolbox Demo
application project. To run the bat file and flash the MCU board, see the instructions in the Appendix —
Downloading and running the .
3. Requirements
• PC software requirements:
⎯ Microsoft® Windows® 7 or 10
• AE-Cloud2 kit (part# YSAECLOUD2) hardware requirements:
⎯ S5D9/S124 Pillar Synergy MCU Board (part # YIOTS5D9PILLAR v1.1 Rev F)
⎯ Wi-Fi Board (part# YSAEWIFI-1)
⎯ BG96 Arduino Shield (Ver 2.0 Rev F)
⎯ Two antennas
⎯ Global SIM with Data plan
⎯ SEGGER J-Link® Lite for Renesas Synergy (part# YSJLINKLITE)
⎯ Two micro USB connector cables
⎯ Ethernet Cable
Note: Do the next step only after all the other modules and connectors are plugged in! Port J9 connector supplies
power to the AE-CLOUD2 board, in addition to the debugger.
For Cellular Network connectivity, see Error! Reference source not found..
• Connect the antennas provided with your CATM1 module
• Connect cellular CATM1 module to MCU board with Arduino header.
Please find driver files for latest Synergy USB CDC driver package at below location.
https://www.renesas.com/en-us/products/synergy/software/add-ons/usb-cdc-drivers.html
Please follow instructions in “Application Note – Installing Synergy signed USB CDC Drivers” to install Synergy USB
CDC driver on your computer.
****************************************************************************
* Synergy Enterprise Cloud Toolbox *
* Version 2.1.0, Released-2019/04/18 *
* Build 2.0 *
****************************************************************************
Figure 8 IP Configuration
Wi-Fi setup may take a few moments and may require a few retries.
>
Wi-Fi Configuration
====================
SSID : Test_AP
Key : no-Wifi4u
Security : WPA2
IP 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
>netif eth
Selected Network Interface : Ethernet
>
Figure 13 Setting Ethernet interface as the active interface
>ipcf dhcp
Stopping DHCP client.done
Waiting for IP address.done
IP 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
User can use the “exit” command to exit the shell interface as shown in Figure 16. This will exit the shell interface
and user can re-enter shell interface if required without restarting the device.
Note - “atshell” interface will only work when SIM card is inserted in BG96 Arduino shield’s SIM card slot and
cellular interface is not already configured or connected.
User is provided with a CLI command “atread” to read stored set of AT commands.
Once final confirmation from user is received as ‘y’, stored set of sequential AT commands will be applied to
cellular module for SIM registration and data connection.
Note: The URL of the Synergy Enterprise Cloud Toolbox Demo Dashboard is: https://cloud.renesassynergy.com
Point your Internet browser to the Dashboard to display the Sign-in screen.
An activation email will be sent to the email address you used during registration. Clicking the link given in the email
will confirm and activate your account. You may then log in using the registered credentials.
6.6 Adding a Device to the Synergy Enterprise Cloud Toolbox Demo Dashboard
After logging in, click Add Device from the Device Management view to display an Add A Device view.
After a successful add operation, the device appears in the Device Management device-list. The device is added to the
IoT Cloud Provider and becomes available for monitoring after the device has been provisioned (bootstrapped) with the
Dashboard (see section 6.8).
In case the user has any devices bootstrapped to Azure IoT, a pop-up message will be displayed on the Device
management view as shown in the screens-capture below
The next step is to configure the device with the registered username (email) and password.
6.7 Configuring User Credentials for AE-CLOUD2
Switch to the device for the CLI and configure your email address and password, using the command user <email_id>
<password>. Use the same email address and password you registered for your dashboard.
If the boot command fails, user may see following error logs. Please verify your settings as suggested.
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 single 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 the dashboard.
3. Every time you switch IoT providers, the device needs to be power cycled. This step is due to a limitation in the
MQTT client implementation.
In addition to downloading the firmware binary and the Quick Start Guide, this view has a link to buy the kit.
A non-volatile memory block of 64 bytes is reserved for session header. For every cloud connectivity session, this
header is constructed according to user inputs. It captures information entered by user to start Turbine application.
The log mechanism has two levels of verbosity: Info and Trace
Info log:
Info log (Low verbosity) is ON by default. Info logs are stored in 16k block of memory in internal flash.
Info logs frame structure:
Info logs can be retrieved from the device using CLI command (LPOP).
Trace log:
Trace log is a High verbosity logging mechanism which captures in-depth information of most of the functions. These
logs are OFF by default. User needs to run the CLI command to turn trace logging ON in the device.
These logs are printed on console and not stored on the internal data flash. If user wants to capture all the trace logs,
then user needs to turn the logging on in the serial terminal emulator to save the logs. Trace Logs have same display
format as Info Logs.
Trace log frame structure
LOFF This command stops the logging process for trace log. LOFF
LPOP This command retrieves the session header and all the info logs LPOP
from internal data flash and displays them on console.
If the user has entered the LPOP command immediately after a
device reset cycle, the session header and info logs of the last
session are retrieved and displayed on the console. After retrieval,
this information is erased from flash.
In other cases, if user gives the LPOP command, then the session
header and info logs of the current session are retrieved and
displayed on console
LCLEAR This command erases all the info logs in internal data flash LCLEAR
LSEND This command sends info logs to the remote server. An active LSEND
network connection is needed to successfully run the thin
command.
All trademarks and registered trademarks are the property of their respective owners.
Revision History
Description
Rev. Date Page Summary
1.8.0 April 09, 2018 — Initial release
1.9.0 May 07, 2018 — Updated Dashboard screen captures to reflect release 1.9.0
Updated Synergy USB CDC driver link. Updates CLI screen
shots. Added details of Info, Trace and Debug logs in section
6.17.
1.9.2 May 24, 2018 — Updated section 6.4 for cellular changes
Added snap shots for new CLI commands to support cellular
changes.
Updated section 6.17 to add table of supported CLI commands
for logging
Updated SECT banner
1.9.3 June 28, 2018 — Updated section 6.11 for new sensors.
Updated figure 2 and figure 3 for new BG96 module.
Updated SECT banner.
Updated the Dashboard screen-captures to reflect the release
version. Update the remote-monitoring screen-capture to
reflect the additional sensor widgets.
1.9.4 July 12, 2018 — Updated banner information. Updated section 3 with latest
SSP and tool (e2studio and IAR) version.
Removed “connect” command support in atshell interface and
associated screen capture from section 6.4.. Updated section
6.15 for correct button label name “S1” for auto start.
Updated dashboard screen captures.
1.95 August 14, 2018 — Update section 3 to mention SSP 1.5.0 MP build1
Updated section 6.1 for CLI mode description changes and
banner information.
Updated section 6.15 for auto start description changes.
Aligned captured snap shots of console. Updated limitation
section.
Updated Dashboard screen captures
2.00 September 26, — Updated banner information. Removed comments from the
2018 doc. Changed reference of application “example” to application
“demo” in document. Added http response code and log map.
Updated CLI terminal snap shots.
Updated dashboard screen-captures.
2.1.0 April 18, 2019 — Updated banner information. Updated screen shots of cellular
carriers figure 15 and 19.
R20QS0004EU0110