# Bigscreen Beyond Synaptics Firmware Wiki

Firmware for the **Bigscreen Beyond** VR head-mounted display main display board.

**Target MCU:** ATSAMG55G19 (ARM Cortex-M4, 120 MHz, 512 KB Flash, 128 KB RAM)  
**RTOS:** FreeRTOS 10.0.0 (cooperative scheduling, 12 tasks)  
**Build Environment:** Microchip Studio 7.0.2542, ARM GCC  
**USB IDs:** VID `0x35BD` / PID `0x0101` (application), PID `0x4004` (bootloader)  
**Hardware Variants:** BS1 (original), BS2 (triple USB hub, eye-tracking FPGA), BS2-EVT

## Wiki Pages

| Page | Description |
|------|-------------|
| [[Display-System]] | Dual micro-OLED panels, video modes, EDID, brightness, DSC |
| [[VXR7200-Display-SoC]] | Remote control interface, firmware management, power control |
| [[Audio-System]] | PDM microphone array, USB Audio Class, gain control |
| [[Eye-Tracking]] | FPGA interface, IR current measurement, overcurrent protection (BS2 only) |
| [[Proximity-Sensor]] | TMD2635 driver, state machine, calibration, auto-dim |
| [[USB-Subsystem]] | Composite device, USB hub management, USB-C detection |
| [[USB-HID-Commands]] | Full command reference (56 commands), periodic telemetry report |
| [[Power-Management]] | Power rails, temperature monitoring, USB-C detection |
| [[Persistent-Configuration]] | Flash config storage, EEPROM emulation, usage timers |
| [[Bootloader]] | Flash programming protocol, CRC verification, memory layout |
| [[Crash-Handling-and-Diagnostics]] | Fault handlers, stack monitoring, hardware self-test, debug interfaces |
| [[Factory-and-Test-Support]] | FATP modes, production tooling scripts |
| [[FreeRTOS-Task-Architecture]] | Task list, scheduling, synchronization |
| [[Version-History]] | Changelog summary from v0.1.0 through v0.3.12 |

## Repository Structure

```
beyond_synaptics/
  src/                      Application source code
    config/                 FreeRTOS, board, clock, USB configuration headers
    Devices/                Peripheral device drivers (OLED, VXR, FPGA, USB hubs, proximity, etc.)
    Drivers/                Core hardware drivers (I2C, ADC, PDM, power, temperature, flash)
    crash_handler/          ARM fault handler with flash-based crash dump
    ASF/                    Atmel Software Framework (vendor HAL)
  docs/                     HID command spec, config format, bootloader protocol
  scripts/                  Python utilities (firmware loader, config editor, monitoring tools)
  vxr7200_firmware/         Pre-built VXR7200 display SoC firmware images
  build/                    Release hex files (AppImage and FullImage)
```