Build | Holoscan Sensor Bridge Documentation

Building the Holoscan Sensor Bridge container

Holoscan sensor bridge host software includes instructions for building a demo container. This container is used to run all holoscan tests and examples.

If you have not done so already, fetch the sensor bridge source code from https://github.com/nvidia-holoscan/holoscan-sensor-bridge
```
$ git clone https://github.com/nvidia-holoscan/holoscan-sensor-bridge
```
Build the sensor bridge demonstration container. Use dGPU for IGX Orin with a discrete GPU and OS configured as dGPU, and for x86_64 Linux hosts with an NVIDIA discrete GPU (see the x86 Linux tab in host setup). For remaining platforms listed here, use iGPU below.

iGPU

dGPU

  $ cd holoscan-sensor-bridge
  $ sh docker/build.sh --igpu

Run tests in the demo container

To run the sensor bridge demonstration container, from a terminal in the GUI,

xhost +
sh docker/demo.sh

This brings you to a shell prompt inside the Holoscan sensor bridge demo container. (Note that iGPU configurations, when starting the demo container, will display the message “Failed to detect NVIDIA driver version”: this can be ignored.) Now you’re ready to run sensor bridge applications.

Holoscan sensor bridge software loopback tests

Sensor bridge host software includes a test fixture that runs in loopback mode, where no sensor bridge equipment is necessary. This test works by generating UDP messages and sending them over the Linux loopback interface.

In the shell in the demo container:

pytest

Note that the test fixture intentionally introduces errors into the software stack. As long as pytest indicates that all test have passed, any error messages published by individual tests can be ignored. If pytest itself reports failures, see the troubleshooting page.

For systems with a sensor bridge device and IMX274, the test fixture can execute additional tests that prove that the device and network connections are working as expected.

First, ensure that the sensor bridge firmware is up to date.

For IGX configurations, connect both SFP+ connections on the sensor bridge device to the QSFP connectors, then

sh ./test-igx-cpnx100-imx274.sh

For AGX Orin, only one camera is supported, so only SFP+ 0 is to be connected. Run the device test on AGX this way:

sh ./test-agx-cpnx100-imx274.sh

If things are not working as expected, check the troubleshooting page.