AE-CLOUD1 Feb Meetup Tutorial Part 1

This guide is an updated version of the S5D9 Diagnostics Intelligence Tutorial, originally written by Medium One, with some modifications added.

In this guide, you will learn how to set up an AE-CLOUD1 kit with Renesas IoT Sandbox with either Ethernet or WiFi. Then, you’ll login and view temperature, pressure, humidity, vibration, and noise level data on the Dashboard.  You will also receive daily email reports at midnight with the sensor data and other statistics.

HERE’S WHAT YOU NEED TO GET STARTED:

  1. Renesas AE-CLOUD1 Kit (Order Here)
  2. Qualcomm GT202 WiFi module
  3. Micro USB cable to power up the board
  4. Windows computer
  5. Ethernet Cable with Internet access or WiFi

 

STEP 1: ACTIVATE KIT IN RENESAS IOT SANDBOX

Click here to activate the kit and complete the registration process to create a Renesas IoT Sandbox account preloaded with the workflows. Once activation is completed, you will receive an email with your account credentials needed to provision the kit and access the cloud portal.

This email will include your:

  • Renesas IoT Sandbox web login
  • API Key
  • MQTT Project ID
  • MQTT Registration User ID
  • Registration User password

The email will also include a .txt attachment that you will drag into your board to auto-enroll in a later next step. To learn more about how auto-enrollment works, view Appendix C.

STEP 2: CONNECTING TO WIFI OR ETHERNET

This kit allows you to choose to connect the board to the internet via WiFi or Ethernet. First, check the board whether there is a connection via Ethernet cable. If you want to connect via Ethernet, connect the Ethernet cable then skip to the next step.

Alternatively if there is no Ethernet connection, the board will try to connect via WiFi. To be able to connect to WiFi, you’ll need a Qualcomm GT202 WiFi module attached to the board. The following steps will instruct you how to set this up and specify the WiFi credentials.

Make sure the jumper for the PMOD is on 3.3V like this:

Connect the Wi-Fi module to the AE-CLOUD1 board

Plug your AE-CLOUD1 board into your Windows computer and it should show up as a USB Drive. Open the folder.

Note: There may be other files also in the directory.

Create a new text file ‘wifi.txt.’ Open the file.

On the first line, type in the WiFi SSID you want the board to connect to. On the second line, type in the WiFi password, then Save.

Tips for Troubleshooting Your Wifi Connection

Wait 90 Seconds After Plugging the Board In

When you first plug the board in, nothing happens. Wait 90 seconds.

Keep waiting for LED status lights.

In my tests, the Amber light comes on after 12 seconds. This indicates that the board is waiting for WiFi to be connected.

After 22 seconds since the USB power is plugged in, the board connects to WiFi and successfully connects to Renesas IoT Sandbox Data Intelligence. In my tests, the amber and green LEDs are solid for about 1 second, then the amber LED goes off and the green LED stays on.

When everything is working properly, the LED will be green. This is what you want to see.

Here’s a video of a successful boot sequence and connection to Renesas IoT Sandbox Data Intelligence.

When the board is connected to the Renesas IoT Sandbox, you will see the Board Online Status as “on” in the Last Value Table.

2. Access network.log

When you plug the S5D9 into your computer with a USB cable, it will mount as a USB drive. In the example below, the S5D9 board is USB Drive (E:). The default binary will generate a log file called network.log.

A successful connection will look like this.

3. Access ipconfig.txt

The default binary will also generate ipconfig.txt

4. Solid Green and Amber Indicates Trying to Connect to Data Intelligence

In a good boot sequence, the amber and green LEDs will stay on together briefly, probably less than a second. However, if you see solid green and amber lights stay on and it's stuck at this stage, the board is trying to connect to Data Intelligence. It connected to your WiFi router, but can’t access the Internet or can’t connect to Data Intelligence. The board is still trying to connect.

In your email, you should have received a message about activation.

The email has an attachment.

Make sure that you copied this file to your S5D9 board and ejected the board, then rebooted the board (pull out the USB power and the plug it back in).

All Lights Flashing Indicates Connection Failure

The board is no longer trying to connect. Please check your logs.

STEP 3: CONNECT THE AE-CLOUD1 KIT TO THE CLOUD

This step is to connect your AE-CLOUD1 board to the cloud and auto-enroll an API Basic User in your project.

  1. If you have not already done so, plug your AE-CLOUD1 board into your Windows computer and it should show up as a USB Drive. Open the folder.
  2. Download the file named “m1config.txt” from your welcome email that you’ve received from Step 2. Do not change the file name. The email should have these credentials on each line:
    1. On the first line, the API Key
    2. On the second line, the MQTT Project ID
    3. On the third line, the MQTT Registration User ID
    4. On the last line, the Registration User Password

Sample m1config.txt:

  1. Drag this file into the board directory. Wait several seconds, then unplug the board and plug it back in. Make sure it is still connected to the Ethernet cable or WiFi module.
  2. After a few moments, both the green and yellow LED will turn on. This signifies that the board is trying to connect to the internet and your Renesas IoT Sandbox credentials (via m1config.txt file). Once connected, only the green LED light on the board should be on. If the board can’t connect for some reason, all 3 lights will simultaneously blink on and off. If this happens, verify the “m1config.txt” file is correct and your internet source is working.

Note: Once your board is properly connected, the m1config.txt file will be automatically deleted for security purposes. However, your board will still store its credentials until a new m1config.txt is created.

Continue to Part 2