Simulate: voyant_carbon_simulator

Stream synthetic sensor data for hardware-free testing.

Generates synthetic Carbon sensor data and streams it over UDP, so you can exercise the visualizer and other tools without a physical sensor.

Use voyant_carbon_simulator --help to see all available options.

Usage

Start the simulator, streaming to multicast group 239.255.48.84:5678 at 10 fps:

voyant_carbon_simulator --bind-addr 127.0.0.1:0 --group-addr 239.255.48.84:5678 --fps 10.0

Leave it running, then connect a tool to the same group (see below).

Common options

• --bind-addr <ADDR> — local address to send from (e.g. 127.0.0.1:0 for an ephemeral port).
• --group-addr <ADDR:PORT> — multicast group to stream to (e.g. 239.255.48.84:5678).
• --fps <HZ> — frame rate (default: 10).
• --horizontal-fov-deg <DEG> — horizontal field of view; 0 = line-scanner mode (default: 45).
• --range-min <M> / --range-max <M> — bounds of the simulated range sweep.
• --noisy-points-percent <0..1> — fraction of points to randomly perturb (default: 0).
• --fpga-listen-addr <ADDR> — bind a register port so the simulator accepts sensor-configuration commands and serves host↔FPGA time-sync, like a real device. Include this if the connecting tool needs to configure the sensor or run time-sync.

Connecting a tool to the simulator

Visualizer — open 🔌 Open Connection… and choose the Carbon Sim preset, then connect.

Headless tools — point them at the same group and interface. For example, verify the stream with voyant_carbon_client_check:

voyant_carbon_client_check --bind-addr 0.0.0.0:5678 --group-addr 239.255.48.84 --interface-addr 127.0.0.1

The same --bind-addr / --group-addr / --interface-addr values work for voyant_logger_binary and other streaming tools.