# jtm2kfpv-git/dji-unchained-voc architecture

> Architecture diagram of the GitHub repository jtm2kfpv-git/dji-unchained-voc, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jtm2kfpv-git/dji-unchained-voc
- Repository: https://github.com/jtm2kfpv-git/dji-unchained-voc

## Overview

DJI Unchained VOC is an offline Android receiver for DJI Goggles N3 video. The main workflow is USB accessory discovery and permission, N3 stream reception and H.264 framing, hardware decoding to the display, and optional local recording or replay saving. The graph represents the root v0.8.0-dev app, not the preserved historical snapshots. MainActivity and replay relationships are supported by excerpts or the source index; several internal connections are unverified because those implementations were not sampled.

Main entry points: [`app/src/main/java/local/djiunchained/voc/MainActivity.java`](https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/MainActivity.java) (App controls), [`app/src/main/java/local/djiunchained/voc/InstantReplaySaver.java`](https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/InstantReplaySaver.java) (Replay saver), [`app/src/main/java/local/djiunchained/voc/RecordingCoordinator.java`](https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/RecordingCoordinator.java) (Recording coordinator), [`app/src/main/java/local/djiunchained/voc/UsbAccessoryController.java`](https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/UsbAccessoryController.java) (USB accessory)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_connection["Connection and Recovery"]
  node_usb["USB accessory"]
  node_session["N3 session<br/>[N3Session.java]"]
  node_recovery["Stream recovery"]
  node_reconnect["Reconnect policy"]
end

subgraph group_video["Video Pipeline"]
  node_protocol["LogicLink protocol"]
  node_packet["Video packets"]
  node_assembler["H.264 assembler"]
  node_access_unit["H.264 access units"]
  node_decoder["Surface decoder"]
end

subgraph group_recording["Recording and Replay"]
  node_recording_control["Recording coordinator"]
  node_original_recorder["Original stream recorder"]
  node_raw_recorder["Raw H.264 recorder<br/>[H264Recorder.java]"]
  node_replay_config["Replay configuration"]
  node_replay_buffer[("Replay buffer")]
  node_replay_saver["Replay saver"]
  node_save_lifecycle["Save lifecycle"]
  node_timeline["Presentation timeline"]
end

subgraph group_interface["Display and Diagnostics"]
  node_activity["App controls<br/>[MainActivity.java]"]
  node_display["Video display"]
  node_geometry["Display geometry"]
  node_diagnostics["Diagnostics timeline"]
  node_performance["Performance metrics"]
end

node_user(("Android user"))
node_goggles["DJI Goggles N3"]
node_android_usb["Android USB"]

node_user -->|"uses"| node_activity
node_goggles -->|"sends video"| node_android_usb
node_android_usb -->|"connects through"| node_usb
node_activity -->|"starts"| node_usb
node_usb -.->|"dispatches to"| node_session
node_session -.->|"decodes stream"| node_protocol
node_protocol -.->|"extracts"| node_packet
node_packet -.->|"supplies bytes"| node_assembler
node_activity -->|"assembles"| node_assembler
node_assembler -.->|"emits"| node_access_unit
node_access_unit -.->|"feeds"| node_decoder
node_decoder -->|"renders to"| node_display
node_activity -->|"configures"| node_geometry
node_activity -.->|"tracks stream"| node_recovery
node_recovery -.->|"requests retries"| node_reconnect
node_activity -.->|"controls recording"| node_recording_control
node_recording_control -.->|"starts"| node_original_recorder
node_recording_control -.->|"starts"| node_raw_recorder
node_activity -->|"configures"| node_replay_config
node_activity -->|"buffers units"| node_replay_buffer
node_activity -->|"requests save"| node_replay_saver
node_replay_saver -->|"snapshots"| node_replay_buffer
node_replay_saver -->|"updates state"| node_save_lifecycle
node_replay_saver -.->|"tracks timestamps"| node_timeline
node_activity -.->|"records events"| node_diagnostics
node_activity -.->|"reports metrics"| node_performance

click node_activity "https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/MainActivity.java"
click node_usb "https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/UsbAccessoryController.java"
click node_session "https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/N3Session.java"
click node_protocol "https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/protocol/LogicLinkDecoder.java"
click node_packet "https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/protocol/LogicLinkPacket.java"
click node_assembler "https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/protocol/H264AnnexBAssembler.java"
click node_access_unit "https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/protocol/H264AccessUnit.java"
click node_decoder "https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/AvcSurfaceDecoder.java"
click node_display "https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/ClickableSurfaceView.java"
click node_geometry "https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/DisplayGeometry.java"
click node_recovery "https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/StreamWatchdog.java"
click node_reconnect "https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/ReconnectPolicy.java"
click node_recording_control "https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/RecordingCoordinator.java"
click node_original_recorder "https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/OriginalStreamRecorder.java"
click node_raw_recorder "https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/H264Recorder.java"
click node_replay_config "https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/InstantReplayConfiguration.java"
click node_replay_buffer "https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/InstantReplayBuffer.java"
click node_replay_saver "https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/InstantReplaySaver.java"
click node_save_lifecycle "https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/ReplaySaveLifecycle.java"
click node_timeline "https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/MonotonicPresentationTimeline.java"
click node_diagnostics "https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/DiagnosticTimeline.java"
click node_performance "https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/PerformanceTracker.java"

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_usb,node_session,node_recovery,node_reconnect,node_user toneBlue
class node_protocol,node_packet,node_assembler,node_access_unit,node_decoder toneAmber
class node_recording_control,node_original_recorder,node_raw_recorder,node_replay_config,node_replay_buffer,node_replay_saver,node_save_lifecycle,node_timeline toneMint
class node_activity,node_display,node_geometry,node_diagnostics,node_performance toneRose
class node_goggles,node_android_usb toneIndigo
```

## Components

### Connection and Recovery

- [USB accessory](https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/UsbAccessoryController.java): `app/src/main/java/local/djiunchained/voc/UsbAccessoryController.java`
- [N3 session](https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/N3Session.java): `app/src/main/java/local/djiunchained/voc/N3Session.java`
- [Stream recovery](https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/StreamWatchdog.java): `app/src/main/java/local/djiunchained/voc/StreamWatchdog.java`
- [Reconnect policy](https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/ReconnectPolicy.java): `app/src/main/java/local/djiunchained/voc/ReconnectPolicy.java`

### Video Pipeline

- [LogicLink protocol](https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/protocol/LogicLinkDecoder.java): `app/src/main/java/local/djiunchained/voc/protocol/LogicLinkDecoder.java`
- [Video packets](https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/protocol/LogicLinkPacket.java): `app/src/main/java/local/djiunchained/voc/protocol/LogicLinkPacket.java`
- [H.264 assembler](https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/protocol/H264AnnexBAssembler.java): `app/src/main/java/local/djiunchained/voc/protocol/H264AnnexBAssembler.java`
- [H.264 access units](https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/protocol/H264AccessUnit.java): `app/src/main/java/local/djiunchained/voc/protocol/H264AccessUnit.java`
- [Surface decoder](https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/AvcSurfaceDecoder.java): `app/src/main/java/local/djiunchained/voc/AvcSurfaceDecoder.java`

### Recording and Replay

- [Recording coordinator](https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/RecordingCoordinator.java): `app/src/main/java/local/djiunchained/voc/RecordingCoordinator.java`
- [Original stream recorder](https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/OriginalStreamRecorder.java): `app/src/main/java/local/djiunchained/voc/OriginalStreamRecorder.java`
- [Raw H.264 recorder](https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/H264Recorder.java): `app/src/main/java/local/djiunchained/voc/H264Recorder.java`
- [Replay configuration](https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/InstantReplayConfiguration.java): `app/src/main/java/local/djiunchained/voc/InstantReplayConfiguration.java`
- [Replay buffer](https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/InstantReplayBuffer.java): `app/src/main/java/local/djiunchained/voc/InstantReplayBuffer.java`
- [Replay saver](https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/InstantReplaySaver.java): `app/src/main/java/local/djiunchained/voc/InstantReplaySaver.java`
- [Save lifecycle](https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/ReplaySaveLifecycle.java): `app/src/main/java/local/djiunchained/voc/ReplaySaveLifecycle.java`
- [Presentation timeline](https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/MonotonicPresentationTimeline.java): `app/src/main/java/local/djiunchained/voc/MonotonicPresentationTimeline.java`

### Display and Diagnostics

- [App controls](https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/MainActivity.java): `app/src/main/java/local/djiunchained/voc/MainActivity.java`
- [Video display](https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/ClickableSurfaceView.java): `app/src/main/java/local/djiunchained/voc/ClickableSurfaceView.java`
- [Display geometry](https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/DisplayGeometry.java): `app/src/main/java/local/djiunchained/voc/DisplayGeometry.java`
- [Diagnostics timeline](https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/DiagnosticTimeline.java): `app/src/main/java/local/djiunchained/voc/DiagnosticTimeline.java`
- [Performance metrics](https://github.com/jtm2kfpv-git/dji-unchained-voc/blob/main/app/src/main/java/local/djiunchained/voc/PerformanceTracker.java): `app/src/main/java/local/djiunchained/voc/PerformanceTracker.java`

### Other components

- **Android user**
- **DJI Goggles N3**
- **Android USB**

## Connections

- Android user → App controls: uses (evidence: `README.md`)
- DJI Goggles N3 → Android USB: sends video (evidence: `README.md`)
- Android USB → USB accessory: connects through (evidence: `README.md`)
- App controls → USB accessory: starts (evidence: `app/src/main/java/local/djiunchained/voc/MainActivity.java`)
- USB accessory → N3 session: dispatches to
- N3 session → LogicLink protocol: decodes stream
- LogicLink protocol → Video packets: extracts
- Video packets → H.264 assembler: supplies bytes
- App controls → H.264 assembler: assembles (evidence: `app/src/main/java/local/djiunchained/voc/MainActivity.java`)
- H.264 assembler → H.264 access units: emits
- H.264 access units → Surface decoder: feeds
- Surface decoder → Video display: renders to (evidence: `README.md`)
- App controls → Display geometry: configures (evidence: `README.md`)
- App controls → Stream recovery: tracks stream
- Stream recovery → Reconnect policy: requests retries
- App controls → Recording coordinator: controls recording
- Recording coordinator → Original stream recorder: starts
- Recording coordinator → Raw H.264 recorder: starts
- App controls → Replay configuration: configures (evidence: `app/src/main/java/local/djiunchained/voc/MainActivity.java`)
- App controls → Replay buffer: buffers units (evidence: `app/src/main/java/local/djiunchained/voc/MainActivity.java`)
- App controls → Replay saver: requests save (evidence: `app/src/main/java/local/djiunchained/voc/MainActivity.java`)
- Replay saver → Replay buffer: snapshots (evidence: `app/src/main/java/local/djiunchained/voc/InstantReplaySaver.java`)
- Replay saver → Save lifecycle: updates state (evidence: `app/src/main/java/local/djiunchained/voc/InstantReplaySaver.java`)
- Replay saver → Presentation timeline: tracks timestamps
- App controls → Diagnostics timeline: records events
- App controls → Performance metrics: reports metrics
