2.1. Setup: hardware and software¶

2.1.1. Cinterion® IoT SDK installation¶

The Cinterion® IoT SDK is distributed by Thales as an archive. Extract its content on your system.

In the following sections, {Cinterion SDK} refers to the directory that directly contains the README.txt file.

Set up the Cinterion module:
- For the EXS82 module, use the LGA DevKit S+M.
- For the PLS63 module, use the LGA DevKit L.
- Screw the socket to the PCB.
- For the EXS82 module, put the SMALL fixing frame in the socket.
- For the PLS63 module, put the LARGE fixing frame in the socket.
- Put the module in the fixing frame.
- Close the socket.
Check hardware configuration of LGA DevKit (both EXS82 and PLS63):
- Set PWR and ASC0 switches to USB.
- Place jumpers on: ASC0_A, CONTROL, B+BB, B+RF, A.
- For GPIO test with STATUS LED blinking, place jumper on: GPIO5
- (optionnal) For GPIO test in input, place button with pull down on: GPIO6
Insert the SIM card.
Plug the wideband antenna into either the Main or the DRX ports.
Connect the dev kit to your PC using the Native USB port.
Press on the ON button to start the firmware.

Follow the section 2 Setup of the SDK Getting_Started.pdf. On Windows 10, make sure to use the SDK drivers to have the names correctly displayed.
Note the following COM ports: Cinterion PID 0X006C USB Modem and Cinterion PID 0X006C USB Com Port2. They will be refered as the modem COM port and the logging COM port respectively. If these devices are not accessible, make sure the drivers are updated.
Configure the logging interface:
```
{Cinterion SDK}/tools> python log.py config -d "COMX,460800" -p COMY
COMX,460800
```
where COMX is the logging COM port and COMY the modem COM port.
Listen to logs:
```
{Cinterion SDK}/tools> python log.py read
{Logs will appear here}
```
The command must be repeated if the module is rebooted (broken connection).

The serial interfaces of the DevKit are used as follows:

USB (native):
- Virtual Port “modem”: AT commands (used by app.py / fs.py)
  - It is also the interface to use for the ECOM-MOBILE mock
- Virtual Port “logging”: Logging interface (used by log.py)
ASC0:
- Serial communication: applications can communicate through this interface using ECOM-COMM APIs.
  - It is also used for the Cinterion mock (MQTT, AT commands, ..)
ASC1:
- Serial communication: applications can communicate through this interface using ECOM-COMM APIs.

The MICROEJ SDK is distributed by MicroEJ with an Eclipse-based IDE.

Follow instructions in Download and Install.

Open the IDE and create a workspace.

In the workspace, select File > Import > MicroEJ > Module Repository,
Select Select file and browse to the file cinterion-offline-repository-<version>.zip,
Click on Apply and Close.

For Cinterion-Platform-Clangv4_cortexa7-<version>.zip, cinterion-demo-kernel-<version>.zip and cinterion-demo-application-<version>.zip:

In the workspace, select File > Import > General > Existing Projects into Workspace,
Select Select archive file and browse to the archive file,
Select all projects and click on Finish.

[Optional] For use with a production license, in cinterion-threadx-configuration/module.properties change the com.microej.platformbuilder.architecture.usage property value to prod.
[Optional] For smaller footprint with mono-sandbox application only, open cinterion-threadx-configuration/cinterion.platform file with a text editor and remove the kf group.
In the Package Explorer view, right-click on cinterion-threadx-configuration and click on Build Module.
Detailed documentation is available in the platform sources, at the location of the import, to open with any rst viewer or text editor, by default: {workspace}/Cinterion-Platform-Clangv4_cortexa7-<version>.zip_expanded
- README.rst: General platform documentation.
- CHANGELOG.rst: platform changelog.
- RELEASE NOTES.rst: platform release note.
- cinterion-threadx-bsp/projects/cinterion/README.rst: Advanced platform documentation.
Configure the platform with your environment: in cinterion-threadx-bsp/projects/cinterion/scripts, copy set_local_env.bat.tpl to set_local_env.bat and set the variables.

The modem must be preconfigured with modem connectivity information. Also, the demo contains several application configurations (MQTT host, topic, …)

To enable the modem connectivity, open a terminal to the modem COM port with baudrate 460800:

To configure the application:

Edit the file {Package}/config/demo.config to set the appropriate configuration where {Package} is the path to the Cinterion MICROEJ evaluation package.

Push the file on the filesystem of the Cinterion module, using the Cinterion SDK tools:

{Cinterion SDK}/tools> python fs.py download {Package}/config/demo.config A:/demo.config
Sent 100 %

If configured, push the CA certificate on the filesystem of the Cinterion module:

{Cinterion SDK}/tools> python fs.py download {Package}/config/mosquitto.org.crt A:/mosquitto.org.crt
Sent 100 %

Note

These configurations are persistent, the above instructions are not required after a reboot of the module.