How jtm2kfpv-git/dji-unchained-voc works
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: MainActivity.java App controls · InstantReplaySaver.java Replay saver · RecordingCoordinator.java Recording coordinator · UsbAccessoryController.java USB accessory
Components 25
Connection and Recovery
- USB accessory
app/src/main/java/local/djiunchained/voc/UsbAccessoryController.java - N3 session
app/src/main/java/local/djiunchained/voc/N3Session.java - Stream recovery
app/src/main/java/local/djiunchained/voc/StreamWatchdog.java - Reconnect policy
app/src/main/java/local/djiunchained/voc/ReconnectPolicy.java
Video Pipeline
- LogicLink protocol
app/src/main/java/local/djiunchained/voc/protocol/LogicLinkDecoder.java - Video packets
app/src/main/java/local/djiunchained/voc/protocol/LogicLinkPacket.java - H.264 assembler
app/src/main/java/local/djiunchained/voc/protocol/H264AnnexBAssembler.java - H.264 access units
app/src/main/java/local/djiunchained/voc/protocol/H264AccessUnit.java - Surface decoder
app/src/main/java/local/djiunchained/voc/AvcSurfaceDecoder.java
Recording and Replay
- Recording coordinator
app/src/main/java/local/djiunchained/voc/RecordingCoordinator.java - Original stream recorder
app/src/main/java/local/djiunchained/voc/OriginalStreamRecorder.java - Raw H.264 recorder
app/src/main/java/local/djiunchained/voc/H264Recorder.java - Replay configuration
app/src/main/java/local/djiunchained/voc/InstantReplayConfiguration.java - Replay buffer
app/src/main/java/local/djiunchained/voc/InstantReplayBuffer.java - Replay saver
app/src/main/java/local/djiunchained/voc/InstantReplaySaver.java - Save lifecycle
app/src/main/java/local/djiunchained/voc/ReplaySaveLifecycle.java - Presentation timeline
app/src/main/java/local/djiunchained/voc/MonotonicPresentationTimeline.java
Display and Diagnostics
- App controls
app/src/main/java/local/djiunchained/voc/MainActivity.java - Video display
app/src/main/java/local/djiunchained/voc/ClickableSurfaceView.java - Display geometry
app/src/main/java/local/djiunchained/voc/DisplayGeometry.java - Diagnostics timeline
app/src/main/java/local/djiunchained/voc/DiagnosticTimeline.java - Performance metrics
app/src/main/java/local/djiunchained/voc/PerformanceTracker.java
Other components
- Android user
- DJI Goggles N3
- Android USB
Connections 26
- Android user → App controls: uses
README.md - DJI Goggles N3 → Android USB: sends video
README.md - Android USB → USB accessory: connects through
README.md - App controls → USB accessory: starts
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
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
README.md - App controls → Display geometry: configures
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
app/src/main/java/local/djiunchained/voc/MainActivity.java - App controls → Replay buffer: buffers units
app/src/main/java/local/djiunchained/voc/MainActivity.java - App controls → Replay saver: requests save
app/src/main/java/local/djiunchained/voc/MainActivity.java - Replay saver → Replay buffer: snapshots
app/src/main/java/local/djiunchained/voc/InstantReplaySaver.java - Replay saver → Save lifecycle: updates state
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