Thales IoT Developer Community
Cinterion® Connect Shield: Library
Documentation, October 16, 2017 - 6:50am, 8515 views
Hello Makers!
FInally, we are able to present you our Arduino based library for your Cinterion® Connect Shield.
Examples
This library contains some examples to easily let you start your project idea!
A basic example how to use the Cinterion Connect Shield and register to the network is here avilable:
There are also two more examples, which show how to prepare your sketch for publishing and subscribing MQTT messages:
MQTT Subscribing
Note: To use the MQTT example you need to download and copy the Arduino MQTT library to your libraries.
Start-up
Plug your Cinterion Connect Shield directly on your Arduino. The library uses the pin mapping below.
Therefore you are free to stack some other shields on top.
Next, you should download the library and place it into the directory where you have your other Arduino libraries.
Now you just need to create a new sketch and add:
#include <LTECinterionConnectShield.h>
then, create an object of class:
LTEConnectShieldModemc
and start using it!
MQTT Test
By default in ourMQTT example you will find the https://test.mosquitto.org/ server which for the first steps to get you project running is a good example because you do not need to create an account.
To test if something is published you can use the webinterface from HiveMQ.
Simply add as host : test.mosquitto.org
Use as port: 8080
Add the 'ClientID' and 'Topic' and you can start!
MQTT with Java
Depending on your project it could be usefull to let embedded Java from the ELS61 handle the MQTT connection and other tasks.
The benefit is that you can use the Arduino C code handle the module/ sensors and actors and let Java do the communication to the server/cloud. This idea of sharing resources is pretty common.
For an example check out the article:
Cinterion ELS61 Connect Shield Java Demo
Limitations
The Cinterion Connect Shield as default uses the main serial connection which is also used for Arduino programing.
Therefore, if the LTE device is enabled during Arduino programing (loading a new software) it may brake the transmission and the programing fails.
Please turn off the LTE device for programing - press the ON/OFF button for at least 3 seconds.
Of course the library does not include everything. The main reason is to leave you enough space on your Arduino for your own application. If you desire some additional examples or modifications let us know!
Hello David,
Thank you for the documentation and the examples.
I just received the cinterion shield with an Arduino 101. I tried to follow the steps explained above but I got stuck with the error below when compiling the sketch. Could it be because of the pin number? because I didn't understand to which value should I change it.
I would be really grateful if you can help me figuring this out.
In file included from /tmp/755663708/custom/Cinterion-Connect-Shield-LIB/src/LTEConnectShieldModem.h:34:0,
from /tmp/755663708/custom/Cinterion-Connect-Shield-LIB/src/LTECinterionConnectShield.h:30,
from /tmp/755663708/MqttPubExample/MqttPubExample.ino:38:
/tmp/755663708/custom/Cinterion-Connect-Shield-LIB/src/LTEConnectShieldHwSerial.h:137:2: error: #error No UART found in HardwareSerial.cpp
#error No UART found in HardwareSerial.cpp
^
exit status 1
Hi David
Im not sure if this is the right place to post.
I have received the dev boards - connect shield and set it up on a Arduino UNO.
I have loaded the test applications (tried all of them) but I dont seem to be creating a session with the mobile sim provider.
The SIM is a Telstra SIM with the Jasper portal so I can see anything that happens.
I have set the PIN as #define PIN_NUMBER ""
and the app to const char* apn = "telstra.internet";
The repeated AT+CPIN? lines are a bit suspicious.
any thoughts ?
The serial console gives the following:
ATE0
AT\Q2
AT+CPIN?
AT+CPIN?
AT+COPS=0
AT+CREG?
at^sics=1,"conType","GPRS0"
at^sics=1,"apn","telstra.internet"
at^siss=1,"srvType","Socket"
at^siss=1,"conid","1"
at^siss=1,"address","socktcp://test.mosquitto.org:1883;etx"
AT+CREG?
at+cops=2
AT+CPIN?
AT+COPS=0