Skip to main content

System-oriented dashboards for DroneCAN & Cyphal (YAML-powered)

Project description

Tsugite PyPI TestPyPI coverage Downloads

A system-oriented dashboard for Cyphal (CAN + UDP) & DroneCAN. Render live panels from a YAML manifest - so you watch the system, not just the bus.

🪵 “Tsugite” (継ぎ手) - a Japanese word for traditional wood joinery - symbolizes how separate modules fit together into one solid structure, just like nodes in your robotics system.

Why this exists

Most tools are bus-oriented (frames/subjects). Field work needs system-oriented views:

  • “Is my VTOL healthy? Which nodes are missing?
  • "Are critical topics alive?”
  • “Can I monitor it remotely - from my laptop or tablet?”

Tsugite answers with:

  • A YAML system manifest that defines your expected nodes, panels, and topics.
  • A backend that speaks Cyphal (CAN + UDP) & DroneCAN.
  • A desktop GUI (PySide6) that dynamically renders dashboards (More frontends are considered to be added later).

Usage

Latest stable version:

pip install "tsugite[dronecan]"

tsugite --help

Latest test version:

pip install -i https://test.pypi.org/simple/ "tsugite[dronecan]"

For devs:

git clone git@github.com:PonomarevDA/tsugite.git
pip install .[all]

MVP scope

  • Transports: SocketCAN / SLCAN (Linux, macOS, Windows where supported), UDP (Cyphal).
  • Protocols: Cyphal, DroneCAN.
  • YAML manifest: Define nodes, panels, widgets, and data bindings.
  • Widgets: Dynamic system panels with labels, buttons, GPS, and plotting.
  • Node list: Health, uptime, firmware version, voltages, temperature, and bootloader state.
  • Parameters panel: Inspect and modify node parameters.
  • Component QA (Node-level, active): run automated node-level tests to verify firmware, parameters, and behavior compliance — ensuring each device meets specification before deployment.
  • Bus analysis (System-level, passive): review overall system traffic, measure total and per-node bandwidth, and detect missing frames or termination issues — a non-intrusive pre-flight consistency check.
  • CLI launcher: tsugite or python -m tsugite.cli to run the GUI.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tsugite-0.4.1.tar.gz (34.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

tsugite-0.4.1-py3-none-any.whl (38.5 kB view details)

Uploaded Python 3

File details

Details for the file tsugite-0.4.1.tar.gz.

File metadata

  • Download URL: tsugite-0.4.1.tar.gz
  • Upload date:
  • Size: 34.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.3

File hashes

Hashes for tsugite-0.4.1.tar.gz
Algorithm Hash digest
SHA256 62a802762167c80e9a3e0027fbf8d7044056cdcd458e7ad9ad25f14fa1ea25a4
MD5 3e85def7c71df520730e24924af292b5
BLAKE2b-256 16c8f51e4990d6117a3a4173bd40d214dacc673bc5285b5fc3a38a993e9b6318

See more details on using hashes here.

File details

Details for the file tsugite-0.4.1-py3-none-any.whl.

File metadata

  • Download URL: tsugite-0.4.1-py3-none-any.whl
  • Upload date:
  • Size: 38.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.3

File hashes

Hashes for tsugite-0.4.1-py3-none-any.whl
Algorithm Hash digest
SHA256 2275aedaedbecaba4b93b7387c1e157b7a123611d265ac714a46ad5cc1cffc4a
MD5 fa75d5d6b4068f0be16397a3a0f2a4d3
BLAKE2b-256 d2226f1e9818e7b4afb8f9a6adff129815a9247b656f3b69eb2c2607505933db

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page