Published October 20, 2023 © MIT

Using Raspberry Pi with Hexabitz GNSS Module

This project aims to GNSS data transfer and display by integrating a GNSS module and an Ethernet module.

IntermediateWork in progress2 hours163

Using Raspberry Pi with Hexabitz GNSS Module

Things used in this project

Hardware components

Raspberry Pi 3 Model B+

DFRobot 7'' HDMI Display with Capacitive Touchscreen

Hexabitz 4-Pin USB-Serial Prototype Cable

Hexabitz BitzClamp

Hexabitz 10Base-T Ethernet (H1DR5x)

Hexabitz SAM-M10Q GNSS (H1FR5x)

Hexabitz 3.3V/1A DC-DC Power Supply Module (H03R00)

Ethernet Cable, Cat6a

Jumper wires (generic)

Software apps and online services

STMicroelectronics STM32CUBEPROG

Hand tools and fabrication machines

Soldering iron (generic)

Solder Wire, Lead Free

Story

The project aims to GPS data transfer and display by integrating a GPS module and an Ethernet module. By utilizing an Ethernet cable, we will seamlessly transmit GPS data to the Raspberry Pi, where it will be processed and displayed in a user-friendly format.

You can create a remote data monitoring system using Raspberry Pi, Ethernet and GNSS module. The system could be set up to monitor and transmit data from a remote location such as between front of car and the raspberry pi at the dashboard. The Raspberry Pi could be connected to the GNSS module via Ethernet and programmed to transmit the data over the internet to a central server for analysis or at the same Raspberry Pi.

Car Dashboard

Or you can create a multi-sensor monitoring system using a Raspberry Pi and Ethernet. The system can be designed to monitor multiple sensors such as temperature, humidity, pressure, light levels and a GNSS module. The Raspberry Pi can be connected to the sensor array via Ethernet and programmed to collect data and transmit it to a central server for analysis or processing within the Raspberry Pi itself before sending it. This type of system can be useful in industries such as agriculture, where monitoring environmental conditions is critical to crop growth and productivity. The weather can also be predicted in advance based on the region in which the system is located.

Multi-sensor Monitoring System Using a Raspberry Pi

We can also use the GNSS module to build a clock interface based on UTC data.

Using a GNSS module to set the correct time for the Raspberry PI without a network. Learn more: https://www.haraldkreuzer.net/en/news/using-gps-module-set-correct-time-raspberry-pi-3-a-plus-without-network

Using a GNSS module to set the correct time for the Raspberry PI without a network.

u‑blox’s range of precision timing modules

Key Features:

1. Enhanced Data Transfer: Our system ensures reliable and high-speed data transfer between the GPS module and Raspberry Pi through the use of Ethernet technology.

2. Real-time Tracking: With our project, users can track their location in real-time, making it ideal for navigation systems, fleet management, or outdoor activities.

3. Seamless Integration: The integration of the GPS module with the Raspberry Pi allows for easy integration into existing projects or systems.

4. User-friendly Display: The collected GPS data will be presented in a visually appealing format on the Raspberry Pi's display, providing users with clear and concise information.

5. Expandable Functionality: Our project is designed to be expandable, allowing for additional features such as mapping, geofencing, or data logging to be incorporated in future iterations.

Benefits:

1. Cost-effective Solution: By utilizing readily available components like the Raspberry Pi and Ethernet modules, our project offers a cost-effective alternative to traditional GPS systems.

2. Improved Accuracy: The combination of GNSS technology with the processing power of the Raspberry Pi ensures accurate positioning information.

3. Versatile Applications: Our system can be applied in various fields such as transportation, agriculture, or personal tracking devices.

4. Open-source Platform: As an open-source platform, our project encourages collaboration and customization by providing access to its source code.

By implementing this enhanced GNSS data transfer and display system using Ethernet for Raspberry Pi, we aim to provide users with a reliable and user-friendly solution that opens up new possibilities for location-based applications.

What is GNSS?

GNSS - Global Navigation Satellite System

GNSS is a general term describing any satellite constellation that provides positioning, navigation, and timing (PNT) services on a global or regional basis. While GPS is the most prevalent GNSS, other nations are fielding, or have fielded, their own systems to provide complementary, independent PNT capability. The main ones to know are BeiDou, Galileo, GLONASS, IRNSS, and QZSS. Learn more Here.

GPS is just one of many GNSSs!

UDP Communication:

User Datagram Protocol (UDP) refers to a protocol used for communication throughout the internet. It is specifically chosen for time-sensitive applications like gaming, playing videos, or Domain Name System (DNS) lookups.

Used for simple request-response communication when the size of data is less and hence there is lesser concern about flow and error control.
It is a suitable protocol for multicasting as UDP supports packet switching.
Normally used for real-time applications which can not tolerate uneven delays between sections of a received message.

Learn more:

https://wiki.python.org/moin/UdpCommunication

https://www.geeksforgeeks.org/differences-between-tcp-and-udp/

Hexabitz 10Base-T Ethernet Module (H1DR5): 10Base-T Ethernet module plays a crucial role in enabling devices to communicate over Ethernet networks using the 10Base-T standard. It provides the necessary hardware support for data transmission and reception, ensuring reliable and efficient network connectivity.

10Base-T Ethernet module

SAM-M10Q GNSS (H1FR5x): H1FR5x is a SAM-M10Q GNSS module based on the STM32G0 MCU.

SAM-M10Q GNSS (H1FR5x)

This module this a compact and high-performance Global Navigation Satellite System (GNSS) receiver. It is designed to provide accurate positioning, navigation, and timing information for various applications.

SAM-M10Q GNSS (H1FR5x)

The module features a built-in antenna, which eliminates the need for an external antenna. This makes it easy to integrate into devices with limited space or those requiring a simplified installation process.

The SAM-M10Q supports multiple GNSS constellations, including GPS, GLONASS, Galileo, and QZSS. This allows for enhanced positioning accuracy and reliability, even in challenging environments.

With its high update rate of up to 10 Hz, the module can provide real-time position updates for dynamic applications such as vehicle tracking, UAVs, and robotics.

1 / 2 • SAM-M10Q

Step-by-Step Instructions:

1. Setting up the Raspberry Pi:

Enter the IP addresses into the relevant fields. Your desired IP address will be in the IPv4 field. Your router's IP and DNS server's IP will be in the fields named after them.

Click Apply, close the window and reboot your Pi. Your Pi will now attempt to use your desired IP address at each boot.

2. Plan the array and assemble the hardware:

We prepare the project components and plan our array design by aligning modules side-by-side. Then we solder the modules together using Hexabitz Fixture.

Hexabitz Array Block Diagram

3.Writing codes with STM32CubeIDE software:

Check out this article for writing code with STM32CubeIDE.

· Fixed topology file: Inter-array communication in Hexabitz is done using a routing table stored in a special header (.h) file. This header file describes the number of modules and how they are connected to each other as well as other important information for the array; hence, it is called a topology header file. Currently, you need to make a topology file manually.

After creating the topology for the two modules and determining their configurations, we add the topology for each module. See this link for help in creating a topology file. Then go to project.h and UN-comment the header.

H1DR5 Firmware main.c code:

In this module we adjust the settings for the ethernet:

uint8_t myGateway[4]={192,168,1,100};
uint8_t mySubnet[4]={255,255,255,0};
uint8_t myIP[4]={192,168,1,101};
uint8_t Mac_addres[6]={0x07,0x6,0x2,0x3,0x4,0x5};

Set Local_Mac_addr:

Set_Local_mac_addr(Mac_addres); // Mac_addr ethernet

Set_Local_IP:

Set_Local_IP(myIP);

Set_SubnetMask:

Set_SubnetMask(mySubnet);

Set_Remote_IP:

Set_Remote_IP(myGateway);

Set_Local_PORT:

Set_Local_PORT(35);

Set_Remote_PORT:

Set_Remote_PORT(34);

Set_reseve_mac_and_ip_Remote:

Set_reseve_mac_and_ip_Remote();

H1FR5 Firmware main.c code:

Get coordinates on the Earth's surface (Longtude, Latitude) in degree.

(Longtudeindicator, Latitudeindicator) North(N), South(S), East(E), West(W).

Latitudes are horizontal lines that measure distance north or south of the equator. Longitudes are vertical lines that measure distance east or west of the meridian in Greenwich. Latitude and longitude are both measured in degrees (°)

Get UTC time(hour, minute, second).
Get Speed Over Ground(Km/h, Knot).
Get Height Above Sea Level(m).

GetPosition(&longdegree, &latdegree, &longindicator, &latindicator);
GetUTC();
GetSpeed(&speedknot, &speedkm);
GetHeight(&height);

And this API must call inside while loop in order to process data which comes from GPS

GPSHandel();

4. Writing Python Code:

You can start Python3 from the command line (with python3) then

import tkinter

If you get an error message then exit out of Python3 and call

sudo apt-get install python3-tk

to install it.

5. Testing the System 🛰️📡🌟🕰️😃🚩🧩🗺️🔎📌📍🌍

Terminal Test

The Project GUI Test

1 / 2

The Project GUI

1 / 3

Code

/*
 BitzOS (BOS) V0.2.9 - Copyright (C) 2017-2023 Hexabitz
 All rights reserved

 File Name     : main.c
 Description   : Main program body.
 */
/* Includes ------------------------------------------------------------------*/
#include "BOS.h"
#include "SAM_M8Q.h"
/* Private variables ---------------------------------------------------------*/

/* Private function prototypes -----------------------------------------------*/

/* Main function ------------------------------------------------------------*/
float longdegree, latdegree, speedknot, speedkm;
char longindicator,latindicator;
uint8_t hours, min, sec;
char data_to_send[10];
char data_to_send1[16];
float height;
int main(void){

	Module_Init();		//Initialize Module &  BitzOS

	//Don't place your code here.
	for(;;){

		}
}

/*-----------------------------------------------------------*/

/* User Task */
void UserTask(void *argument){


	// put your code here, to run repeatedly.
	while(1){

		GPSHandel();
		GetPosition(&longdegree, &latdegree, &longindicator, &latindicator);
		//	GetUTC();
		GetSpeed(&speedknot, &speedkm);
		GetHeight(&height);



	sprintf(data_to_send," - Latitude: %d.%d\n",latdegree);

						messageParams[0] = 8; //length
						memcpy(&messageParams[1],&data_to_send,8);
						SendMessageToModule(2,CODE_H1DR5_Ethernet_Send_Data,9);
						Delay_ms(20);
						IND_blink(50);

	sprintf(data_to_send," - Longitude: %d.%d\n",longdegree);

						messageParams[0] = 8; //length
						memcpy(&messageParams[1],&data_to_send,8);
						SendMessageToModule(2,CODE_H1DR5_Ethernet_Send_Data,9);
						Delay_ms(20);
						IND_blink(50);
	sprintf(data_to_send1," - Speed in km/h: %d.%06d\n",speedkm);

						messageParams[0] = 8; //length
						memcpy(&messageParams[1],&data_to_send1,8);
						SendMessageToModule(2,CODE_H1DR5_Ethernet_Send_Data,9);
						Delay_ms(20);
						IND_blink(50);

	sprintf(data_to_send1," - UTC Time: %02d.%02d.%02d:%02d\n",hours, min, sec);

						messageParams[0] = 8; //length
						memcpy(&messageParams[1],&data_to_send1,8);
						SendMessageToModule(2,CODE_H1DR5_Ethernet_Send_Data,9);
						Delay_ms(20);
						IND_blink(50);

	}
}

/*-----------------------------------------------------------*/

/*
 BitzOS (BOS) V0.2.9 - Copyright (C) 2017-2023 Hexabitz
 All rights reserved

 File Name     : main.c
 Description   : Main program body.
 */
/* Includes ------------------------------------------------------------------*/
#include "BOS.h"


/* Private variables ---------------------------------------------------------*/
    uint8_t myGateway[4]={192,168,1,100};
	uint8_t mySubnet[4]={255,255,255,0};
	uint8_t myIP[4]={192,168,1,101};
	uint8_t Mac_addres[6]={0x07,0x6,0x2,0x3,0x4,0x5};

/* Private function prototypes -----------------------------------------------*/
	//uint8_t Mac_addres[6]={0xb8,0x27,0xeb,0xfd,0x80,0x64};

/* Main function ------------------------------------------------------------*/

int main(void){
	Set_Local_mac_addr(Mac_addres); // Mac_addr ethernet

	Module_Init();		//Initialize Module &  BitzOS

	//Don't place your code here.
	for(;;){}
}

/*-----------------------------------------------------------*/

/* User Task */
void UserTask(void *argument){
	Set_Local_IP(myIP);  // ip ethernet
	Set_SubnetMask(mySubnet);	// SubnetMask laptop
	Set_Remote_IP(myGateway); //ip laptop
	Set_Local_PORT(35);// port ethernet
	Set_Remote_PORT(34);//port laptop
    Set_reseve_mac_and_ip_Remote();

	// Defalt_Value();
		// put your code here, to run repeatedly.
	while(1){


	}
}

/*-----------------------------------------------------------*/

/*
 BitzOS (BOS) V0.2.9 - Copyright (C) 2017-2023 Hexabitz
 All rights reserved

 File Name     : topology.h
 Description   : Array topology definition.

 */

/* Define to prevent recursive inclusion -------------------------------------*/
#ifndef __topology_H
#define __topology_H
#ifdef __cplusplus
 extern "C" {
#endif

/* Includes ------------------------------------------------------------------*/
#include "stm32g0xx_hal.h"

#define __N	2					// Number of array modules

// Array modules
#define _mod1	1<<3
#define _mod2	2<<3

// Topology
static uint16_t array[__N ][7] ={
	{_H1FR5,  0, 0, _mod2 | P5, 0, 0, 0}, 								 // Module 1
	{_H1DR5,0, 0,0, 0, _mod1 | P3, 0},					    			 // Module 2
};

// Configurations for duplex serial ports
#if ( _module == 1 )
	#define	H1FR5	1
	#define	_P1pol_normal	1
	#define	_P2pol_normal	1
	#define	_P3pol_normal	1
	#define	_P4pol_normal	1
	#define	_P5pol_normal	1
	#define	_P6pol_normal	1
#endif

#if ( _module == 2 )
	#define	H1DR5			1
	#define	_P1pol_normal	1
	#define	_P2pol_normal	1
	#define	_P3pol_normal	1
	#define	_P4pol_normal	1
	#define	_P5pol_reversed	1
	#define	_P6pol_normal	1

#endif


#ifdef __cplusplus
}
#endif
#endif /*__ topology_H */

/************************ (C) COPYRIGHT HEXABITZ *****END OF FILE****/

import tkinter as tk
# Create GUI window
root = tk.Tk()
root.title('Hexabitz GNSS Data')
root.geometry('800x300')
root.config(bg= "whitesmoke")   
# Create labels to display data
q_label = tk.Label(root, text='Using Raspberry Pi with Hexabitz GNSS Module',fg="deeppink",bg="whitesmoke", font=('Trebuchet MS', 22, 'bold'))
utc_label = tk.Label(root, text='UTC: ',fg="navy", font=('Trebuchet MS', 36, 'bold'))
lat_label = tk.Label(root, text='Latitude: ',fg="gold", font=("Helvetica", 36, 'bold'))
lon_label = tk.Label(root, text='Longitude: ',fg="dark green", font=("Helvetica", 36, 'bold'))
Speed_label = tk.Label(root, text='Speed: ',fg="limegreen", font=("Helvetica", 36, 'bold'))
# Position labels in window
q_label.pack()
utc_label.pack()
lat_label.pack()
lon_label.pack()
Speed_label.pack()

# Function to update labels with new data
def update_data():
    # Read data from GNSS module  
    # Update labels with new data
    utc_label.config(text='UTC: ' + str(12.00), fg="navy",bg="whitesmoke", font=('Trebuchet MS', 36, 'bold'))
    lat_label.config(text='Latitude: ' + str(00),fg="gold",bg="whitesmoke", font=("Helvetica", 36, 'bold'))
    lon_label.config(text='Longitude: ' + str(00),fg="dark green",bg="whitesmoke", font=("Helvetica", 36, 'bold'))
    Speed_label.config(text='Speed: ' + str(00),fg="limegreen",bg="whitesmoke", font=("Helvetica", 36, 'bold'))
    # Schedule next update in 1 second
    root.after(1000, update_data)

# Start updating labels with new data
update_data()

# Start GUI main loop
root.mainloop()