Click here for Cellular overview
1. Introduction
This wiki page contains information to help the user navigate ST Cellular software. When the information is already present in a databrief or a user manual, this wiki redirects to those reference documents. While this wiki does not contain all of the information, it helps you to find it.
2. X-CUBE-CELLULAR versions
Since the initial version V1.0.0 in mid-2018, the software content and hardware support have increased continuously.
The current version V6.0.0 support the following hardware configurations:
P-L496G-CELL02 (Pack with a screenless 32L496GDISCOVERY associated with a STMod+ BG96 Quectel modem)
B-L4S5I-IOT01A (STM32L4+ Discovery kit IoT node)
32L496GDISCOVERY (Discovery kit with STM32L496AG MCU)
STEVAL-STWINKT1 (STWIN SensorTile Wireless Industrial Node development kit and reference design for industrial IoT applications)
B-L462E-CELL1 (Discovery board with T1SE Murata module (STM32 L462, ST4SIM, ALT1250 modem)
X-NUCLEO-STMODA1 (STMod+ connector expansion board for Arduino connectors)
STEVAL-STMODLTE (LTE connectivity expansion board for STMod+ connector compatible evaluation boards)
GM01Q (Monarch GM01Q-STMOD)
For all the HW setup, an application, Cellular_App, is provided. It demonstrates only the Cellular possibilities (no sensors, display ...).
For the STMicroelectronics / Murata setup (L462 / ALT1250), more materials are provided like BSP for sensors, BSP for display, and vertical examples. By vertical it means a complete application that reads sensors, displays information on the screen and exchange data over Cellular with the cloud.
For the complete description of deliveries (software and supported hardware), refer to the release notes included in the X-CUBE package.
3. What is X-CUBE-CELLULAR?
X-CUBE-CELLULAR used for? It is used to allow applications to send and receive data on the cellular network using BSD API sockets.
Remember that through the official web page on X-CUBE-CELLULAR on st.com you have access to multiple resources (software, documents, and so on).
X-CUBE-CELLULAR consists of a set of libraries and application examples for STM32L4 Series MCUs acting as hosts for cellular connectivity applications.
The colors help to understand the different parts, Green for applications, light Blue for Middlewares, dark Blue for HAL, Purple for hardware.
Currently supported STM32 MCU are from L4 family, in the future more families will be added. However it is easy to port the Cellular middleware on other STM32 MCU families.
4. Applications provided
One single application is provided for all the possible Hardware configuration supported as examples, it allows to test the Cellular middleware and contains the following features:
- ECHO to provide an example of connection and data exchanges using the TCP or UDP (connected or not-connected mode) socket protocols. By default one instance of ECHO is started but a second one can be started to test multiple sockets configurations.
- PING to test the access to a remote machine
- Performance to test throughput.
At boot, after Hardware initialization, Cellular App is started and this latter starts the Cellular middleware.
X-CUBE-CELLULAR also contains modular tools such as Command (to interact with the firmware through the terminal) and setup menu (to set parameters in the firmware to avoid a new compilation).
The following hardware setup (B-L462E-CELL1) embeds more than the others. It also bring BSP for sensors and display and a complete IoT application (reads sensors displays information on the screen and use Cellular middleware to exchange with the cloud).
5. What is the getting started user manual?
This user manual is a simple and short document to read first. It explains the basics to: connect the hardware, activate the eSIM, program the on-board firmware and to run it; all this information in less than 10 pages.
6. How to ...
This part is a guideline that describes how to perform the main activities with X-CUBE-CELLULAR. All the information is merged in the X-CUBE-CELLULAR How To Wiki page
7. FAQ
All the frequently-asked questions are listed in the dedicated X-CUBE-CELLULAR F.A.Q page