# altera-fpga/holoscan-sensor-bridge architecture

> Architecture diagram of the GitHub repository altera-fpga/holoscan-sensor-bridge, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/altera-fpga/holoscan-sensor-bridge
- Repository: https://github.com/altera-fpga/holoscan-sensor-bridge

## Overview

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: [`tools/hsb_flasher/main.cpp`](https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/tools/hsb_flasher/main.cpp) (Flasher CLI), [`python/hololink/operators/roce_controller_receiver.py`](https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/python/hololink/operators/roce_controller_receiver.py) (RoCE controller receiver), [`python/tools/hololink.py`](https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/python/tools/hololink.py) (Python API), [`python/hololink/hsb_controller.py`](https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/python/hololink/hsb_controller.py) (HSB controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["Device control"]
  node_python_api["Python API<br/>[hololink.py]"]
  node_device_core["Device core<br/>[hololink.cpp]"]
  node_device_channel["Data channel<br/>[data_channel.cpp]"]
  node_controller["HSB controller<br/>[hsb_controller.py]"]
  node_enumerator["Device enumeration<br/>[enumerator.cpp]"]
  node_ip_tool["IP configuration<br/>[set_ip.cpp]"]
end

subgraph group_capture["Sensor capture"]
  node_camera_drivers["Camera drivers<br/>[camera_sensor.cpp]"]
  node_sensor_modes["Sensor modes<br/>[imx274_mode.cpp]"]
  node_sipl_capture["SIPL capture"]
end

subgraph group_pipeline["Data pipeline"]
  node_receiver["RoCE receiver<br/>[roce_receiver.cpp]"]
  node_receiver_adapter["RoCE controller receiver"]
  node_operators["Holoscan operators"]
  node_csi_formats["CSI formats<br/>[csi_formats.hpp]"]
end

subgraph group_emulation["Emulation"]
  node_emulator["HSB emulator<br/>[hsb_emulator.hpp]"]
end

subgraph group_firmware["Firmware management"]
  node_flash_cli["Flasher CLI<br/>[main.cpp]"]
  node_discovery["Flash discovery<br/>[hsb_discovery.hpp]"]
  node_firmware_lookup["Firmware lookup<br/>[hsb_fw_lookup.hpp]"]
  node_flash_strategy["Flash strategy<br/>[hsb_flasher.hpp]"]
  node_lattice_programmer["Lattice programmer<br/>[programmer.cpp]"]
end

node_user(("Pipeline developer"))
node_sensor{{"Sensor hardware"}}
node_fpga{{"HSB FPGA"}}
node_connectx{{"ConnectX NIC"}}
node_gpu[("GPU memory")]
node_board{{"HSB device"}}

node_user -->|"builds pipeline"| node_python_api
node_sensor -->|"sends sensor data"| node_fpga
node_fpga -->|"sends UDP data"| node_connectx
node_connectx -->|"writes data"| node_gpu
node_camera_drivers -.->|"uses modes"| node_sensor_modes
node_controller -->|"starts receiver"| node_receiver_adapter
node_receiver_adapter -->|"creates receiver"| node_receiver
node_receiver_adapter -->|"exposes frame memory"| node_gpu
node_controller -->|"starts sensor factory"| node_camera_drivers
node_sipl_capture -.->|"acquires frames"| node_gpu
node_operators -.->|"processes frames"| node_gpu
node_python_api -->|"creates channel"| node_device_channel
node_device_channel -.->|"provides device"| node_device_core
node_enumerator -.->|"enumerates devices"| node_python_api
node_user -.->|"requests update"| node_flash_cli
node_flash_cli -->|"discovers device"| node_discovery
node_flash_cli -->|"looks up firmware"| node_firmware_lookup
node_flash_cli -->|"selects flasher"| node_flash_strategy
node_flash_strategy -.->|"flashes firmware"| node_board
node_user -->|"sets device IP"| node_ip_tool
node_user -->|"programs FPGA"| node_lattice_programmer
node_emulator -.->|"emulates device"| node_fpga
node_csi_formats -.->|"defines formats"| node_operators

click node_python_api "https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/python/tools/hololink.py"
click node_device_core "https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/src/hololink/core/hololink.cpp"
click node_device_channel "https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/src/hololink/core/data_channel.cpp"
click node_controller "https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/python/hololink/hsb_controller.py"
click node_enumerator "https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/src/hololink/core/enumerator.cpp"
click node_camera_drivers "https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/src/hololink/sensors/camera/camera_sensor.cpp"
click node_sensor_modes "https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/src/hololink/sensors/camera/imx274/imx274_mode.cpp"
click node_sipl_capture "https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/src/hololink/operators/sipl_capture/sipl_capture_service.cpp"
click node_receiver "https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/src/hololink/operators/roce_receiver/roce_receiver.cpp"
click node_receiver_adapter "https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/python/hololink/operators/roce_controller_receiver.py"
click node_operators "https://github.com/altera-fpga/holoscan-sensor-bridge/tree/altera-release-2.6.0/src/hololink/operators"
click node_csi_formats "https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/src/hololink/core/csi_formats.hpp"
click node_emulator "https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/src/hololink/emulation/hsb_emulator.hpp"
click node_flash_cli "https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/tools/hsb_flasher/main.cpp"
click node_discovery "https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/tools/hsb_flasher/hsb_discovery.hpp"
click node_firmware_lookup "https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/tools/hsb_flasher/hsb_fw_lookup.hpp"
click node_flash_strategy "https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/tools/hsb_flasher/hsb_flasher.hpp"
click node_lattice_programmer "https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/tools/program_lattice_cpnx100/programmer.cpp"
click node_ip_tool "https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/tools/set_ip/set_ip.cpp"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_python_api,node_device_core,node_device_channel,node_controller,node_enumerator,node_ip_tool toneBlue
class node_camera_drivers,node_sensor_modes,node_sipl_capture,node_gpu toneAmber
class node_receiver,node_receiver_adapter,node_operators,node_csi_formats toneMint
class node_emulator toneRose
class node_flash_cli,node_discovery,node_firmware_lookup,node_flash_strategy,node_lattice_programmer,node_user,node_sensor,node_fpga,node_connectx,node_board toneIndigo
```

## Components

### Device control

- [Python API](https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/python/tools/hololink.py): `python/tools/hololink.py`
- [Device core](https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/src/hololink/core/hololink.cpp): `src/hololink/core/hololink.cpp`
- [Data channel](https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/src/hololink/core/data_channel.cpp): `src/hololink/core/data_channel.cpp`
- [HSB controller](https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/python/hololink/hsb_controller.py): `python/hololink/hsb_controller.py`
- [Device enumeration](https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/src/hololink/core/enumerator.cpp): `src/hololink/core/enumerator.cpp`
- [IP configuration](https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/tools/set_ip/set_ip.cpp): `tools/set_ip/set_ip.cpp`

### Sensor capture

- [Camera drivers](https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/src/hololink/sensors/camera/camera_sensor.cpp): `src/hololink/sensors/camera/camera_sensor.cpp`
- [Sensor modes](https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/src/hololink/sensors/camera/imx274/imx274_mode.cpp): `src/hololink/sensors/camera/imx274/imx274_mode.cpp`
- [SIPL capture](https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/src/hololink/operators/sipl_capture/sipl_capture_service.cpp): `src/hololink/operators/sipl_capture/sipl_capture_service.cpp`

### Data pipeline

- [RoCE receiver](https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/src/hololink/operators/roce_receiver/roce_receiver.cpp): `src/hololink/operators/roce_receiver/roce_receiver.cpp`
- [RoCE controller receiver](https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/python/hololink/operators/roce_controller_receiver.py): `python/hololink/operators/roce_controller_receiver.py`
- [Holoscan operators](https://github.com/altera-fpga/holoscan-sensor-bridge/tree/altera-release-2.6.0/src/hololink/operators): `src/hololink/operators`
- [CSI formats](https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/src/hololink/core/csi_formats.hpp): `src/hololink/core/csi_formats.hpp`

### Emulation

- [HSB emulator](https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/src/hololink/emulation/hsb_emulator.hpp): `src/hololink/emulation/hsb_emulator.hpp`

### Firmware management

- [Flasher CLI](https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/tools/hsb_flasher/main.cpp): `tools/hsb_flasher/main.cpp`
- [Flash discovery](https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/tools/hsb_flasher/hsb_discovery.hpp): `tools/hsb_flasher/hsb_discovery.hpp`
- [Firmware lookup](https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/tools/hsb_flasher/hsb_fw_lookup.hpp): `tools/hsb_flasher/hsb_fw_lookup.hpp`
- [Flash strategy](https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/tools/hsb_flasher/hsb_flasher.hpp): `tools/hsb_flasher/hsb_flasher.hpp`
- [Lattice programmer](https://github.com/altera-fpga/holoscan-sensor-bridge/blob/altera-release-2.6.0/tools/program_lattice_cpnx100/programmer.cpp): `tools/program_lattice_cpnx100/programmer.cpp`

### Other components

- **Pipeline developer**
- **Sensor hardware**
- **HSB FPGA**
- **ConnectX NIC**
- **GPU memory**
- **HSB device**

## Connections

- Pipeline developer → Python API: builds pipeline (evidence: `README.md`)
- Sensor hardware → HSB FPGA: sends sensor data (evidence: `README.md`)
- HSB FPGA → ConnectX NIC: sends UDP data (evidence: `README.md`)
- ConnectX NIC → GPU memory: writes data (evidence: `README.md`)
- Camera drivers → Sensor modes: uses modes
- HSB controller → RoCE controller receiver: starts receiver (evidence: `python/hololink/hsb_controller.py`)
- RoCE controller receiver → RoCE receiver: creates receiver (evidence: `python/hololink/operators/roce_controller_receiver.py`)
- RoCE controller receiver → GPU memory: exposes frame memory (evidence: `python/hololink/operators/roce_controller_receiver.py`)
- HSB controller → Camera drivers: starts sensor factory (evidence: `python/hololink/hsb_controller.py`)
- SIPL capture → GPU memory: acquires frames
- Holoscan operators → GPU memory: processes frames
- Python API → Data channel: creates channel (evidence: `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 (evidence: `tools/hsb_flasher/main.cpp`)
- Flasher CLI → Firmware lookup: looks up firmware (evidence: `tools/hsb_flasher/main.cpp`)
- Flasher CLI → Flash strategy: selects flasher (evidence: `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
