How altera-fpga/holoscan-sensor-bridge works
Holoscan Sensor Bridge connects FPGA-acquired sensor data to GPU-resident Holoscan pipelines, with Python/C++ control, sensor integrations, network receivers, and image-processing operators. A separate management workflow discovers and configures devices and updates FPGA firmware. The README documents the broad data path; the available excerpts and source index support only selected internal relationships, so other subsystem links are omitted rather than inferred.
Main entry points: main.cpp Flasher CLI · roce_controller_receiver.py RoCE controller receiver · hololink.py Python API · hsb_controller.py HSB controller
Components 25
Device control
- Python API
python/tools/hololink.py - Device core
src/hololink/core/hololink.cpp - Data channel
src/hololink/core/data_channel.cpp - HSB controller
python/hololink/hsb_controller.py - Device enumeration
src/hololink/core/enumerator.cpp - IP configuration
tools/set_ip/set_ip.cpp
Sensor capture
- Camera drivers
src/hololink/sensors/camera/camera_sensor.cpp - Sensor modes
src/hololink/sensors/camera/imx274/imx274_mode.cpp - SIPL capture
src/hololink/operators/sipl_capture/sipl_capture_service.cpp
Data pipeline
- RoCE receiver
src/hololink/operators/roce_receiver/roce_receiver.cpp - RoCE controller receiver
python/hololink/operators/roce_controller_receiver.py - Holoscan operators
src/hololink/operators - CSI formats
src/hololink/core/csi_formats.hpp
Emulation
- HSB emulator
src/hololink/emulation/hsb_emulator.hpp
Firmware management
- Flasher CLI
tools/hsb_flasher/main.cpp - Flash discovery
tools/hsb_flasher/hsb_discovery.hpp - Firmware lookup
tools/hsb_flasher/hsb_fw_lookup.hpp - Flash strategy
tools/hsb_flasher/hsb_flasher.hpp - Lattice programmer
tools/program_lattice_cpnx100/programmer.cpp
Other components
- Pipeline developer
- Sensor hardware
- HSB FPGA
- ConnectX NIC
- GPU memory
- HSB device
Connections 23
- Pipeline developer → Python API: builds pipeline
README.md - Sensor hardware → HSB FPGA: sends sensor data
README.md - HSB FPGA → ConnectX NIC: sends UDP data
README.md - ConnectX NIC → GPU memory: writes data
README.md - Camera drivers → Sensor modes: uses modes
- HSB controller → RoCE controller receiver: starts receiver
python/hololink/hsb_controller.py - RoCE controller receiver → RoCE receiver: creates receiver
python/hololink/operators/roce_controller_receiver.py - RoCE controller receiver → GPU memory: exposes frame memory
python/hololink/operators/roce_controller_receiver.py - HSB controller → Camera drivers: starts sensor factory
python/hololink/hsb_controller.py - SIPL capture → GPU memory: acquires frames
- Holoscan operators → GPU memory: processes frames
- Python API → Data channel: creates channel
python/tools/hololink.py - Data channel → Device core: provides device
- Device enumeration → Python API: enumerates devices
- Pipeline developer → Flasher CLI: requests update
- Flasher CLI → Flash discovery: discovers device
tools/hsb_flasher/main.cpp - Flasher CLI → Firmware lookup: looks up firmware
tools/hsb_flasher/main.cpp - Flasher CLI → Flash strategy: selects flasher
tools/hsb_flasher/main.cpp - Flash strategy → HSB device: flashes firmware
- Pipeline developer → IP configuration: sets device IP
- Pipeline developer → Lattice programmer: programs FPGA
- HSB emulator → HSB FPGA: emulates device
- CSI formats → Holoscan operators: defines formats