🔦 Flashing the Wireless PCB

NOTE: The wireless PCB’s cannot be flashed via QMK Toolbox or any other method to flash a QMK firmware. Wireless PCBs uses Wuque Studio's own software named “WuqueDFUUpgradeProgrammer” to flash a new firmware.

Do not attempt to flash the firmware with QMK Toolbox as you may permanently damage the PCB.

<aside> 📢 Flash the PCB using a Windows machine Mac and other OS are not supported by Wuque’s Flashing firmware.

</aside>

1. Get the necessary files for the keyboard you are flashing in the firmware Database or in the Google drive folder linked below.

<aside> 📂 Click the hyperlink below to view the Files Database:

Firmware Files

Google Drive link:

Wuque/Meletrix Firmware Files - Google Drive

</aside>

1. You would need 3 files to proceed.

   2.1) WuqueDFUUpgradeProgrammer- Flashing Tool used to upgrade the firmware. 2.2) .HEX File- This is your firmware file. 2.3) .JSON File- Used for VIA to detect the keyboard for remapping (have to be side loaded on wired mode).

   Note that the LITE.HEX doesn’t support any RGB in Bluetooth mode to save battery.

2. Getting things ready before flashing. Open WuqueDFUupgradeProgrammer

1. After another click you will see these folder contents. We only need to look at 2 files.

   4.A) DFU_DriverInstall- This is installed so that the flashing program will work.

   4.B) WuqueDFUupgradeProgrammer- This is the Flashing program for Wuque Wireless Keyboards.

1. Open the folder DFU_DriverInstall then you will see this file.

1. Right click on the DFU_DriverInstall and click Run as Administrator. Then click YES on the Windows pop up.

1. Click Install Driver and wait for it to finish.

1. Now you have prepare you computer to Flash. Time to flash the keyboard. Go back to folder with the following contents:

1. Right click on WuqueDFUupgradeProgrammer then click Run as Administrator. Then click YES on the Windows pop up.

1. The default language is Chinese but we could change that by clicking the toggle box. Then Select English.

1. Once the language is set on English, connect the PCB of your keyboard.

<aside> 📢 NOTE: IT IS VERY IMPORTANT IN THIS PROCESS THAT THE PCB SHOULD NOT BE UNPLUGGED. If unplugged during the flashing process this will brick your PCB making it broken.

</aside>

It should Automatically switch to DFU mode  if selected then your keyboard will have been in a ready to flash state, you don't need to do anything until the next step.

If it's not selected, click the Switch to DFU mode button to enter DFU mode. You will loose any keyboard input.

Please keep in mind if Automatically switch to DFU mode is selected your keyboard will automatically enter DFU mode again after a successful flash. When in DFU mode you will not have any keyboard input. Please close the software and/or unplug and replug the keyboard to get back to normal operation.

1. Wait for your keyboard to be recognized. You will know it’s connected if these are present.

1. Click select (we are going to select the .hex file since this is the firmware file.)

1. Select the appropriate firmware for the keyboard your using. It should be a .HEX file **then click Open. (I’ll be using a Zoom 65 V2 in this process)

1. This will show up under the upgrade file tab.

1. Click Manually Download

1. This means the keyboard is flashing.

1. Once the Factory Reset is done. You can Close the program and unplug then plug your keyboard. Congratulations 🥳 Get go treat yourself, you have successfully flashed your PCB.

WuqueDFUUpgradeProgrammer Troubleshooting Guide:

WuqueDFUUpgrade Programmer Troubleshooting.

Flashing Firmware on MacOS using Parallels (NOTE: You have to be using Intel Powered Macs for this to work. M1 Macs are still not yet supported.)

1. Install Parallels

Parallels: Mac & Windows Virtualization, Remote Application Server, Mac Management Solutions

1. Installation Guide for Parallels

How to Install Windows 10 in Parallels Desktop for Mac - Parallels Blog

1. Follow Wuque Installation Guide for the firmware and take note of what willjauregui#5600 said:

Flashing Firmware on MacOS using Parallels (For M Series Macs) Contributed by: lex#5309

1. Download UTM and set up Windows 7 using these instructions.

Windows 7

1. Log into windows and install .net version 4.5.2. You will need to download it from the internet.
2. Download and run normal firmware install instructions, with one minor difference: In UTM you will need to hit the USB icon in the top-right, then select your zoom. Once it boots into DFU mode, you will need to select it again (but it will have a different name).

NOTE: If your having issues getting the flasher to recognize your keyboard. Toggling a bunch of USB options. in the end this is what the "inputs" setting looks like in UTM.