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 STMicroelectronics STM32F746G-DISCO

1

Prepare your Evaluation Board.

Prerequisites

Hardware
  • An STM32F746G-DISCO Discovery Kit (available here).
Software
Prepare the Board
  • Insert a FAT32 formatted MicroSD card in the MicroSD connector.
  • The jumper configuration for the power (below the black reset button) must be on 5V link.
  • Connect the board through the Ethernet port to a network providing a DHCP server and DNS via DHCP.
  • The STM32F746G-DISCO board has three USB connectors, with the screen facing upward and from left to right:
    • CN14 - USB ST-LINK (Mini-B connector)
    • CN13 - USB_FS (Micro-B connector)
    • CN12 - USB_HS (Micro-B connector)
    For power supply, you can select the ST-LINK connector by setting jumper JP1 on the back of the board, next to the reset button. You must select "CN14 USB ST-LINK" (factory settings) when you use the STM32 ST-LINK utility, you need a cable with a "Mini-B" connector.
  • Connect the board to the PC using a mini USB to USB cable on connector CN14.

Program the MicroEJ Firmware

Setup ST-LINK Utility
  • Start ST-LINK Utility.
  • Select External Loader > Add External Loader.
  • Check N25Q128A_STM32F746G-DISCO loader and press Validate.
Program the Flash
  • Select Target > Program.
  • Download the MicroEJ firmware here.
  • Browse for the downloaded file.
  • Press Start and wait until programming complete (this may take a while).
  • Exit from ST-Link Utility.

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 default Settings page available from the        icon, 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

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 VEE (Virtual Execution Environment).

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)

4

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.
5

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 project.
  • Select Run As > MicroEJ Application.
  • The application is executed on the MicroEJ Virtual Device.
  • You should get the following window:
MicroEJ Demo Applications

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, from the Settings menu by clicking the        icon on the main screen.
  • Inside MicroEJ Studio.
  • Select the previously created launcher for the Simulator
    • Go to Run > Run Configurations...
    • Select the com.microej.demo.hello HelloActivityStandalone 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.
6

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 Firmware and their flavors. This MicroEJ Firmware is BLUE.

Engage with the community

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

7

Advanced Settings

Debug Notes

  • Unplug and plug the USB cable.
  • To get debug traces, retrieve the COM port STMicroelectronics STLink Virtual COM port available from the device manager, open a serial terminal and connect the COM port with the following settings:
    • baudrate=115200
    • parity=NONE
    • databits=8
    • stopbits=1