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

Connect your board to the MicroEJ Store

To install and manage apps, the board has to be connected to a MicroEJ Store:

  • First and foremost create an account here.
  • Then click on the "+" hexagon.
  • Log in with your credentials.
  • A list of MicroEJ applications available on the community store will be displayed on the board.
  • 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 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 YELLOW.

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