sergiotarxz/nuttx-apps
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
c86b154677
nuttx-apps/logging/nxscope
History
Xiang Xiao 86080a110e apps: Remove the check of CONFIG_SERIAL_TERMIOS 
If the code only change c_oflag, c_iflag and c_lflag, not c_cflag in termios.
Follow up the change from kernel: https://github.com/apache/nuttx/pull/8843

Signed-off-by: Xiang Xiao <xiaoxiang@xiaomi.com>
2023-03-19 14:53:44 -06:00
..
Kconfig apps: Remove the check of CONFIG_SERIAL_TERMIOS 2023-03-19 14:53:44 -06:00
Make.defs add the NxScope library - a real-time data logging tool 2022-12-28 01:40:24 +08:00
Makefile add the NxScope library - a real-time data logging tool 2022-12-28 01:40:24 +08:00
nxscope_chan.c nxscope: use the entire reserved channel length when sending strings 2023-02-08 10:29:28 +08:00
nxscope_idummy.c add the NxScope library - a real-time data logging tool 2022-12-28 01:40:24 +08:00
nxscope_internals.c add the NxScope library - a real-time data logging tool 2022-12-28 01:40:24 +08:00
nxscope_internals.h add the NxScope library - a real-time data logging tool 2022-12-28 01:40:24 +08:00
nxscope_iser.c apps: Remove the check of CONFIG_SERIAL_TERMIOS 2023-03-19 14:53:44 -06:00
nxscope_pser.c add the NxScope library - a real-time data logging tool 2022-12-28 01:40:24 +08:00
nxscope.c add the NxScope library - a real-time data logging tool 2022-12-28 01:40:24 +08:00
README.md logging/nxscope: add a mention of available client tools for NxScope 2023-02-27 16:04:46 +08:00

README.md

NxScope Library

This library provides real-time data logging functionality for NuttX.

The principle of action is to accumulate data gathered in virtual channels and periodically send buffered data through a dedicated interface packed with a custom protocol.

Supported features:

  • up to 255 channels possible
  • support for standard data types and user-specific data (enum nxscope_sample_dtype_e)
  • support for vector data or point data
  • support for character-based channels (text messages)
  • support for channel metadata - can be used to enumerate samples or timestamp
  • stream buffer overflow detection (NXSCOPE_STREAM_FLAGS_OVERFLOW)
  • remote control with commands (enum nxscope_hdr_id_e)
  • protocol and interface implementation can be different for control commands and stream data
  • (optional) support for user-specific commands (NXSCOPE_HDRID_USER and struct nxscope_callbacks_s)
  • (optional) support for samples divider (CONFIG_LOGGING_NXSCOPE_DIVIDER)
  • (optional) support for ACK frames (CONFIG_LOGGING_NXSCOPE_ACKFRAMES)
  • (optional) support for user-defined types (CONFIG_LOGGING_NXSCOPE_USERTYPES)
  • (optional) support for non-buffered critical channels (CONFIG_LOGGING_NXSCOPE_CRICHANNELS)

A custom interface and a custom protocol can be implemented with struct nxscope_intf_s and struct nxscope_proto_s structures.

Supported interfaces:

  1. a serial port: logging/nxscope/nxscope_iser.c
  2. a dummy interface for debug purposes: logging/nxscope/nxscope_idummy.c

A default serial protocol is implemented in apps/logging/nxscope/nxscope_pser.c It just packs NxScope data into simple frames with a CRC-16 checksum.

External tools

  • Nxslib - a Python (3.10+) client library for NxScope devices,
  • Nxscli - a Python (3.10+) command-line interface for NxScope, supporting data capture and visualization