Skip to content
/ nxscli Public

A command-line client to the Apache NuttX NxScope real-time logging module

License

Notifications You must be signed in to change notification settings

railab/nxscli

Repository files navigation

Nxscli

master workflow

Nxscli is a command-line client package for the Apache NuttX NxScope real-time logging module.

Compatible with Python 3.10+.

Features

  • Plugins architecture, extendable through nxscli.extensions entrypoint
  • Client-based triggering (global and per-channel triggers)
  • Save data to CSV files
  • Print samples
  • Stream data over UDP (compatible with PlotJuggler)
  • NxScope protocol via serial port or Segger RTT interface

Features Planned

  • More triggering types
  • Boolean operations on triggers
  • Virtual channels and math operations on channels data
  • Improve pdevinfo output (human-readable prints)
  • Interactive mode

Plugins

By default, we only support features that depend on the standard Python libraries. The functionality is expadned by installing plugins. Plugins are automatically deteceted by Nxscli.

Available plugins:

Plugins Planned

  • Stream data as audio (inspired by audio knock detection systems)
  • PyQtGraph support

Instalation

Nxscli can be installed by running pip install nxscli.

To install latest development version, use:

pip install git+https://github.com/railab/nxscli.git

Usage

Look at docs/usage.

Contributing

All contributions are welcome to this project.

To get started with developing Nxscli, see CONTRIBUTING.md.