Cinterion Extended AT Commands

implementing MQTT 3.1.1 Client

Simon Mullenger
January 2019
 What we are talking about today

Overview of the demonstration

Features and Performance at a glance

What equipment is needed

Software set-up
Hardware set-up
Output from the demo

Benefit: Tutorial for AT Command Extending

Benefit: Usable MQTT Client as AT Commands

2 Gemalto Private
 Overview of the demonstration

AT Command Extension showcase on PLS62 / ELS61 / EHSx r4

Allows remote communications with an MQTT broker/server

New AT Command is called AT^SJMQTT

User Guide here:

3 Gemalto Private
 Features and Performance at a glance
AT Commands used to:

Configure Broker and Port

Configure Connection Parameters (APN etc)
Open connection to Broker
Publish MQTT messages to Broker
Display URCs with message received from Broker
Close connection from Broker

Uses new Java AT Command Extension framework (JAT)

Available only on ELS61 rel 1 “MR”*, ELS61 rel 2 and PLS62-W rel 2
Available shortly on EHSx rel 4

* - ELS61 rel 1 “Maintenance Release” => arn28 and arn29 only (not arn26 or arn30)

4 Gemalto Private
 What equipment is needed

To set-up the demo:

laptop with the Module Exchange Suite for (JAR, JAD files)

USB lead and B80 starter kit is ideal

B80 Starter kit - Ordering Number: L30960-N0040-A100

To run the demo a compatible module PLS62/ELS61/EHSx

PLS62-W eval - Ordering number: L30960-N4601-A100
ELS61 rel 2 eval - Ordering number: L30960-N4451-A200
EHS6 rel 4 eval - Ordering number: L30960-N2951-A400

Suitable power supply and SIM card

5 Gemalto Private
 Software set-up
Connect your PC to USB port of the concept board (install drivers if needed)
Use PLSx USB Modem* for AT Commands (terminal such as TeraTerm/ZOC)
Use PLSx USB Port1 for Java output (terminal such as TeraTerm/ZOC)
Use PLSx USB Port2 for coping files to the module (Cinterion MES software).

 Use MES to copy the ATSJMQTT.jar and ATSJMQTT.jad to the module

 Ensure Java application is not running already:
 AT^SJAM=2,”a:/ATSJMQTT.jad”,””

 Install the Java application by AT command: AT^SJAM=0,”a:/ATSJMQTT.jad”,””

 The Java application sends output to the defined Java stdout interface, if configured with:
 AT^SCFG="Userware/Stdout","usb1",,,,"off”

 Run the Java by AT command: AT^SJAM=1,”a:/ATSJMQTT.jad”,”” * - EHSx USB Modem

EHSx USB Port3
EHSx USB Port5

6 Gemalto Private
 The importance of the .JAD file - passing parameters
Java ME 3.2 applications comprise two parts:
Binary .JAR file containing the actual Java application
Text .JAD file containing meta data about the application, such as versioning, size, etc.

You can edit the .JAD file to pass parameters to the application, without having to rebuild it
Add lines such as the following to the .JAD file:

Oracle-MIDlet-Autostart: 1 Allow demo to auto start upon power-up

Oracle-MIDlet-Restart: true
Oracle-MIDlet-Restart-Count: 1000 APN details for your SIM
connParamsSocket: bearer_type=gprs;access_point=internet;username=;password=;timeout=30

broker: tcp://broker.hivemq.com:1883
MQTT broker to connect to for demo
brokerUser: test1
brokerPass: test1
MQTT broker Username and
Password if required

7 Gemalto Private
 Output from the demo, end user AT Command view
+PBREADY

at^sjam=1,"a:/ATSJMQTT.jad",""
OK
^SYSSTART_EXTENDED_AT

at^sjmqtt="tcp://broker.hivemq.com:1883","","","ATSJMQTTDemo","ATSJMQTTDemoListener","bearer_type=gprs;
access_point=internet;username=;password=;timeout=30"
OK

at^sjmqtt="open"
OK
^SJMQTT: 'ATSJMQTTDemoListener'/'Hello, this is a message arriving on the module from the broker'

at^sjmqtt="pub","Sending a message from the module MQTT client to the broker"

OK

at^sjmqtt="close"
OK

at^sjmqtt=“exit"
OK
^SYSSTART

8 Gemalto Private
 What the output looks like – MQTT Dashboard
http://www.mqtt-dashboard.com/

http://www.hivemq.com/demos/websocket-client/

9 Gemalto Private
 What the output looks like – MQTT Web Socket Client
http://www.hivemq.com/demos/websocket-client/
Subscription Topic “ATSJMQTTDemo/#”
Add New Topic Subscription

10 Gemalto Private
 What we are talking about today

Overview of the demonstration

Features and Performance at a glance

What equipment is needed

Software set-up
Hardware set-up
Output from the demo

Benefit: Tutorial for AT Command Extending

Benefit: Usable MQTT Client as AT Commands

11 Gemalto Private