Getting Started

Online Getting Started

The MicroEJ Multi-Sandbox Firmware Getting Started is available on MicroEJ GitHub repository, at https://github.com/MicroEJ/Example-MinimalMultiAppFirmware.

The file README.md provides a step by step guide to produce a minimal firmware on an evaluation board on which new applications can be dynamically deployed through a serial or a TCP/IP connection.

Create an Empty Firmware from Scratch

Create a new Firmware Project

MicroEJ SDK provides an EasyAnt skeleton (com.is2t.easyant.skeletons#firmware-multiapp) to create an empty Multi-Sandbox Firmware project.

Select File > New > Other… > Easyant > Easyant Project, set the appropriate skeleton, and press the Finish button.

../_images/firmware-multiapp-skeleton.png

A new project is generated into the workspace:

../_images/firmware-multiapp-skeleton-project.png

Setup a Platform

Before building the firmware, a target platform must be configured. The easiest way to do it is to copy a platform file into the myfirmware > dropins folder. Such file usually ends with .jpf. For other ways to setup the input platform to build a firmware see Change the Platform used to Build the Firmware and the Virtual Device.

Build the Firmware

In the Package Explorer, right-click on the firmware project and select Build Module. The build of the Firmware and Virtual Device may take several minutes. When the build is succeed, the folder myfirmware > target~ > artifacts contains the firmware output artifacts (see Firmware Input and Output Artifacts) :

  • mymodule.out: The Firmware Binary to be programmed on device.
  • mymodule.kpk: The Firmware Package to be imported in a MicroEJ Forge instance.
  • mymodule.vde: The Virtual Device to be imported in MicroEJ Studio.
  • mymodule-workingEnv.zip: This file contains all files produced by the build phasis (intermediate, debug and report files).
../_images/firmware-multiapp-skeleton-artifacts.png