All skills
nvidia avatar

/hsb-setup

@bb0436f
by NVIDIA Corporationnvidia/skills3.5k stars
424

Clone the latest NVIDIA Holoscan Sensor Bridge repo, ask which supported devkit is being used, configure the host per platform, build the correct demo container, run it, and verify HSB connectivity by pinging 192.168.0.2. Use for Holoscan Sensor Bridge setup, build, container launch, and first-connectivity bring-up.

Use this Skill: https://skilld.dev/gh/nvidia/skills/hsb-setup

This session only. Nothing lands on disk.

docsplatform-mapping.md

≈658 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Holoscan Sensor Bridge platform mapping

This file is the quick reference used by the skill.

Supported host platforms

  • IGX Orin with CX7 SmartNIC
  • AGX Orin with onboard Ethernet and Linux sockets path
  • AGX Thor with MGBE SmartNIC and CoE transport
  • DGX Spark with CX7 SmartNIC

Build mode selection

  • --dgpu: only for IGX Orin with a discrete GPU and OS configured as dGPU
  • --igpu: for all other supported configurations
    • IGX Orin iGPU
    • AGX Orin
    • AGX Thor
    • DGX Spark

Default board IPs

  • Port 0: 192.168.0.2
  • Port 1: 192.168.0.3

Default host IPs used in examples and setup

  • Host port connected to board port 0: 192.168.0.101/24
  • Optional second host port for stereo: 192.168.0.102/24

Host-network summary by platform

IGX Orin

  • Discover CX7 Infiniband device name from /sys/class/infiniband
  • Map that to Ethernet netdev
  • Use NetworkManager
  • Configure:
    • static IP 192.168.0.101/24
    • route 192.168.0.2/32
    • RX ring 4096

AGX Orin

  • Use onboard Ethernet, commonly eno1 on the documented JP6.2.1 setup
  • Use NetworkManager
  • Increase net.core.rmem_max
  • Configure static IP 192.168.0.101/24

DGX Spark

Same general approach as IGX — see references/phase-details.md for the full DGX Spark setup steps.

AGX Thor

  • Use --igpu build mode
  • Follow repo or doc guidance for MGBE interface naming
  • Socket examples may benefit from increased receive buffers
  • Do not hardcode eno1 unless the local system confirms it
  • Supports native CLI builds outside the container (Phase 2b):
    • Requires CUDA 13.0, Holoscan SDK 3.9.0, cmake, and build libraries
    • cmake -DHOLOLINK_BUILD_PYTHON=OFF .. && make -j hololink-enumerate for enumerate only
    • cmake -DHOLOLINK_BUILD_SIPL=1 -DHOLOLINK_BUILD_FUSA=1 .. && make -j for all CoE examples
    • Native binary at build/tools/enumerate/hololink-enumerate
    • Native and containerized enumerate share the same UDP port — cannot run simultaneously

Container startup notes

  • Start from a GUI terminal when visualizer access is needed
  • xhost + or preferably xhost +local:docker before sh docker/demo.sh
  • On iGPU platforms, a message about failing to detect the NVIDIA driver version can be expected and ignored during container start

Connectivity interpretation

  • ping 192.168.0.2 success means the control-plane IP path is up
  • It does not guarantee enumeration or data-plane correctness
  • If ping succeeds but hololink enumerate shows nothing, suspect firmware mismatch, cable placement, or board/app compatibility

Source: SKILL.md on GitHub

2 warnings3mo3 checks · Risk SAFE
  • Gen Agent Trust Hub3mo

    This skill automates the end-to-end setup and validation of the NVIDIA Holoscan Sensor Bridge (HSB) environment on supported devkits. It handles repository cloning, host network configuration, Docker container builds, and connectivity verification through a structured multi-phase workflow.

  • Socket3mo

    4 alerts: gptAnomaly

  • Snyk3mo

    Risk: MEDIUM · 2 issues

Signed by skilld at bb0436f. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 4 months ago
What it can do
Reads files Edits files Runs commands
author
Holoscan Team <holoscan-team@nvidia.com>
version
1.0.0
tags
[
  "holoscan-sensor-bridge",
  "hsb",
  "setup"
]
All 7 allowed tools
ReadWriteEditMultiEditGrepGlobBash
Other metadata
tools
[
  "Read",
  "Write",
  "Edit",
  "Grep",
  "Glob",
  "Bash"
]
disable-model-invocation
true
metadata
{
  "author": "Holoscan Team <holoscan-team@nvidia.com>",
  "team": "holoscan",
  "tags": [
    "holoscan-sensor-bridge",
    "hsb",
    "setup"
  ],
  "agents": [
    "claude-code",
    "codex"
  ]
}

README badge

README badge for nvidia/skills/hsb-setup