Connect: voyant_carbon_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_carbon_client_check --help to see all available options.

Usage

voyant_carbon_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_carbon_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.

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