Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
53 changes: 12 additions & 41 deletions examples/camera_streamer/AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,45 +3,16 @@ SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All
SPDX-License-Identifier: Apache-2.0
-->

# Standalone GMSL/Argus streamer
# Standalone camera streamer

- 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 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.
- Preserve the standalone Argus → AVS1/TCP → NVDEC → CUDA IPC boundary; these tools must not import robot control packages or the Isaac Capture runtime.
- Deploy to a driver-ready Orin/Thor without assuming a vendor directory or existing camera services. Snapshot and restore camera-streamer artifacts and the platform service state changed for camera ownership; leave driver configuration to the BSP.
- Keep sender-only calibration assets, remaps and deployment helpers under argus_sender/. Resolve remap paths relative to the sender config so copying the sender includes its calibration assets.
- Treat the shipped calibration as an approximate viewing example. Preserve the 2x wrist lookup grid and box filtering when moving or regenerating it.
- Keep the sender build's Argus linkage consistent with the launcher's daemon ownership checks. The build wrapper selects single-process Argus; direct CMake builds also support multiprocess mode.
- Standalone Python loggers use the isaaccapture namespace without importing the runtime.
- The imported Argus sample helpers `Error.h` and `EGLGlobal.h` retain BSD-3-Clause notices and SPDX identifiers. Do not assign the example's Apache default to those files.
- Preserve upstream notices. Downloaded SDK sources remain outside this source export and retain their own license.
- Preserve the source layout when exporting standalone components; keep each component's tests inside its own folder. Reserve example-level tests/ for checks spanning components.
- Minimize differences from the source export: preserve CMake target definitions, include/header locations and flat component tests. This standalone import is an exception to the repository's CMake/include conventions; C++ formatting follows the repository's clang-format-14 configuration. Do not add build options or refactor working code solely for local verification.
- Normalize imported executable modes and final newlines before staging.
Loading
Loading