Skip to content
  • hardware
  • core flashing

Core Firmware Update

Current Version: v1.2.3 (ATLAS Ready)

ATLAS requires Doppelgänger Core firmware v1.2.3 or higher for full compatibility.

Download

Section titled “Download”

Download the latest firmware for your platform from the Downloads page.

Update Instructions

Section titled “Update Instructions”

Firmware updates are performed using prebuilt installers.

Prerequisites

Section titled “Prerequisites”
  • Doppelgänger Core device
  • USB-C cable
  • Computer (Windows, macOS, or Linux)

Steps

Section titled “Steps”
  1. Download the latest installer for your OS from the Downloads page
  2. Connect your Core device via USB-C
  3. Run the downloaded installer for your platform:

macOS:

Terminal window
chmod +x ./core_firmware_<version>_darwin_<arch>
./core_firmware_<version>_darwin_<arch>

Linux:

Terminal window
chmod +x ./core_firmware_<version>_linux_<arch>
./core_firmware_<version>_linux_<arch>

Windows: Run the .exe file directly.

  1. Select the suggested ESP32 serial port when prompted
  2. Follow on-screen instructions
  3. Device will automatically reboot when complete

Notes

Section titled “Notes”

On macOS, you may need to allow execution in System Settings → Privacy & Security if the binary was quarantined. Alternatively, remove the quarantine flag:

Terminal window
xattr -d com.apple.quarantine ./core_firmware_<version>_darwin_<arch>

USB drivers are typically not required for ESP32-S3. The updater automatically detects the product type and installs the appropriate firmware.

After Flashing

Section titled “After Flashing”

Flashing resets the device to factory defaults:

  • Reader Mode: Resets to HID Mode (default). If you were using Paxton Mode, you’ll need to reconfigure via ATLAS.
  • Card Data: All stored card data is wiped.
  • WiFi Credentials: Core devices retain their configured WiFi credentials after flashing.

Initial Setup

Section titled “Initial Setup”

After flashing, connect to the device’s captive portal WiFi network (default password: UndertheRadar) to configure settings. The captive portal provides:

  • Configure WiFi - Scan and select wireless networks for the device to connect to
  • Info - View device stats and erase WiFi credentials
  • Update - Perform OTA firmware updates
  • Restart/Exit - Restart device or close portal

Reader Mode

Section titled “Reader Mode”

Select HID Global or Paxton from the reader type dropdown in ATLAS. HID Mode processes standard Wiegand protocols (26-bit through 56-bit formats). Paxton Mode captures Net2 75-bit protocol frames with automatic decoding.

Serial Debugging

Section titled “Serial Debugging”

Enable or disable serial output over USB-C from the Configuration Menu for OPSEC. Enable serial debugging prior to firmware updates.

WiFi Reset Card

Section titled “WiFi Reset Card”

The WiFi Reset Card erases stored wireless credentials. Useful for rotational gear shared between team members. Customize this card with unique values.

GPIO Settings

Section titled “GPIO Settings”

Configure haptic feedback on GPIO36. When enabled, the sensor vibrates for 3 seconds upon successful card read.

Troubleshooting

Section titled “Troubleshooting”

Device not detected

Section titled “Device not detected”
  • Ensure USB-C cable supports data transfer (not charge-only)
  • Try a different USB port
  • Check that no other application is using the serial port

Flash fails

Section titled “Flash fails”
  • Do not disconnect during flashing
  • Retry the flash command
  • Contact [email protected] if issues persist

Need Help?

Section titled “Need Help?”