# arwchair/jetson-orin-nx-framos-builder architecture

> Architecture diagram of the GitHub repository arwchair/jetson-orin-nx-framos-builder, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/arwchair/jetson-orin-nx-framos-builder
- Repository: https://github.com/arwchair/jetson-orin-nx-framos-builder

## Overview

This repository combines Jetson camera setup with a low-latency stereo VR passthrough application. The user configures the Jetson through installer playbooks, then runs the application with a dewarp configuration. In the runtime, the application starts two Argus camera captures, obtains EGL images, dewarps each eye with a shader, and presents the combined view. The README documents installer and passthrough capabilities; installer playbook internals were not sampled, so their relationships are shown only at the documented level.

Main entry points: [`vr_passthrough/src/main.cpp`](https://github.com/arwchair/jetson-orin-nx-framos-builder/blob/main/vr_passthrough/src/main.cpp) (Application Loop), [`installer/Install.yml`](https://github.com/arwchair/jetson-orin-nx-framos-builder/blob/main/installer/Install.yml) (System Installer), [`vr_passthrough/src/ArgusCamera.cpp`](https://github.com/arwchair/jetson-orin-nx-framos-builder/blob/main/vr_passthrough/src/ArgusCamera.cpp) (Argus Capture), [`vr_passthrough/src/Config.hpp`](https://github.com/arwchair/jetson-orin-nx-framos-builder/blob/main/vr_passthrough/src/Config.hpp) (Dewarp Config)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Jetson Setup"]
  node_installer["System Installer<br/>[Install.yml]"]
  node_os_setup["OS Configuration<br/>[configure-os.yml]"]
  node_camera_setup["Camera Setup"]
  node_vr_setup["VR Setup"]
end

subgraph group_runtime["Passthrough Runtime"]
  node_config["Dewarp Config<br/>[Config.hpp]"]
  node_config_file["Runtime Settings<br/>[config.txt]"]
  node_app["Application Loop<br/>[main.cpp]"]
  node_camera["Argus Capture<br/>[ArgusCamera.cpp]"]
  node_camera_api["Camera Interface<br/>[ArgusCamera.hpp]"]
  node_egl_extensions["EGL Extensions<br/>[GLExtensions.cpp]"]
end

subgraph group_presentation["Stereo Presentation"]
  node_shader["Dewarp Shader<br/>[Shaders.hpp]"]
end

node_user(("Operator"))
node_camera_devices(("Camera Devices"))
node_display(("Stereo Display"))

node_user -->|"runs setup"| node_installer
node_installer -.->|"configures OS"| node_os_setup
node_installer -.->|"sets up cameras"| node_camera_setup
node_installer -.->|"prepares passthrough"| node_vr_setup
node_user -->|"runs application"| node_app
node_app -->|"loads settings"| node_config
node_config_file -.->|"provides values"| node_config
node_app -->|"starts capture"| node_camera
node_camera -->|"implements interface"| node_camera_api
node_camera -->|"captures frames"| node_camera_devices
node_app -->|"gets EGL images"| node_camera
node_app -->|"compiles and uses"| node_shader
node_app -.->|"uses extension loader"| node_egl_extensions
node_app -->|"presents stereo view"| node_display

click node_installer "https://github.com/arwchair/jetson-orin-nx-framos-builder/blob/main/installer/Install.yml"
click node_os_setup "https://github.com/arwchair/jetson-orin-nx-framos-builder/blob/main/installer/playbooks/configure-os.yml"
click node_camera_setup "https://github.com/arwchair/jetson-orin-nx-framos-builder/blob/main/installer/playbooks/jetson-imx900-setup.yml"
click node_vr_setup "https://github.com/arwchair/jetson-orin-nx-framos-builder/blob/main/installer/playbooks/vr-passthrough-setup.yml"
click node_config "https://github.com/arwchair/jetson-orin-nx-framos-builder/blob/main/vr_passthrough/src/Config.hpp"
click node_config_file "https://github.com/arwchair/jetson-orin-nx-framos-builder/blob/main/vr_passthrough/config.txt"
click node_app "https://github.com/arwchair/jetson-orin-nx-framos-builder/blob/main/vr_passthrough/src/main.cpp"
click node_camera "https://github.com/arwchair/jetson-orin-nx-framos-builder/blob/main/vr_passthrough/src/ArgusCamera.cpp"
click node_camera_api "https://github.com/arwchair/jetson-orin-nx-framos-builder/blob/main/vr_passthrough/src/ArgusCamera.hpp"
click node_egl_extensions "https://github.com/arwchair/jetson-orin-nx-framos-builder/blob/main/vr_passthrough/src/GLExtensions.cpp"
click node_shader "https://github.com/arwchair/jetson-orin-nx-framos-builder/blob/main/vr_passthrough/src/Shaders.hpp"

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_installer,node_os_setup,node_camera_setup,node_vr_setup toneBlue
class node_config,node_config_file,node_app,node_camera,node_camera_api,node_egl_extensions toneAmber
class node_shader toneMint
class node_user,node_camera_devices,node_display toneIndigo
```

## Components

### Jetson Setup

- [System Installer](https://github.com/arwchair/jetson-orin-nx-framos-builder/blob/main/installer/Install.yml): `installer/Install.yml`
- [OS Configuration](https://github.com/arwchair/jetson-orin-nx-framos-builder/blob/main/installer/playbooks/configure-os.yml): `installer/playbooks/configure-os.yml`
- [Camera Setup](https://github.com/arwchair/jetson-orin-nx-framos-builder/blob/main/installer/playbooks/jetson-imx900-setup.yml): `installer/playbooks/jetson-imx900-setup.yml`
- [VR Setup](https://github.com/arwchair/jetson-orin-nx-framos-builder/blob/main/installer/playbooks/vr-passthrough-setup.yml): `installer/playbooks/vr-passthrough-setup.yml`

### Passthrough Runtime

- [Dewarp Config](https://github.com/arwchair/jetson-orin-nx-framos-builder/blob/main/vr_passthrough/src/Config.hpp): `vr_passthrough/src/Config.hpp`
- [Runtime Settings](https://github.com/arwchair/jetson-orin-nx-framos-builder/blob/main/vr_passthrough/config.txt): `vr_passthrough/config.txt`
- [Application Loop](https://github.com/arwchair/jetson-orin-nx-framos-builder/blob/main/vr_passthrough/src/main.cpp): `vr_passthrough/src/main.cpp`
- [Argus Capture](https://github.com/arwchair/jetson-orin-nx-framos-builder/blob/main/vr_passthrough/src/ArgusCamera.cpp): `vr_passthrough/src/ArgusCamera.cpp`
- [Camera Interface](https://github.com/arwchair/jetson-orin-nx-framos-builder/blob/main/vr_passthrough/src/ArgusCamera.hpp): `vr_passthrough/src/ArgusCamera.hpp`
- [EGL Extensions](https://github.com/arwchair/jetson-orin-nx-framos-builder/blob/main/vr_passthrough/src/GLExtensions.cpp): `vr_passthrough/src/GLExtensions.cpp`

### Stereo Presentation

- [Dewarp Shader](https://github.com/arwchair/jetson-orin-nx-framos-builder/blob/main/vr_passthrough/src/Shaders.hpp): `vr_passthrough/src/Shaders.hpp`

### Other components

- **Operator**
- **Camera Devices**
- **Stereo Display**

## Connections

- Operator → System Installer: runs setup (evidence: `README.md`)
- System Installer → OS Configuration: configures OS
- System Installer → Camera Setup: sets up cameras
- System Installer → VR Setup: prepares passthrough
- Operator → Application Loop: runs application (evidence: `README.md`)
- Application Loop → Dewarp Config: loads settings (evidence: `vr_passthrough/src/main.cpp`)
- Runtime Settings → Dewarp Config: provides values
- Application Loop → Argus Capture: starts capture (evidence: `vr_passthrough/src/main.cpp`)
- Argus Capture → Camera Interface: implements interface (evidence: `vr_passthrough/src/ArgusCamera.cpp`)
- Argus Capture → Camera Devices: captures frames (evidence: `vr_passthrough/src/ArgusCamera.cpp`)
- Application Loop → Argus Capture: gets EGL images (evidence: `vr_passthrough/src/main.cpp`)
- Application Loop → Dewarp Shader: compiles and uses (evidence: `vr_passthrough/src/main.cpp`)
- Application Loop → EGL Extensions: uses extension loader
- Application Loop → Stereo Display: presents stereo view (evidence: `vr_passthrough/src/main.cpp`)
