Connect: voyant_client_check

Headless check that the host is receiving the sensor stream.

Connects to a Carbon sensor, receives its stream, and prints live frame statistics (frame rate, latency, and point count). Use it to confirm a connection from the command line — on headless systems, in CI, or when debugging networking — without opening the visualizer.

Use voyant_client_check --help to see all available options.

Usage

voyant_client_check --bind-addr 0.0.0.0:5678 --group-addr 239.255.48.84 --interface-addr 192.168.1.100

Use 127.0.0.1 as the interface address to connect to the local voyant_simulator instead of a sensor. Press Ctrl+C to stop.

To check a sensor another client already owns, add --observer-only — it receives passively without sending anything to the sensor.

Common options

• --bind-addr <ADDR> — local address to bind to (e.g. 0.0.0.0:5678).
• --group-addr <ADDR> — multicast group address to join (e.g. 239.255.48.84).
• --interface-addr <ADDR> — local interface IP for the multicast group (192.168.1.100 for a live sensor, 127.0.0.1 for the simulator).
• --observer-only — passively receive the stream without sending anything to the sensor.
• --stream-transport <unicast|multicast> — how the sensor delivers its stream (default: unicast).

If frames arrive, the connection is healthy. If nothing prints, check the network configuration and that the sensor is streaming.

Arriving frames confirm the connection, not that the sensor is at full measurement performance — after a configuration change it settles first. See After Changing SDL Parameters.