Abeeway Geolocation Kit – Step-by-Step Implementation Guide

Getting Started with Abeeway Geolocation Module Discovery Kit

Implementation Steps

In this activity, you are going to perform two categories of steps. 1st category is to prepare the environment , and 2nd category is to use sample firmware to test functionality on different categories such as BLE, LoRaWAN®, Wi-Fi, GPS, etc.

Hardware setup of Abeeway Geolocation Module.
Download STM32CubeWB firmware package.
Download sample application.
Install STMCubeProgrammer software.
Update the Firmware Upload Service of EVB.
Update the BLE Stack of the Abeeway Geolocation Module.
Upload sample EVB firmware to Abeeway Geolocation Module.
Install Tera Term terminal emulator.
Set and display LoRaWAN® parameters of EVB.
Register Abeeway Geolocation Module to TPC.

Step 1 - Hardware setup of Abeeway Geolocation Module

To be able to access EVB from your computer, you need to :

Unpack the discovery kit and check that all the needed components are there.
Make the necessary antenna and USB connections.

It is important to connect the LoRaWAN® antenna before turning on the EVB board. Because if the LoRaWAN® antenna is not attached when the EVB is powered on, the EVB board could be damaged.

1/ The Abeeway-Murata Module Discovery Kit comes with all the necessary components for you to complete this activity. In addition to the EVB, you will find a USB cable and three receivers (one each for LoRaWAN®, Wi-Fi, and GPS) inside the package.

Please select the icon Tera Term under the Tera Term group to start Tera Term application.

You have three separate antennas, and you need to connect them to the appropriate terminals in the way that is illustrated in the figure. As can be seen, one of the antennas is significantly longer than the other; this particular antenna is a LoRaWAN® antenna. It is essential to connect the LoRaWAN® antenna before powering on the EVB; failing to do so may result in the EVB being damaged.
The EVB has three different USB connections, and in order to configure it, you need to connect it to the third one (USB3). This is demonstrated in the following picture.

As a result of this step, you prepared the EVB to be ready for the rest of the activity.

Step 2 - Download STM32CubeWB Firmware Package

In this step you will:

Download the zip file from ST website
Unpack into any directory to access to files if needed at Step 5 and Step 6

If you already have an account please proceed with your credentials, otherwise you need to register, which is also free.

When you login, product page is shown and download of the file starts at the same time.

Firmware package is a zip file named as en.stm32cubewb-1-15-0.zip After downloading the file, please unpack it into a directory so that you can find the files* when required at firmware upgrade steps (Step 4 and Step 5).

As a result of this step, you have a firmware package ready which contains the firmware binaries to upload to EVB at the later steps (Step 5 and Step 6) of this activity.

*Exact path & name of the files on the package:

FUS: STM32Cube_FW_WB_V1.15.0\Projects\STM32WB_Copro_Wireless_Binaries\STM32WB5x\stm32wb5x_FUS_fw.bin

BLE: STM32Cube_FW_WB_V1.15.0\Projects\STM32WB_Copro_Wireless_Binaries\STM32WB5x\stm32wb5x_BLE_Stack_full_fw.bin

Step 3 - Download Sample Application

In this step, you will:

Download the Geolocation Module SDK package, which is hosted on GitHub.
Unpack into a directory to access the sample application that will be used in Step 7.

You can access the GitHub page of the Geolocation Module SDK from here.

Click on the CODE button
Then select Download ZIP in order to download the repository as a zip file.

The firmware package is a zip file named as abeeway-geolocation-module-master.zip . After downloading the file, please unpack it onto a directory on your machine, so that you can find the compiled demo file* when required at Step 7.

As a result of this activity, you have the GitHub repository copy of the Geolocation Module SDK, which contains the compiled sample application and will be flashed to EVB at later steps of the activity.

*Exact path the compiled demo file in the package:

abeeway-geolocation-module-master\apps\abeeway\app-abw-demo\Release

Step 4 - Install STMCubeProgrammer Software

In this step, you are going to install STMCubeProgrammer, if it is not already installed on your machine. For this step:

You need to download the zip file ST website
Install the STMCubeProgrammer, which is stored in the zip file.

Visit the website that is provided below in order to download the product. This connection, like the one in the preceding step, requires the use of valid log-in information.

After successfully logging in, the product page will load, and you will need to select the Get Software option to download the software.

Select Get latest next to STM32CubeProgrammer software for Win64 label.

To continue with the download of the product, please select the SUBMIT option to indicate that you have read and agreed to the License Agreement.

After accepting the License Agreement download of the product starts. The name of the zip file is stm32cubeprg-win64-v2-12-0.zip.

After the download is completed, you can begin the installation process for the product by double-clicking the SetupSTM32CubeProgrammer win64.exe file.

You can to monitor the downloading of the files as they proceed in real time.

Now that the installation of the product has begun, select the Next button to carry on with the installation.

After you have finished reading the information about the product, you can proceed with the installation by clicking the Next button.

After clicking the Next button, you will need to select the checkbox that says, “I approve the conditions of the license agreement.”

You have the option of using the default directory path for the implementation, which you can approve, or you can modify it as necessary. After that, proceed with the installation by clicking the Next button.

Click OK button if installation directory is correct.

Please select the options to be installed and click the Next button. By the way, default options is sufficient.

You can view the progress of the installation.

In order for the product to function correctly, the STLink drivers need to be installed. Therefore, to begin the installation of the STLink software, click the Next button.

Simply clicking the Finish button at the end of the STLink Driver installation will allow you to continue setting up the remainder of the product.

To proceed with the installation, please select the Next button.

Select the installation options and click the Next button. By the way, using the default options is sufficient.

To complete the product installation, click the Done button when you are finished.

As a result of this activity, you just installed the STMCubeProgrammer application, which will be used to upload firmware and sample application to EVB.

Step 5 - Update the Firmware Upload Service of EVB

In this stage, you will

– Activate FUS (Firmware Upload Service) function on STM32CubeProgrammer
– Make sure the FUS firmware level is checked.
– If it’s necessary, upload the updated FUS firmware.

To use the EVB, you will need to initiate the STM32CubeProgrammer.

Ensure that Under reset and Hardware reset options are selected.
Click the Connect button to access to EVB.

Please notice that the Target Information section has been filled in with data pertaining to the associated MCU (STM32W55), which serves as the central processing unit for the EVB.

At this point, it is possible that you will be required to upgrade the software on the ST-Link. In this scenario, the upgrade can be performed by clicking the “Firmware Install” button.

Click the FUS icon to switch to the FUS screen.

Click the Start FUS button to start FUS Service.

If you get error in this step, do not panic! Just unplug and re-plug the USB cable and reconnect to EVB.

The dialog informs you that FUS has started. Click the OK button to finalize the FUS firmware update.

Simply examine the firmware version of the FUS by clicking the Read FUS infos button in order to determine whether or not an upgrade to the FUS’s software is required.

You will need to replace the FUS software to version V1.2.0.0 if the current FUS version is V1.0.2.0, which is the first available version.
In order to update the FUS service :
-Browse for the file path that points to the file that was downloaded in Step 2.
– File path: path of the stm32wb5x_FUS_fw.bin* file (including file name)
– Start Address: 0x080EC000
Click Firmware Upgrade button to start the FUS firmware upgrade.

Click the View FUS infos button in order to check and see if the FUS software version has been upgraded to V1.2.0.0.

As a result of participating in this task, the STMCubeProgrammer application was successfully installed on your computer. This program will be utilized to transfer example applications and software to EVB.

See Steps 6

Learn about LoRaWAN®

What is LoRaWAN®?

Learn about Actility and ThingPark

Learn about Actility and ThingPark

Build your first end-to-end use case

Build your first end-to-end use case

Application provider

Application provider

Students and Academicians

Students and Academicians

Device maker

Device maker

System integrator

Solutions Partner

Hands on Labs

Application provider

Application provider

Students and Academicians

Students and Academicians

Device maker

Device maker

System integrator

Solutions Partner

Hands on Labs

Getting Started with Abeeway Geolocation Module Discovery Kit

Implementation Steps

Step 1 - Hardware setup of Abeeway Geolocation Module

Step 2 - Download STM32CubeWB Firmware Package

Step 3 - Download Sample Application

Step 4 - Install STMCubeProgrammer Software

Step 5 - Update the Firmware Upload Service of EVB

ThingPark Community

Journey

Actility Websites

About