X

Sign up for MicroEJ Studio

A few clicks left before entering the MicroEJ world.

 
Salutation: *
First Name: *
Last Name: *
Country: *
Email Address: *
Company:
  I agree to hear from MicroEJ about the latest trends and news
 
 
X

Firmware Evaluation License Agreement

You need to accept the License Agreement before downloading the firmware.

  I agree

Getting Started on Renesas GR-peach

1

Prepare your Evaluation Board.

Prerequisites

Hardware
  • a GR-PEACH reference board (available here)
  • a microUSB to USB cable
  • a microSD card

Program the MicroEJ Firmware

  • Insert the microSD card into the microSD card connector.
  • Connect the GR-PEACH to your computer with a microUSB to USB cable on the PG connector.
  • A USB mass storage device named MBED should be mounted on your OS.
  • Download the firmware from here.
  • Drag and drop the downloaded firmware at the root of the filesystem of the USB mass storage device.
  • Wait for the file to be copied and reset the board using the RST button next to the PW connector.

The MicroEJ firmware should now run on your evaluation board. You can also read the RELEASE-NOTES of the firmware.

2

MicroEJ Android Companion

The Android companion is an application that connects to a MicroEJ application store (communitystore.microej.com store by default) to install apps on an embedded device running a MicroEJ firmware using a Wifi or Bluetooth interface.

Hardware Requirements

  • an Android Device with networking capabitlities over WiFi

Software Requirements

  • an Android OS KitKat (v4.4 or API level 19) or superior

Android Application Installation

  • Your evaluation card and the Android device running the MicroEJ companion should be connected to the same LAN.
  • Download the Android application package here and transfer the .apk file to the filesystem of your Android device.
  • Launch a file manager on your device.
  • Find your apk file.
  • Launch it and select Install.
  • If a security warning appears, click on Settings and activate the Unknown sources option.
  • Then proceed with the installation.

Use of the MicroEJ Companion

The MicroEJ Companion has several steps to be followed before managing applications with your device.

  • First and foremost create an account here.
  • Start the MicroEJ Companion and log in with the credentials you created on the community store.
  • Choose the WiFi/Network device.
  • Add your evaluation board by clicking on the + icon, enter a name and an IP (the IP can be found on the debug traces (cf. section 8), also take note of your Device UID for future use.).
  • Confirm by clicking on Add Device
  • Select the newly created board in the list.
  • A list of MicroEJ applications available on the community store and board is displayed.
  • You can control the lifecycle (start/stop, install/uninstall) of each app from this list of app.
3

Publishing Data to Xively Cloud

In this section, we are going to install an app (XIMI) that is a service to connect to LogMeIn Xively cloud . A second application (LedPublisher) is a simple app that is using the XIMI service to publish a data.

The published data can be accessed through the Xively web platform.

Install Data Applications

  • Use your Android phone and start the MicroEJ Companion.
  • Connect to your development board.
  • Install the    LedPublisher and    XIMI application.
  • Start the XIMI application with the Companion.
  • Start the LedPublisher application with the Companion.

Publishing Data in the Xively Platform

  • Connect to https://freedatahub.app.xively.com:
    • The login is the user email address used in the Community Store account.
    • The password is freedatahub.
  • Go to Devices > All Devices > FreeDataHub > Messaging Tab and visualize the message from the LedPublisher application
4

Install MicroEJ Studio

In the following sections, we're going to install MicroEJ Studio, develop a new application and locally deploy it on our board.

MicroEJ Studio is an IDE built on Eclipse for creating applications for the MicroEJ OS.

Supported Operating System

MicroEJ Studio runs on the following operating systems:

  • Windows 10, Windows 8.1, Windows 8, Windows 7
  • Linux distributions (tested on Ubuntu 12.04 and Ubuntu 14.04)
  • Mac OS X 10.11 and macOS 10.12

Java™ Runtime Environment

A Java™ Runtime Environment 8 is needed on your host computer for running MicroEJ Studio. Download Java™ from http://java.com/en/.

Download MicroEJ Studio

Download the installer package corresponding to your host computer OS from the download link.

Install MicroEJ Studio

  • Unzip the downloaded installer package.
  • Run the unzipped executable file.
  • On Windows, accept the administrator privileges elevation.
  • Follow the installer steps.
  • Proceed to the next step.

MicroEJ Studio
 

(Other platforms)

5

Install the Virtual Device

  • Start MicroEJ Studio.
  • Select the workspace where to put the MicroEJ applications code. If you are not familiar with Eclipse workspaces, select the default one and press OK.
  • Select the MicroEJ repository where to put MicroEJ application platforms. If you are not familiar with MicroEJ repositories, select the default one and press OK.
  • Select the Window > Preferences > MicroEJ > Platforms menu.
  • Download the Virtual Device here.
  • Press the Import... button and select the Virtual Device file previously downloaded (its extension is .jpf ).
  • Accept the license terms and press Finish. The MicroEJ Virtual Device is successfully installed.
6

Run your First MicroEJ Application

Learn how to develop applications with our demo application samples.

Import the Application Samples into Workspace

  • Download the Application Samples here.
  • Inside MicroEJ Studio.
  • Select File > Import > General > Existing Projects into Workspace.
  • Check Select archive file and browse applications-[version].zip.
  • The workspace shall compile without errors.

Application Samples


MicroEJ Demo Applications

Download

Application Deployment on Simulator

  • Inside MicroEJ Studio.
  • Right-Click on com.microej.demo.hello.headless project.
  • Select Run As > MicroEJ Application.
  • The application is executed on the MicroEJ Virtual Device.
  • You should get the following window:
MicroEJ Demo Applications
  • Start a web browser.
  • Open the url http://IP where IP is displayed in the Console view of the MicroEJ Studio.

Application Deployment on Firmware

Once the MicroEJ Firmware is flashed on your evaluation board.

  • Plug your board to a DHCP-enabled network thanks to an Ethernet cable.
  • Retrieve the IP address assigned to the Device, the IP is displayed in the Debug Traces of the GR-PEACH (see Advanced Settings)
  • Inside MicroEJ Studio.
  • Select the previously created launcher for the Simulator
    • Go to Run > Run Configurations...
    • Select the com.microej.demo.hello.headless BackgroundServicesStandalone launcher
  • Select the Execution tab and check Execute on Device
    • Core Engine Mode: Default
    • Settings: Local Deployment
  • Select the Configuration tab and set Host option with the board IP address.
  • Press Run. The application is deployed on board and is started.
  • Start a web browser.
  • Open the url http://IP where IP is displayed in the Debug Traces of the GR-PEACH (see Advanced Settings).
7

Create your First MicroEJ Application

Learn to develop

Get the full technical documentation to develop your first apps.

Go further

Leverage the curated developer resources from MicroEJ to enrich your apps with powerful new features.

Learn about the MicroEJ Firmwares and their flavors. This MicroEJ Firmware is PURPLE.

Engage with the community

Publish your app. Show what you can do with MicroEJ Studio! Upload your app to MicroEJ Store.

8

Advanced Settings

Debug Notes

To get access to debug traces:

  • On Windows if the mBed serial drivers is not installed automatically, follow the procedure here.
  • Unplug and plug the USB cable.
  • Retrieve the right COM port available from the Windows device manager.
  • Open a serial terminal and connect the COM port with the following settings:
    • baudrate=115200
    • parity=NONE
    • databits=8
    • stopbits=1