The META-ST-X-LINUX-GNSS1 is a Yocto Recipe for GNSS and IMU application for OpenSTLinux for STM32MP157F-DK2 Board.This recipe provides the Yocto Recipes for GNSS , RTK (Real-time kinematic) Library using X-STM32MP-GNSS1 board plugged to the 40 Pin Connector of the STM32MP157F-DK2 Discovery Board . Detailed User Guide "X-LINUX-GNSS1 package for developing GNSS Applications on Linux" can be foudn here : https://www.st.com/resource/en/user_manual/um2909-getting-started-with-xlinuxgnss1-package-for-developing-gnss-applications-on-linux-os-stmicroelectronics.pdf"
The META-ST-X-LINUX-GNSS1 is a Yocto Recipe for GNSS and IMU application for OpenSTLinux for STM32MP157F-DK2 Board.This recipe provides the Yocto Recipes for GNSS , RTK (Real-time kinematic) Library using X-STM32MP-GNSS1 board plugged to the 40 Pin Connector of the STM32MP157F-DK2 Discovery Board .
Its main feature are :
meta-st-x-linux-gnss1: Yocto Recipe for Reading NMEA GNSS data and enabling IMU and Environmental Sensors meta-st-x-linux-gnss1-rtklib : Yocto Recipe for Enabling Real Time Kinematics (RTK) data using RTCM Messages on Teseo-LIV3F module board meta-st-x-linux-gnss1-ekf : Yocto Recipe for Enabling IMU +GNSS fusion using EKF.
The software uses the OpenSTLinux UART and I2C Driver to interact with the Teseo-LIV3FL GNSS modules on X-STM32MP-GNSS1 board. for meta-st-x-linux-gnss1 : The Yocto recipe creates the gnss_app application as a part of system image which can be flashed to the STM32MPU for meta-st-x-linux-gnss1-rtklib : The Yocto recipe creates the RTK lib application along with the QT based application as a part of system image which can be flashed to the STM32MPU for meta-st-x-linux-gnss1-ekf : The Yocto recipe creates ekf commandline application as a part of system image which can be flashed to the STM32MPU
---meta-st-x-linux-gnss1
¦ LICENSES.html
¦ README.md
¦ Release_Notes.md
¦
+---Layers
¦ +---meta-st-x-linux-gnss1
¦ ¦ ¦ README.md
¦ ¦ ¦
¦ ¦ +---meta-gnss1
¦ ¦ ¦ COPYING.MIT
¦ ¦ ¦
¦ ¦ +---conf
¦ ¦ ¦ layer.conf
¦ ¦ ¦
¦ ¦ +---recipes-gnss1
¦ ¦ ¦ +---gnss1(recipe file for gnss app)
¦ ¦ ¦ gnss1_0.1.bb
¦ ¦ ¦ gnss1_0.1.bbappend
¦ ¦ ¦
¦ ¦ +---recipes-kernel
¦ ¦ +---linux
¦ ¦ ¦ linux-stm32mp_%.bbappend
¦ ¦ ¦
¦ ¦ +---linux-stm32mp
¦ ¦ +---stm32mp1
¦ ¦ ¦ -Kernel patches
¦ ¦ ¦
¦ ¦ +---5.15
¦ ¦ fragment-07-X-STM32MP_full.config
¦ ¦
¦ +---meta-st-x-linux-gnss1-rtklib
¦ ¦ ¦ README.md
¦ ¦ ¦
¦ ¦ +---meta-gnss1-rtklib
¦ ¦ +---conf
¦ ¦ ¦ layer.conf
¦ ¦ ¦
¦ ¦ +---recipes-gnss1-rtklib
¦ ¦ ¦ +---gnss1-rtklib
¦ ¦ ¦ ¦ gnss1-rtklib_0.1.bb ( recipe file for RTK Lib)
¦ ¦ ¦ ¦
¦ ¦ ¦ +---files
¦ ¦ ¦ ¦ rtklib_stm32mp1.patch
¦ ¦ ¦ ¦
¦ ¦ ¦ +---shell_scripts_icons
¦ ¦ ¦ -icons and logos
¦ ¦ ¦
¦ ¦ +---recipes-kernel
¦ ¦ +---linux
¦ ¦ -recipe files
¦ ¦
¦ +---meta-st-x-linux-gnss1-ekf
¦ ¦ ¦ README.md
¦ ¦ ¦
¦ ¦ +---meta-gnss1-ekf
¦ ¦ +---conf
¦ ¦ ¦ layer.conf
¦ ¦ ¦
¦ ¦ +---recipes-gnss1-ekf
¦ ¦ +---gnss1-ekf
¦ ¦ ¦ gnss1-ekf_0.1.bb ( recipe file for ekf cmdline app)
¦ ¦ ¦
¦ ¦ +---files
¦ ¦ -ekf patch and python scripts for visualization
¦ ¦
+---¦ _htmresc
¦ -Logos
¦
The current package provides software support for the following boards
- X-STM32MP-GNSSx board mounted on STM32MP157F-DK2 based on Teseo-LIV3FL or Teseo-LIV4FL.
- The board is also compatible with X-NUCLEO-GNSSx and X-NUCLEO-LIV* boards plugged to the Arduino Connectors
The section describes the software setup that is required for building, flashing, deploying, and running the application.
A Linux® PC running Ubuntu® 20.04 or 22.04 is recommended. Developers can follow the link below for details. https://wiki.st.com/stm32mpu/wiki/PC_prerequisites
Follow the instructions on the ST wiki page Image flashing to prepare a bootable SD card with the starter package.
Alternatively, a Windows / Mac computer can also be used; in that case, the following tools would be useful:
- Use STM32CubeProgrammer to flash the OpenSTLinux started package image onto the SD card
- Use TeraTerm or PuTTY to access the console interface via USB
- Use winscp to copy the application to the MPU board
The following conventions are used when referring to the code instructions.
#Comments: Comment describing steps
PC>$ : Development or Host PC/machine command prompt. Text after $ is a command
Board>$ : STM32MP1 command prompt. Text after $ is a command
STMPU Software Prerequisites
-NA
It is required to transfer the built binaries, Python scripts, and application resources to the STM32MP board from the development PC.
The resources can be transferred via any of the following methods:
- Using a network connection
Refer to How to Transfer a File Over a Network
To connect the MPU board to a network, you may connect it to a wired network via the Ethernet jack on the MPU board.
OR
To connect to a WLAN, refer to How to Setup a WLAN Connection"
- Using a serial protocol (like zmodem from Teraterm or kermit)
For Linux hosts refer to How to transfer a file over a serial console
For Windows hosts, refer to
How to transfer files to Discovery kit using Tera Term
To evaluate the X-LINUX-GNSS1 package quickly, developers may copy the contents of the "application/Binaries" folder contained in the package to /usr/local/demo/application folder on the STM32MP board using any of the above methods.
# Go to the application folder and scp/push the binary to STM32MPU using zmodem or scp command
Then execute the below command in the STM32MPU
Board>$ chmod +x <binary_name>
# Run the binary
Board>$ ./<binary_name>Details about the terms under which various components are licensed are available here
Details about the content of this release are available in the release note here.
The software package is validated for the OpenSTLinux version 5.0. For running the software on other ecosystem versions customization may be needed. The software is tested on the STM32MP157F-DK2 board.