Changelog

New features

• Add support for PS2/3 pressure buttons
• Persistent customizable default config via NVS variables
  See docs

Bug fixes

• Fix polarity of the RY axis for generic wireless devices (Thanks @hworld)
• Fix mapping regression for some 8bitdo controller
• Fix sign of 8 bits logical min & max in HID parser
• Fix Switch LED getting change on HW2 when using N64 acc toggle functions

Firmware is available in 2 different flavor

1. Regular FW as before retroactively renamed HW1 (Typically for external adapter)

Use firmwares from HW1 archive for:

• WillConsole's PSUnoRetro
• All Humble Bazooka's BT dongle
• RetroTime's N64 dongle
• RetroOnyx's VB dongle
• GrechTech's RetroRosetta
• any DIY adapter you made base on the original BlueRetro spec
• most likely anything from aliexpress

2. HW2 FW that support power management and port detection (Typically for internal install)

Use firmwares from HW2 archive for:

• Laser Bear Industries's GameCube BlueRetro Internal Adapter
• any DIY internal install you made base on the HW2 spec

OTA Firmware update page has protection to prevent cross flashing between HW1 & HW2 firmware.

Download latest firmware archives from https://darthcloud.itch.io/blueretro

Changelog

New features

• Famicom Keyboard support
  See Docs:
  • Special buttons functions
  • Schematic
• Add support for 8BitDo Retro Mechanical Keyboard
• Add support for Famicom expansion port only dongle

Bug fixes

• Fix Jaguar's NBA Jam regression
• Fix port LEDS on various system
• LE filter in only HID KB, Mouse, Joystick or Gamepad
• Fix turbo for parallel systems when using Xbox & 8bitdo ctrls
• Fix Switch controller disconnection regression on quick buttons presses
• Fix N64 accessories init state
• Fix adapter crash with N64 OoT at boot when rumble is enable

Firmware is available in 2 different flavor

1. Regular FW as before retroactively renamed HW1 (Typically for external adapter)

Use firmwares from HW1 archive for:

• WillConsole's PSUnoRetro
• All Humble Bazooka's BT dongle
• RetroTime's N64 dongle
• RetroOnyx's VB dongle
• GrechTech's RetroRosetta
• any DIY adapter you made base on the original BlueRetro spec
• most likely anything from aliexpress

2. HW2 FW that support power management and port detection (Typically for internal install)

Use firmwares from HW2 archive for:

• Laser Bear Industries's GameCube BlueRetro Internal Adapter
• any DIY internal install you made base on the HW2 spec

OTA Firmware update page has protection to prevent cross flashing between HW1 & HW2 firmware.

Download latest firmware archives from https://darthcloud.itch.io/blueretro

Changelog

New features

• VMU emulation for Dreamcast. (thanks @breademan)
  See Docs:
  • Web config -> DC VMU Manager page
  • Web config -> Output config option for DC
  • Web config -> Output config
• Macro functions buttons are now customizable.
  See Docs:
  • Button combinations functions
• PlayStation Analog mode status LED for P1 & P2 on port LED 3 & 4.
  See Docs:
  • Port Status LED
• Toggle between GamePad & GamePadAlt config without reboot or config change via Macro (All system) or Home buttons (PCE, Genesis, Saturn, Dreamcast & 3DO only).
  See Docs:
  • Button combinations functions
• Support for 8BitDo N64 Modkit D mode.
  See Docs:
  • 8BitDo N64 Modkit paring guide

Bug fixes

• Various BT connection issues introduced in v1.8.4.
• BT keyboard random input.
• Parallel system config override not applying.
• Activision games PS2 support (CoD 2 & 3 now work).
• All port controlled by a single controller gets enable on hot plug systems.
• Atari Jaguar FW not working
• Fix PC-FX timing (random input in some games)
• Fix autofire/turbo on PS1/PS2

Firmware is available in 2 different flavor

1. Regular FW as before retroactively renamed HW1 (Typically for external adapter)

Use firmwares from HW1 archive for:

• WillConsole's PSUnoRetro
• All Humble Bazooka's BT dongle
• RetroTime's N64 dongle
• RetroOnyx's VB dongle
• GrechTech's RetroRosetta
• any DIY adapter you made base on the original BlueRetro spec
• most likely anything from aliexpress

2. HW2 FW that support power management and port detection (Typically for internal install)

Use firmwares from HW2 archive for:

• Laser Bear Industries's GameCube BlueRetro Internal Adapter
• any DIY internal install you made base on the HW2 spec

OTA Firmware update page has protection to prevent cross flashing between HW1 & HW2 firmware.

Download latest firmware archives from https://darthcloud.itch.io/blueretro

Bluetooth

• Use Switch default report (0x3F) to mitigate multiplayer issues w/ digital pad only Switch ctrls
• Enable Sniff mode for Switch controller at all time
• Enable Sniff when more than one controller connected
• Added Rumble Support for generic devices (Thanks @JPZV)
• Fix SNES Switch controller mapping regression
• Add PS5 DualSense trigger end button effects (Thanks @@coolbho3k)

Wired

• GameCube: Fix Metroid Prime trigger issue with BT controller w/ digital only trigger
• Fix inverted logic for Saturn 3D ctrl triggers
• Fix dreamcast mode crash with ESP32_PICO_V3 (but limited to 1P only)
• Fix Parallel 1P 3v3 (OD) image

Global

• Fix parsing of HID descriptor report omitting the ID
• Fix 32 bits HID usage mask
• Fix extra HID buttons assignment
• Make joysticks & triggers maximum change dynamically if higher than default

Firmware is available in 2 different flavor

1. Regular FW as before retroactively renamed HW1 (Typically for external adapter)

Use firmwares from HW1 archive for:

• WillConsole's PSUnoRetro
• All Humble Bazooka's BT dongle
• RetroTime's N64 dongle
• RetroOnyx's VB dongle
• GrechTech's RetroRosetta
• any DIY adapter you made base on the original BlueRetro spec
• most likely anything from aliexpress

2. HW2 FW that support power management and port detection (Typically for internal install)

Use firmwares from HW2 archive for:

• Laser Bear Industries's GameCube BlueRetro Internal Adapter
• any DIY internal install you made base on the HW2 spec

OTA Firmware update page has protection to prevent cross flashing between HW1 & HW2 firmware.

Download latest firmware archives from https://darthcloud.itch.io/blueretro

Bluetooth

• Add Google Stadia support

Wired

• Add support for Wii extension encryption

Global

• Update to esp-idf 5.1.0 (2023-01-16)
• Fix HW2 reset output being held low at boot (Thanks @Extrems for the heads up)

Firmware is now available in 2 different flavor

1. Regular FW as before retroactively renamed HW1 (Typically for external adapter)

Use firmwares from HW1 archive for:

• WillConsole's PSUnoRetro
• All Humble Bazooka's BT dongle
• RetroTime's N64 dongle
• RetroOnyx's VB dongle
• GrechTech's RetroRosetta
• any DIY adapter you made base on the original BlueRetro spec
• most likely anything from aliexpress

2. HW2 FW that support power management and port detection (Typically for internal install)

Use firmwares from HW2 archive for:

• Laser Bear Industries's GameCube BlueRetro Internal Adapter
• any DIY internal install you made base on the HW2 spec

OTA Firmware update page has protection to prevent cross flashing between HW1 & HW2 firmware.

Download latest firmware archives from https://darthcloud.itch.io/blueretro

Bluetooth

See the controller pairing guide for specific instruction for using each of the newly supported BT controllers.

• Add 8bitdo S30 Modkit support
• Add 8BitDo N30 Modkit support
• Add RetroFighters Warrior support
• Add Hyperkin Admiral support
• Add RetroFighters Brawler 64 support
• Add BlueN64 controller support (thanks @JPZV !)
• Fix Gbros trigger mapping
• Fix Wii Classic Pro support
• Support Wii extension 8 bytes mode when supported by extension

Wired

• Add support for Wii extension 6 bytes mode (without encryption only)
• Fixup SNES multitap support (thanks @DigiDwrf !)

Global

• Various new debug options

Firmware is now available in 2 different flavor

1. Regular FW as before retroactively renamed HW1 (Typically for external adapter)

Use firmwares from HW1 archive for:

• WillConsole's PSUnoRetro
• All Humble Bazooka's BT dongle
• RetroTime's N64 dongle
• RetroOnyx's VB dongle
• GrechTech's RetroRosetta
• any DIY adapter you made base on the original BlueRetro spec
• most likely anything from aliexpress

2. HW2 FW that support power management and port detection (Typically for internal install)

Use firmwares from HW2 archive for:

• Laser Bear Industries's GameCube BlueRetro Internal Adapter
• any DIY internal install you made base on the HW2 spec

OTA Firmware update page has protection to prevent cross flashing between HW1 & HW2 firmware.

Download latest firmware archives from https://darthcloud.itch.io/blueretro

Global

• [MGR] Fix R button for GBAHD
• [ATT_CFG] Fix read cmd for Bluefy

Firmware is now available in 2 different flavor

1. Regular FW as before retroactively renamed HW1 (Typically for external adapter)

Use firmwares from HW1 archive for:

• WillConsole's PSUnoRetro
• All Humble Bazooka's BT dongle
• RetroTime's N64 dongle
• RetroOnyx's VB dongle
• GrechTech's RetroRosetta
• any DIY adapter you made base on the original BlueRetro spec
• most likely anything from aliexpress

2. HW2 FW that support power management and port detection (Typically for internal install)

Use firmwares from HW2 archive for:

• Laser Bear Industries's GameCube BlueRetro Internal Adapter
• any DIY internal install you made base on the HW2 spec

OTA Firmware update page has protection to prevent cross flashing between HW1 & HW2 firmware.

Download latest firmware archives from https://darthcloud.itch.io/blueretro

Global

• [MGR] Add support for internal install for all system (Only tested GC)
• [GAMEID] Add support for Game ID for PS1, N64 & GC multi config selection
• [ADAPTER] Reduce 8bit accessible heap memory usage (Fix memcard malloc in universal build)

Wired

• [GC] Support all command format

Bluetooth

• [BT] Add support for 8bitdo M30 controller
• [BT] Add RetroFighters GC adapter support
• [ADAPTER] Fixup 8bitdo Gbros B & X mapping

Firmware is now available in 2 different flavor

1. Regular FW as before retroactively renamed HW1 (Typically for external adapter)

Use firmwares from HW1 archive for:

• WillConsole's PSUnoRetro
• All Humble Bazooka's BT dongle
• RetroTime's N64 dongle
• RetroOnyx's VB dongle
• GrechTech's RetroRosetta
• any DIY adapter you made base on the original BlueRetro spec
• most likely anything from aliexpress

2. HW2 FW that support power management and port detection (Typically for internal install)

Use firmwares from HW2 archive for:

• Laser Bear Industries's GameCube BlueRetro Internal Adapter
• any DIY internal install you made base on the HW2 spec

OTA Firmware update page has protection to prevent cross flashing between HW1 & HW2 firmware.

Download latest firmware archives from https://darthcloud.itch.io/blueretro

Global

[MAIN] Fix stack overflow when formating SPIFFS on first boot after initial flash (Fixes #359)

BAD Use v1.7.3

Bluetooth

• [HID] Assume report ID 1 if none provided by descriptor

Wired

• [PCE] Fixup mouse support (Fixes #348)

Global

• ESP-IDF updated to 5.0.0 2022-08-05

Bluetooth

• [BT] Add support for Retro-bit 6 buttons controllers (Fixes #312 #313)

Wired

• [GC] Add support for trigger 4 bits mode (Fixes #324)

Adapter

• Macro command not affected by mapping (Fixes #335)

Global

• Add Autofire / Turbo function
• [HID] Use first report found that match supported type

See https://github.com/darthcloud/BlueRetro/discussions/327 for instruction on how to configure the autofire / turbo feature.

Wireless

• [HID] Fixup axes min, neutral & max values

Wired

• [N64] Reduce scope of N64 digital workaround to N64 port 1 only

Wired

• [WII-EXT] Fix unreliable TX FIFO flush (Fixes #286)

Global

• Fix memory card read on Android (Closes #277)

General

• Add button macro to perform system function (alternative to boot button)
• Add support for wireless ctrl reassignment base on wired ctrl connection (Internal install).
• Add support for powering on/off and reset (Internal install)
• Add BLE commands to reset ESP32
• Add BLE attribute to get BD_ADDR (Closes #249)
• Add macro and BLE commands to put ESP32 in deep sleep (Closes #174)
• Detect ESP32 PICO package and use GPIO20 for LED (Closes #156)
• Make BLE advertised name unique

Wireless

• Add support for 8bitdo N64 controller
• Add rumble feedback on accessory switch (Closes #175)

Wired

• [N64] Switch data line config from open drain to push-pull (Closes #264)
• [WII-EXT] Add support for Wii extension up to 2 players (tested SNES mini only, Hakchi kernel not working)

Wired

• [PCE] Rework 2 btns to ignore OE line and handle OE via interrupt for MT & 6 btns (Fixes #192 #212 )

Wired

• Add support for GBAHD

Wired

• Rework default mapping for PCE, PC-FX, Jaguar, Genesis & Saturn so that main 2 or 3 buttons always map onto the main 4 buttons of modern controller. See:
  https://docs.google.com/spreadsheets/d/e/2PACX-1vT9rPK2__komCjELFpf0UYz0cMWwvhAXgAU7C9nnwtgEaivjsh0q0xeCEiZAMA-paMrneePV7IqdX48/pubhtml
• [PSX] Add support for special accessories on multitap

Bluetooth

• Fix Wiimote horizontal default mapping

Wired

• Add support for Virtual Boy
• Add support for VirtualTap Mode & Palette buttons
• Add support for SEA board
• Add support for open drain parallel output
• Fixes Jaguar Breakout 2000 issue

Bluetooth

• Increase BLE devices maximum from 3 to 8

General

• Update to esp-idf 5.0.0
• Increase SPIFFS partition to 960KB