The STM32 Discovery pack (P-L496G-CELL02) is an STM32L496AG I6-based low-power Discovery mother board and an STMod+ Cellular 2G/3G worldwide expansion board with antenna. Following this guide you will be able to program the P-L496G-CELL02 Discovery Pack to connect with Ubidots.  

IMPORTANT NOTE: Reference the official documentation for a detailed technical review of the P-L496G-CELL02 device.

1. Insert an activated SIM card into the cellular add-on board.

NOTE: To avoid future connectivity issues we recommend verifing if the SIM card inserted is already unlocked in the region where it will be operating.

2.  Plug the cellular add-on board into the STMod+'s connector of the STM32 Discovery Base Board, as shown below:

3. Check the jumper default positions:

4. Connect the STM32 Discovery base board to a PC using CN5(STLink) USB connector (also to power the board). The LEDs LD5 (PWR) and LD8 (COM) should be illuminated. 

5. Add the STM32 cellular Discovery Pack to the STM32 dashboard using the following steps:

NOTE:  If you are working with Windows make sure the ST Link USB drivers are installed on the PC.

1. Once the board is added to the STM32 Dashboard, scroll down until you find "Precompiled Demos Repositories"

2. Then find "Cellular to Ubidots Cloud Demos" and download the .zip file pressing the respective download button. 

3. Once the .zip file is downloaded, unzipped and confirm the file contains and is similar to that of the below image:  

NOTE: This guide is going to provided all the steps required to integrate the board with Ubidots. To avoid errors, it is advisable to read and become familiar with "What these JS file do" and "readme-CellularToUbidotsCloud." which are included in the zip file that is downloaded when you press the "Precompiled Demos Repositories".

4. To avoid issues with the firewall, the *.JS file in this zip have been renamed as *_JS.txt. Please rename them back to the .js extension before using them with Espruino JS Engine.

The examples provided in the folder is:

1. Download or open the Espruino Web IDE if you already don't have it.

2. Download the up-to-date Espruino firmware for the STM32L496 provided here. The downloaded file should be titled:

Where 1v97.35 is the latest version (as of this articles publication), but can be more recent.

 3. Load the bin file previously downloaded into the STM32L496 Discovery Pack. To load the firmware, follow the next steps:

4. Once the firmware is updated properly into the board. Open the Espruino Web IDE and assign a SandBox if you don't already have it. To select the folder SandBox go to Settings > Project and assign the folder desired. 

Once the folder is assigned, the folders required are going to be a automatically generated, as shown below:

The SandBox is in charge of handling and loading all the requirements of the program, such as modules, firmwares, binary files, etc. 

5. Connect the STM32L496 Discovery to the Espruino Web IDE. To connect the board, press the connection icon located in the upper right part of the IDE:

The board PORT will automatically be detected in the Espruino Web IDE, so select the correct one assigned or that you are working with:  

Wait a couple of seconds until the board is connected properly:
​

6. Open the files meant to be loaded. To open the file, select the folder icon and choose one of the two script provided:

-or–

7. Update the the first part of both .js files

PRO TIP: Also, in order to debug the behavior of the cellular connection, we highly recommend you set the debug to true. For this, you have to modify the following line at the ending of the code (ubidots_MQTT_w_sensors.js or ubidots_REST_w_sensors.js) 

Before:

After:

8. With the parameters updated, send the code to the Espruino by pressing the send icon pictured below:

This process is going to take a couple of minutes so please be patient. 

9. Once the code is properly sent, you should start presenting the behavior below at the debug console of the Espruino Web IDE:

When complete you will find the response lines: "Good luck with Ubidots cloud!" at the bottom of of the connection process. Once an IP address is allocated, your "modem is ready to use."

Now it's time to start your App Development with Ubidots!  
​

If you didn't notice, the first debug messages provided the initialization commands to handle data with Ubidots.

IMPORTANT NOTE: The .js files provided (MQTT and REST) have different initialization commands, so please make sure to use the commands provided based on your file. FYI, the file used in this tutorial is the ubidots_MQTT_w_sensors.js

1. When you get an IP address, install your device and activate the connection token using the following command:

The "MQTT device YOUR_DEVICE_NAME is connected" shall appear on the screen.

2. To publish data to Ubidots, use the following command where the argument is the variable label of the variable desired to be published:

Result: 

3. Then, to subscribe to different topics, use the following command where the argument is the variable label of the variable desired to be subscribed:

As an example, I decided establish the subscription with the variable previously published temperature; resulting in:

As you can see the message received is 23 which was the last value posted in the variable assigned to the command (temperature). 

4. You can start X-NUCLEO-IKS01A1 sensors read-out by
​ SensorStart() with periodic update (30s). After 30 minutes, the SensorStop() deactivates the read-out. To enable updating cloud service with sensor data, call:

Result:

5. At the end of the session, close the connection with:

Now its time to create Ubidots Dashboards to visualize and understand your data to make the best decisions, simply and coherently. 

STMicroelectronics brings freedom and flexibility formass-market developers by configuring IoT devices working over LTE Cat M1/NB1 cellular connectivity. 

The STM32L4 Cellular Discovery Pack is ready to use, out of the box, and developers can quickly start running and customizing sample scripts on the JavaScript engine with no additional investment. If you are thinking of a scalable and robust IoT solution, Ubidots recommends reviewing the X-CUBE-CLD-GEN expansion package, supported by STM32Cube software tools, libraries, middleware, and code examples to accelerate development of C code for optimum performance and positive value creation. 

Happy Developing :)