Twinleaf I/O Tools in Rust

This repository contains a set of tools that are useful for working with Twinleaf quantum sensors and accessories.

The primary tool is the proxy, which makes the device available via ethernet:

	tio-proxy --auto

When there are more than one serial port available, it is necessary to specify the port

	[linux]> tio-proxy -r /dev/ttyACM0
	[macOS]> tio-proxy -r /dev/cu.usbserialXXXXXX
	[wsl1] > tio-proxy -r COM3

When a sensor is attached to a hub at port 0, it is possible to proxy the data directly to that port using the -s flag:

	tio-proxy --auto -s /0

With the proxy running, a set of tools can be used on the data stream.

Logging data to a raw binary file:

	tio-tool log

Parsing that log data for stream id 1 to a csv file:

	tio-tool log-csv 1 logfile.tio

Issuing commands:

	tio-tool rpc dev.name

List available commands:

	tio-tool rpc-list

Firmware upgrade:

	tio-tool firmware-upgrade <firmware.bin>

Monitoring the data stream:

	tio-tool data-dump

And a variety of additional functions for use with Twinleaf sensors.

Installation

On macOS and linux, there is a dependency on libudev; to install it use:

	sudo apt install libudev-dev  # debian linux
	brew install libudev          # macOS homebrew

Now build:

	cargo build --release

The resulting tools can be found in the target directory:

	cd target/release
	./tio-tool

The tools can be compiled for other platforms by first adding those platform targets:

	rustup target add x86_64-pc-windows-gnu
	rustup toolchain install stable-x86_64-pc-windows-gnu

And then building for the new target:

	cargo build --target x86_64-pc-windows-gnu