Zum Inhalt springen

WSAL18233 – MAX-M8Q GNSS HAT/en

Aus JW Tech Wiki

Documentation notice: This technical documentation was independently rewritten from an archived supplier source. Check technical details and commands against the product version and manufacturer documentation before use.

Summary

The Waveshare MAX-M8Q GNSS HAT is a multi-constellation receiver hat for Raspberry Pi supporting GPS, Beidou, Galileo and GLONASS. The document covers positioning principles (GNSS, RTK), hardware connections, serial port configuration, Python examples, and NTP server setup.

Related products at JW Tech

Technical overview

  • GNSS encompasses multiple satellite navigation systems: BDS (China), GLONASS (Russia), GPS (USA), Galileo (Europe), QZSS (Japan) and IRNSS (India).
  • RTK (Real Time Kinematic) enables centimeter-level positioning via differential measurement between base and mobile stations over the mobile network.
  • The MAX-M8Q HAT provides UART, I2C, PPS and INT connections; the INT pin is low-active as a wake-up signal.
  • For Raspberry Pi, the serial port must be enabled via raspi-config: Interfacing Options -> Serial -> No -> Yes, then reboot.
  • The gpsd daemon configuration requires editing /etc/default/gpsd with USBAUTO="false", DEVICES="/dev/ttyS0" and GPSD_OPTIONS="/dev/ttyUSB0".
  • The Python library gps3 is installed via pip3; demo codes are located in ~/Documents/MAX-XXX_GNSS_HAT_Code/RaspberryPi/python/coordinate_converter.
  • For STM32 boards (XNUCLEO-F103RB), connect RXD to P9(TX) and TXD to P10(RX); the project is compiled in Keil and downloaded.
  • NTP server setup uses the module's PPS output; gpiopin=18 is configured in /boot/config.txt.
  • When using Jetson Nano, the serial port /dev/ttyTHS1 is used; minicom at 9600 baud rate checks data.
  • The FAQ notes that BeiDou and Galileo are only visible when NMEA 4.10 output is enabled.

Commands and examples – verify before use: 

sudo raspi-config
sudo apt-get update
sudo apt-get install gpsd gpsd-clients gpsd-tools
sudo pip3 install gps3
sudo nano /etc/default/gpsd
USBAUTO="false"
DEVICES="/dev/ttyS0"
GPSD_OPTIONS="/dev/ttyUSB0"
mkdir ~/Documents/MAX-XXX_GNSS_HAT_Code
cd ~/Documents/MAX-XXX_GNSS_HAT_Code/
wget https://files.waveshare.com/upload/0/0f/MAX-XXX_GNSS_HAT_Code.zip
unzip MAX-XXX_GNSS_HAT_Code.zip
cd ~/Documents/MAX-XXX_GNSS_HAT_Code/RaspberryPi/python/coordinate_converter
sudo python3 main.py
sudo apt-get install git
sudo git clone https://github.com/beta-tester/RPi-GPS-PPS-StratumOne.git
sudo chmod 777 install-gps-pps.sh
sudo nano /boot/config.txt
dtoverlay=pps-gpio,gpiopin=18,capture_clear # /dev/pps0
sudo apt-get install python-serial

Notes and version constraints

  • The source document contains placeholders such as {{{name2}}} through {{{name6}}} and {{{userDefinedInfo}}}, indicating incomplete metadata.
  • The NTP server section mentions NEO-M8T instead of MAX-M8Q; it is unclear whether these steps apply directly to the MAX-M8Q.
  • Demo file URLs use the placeholder 'MAX-XXX' instead of 'MAX-M8Q'; the actual URL must be verified before execution.
  • Compatibility with other Raspberry Pi models (e.g., Pi 5) is not explicitly stated.
  • Exact power supply values (voltage, current draw) are missing from the source text.
  • No information on warranty, certifications, or safety compliance is provided.

Source and revision record

  • MAX-M8Q GNSS HAT - Waveshare Wiki
  • Source revision: 79438
  • Captured: 2026-09-01T03:15:31+00:00
  • SHA-256: a275c90791278ace64b048fb6838be1f201cbabb5f9415b4a4d19fdbf700f98a