Quelltext der Seite WSAL18233 – MAX-M8Q GNSS HAT/en

__NOINDEX__
'''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 ==
* [https://shop.jw-tech.eu/p/WSAL18233 WSAL18233 – MAX-M8Q GNSS HAT for Raspberry Pi, Multi-constellation Receiver Support, GPS, Beidou, Galileo, GLONASS]

== 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 -&gt; Serial -&gt; No -&gt; 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:''' 
<syntaxhighlight lang="text">
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
</syntaxhighlight>

== Notes and version constraints ==
* The source document contains placeholders such as &#123;&#123;&#123;name2&#125;&#125;&#125; through &#123;&#123;&#123;name6&#125;&#125;&#125; and &#123;&#123;&#123;userDefinedInfo&#125;&#125;&#125;, 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 ==
* [https://www.waveshare.com/wiki/MAX-M8Q_GNSS_HAT MAX-M8Q GNSS HAT - Waveshare Wiki]
* Source revision: 79438
* Captured: 2026-09-01T03:15:31+00:00
* SHA-256: <code>a275c90791278ace64b048fb6838be1f201cbabb5f9415b4a4d19fdbf700f98a</code>