[Camera streamer 5/5] CUDA IPC viewer and GMSL operator runbook

examples/camera_streamer/AGENTS.md

@@ -5,10 +5,43 @@ SPDX-License-Identifier: Apache-2.0
 
 # Standalone GMSL/Argus streamer
 
-- Keep the wire/configuration tests runnable without Jetson or CUDA dependencies.
+- Keep this example scoped to GMSL/Argus capture, AVS1/TCP, NVDEC and CUDA IPC.
+  Do not restore unrelated camera wrappers, USB senders, RTP/recording paths or
+  rig-specific deployment assets without an explicit scope change.
 - Preserve upstream notices when adding SPDX headers; missing SPDX does not mean
   a file lacks a license. Keep third-party exceptions separate from Apache-2.0 code.
-- Keep each review independently buildable: add tests and documentation with their dependencies.
-- Normalize generated build fragments to one final newline before staging.
+- Keep the native sender and standalone receiver independent of robot control
+  software and the Isaac Capture runtime. Use the isaaccapture logger tree without importing it.
+- Document Install, Preview, Send, Receive and Viewer stages with explicit
+  commands, without a launcher wrapper. Keep operator instructions in this README
+  rather than duplicating them across subdirectories. Local Argus preview is a separate application
+  and must release the sensor before network capture starts.
+- Use HOST_IP/ROBOT_IP discovered for the installation, never developer addresses.
+  Explain source transfer before referencing robot deployment directories.
+- Select sensor modes from --list-modes and match PWM to capture rate. Record
+  hardware validation evidence in the review; keep operator mode tables focused on configuration.
+- Deploy directory renames with documentation and rebuild stale CMake
+  caches. Do not transfer virtual environments, builds or caches between machines.
+- Receiver tests must establish the standalone import path. Check runtime imports
+  and native/receiver tests after trimming dependencies, not just formatting.
+- Preserve encoded frame dependencies across disconnects. CUDA IPC handles stay
+  local to the receiving machine; they are not network transport handles.
+- Preview loops must handle window-close events before rendering another frame.
+- CuPy pixel diagnostics need matching NVRTC; exclude first-use JIT from timing.
+- Normalize final newlines and imported executable permissions before staging.
+- Describe camera support generically; separate upstream device testing from local validation.
+- Use one shared profile per device/resolution; define wire geometry and port once.
+- Keep tests under the example-level tests/ directory, split by language and hardware needs.
+- Public setup instructions target main; describe pre-merge branch overrides separately.
+- Do not infer Argus mode indices from vendor specifications or another model; keep unknown modes explicit in profiles.
+- Keep camera YAMLs directly under configs/ with model-prefixed filenames so profile selection needs no subdirectory.
+- Use matching columns for all camera profile tables so resolution, frame rate and capture constraints are directly comparable.
+  Keep profile alternatives in those tables; show PROFILE assignments in fenced code blocks with an inline selection hint.
+- Preserve HEVC ordering through TCP enqueue and bound receiver work queues; backpressure must remain interruptible during shutdown.
+- Verify unresolved review findings against the current PR head and regression tests;
+  an open thread can describe code already fixed in an earlier commit.
+- Concurrency regression tests must synchronize inside the operation under test;
+  a pre-call flag and a fixed sleep do not establish lock contention.
+- Keep portable tests buildable without Jetson dependencies and each review independently buildable.
 - Keep argus_sender, camera_receiver and cuda_ipc_consumer directly under camera_streamer;
   do not group standalone transport components under the TeleViz visualization name.

examples/camera_streamer/__init__.py

@@ -0,0 +1,4 @@
+# SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+
+"""Standalone Sensing/Argus camera streaming example."""

examples/camera_streamer/cuda_ipc_consumer/.gitignore

@@ -0,0 +1,18 @@
+# SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+
+# Python environment and caches
+.venv/
+__pycache__/
+*.py[cod]
+*$py.class
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+
+# Local logs and runtime artifacts
+*.log
+*.pid
+*.sock