Skip to content

Repository files navigation

netft-cli

CI Release CodeQL Coverage License

netft-cli is a cross-platform command-line application for commissioning, diagnosing, monitoring, recording, and biasing ATI Net F/T Ethernet sensors. It discovers the active calibration and native units before consuming the RDT force/torque stream.

Features

  • Inspect sensor identity, calibration, and measurement units.
  • Check stream continuity, packet loss, rate, reconnects, and device status.
  • Monitor the latest six-axis sample in a live table or structured stream.
  • Record every accepted sample to CSV or NDJSON with integrity safeguards.
  • Apply software bias through an explicit confirmation step.

Installation

Install method Platform Support
GitHub Releases or installer Linux x86-64/ARM64, macOS Intel/Apple silicon, Windows x86-64 Self-contained executable
Source Linux, macOS, Windows CMake 3.16+, C++17, Threads, libcurl 7.63+

On Linux or macOS:

curl -fsSL https://raw.githubusercontent.com/netft/netft-cli/main/scripts/install/install.sh | sh

On Windows PowerShell:

irm https://raw.githubusercontent.com/netft/netft-cli/main/scripts/install/install.ps1 | iex

The installers select and verify the latest stable release. Release binaries include the private netft-cpp core and libcurl, so no separate runtime is required.

Quick start

The examples use 192.168.1.1, the ATI factory-default sensor address. Replace it with the address configured for your sensor.

# Inspect identity, calibration, and units.
netft info 192.168.1.1

# Run a bounded health check.
netft check 192.168.1.1 --duration 10s

# Monitor the latest sample in a live table.
netft monitor 192.168.1.1

# Record every accepted sample for one minute.
netft record 192.168.1.1 --output measurement.csv --duration 60s

Run netft help <COMMAND> or netft <COMMAND> --help for the options supported by the installed version.

Documentation

monitor presents the latest sample without maintaining a backlog. Use record when every accepted sample must be preserved. Bias changes the measurement zero; perform it only when the sensor and connected equipment are in a safe state.

Contributing

See CONTRIBUTING.md for development setup, tests, hardware-safety requirements, and core synchronization. Report security issues through SECURITY.md.

License

This project is licensed under the Apache License 2.0. Release archives include the notices for the synchronized netft-cpp core and libcurl.

About

Cross-platform command-line interface for ATI Net F/T Ethernet force/torque sensors.

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Used by

Contributors

Languages