https://github.com/saradaabura/pygps2
Analyze almost every sentence.
https://github.com/saradaabura/pygps2
gnss gps parser pygps2 python
Last synced: 3 months ago
JSON representation
Analyze almost every sentence.
- Host: GitHub
- URL: https://github.com/saradaabura/pygps2
- Owner: saradaabura
- Created: 2025-03-12T11:20:59.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2026-03-26T06:20:22.000Z (3 months ago)
- Last Synced: 2026-03-27T01:55:57.017Z (3 months ago)
- Topics: gnss, gps, parser, pygps2, python
- Language: Python
- Homepage: https://qiita.com/raspico/items/2c4d4d3308c841006fa2
- Size: 216 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Japanese
# pygps2
このライブラリは自由に使用してください。
# バージョン情報
https://github.com/saradaabura/pygps2/blob/master/Version.md
# 依存ライブラリ (micropython)
- micropython-decimal-number (設定により依存)
### Raspberry Pi PicoやESP32・RPi4などのMicroPython・CPython向けのGPS/NMEA解析ライブラリです。
### 通常のPythonに対応(CPython)しているため、WindowsやLinuxなどの環境でも使用できます。
# 対応センテンス
基本的にすべてのセンテンスに対応しています。
```
GGA:$GNGGA, $GPGGA, $BDGGA
GLL:$GNGLL, $GPGLL, $BDGLL
GSA:$GNGSA, $GPGSA, $BDGSA
GSV:$GPGSV, $BDGSV, $GQGSV, $GLGSV, $GAGSV, $GBGSV
RMC:$GNRMC, $GPRMC, $BDRMC
VTG:$GNVTG, $GPVTG, $BDVTG
GST:$GNGST, $GPGST, $BDGST
DHV:$GNDHV, $GPDHV, $BDDHV
ZDA:$GNZDA, $GPZDA, $BDZDA
TXT:$GNTXT, $GPTXT, $BDTXT
```
# MicroPythonでの使い方
examples/for_micropython.py環境にあったサンプルコード(Raspberry Pi Pico用)があります。
**サンプルを実行し、環境で動作を確認してからプログラムをつくることをおすすめします。**
# CPythonでの使い方
examples/for_cpython_example.pyというサンプルコード(Windows用)を使います。
**サンプルを実行し、環境で動作を確認してからプログラムを制作することをおすすめします。**
```python:main.py
import threading
import serial
import time
from pygps2 import pygps2
class GPSReader:
def __init__(self, port="COM6", baud=460800):
self.port = port
self.baud = baud
self.running = False
self.thread = None
self.gps = pygps2()
self.lock = threading.Lock()
def start(self):
self.running = True
self.thread = threading.Thread(target=self._loop, daemon=True)
self.thread.start()
def stop(self):
self.running = False
if self.thread:
self.thread.join()
def _loop(self):
try:
ser = serial.Serial(self.port, self.baud, timeout=1)
except Exception as e:
print("Serial open error:", e)
return
print(f"[GPSReader] Reading {self.port} @ {self.baud}")
while self.running:
try:
line = ser.readline().decode(errors="ignore").strip()
if not line:
continue
with self.lock:
self.gps.analyze_sentence(line)
except Exception as e:
print("Error in GPS thread:", e)
ser.close()
print("[GPSReader] Stopped")
def get(self, key):
with self.lock:
return getattr(self.gps, key, None)
if __name__ == "__main__":
gps_reader = GPSReader("COM6", 460800)
gps_reader.start()
try:
while True:
rmc = gps_reader.get("RMC"); gsv = gps_reader.get("GSV")
if rmc:
print("Lat:", rmc["latitude"], "Lon:", rmc["longitude"])
if gsv:
print("GPS:", gsv["GP"]["num_satellites"] if gsv["GP"] else 0,
"BD:", gsv["GB"]["num_satellites"] if gsv["GB"] else 0,
"GA:", gsv["GA"]["num_satellites"] if gsv["GA"] else 0)
time.sleep(1)
except KeyboardInterrupt:
print("Stopping...")
gps_reader.stop()
```
Serialのポートとボーレートは環境に合わせて変更してください。
# 動作確認済み環境
- CPython (Python3.14)
- Windows11 Linux(Raspberry Pi Zero 2W with DietPi)
- Raspberry Pi Pico 2
- MicroPython v1.24.1 on 2024-11-29; Raspberry Pi Pico2 with RP2350
- MicroPython v1.27.0 on 2025-12-09; Raspberry Pi Pico2 with RP2350
- ESP32-DevKitC-VE ESP32-WROVER-E開発ボード 8MB
- MicroPython v1.27.0 on 2025-12-09; Generic ESP32 module with SPIRAM with ESP32
- GPSモジュール: AT6668 (M5Stack GPSモジュールv1.1)
- GPSモジュール: AT6558 (Air530Z)
- GPS受信機: GT-505GGBL5-DR-N(秋月電子)
ジェネリック
- Python3 serialが使えること
- NMEA0183をUARTで受信できること
**マシンパワーがあまりにも低いと解析できないおそれはある。(マイコンでは動くのでCpyでも大丈夫だと思う)**
# 問題
- 速いボーレートでは処理が追いつかず、すべて解析できないことがある。推奨は115200bps
- ESP32だと処理が追いつかず、センテンスを解析できない。たまに解析できる。bufの問題だと思う。