rpi-cxd56xx-gnss
pip install rpi-cxd56xx-gnss
English | 日本語
Sony CXD56xx GNSS receivers on Raspberry Pi: a Linux I2C driver, Python bindings
and a command-line reader. Read position, altitude, speed, heading, satellite
data and UTC time with the CXD56xx class or cxd56xx-gnss command.
The installed Python API and CLI support I2C only.
Requires Linux, Python 3.13+ and libgpiod 2.0+. Packages are built from source on the target system; Raspberry Pi OS Trixie or later is recommended.
Quick start
Follow the hardware setup to connect SDA, SCL and IRQIN through 1.8 V level shifting, enable I2C at 400 kHz, and grant I2C/GPIO access.
sudo apt install build-essential python3-dev python3-venv libgpiod-dev gpiod
python3 -m venv .venv
. .venv/bin/activate
CXD56XX_GPIO_CHIP=/dev/gpiochip0 python -m pip install --no-cache-dir rpi-cxd56xx-gnss
cxd56xx-gnss
Replace /dev/gpiochip0 with the chip containing your interrupt GPIO, identified
using gpiodetect and gpioinfo. The default is /dev/gpiochip4, line offset
17. The chip is selected at build time; changing it requires reinstalling.
Press Ctrl+C to stop the reader.
Tested I2C hardware
| Board | Chip | Bands | Validation |
|---|---|---|---|
| Spresense GNSS Add-on Board | CXD5610GF | L1 + L5 | 3D fix confirmed on Pi Zero 2 W |
CXD5605 I2C compatibility is unverified.
Standalone UART example
The repository includes a separate pySerial UART example
for startup commands, band selection and raw NMEA output. It is not installed
by pip and does not use the CXD56xx API.
UART connections have been tested with these boards:
| Board | Chip | Bands |
|---|---|---|
| REYAX RYS8833_Lite | CXD5605AGF | L1 |
| REYAX RYS8839_Lite | CXD5610GF | L1 + L5 |
Documentation
- Setup — wiring diagrams, pin mapping, I2C clock and GPIO settings.
- Python and C API — examples, properties and building from a checkout.
- UART example — standalone pySerial usage, startup commands and band selection.
- Releasing — GitHub, TestPyPI and PyPI publishing.
License and origin
Apache License 2.0. Extracted from Pi Zero Bikecomputer into a standalone library, which the original application now uses as an external package. Includes code adapted from Apache NuttX; see NOTICE and THIRD_PARTY.md. This is an independent project, unaffiliated with Sony or the Apache Software Foundation.
1 maintainer
Metadata
1 maintainer
Release files for rpi-cxd56xx-gnss 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| rpi_cxd56xx_gnss-0.1.0.tar.gz | 194.2 kB | Details |
Release files / rpi_cxd56xx_gnss-0.1.0.tar.gz
| Download URL | rpi_cxd56xx_gnss-0.1.0.tar.gz |
|---|---|
| Size | 194.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9225efc5cf07ee8abf571fce10d3679dde881e4907b24248180f491a83cfa6a0
|
|
BLAKE2b-256 checksum How to use checksums |
616ef36ee2add767d457899dc3c9afd9dcc4e082d4f79795ebaf87e96995b520
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 7, 2026.
Transparency log
