Skip to content

Hyperk Installation Guide (Wireless LED Controller)

Chapter 1: Hardware Preparation and Firmware Flashing

Before starting, ensure you have a compatible device and a stable USB connection. Hyperk supports various microcontrollers, but the flashing process depends on the specific hardware architecture you are using.

1.1 Supported Devices

The following chips are currently supported:

  • Espressif Systems: ESP8266, ESP32, ESP32-S2, ESP32-S3, ESP32-C2, ESP32-C3, ESP32-C5, ESP32-C6, and WT32-ETH01.
    • Note: The ESP32-C5 offers support for both standard 2.4 GHz Wi-Fi and the newer Wi-Fi 6 standard.
  • Raspberry Pi Pico W: RP2040 and RP2350.
    • Important: The "W" in "Pico W" is essential. Standard Pico boards without it do not have a Wi-Fi module and are not compatible.

1.2 Web Installer

The easiest way to flash your device is via the official web installer: 👉 https://hyperk.hyperhdr.org

installer

1.3 Flashing Raspberry Pi Pico W

For Pico boards, the process uses Mass Storage Mode rather than direct Web Serial flashing:

  1. Enter DFU Mode:
    • If your Pico has one button (BOOT): Press and hold it while connecting the board to your USB port. Release the button once connected.
    • If your Pico has two buttons (BOOT and RESET): Connect it to the USB port. Press and hold both buttons, release RESET, then release BOOT.
  2. Copy Firmware: The board will appear on your computer as a removable drive.
  3. Download the appropriate firmware file from the installer page and copy it directly onto the Pico drive. The device will automatically update and reboot.

1.4 Flashing ESP32 / ESP8266

These chips can be flashed directly from the web installer if you are using a compatible browser. If the board is not detected automatically, you may need to enter the DFU mode manually.

Browser Compatibility: You must use a browser that supports the Web Serial API (such as Google Chrome, Microsoft Edge, or Opera). Firefox is not supported as it does not allow web-based serial communication.

If you encounter issues, you can flash the factory firmware manually using esptool. If you are unsure of the button combination for your specific board to enter DFU, consult its documentation or use an AI (like Gemini) to find the correct combination. E.g. for ESP32-S2 to enter DFU mode: Press and hold Rst + 0, release Rst, then release 0.

Example usage of esptool for ESP32-S2 board in DFU mode:
esptool.py write_flash 0x0 Hyperk_0.0.2-beta_esp32s2_factory.bin.
All the settings will be erased and the bootloader will be restored.

Note: After the firmware is successfully flashed, a power cycle (unplug and replug the USB cable) is highly recommended.