1. Introduction

1.1. Overview

This is the documentation of the Cinterion VEE 1.6.0.

It describes the content of the evaluation package, guides the evaluation (setup, demo, …) and documents how to extend it for a specific application.

This section provides an overview of the package. Section Getting Started helps to set up a development environment and run the demo. Then, Application Documentation, Kernel Documentation and Platform Documentation document how to create/extend respectively a MicroEJ Application, a MicroEJ Kernel and the Cinterion Platform.

Note

This package is intended for evaluation only. It must not be used for production.

1.2. Requirements

  • MICROEJ SDK 5.4.0 (as provided by the MICROEJ SDK Dist. 21.03).

  • Cinterion® IoT SDK v00.02.005 for embedded processing.

    • Requires a Python 2.7 installation.

  • Cinterion® LGA DevKit (Small socket footprint) + EXS82 module

    or Cinterion® LGA DevKit (Large socket footprint) + PLS63 module.

    • The development kit contains a wideband antenna for LTE networks.
    • The development kit does not contain a GPS antenna: it is optional for the demo.
    • The development kit does not contain a second USB cable for the ASC0 serial interface: required for running applications on the simulator.

This package has been tested on:

  • MICROEJ SDK 5.4.1.
  • PLS63:
    • Cinterion® IoT SDK v00.02.005, PLS63 firmware rev 02.000 / arn 01.000.00.
    • Cinterion® LGA DevKit (Large socket footprint) + PLS63-EP B2.3.

1.3. Package Structure

The Cinterion VEE Evaluation Package 1.6.0 is available here, it contains:

  • Cinterion-Platform-Clangv4_cortexa7-<version>.zip: this package contains the sources of the Cinterion Platform.
  • cinterion-offline-repository-<version>.zip: this package contains all the modules required to build the packaged sources.
  • cinterion-demo-kernel-<version>.zip: this package contains the sources of the demonstration multi-sandbox kernel.
  • cinterion-demo-application-<version>.zip: this package contains the MQTT-based demonstration application.
  • config/: this folder contains configuration files to upload to the Cinterion file system for the demonstration.
  • binaries/: this folder contains the prebuilt binaries of the demonstration.
  • platform-mock-<version>/: this folder contains the hardware mock controller binary to run the demonstration in simulation.

1.4. Support

For the Cinterion® IoT SDK and LGA DevKit requests, as well as technical support regarding the EXS82 and PLS63 modules and the Cinterion® IoT SDK, please contact Thales.

To build applications with the MICROEJ SDK, a license is required. To get an evaluation license, follow instructions here: Evaluation Licenses. To request a production license, please contact sales@microej.com.

For support on this package and on the MICROEJ SDK, please contact support@microej.com.

1.5. Thales contact

For any questions on Thales’ Cinterion® product ordering or technical support requests, please contact Thales DIS AIS: IoT Solutions for 2021 (Connectivity & Security).

1.6. External resources

Regarding the Cinterion® hardware and software, please refer to the documentation of the Cinterion® IoT SDK.

Regarding the MICROEJ SDK:

1.7. Known issues and Limitations

  • The current package has not been tested on the EXS82 module.
  • The device serial communication is limited (output is working but not input).
    • This is a limitation for the simulator: Cinterion APIs mocking is unsupported.
  • The GPS features have not been fully tested.
  • The platform known issues / limitations are listed in its release notes.