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
