SDK User Guide¶
MicroEJ SDK provides tools based on Eclipse to develop software applications for MicroEJ-ready devices. MicroEJ SDK allows application developers to write MicroEJ Applications and run them on a virtual (simulated) or real device.
The purpose of MicroEJ SDK is to develop for targeted MCU/MPU computers (IoT, wearable, etc.) and it is therefore a cross-development tool. Unlike standard low-level cross-development tools, MicroEJ SDK offers unique services like hardware simulation and local deployment to the target hardware.
Application development is based on the following elements:
MicroEJ SDK, the integrated development environment for writing applications. It is based on Eclipse and relies on the integrated Java compiler (JDT). It also provides a dependency manager for managing MicroEJ Libraries (see MicroEJ Module Manager). The current distribution of MicroEJ SDK (
21.03) is built on top of Eclipse 2020-06.
MicroEJ Platform, a software package including the resources and tools required for building and testing an application for a specific MicroEJ-ready device. MicroEJ Platforms are imported into MicroEJ SDK within a local folder called MicroEJ Platforms repository. Once a MicroEJ Platform is imported, an application can be launched and tested on Simulator. It also provides a mean to locally deploy the application on a MicroEJ-ready device.
MicroEJ Virtual Device, a software package including the resources and tools required for building and testing an application for a specific MicroEJ-ready device. A Virtual Device will simulate all capabilities of the corresponding hardware board:
- Computation and Memory,
- Communication channels (e.g. Network, USB …),
- User interaction.
Virtual Devices are imported into MicroEJ SDK within a local folder called MicroEJ Repository. Once a Virtual Device is imported, an application can be launched and tested on Simulator. It also provides a mean to locally deploy the application on a MicroEJ-ready device.
MicroEJ-ready device, a hardware device that has been previously programmed with a MicroEJ Firmware. A MicroEJ Firmware is a binary instance of MicroEJ runtime for a target hardware board. MicroEJ-ready devices are built using MicroEJ SDK. MicroEJ Virtual Devices and MicroEJ Firmwares share the same version (there is a 1:1 mapping).
The following figure gives an overview of MicroEJ SDK possibilities:
Starting from scratch, the steps to go through the whole process are detailed in the following sections of this chapter :
- Download and install a MicroEJ Platform
- Build and run your first Application on Simulator
- Build and run your first Application on Device