voyant_points_receiver_check
Debug tool to verify you’re receiving a data stream and print basic frame metadata. Useful for troubleshooting connectivity without full visualization.
Use voyant_points_receiver_check --help to see all available options.
Usage
Basic Connection Check
voyant_points_receiver_check --bind-addr 0.0.0.0:4444 --group-addr 224.0.0.0 --interface-addr 192.168.20.100
Custom Processing Simulation
Simulate processing delays to test performance:
voyant_points_receiver_check --processing-time 100 --rolling-window 20 --bind-addr 0.0.0.0:4444 --group-addr 224.0.0.0 --interface-addr 192.168.20.100
Expected Output
When successfully receiving data:
###############
Received frame:
Header: VoyantHeaderWrapper { ... frame_index: 825, device_class: Mdl, ... }
Points count: 0
Measured latency (frame start): 107.037 ms
Rate: 10.0 Hz (2s avg)
###############
Shows frame index, device info, point count, latency, and frame rate for each received frame.
Options
--rolling-window <SIZE>- Number of frames to average for rate calculation (default: 10)--processing-time <MS>- Simulate processing delay in milliseconds (default: 50)--check-interval <MS>- How often to check for new frames in milliseconds (default: 10)--verbose- Enable detailed output for debugging--keep-invalid-points- Include invalid points in the point count
Troubleshooting
If you see no frame output:
- Verify network connectivity and addresses
- Check that the data source is active
- Ensure firewall isn’t blocking UDP traffic
- Try adding
--verbosefor more debugging information