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

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:

Additional tools

Run these tools from a repository checkout or unpacked source distribution; they are not installed as pip commands.

• Timed I2C observation records communication, fixes and update intervals separately.
• RTCM recording collects and checks I2C observations, with an optional screen launcher.
• Firmware update validates an externally obtained v144 package offline and provides an explicit I2C write mode for the Spresense GNSS Add-on Board. The separate RYS8839 UART updater is experimental; firmware compatibility is unverified.

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.