IO Manual Shenzhen NuPhy Technology Co., Ltd.

NuPhy R&D Department Last Updated: April 17, 2025

NuPhyIO Issues

Unable to connect keyboard

Please connect the keyboard with the original data cable and follow the steps below to operate:

1. Cancel browser authorization;
2. Close other drive.nuphyio.com windows (or tabs) and refresh the io page;
3. Press and hold the Fn+key combination until the keyboard restarts (returns to factory settings), and then test whether the keyboard can be used

Unable to save settings after adjusting them with NuPhyIO?

If you refresh the webpage after adjusting the settings and find that the settings have been restored to default, it may be because you have modified many settings at the same time, resulting in a large amount of data that has not been saved successfully. Please keep the current settings page open for more than five seconds after setting.

Magnetic Switch Keyboard Issue

Is the "Trigger Indicator Light" on Field75 HE not working?

Use the combination key: FN and T to turn on and off the "Trigger Indicator Light".

Does it prompt “Confirm Update” every time you open the driver?

Every time you open the driver, it prompts “Confirm Update” . Clicking “Cancel” will cause the keyboard to become bricked, and even if the upgrade is successful, a “Confirm Update” prompt will still pop up next time. This situation may be a hardware issue with the keyboard, and you need to contact the customer service of the platform you ordered to send back the keyboard. We will provide you with a solution after testing.

The keyboard does not respond when receiving/using normally/adjusting parameters, and cannot be used even after re plugging or unplugging?

This situation may be due to forgetting to burn the firmware at the factory or losing firmware information during use. Please contact the customer service of the platform you ordered to send you the firmware burning tool.

Is a key on the keyboard unusable?

Please replace it with another firmware version first. If it still cannot be used, please swap the axis of this button with other buttons after power off. After swapping, you need to click "Recalibrate", and then use normal force to long press the two swapped shafts multiple times until they turn green again on the screen, so that the keyboard can accurately record the shaft parameters when touching the bottom.

Is the keyboard automatically calibrated after clicking the “Recalibrate” button?

When clicking “Recalibrate”, the green button displayed on the screen indicates that it has been calibrated before and is not automatically calibrated. If recalibration is required, please press and hold the button multiple times with normal force. Or long press FN+C until the keyboard light turns completely red (indicating that the calibration information of the keyboard has been cleared), and then use normal force to long press all keys multiple times until they all turn green on the screen.

All keyboard lights are red and cannot be changed to other colors?

This situation indicates that the keyboard has not been calibrated. Please click "Recalibrate" and then press and hold all keys with normal force multiple times until they turn green on the screen.

Does the keyboard occasionally have combo/auto trigger?

Due to the sensitivity of the magnetic axis keyboard, it is easily affected by the environment and may occasionally experience combo/automatic triggering. Generally, re plugging and unplugging the cables can restore normal operation. If frequent combo/automatic triggering occurs, please try replacing with other firmware in the 'History Update'.

Does the keyboard occasionally have combo/auto trigger?

Please use a tool that displays whether the keyboard is currently triggering to test the disconnection phenomenon, such as opening the "Online Keyboard Test" tool 在线键盘测试 | zFrontier 装备前线， When the button is being triggered, it will be displayed in white and can be set to make a sound when triggered. If a button is held down and shaken, and the corresponding button on the interface occasionally displays other colors or makes intermittent sounds, it indicates that the button may have experienced a disconnection phenomenon.

If there is a disconnection phenomenon, please swap the axis of this button with other buttons after the power is turned off. After swapping, you need to click "recalibrate", and then press and hold the two swapped buttons multiple times with normal force until they turn green again on the screen. Then retest if they are disconnected.

If key A experiences a disconnection phenomenon when switched to another key B, key B will experience disconnection while key A will not, indicating that the disconnection phenomenon is caused by the shaft body. Please contact the customer service of the platform you ordered to send you a replacement shaft body.

2. If the disconnected button A is switched to another button B, and button A still disconnects while button B continues to touch, it may be due to improper calibration or firmware issues. Please try replacing it with another firmware in the "History Update" section.

3. If the disconnection phenomenon cannot be improved, please try adjusting the dead zone of the key to a higher value or contact the platform customer service you ordered to send back the keyboard. We will provide you with a solution after testing.

Does the "Press detection"/"Recalibration" function occasionally have a slight orange/yellow color when the button is not pressed?

This situation is mainly due to the browser's performance limitations on the speed at which it can receive keyboard information, resulting in not receiving a keyboard reset message. If the keyboard does not automatically trigger/disconnect/fail to trigger during use, it indicates that there is no problem with the keyboard.

If there is always a little orange/yellow displayed, it may indicate that the shaft body has been hot plugged in. When it needs to be plugged in, the shaft body should be unplugged and reconnected after power failure. Then power on and click 'recalibrate', press and hold this button multiple times with normal force until it turns green again on the screen.

Did you find that the button cannot touch the bottom during the "Press Detection"/"Recalibration" function when pressing the button?

When it is found in the "Press Detection" that the button cannot be touched to the bottom, first adjust the "Trigger Key Range" to the highest, and test whether the button can be triggered in the input box of any software. If it can be triggered, it means that there is no problem with the current button, which may be a problem with the information report.

If the button cannot be triggered under high key travel during the testing process, you can try swapping the axis of this button with other buttons after power failure. After swapping, you need to click "Recalibrate", and then press and hold the two swapped buttons multiple times with normal force until they turn green again on the screen. Then retest if they can trigger when touching the bottom/high key stroke. If this phenomenon still cannot be improved, please try adjusting the dead zone of the key to a higher value or contact the platform customer service you ordered to send back the keyboard. We will provide you with a solution after testing.

Did you find that the button cannot be calibrated in the “Recalibration” function and always displays a red border?

If there is a button that cannot be calibrated during the testing process, you can try swapping the axis of this button with other buttons after the power is turned off. After swapping, you need to click "Recalibrate", and then press and hold the two swapped buttons multiple times with normal force until they turn green again on the screen. If this phenomenon still cannot be improved, please try replacing the firmware in the "History Update" or contact the platform customer service you ordered to send back the keyboard. We will provide you with a solution after testing.

Will the button automatically trigger/continuously combo after power on/sleep on?

During the startup process of a computer, the voltage of the USB interface may fluctuate, and some computers may experience large fluctuations, which can have a significant impact on the magnetic axis keyboard. This impact may cause the magnetic axis keyboard to display automatically or continuously click. This phenomenon will not damage the keyboard. It is recommended to plug in the keyboard after the computer is turned on.

After adjusting the dead zone to 0, entering NuPhyIO again will display the dead zone closed?

In the firmware, the state of 0 dead zone is the state of dead zone closure, so when reported to the driver, the driver will display dead zone closure.

Pressing has reached the trigger key, but NuPhyIO does not display the trigger?

Due to browser limitations, the functionality of test keys may not be as accurate. Sometimes, when the trigger key is reached, the browser does not display the trigger phenomenon, or when many keys are actually triggered, only one is displayed. We are working hard to optimize this issue.

IO Version Mechanical Keyboard Issue

The keyboard has abnormal phenomena during operation

Please check if there is a firmware version in NuPhyIO's' Update History 'that has resolved your issue and try upgrading to that firmware.

A certain button does not work or there is an abnormal phenomenon when it works

Please try replacing the switch of the button. If the issue persists, please try replacing it with a different firmware version in NuPhyIO's “Update History” .

QMK Version Mechanical Keyboard Issue

Bluetooth mode cannot be paired or frequently experiences disconnection

1. Ensure that the Bluetooth function of the device is turned on and the device supports Bluetooth keyboard connection. In the Bluetooth settings of the device, delete the previous pairing record with the keyboard, and then perform the forced pairing operation again. Mandatory pairing steps:

   • Long press the Bluetooth pairing key (such as FN+1/2/3, 60% series FN+Q/W/E) on the keyboard for 3-5 seconds;
   • The keyboard enters pairing mode, and the indicator light * * flashes rapidly * * blue * * (if it flashes slowly, it means it has not entered pairing mode yet);
   • Search for Bluetooth devices on the device and select the keyboard to connect. If the pairing is successful but there is a disconnection, you can try shortening the distance between the device and the keyboard to avoid interference from other electronic devices. At the same time, check if the Bluetooth driver of the device is the latest version, and update it promptly if there are any updates.

2. If the problem persists, you can try updating the keyboard firmware (QMK, RF, Dongle) and re pairing Bluetooth (steps as above).

Unable to connect properly in 2.4G mode, or experiencing flashing indicator lights but unable to input

1. Confirm that the receiver is correctly inserted into the USB port of the computer, check if the device manager recognizes the keyboard receiver, and ensure that the interface driver is working properly. You can try replacing the computer or other USB ports or using a USB hub to see if it can connect successfully. If the indicator light flashes but input is not possible, please ensure that the distance between the keyboard and receiver does not exceed 1 meter during pairing to avoid interference from obstacles.
2. If the problem persists, try refreshing the firmware (QMK, RF, Dongle) and forcibly pairing the 2.4G receiver. Mandatory pairing steps:
   • Long press the 2.4G pairing key (such as FN+4, 60% series FN+R) on the keyboard for 3-5 seconds;
   • The keyboard enters pairing mode, and the indicator light * * flashes rapidly * * green * * (if it flashes slowly, it means it has not entered pairing mode yet);
   • Insert the receiver into the USB port of the computer, and the indicator light will turn on to indicate successful pairing.

The keyboard does not respond in wired mode, the indicator light is not on, and the computer cannot recognize the keyboard

1. Check if the data cable is damaged and try replacing it with a known good data cable to connect the keyboard and computer. At the same time, check if the USB interface of the computer is working properly and try inserting other USB devices for testing.
2. Confirm if the keyboard is properly connected to the computer, sometimes it may not be recognized due to a weak connection. After connecting the data cable, you can try restarting the computer to re recognize the keyboard device. If there are no issues with the data cable and interface, you can try updating the keyboard QMK firmware. During the firmware update process, ensure that the keyboard is in a wired connection state and follow the brick refresh tutorial step by step. After the update is complete, check again if the keyboard is working properly.

No response after pressing the button, or multiple presses are required to trigger

1. First, check if the keys are stuck by foreign objects. You can gently tap the keyboard or use a small tool to clean the gaps between the keys to ensure that they can bounce up normally.
2. Try replacing the button switch. When replacing the switch, ensure that the new switch is compatible with the keyboard and installed in the correct direction. If the problem persists, consider updating the keyboard firmware and retesting whether the keys have returned to normal. If the problem only occurs in 2.4G mode, it may be a receiver issue and you need to try replacing the USB interface to avoid signal interference or replacing the receiver.

Multiple or consecutive abnormal keystrokes

1. Check if the buttons are connected due to improper lubrication or switch malfunction. If you suspect a switch issue, you can try replacing the switch of the button to see if it can solve the problem.
2. Update the keyboard firmware to the latest version and re pair the Bluetooth or receiver. After updating the firmware, retest the button condition. If the problem only occurs in 2.4G mode, it may be a receiver issue and you need to try replacing the USB interface to avoid signal interference or replacing the receiver.

The function of the button does not match expectations

1. Check if the keyboard is in the correct mode settings. Some keyboards have different functional modes and may require specific key combinations or dip switches to switch modes to ensure proper key functionality.
2. Confirm whether the input method settings of the device are correct. In some cases, the settings of the input method may cause abnormal key functions. You can try switching input methods or resetting the shortcut keys of the input method. If the abnormal key function is caused by firmware issues, you can try updating the keyboard firmware. After updating the firmware, restore the keyboard to factory settings and check if the key functions can be restored to normal. If the problem only occurs in 2.4G mode, it may be a receiver issue and you need to try replacing the USB interface to avoid signal interference or replacing the receiver.

Unable to update firmware

1. Ensure that the firmware file that matches the keyboard model has been downloaded correctly and the connection between the computer and keyboard is stable before updating the firmware. During the update process, avoid disconnecting or performing other operations.
2. Check if the USB interface of the computer is working properly, and try replacing it with another USB interface for firmware update. At the same time, ensure that the computer has sufficient battery power to avoid update failures caused by low battery during the update process. If the update fails, you can try updating the firmware by using the reset button on the keyboard and following the keyboard bricking tutorial. (Usually, there is a black reset button under the CAPS keycap.). If multiple attempts still fail to update the firmware, you can contact after-sales for technical support, and after-sales will provide corresponding solutions based on the specific situation.

Unable to update firmware

1. Ensure that the firmware file that matches the keyboard model has been downloaded correctly and the connection between the computer and keyboard is stable before updating the firmware. During the update process, avoid disconnecting or performing other operations.
2. Check if the USB interface of the computer is working properly, and try replacing it with another USB interface for firmware update. At the same time, ensure that the computer has sufficient battery power to avoid update failures caused by low battery during the update process. If the update fails, you can try updating the firmware by using the reset button on the keyboard and following the keyboard bricking tutorial. (Usually, there is a black reset button under the CAPS keycap.). If multiple attempts still fail to update the firmware, you can contact after-sales for technical support, and after-sales will provide corresponding solutions based on the specific situation.

New issues arise after firmware update

1. New issues arise after updating the firmware, such as abnormal button functions, unstable connections, etc.

   • Firstly, confirm whether the updated firmware version matches the keyboard model exactly. Sometimes using the wrong firmware version may cause compatibility issues. If a version mismatch is found, the correct firmware version needs to be downloaded again for updating.
   • Next, confirm whether the keyboard firmware needs to be updated synchronously with the corresponding versions of RF and Dongle. If wireless keyboard mode is required, the QMK of the keyboard should be updated synchronously, RF and Dongle modules are required to restore keyboard functionality to normal.
   • Finally, confirm whether the keyboard has been re paired with Bluetooth or 2.4GHz receiver after updating the complete and correct firmware. If not re paired, it may not completely solve the problems encountered by the keyboard.
   • If the problem is complex, you can contact the after-sales service for detailed feedback, providing detailed information and problem description before and after firmware update. The after-sales service will analyze the cause based on the specific situation and provide corresponding solutions, such as further firmware repair or hardware testing.

2. The keyboard may become bricked or malfunction after refreshing the firmware.

   • Refer to the tutorial on resetting and updating firmware. Hold down the reset button under the CAPS key and try flashing the firmware again.
   • Make sure to use the correct firmware version and avoid power outages during the refresh process.
   • If the problem persists, it may be a hardware issue caused by operational errors. It is recommended that after-sales service provide detailed information for confirmation.

3. The keyboard cannot be awakened after hibernation.

   • Refresh the latest firmware and reset the keyboard.
   • Check if the device manager recognizes the keyboard and ensure that the driver program is functioning properly.
   • If the problem persists, try replacing the USB port or using a USB hub.

VIA cannot recognize keyboard or blank configuration page

1. Try changing the browser or using another device to connect to VIA.
2. Confirm if the connection steps are correct (refer to the VIA connection tutorial for specific steps)
3. Refresh the firmware and reset the keyboard before attempting to connect again.

Unable to change keys or reset automatically after changing keys through VIA software

1. Try changing the browser or using another device to connect to VIA.
2. Check if the keyboard is in the correct mode (mac/win) and if the key changes are in the corresponding layer (there are corresponding VIA layer instructions in the manual)
3. Refresh the firmware and reset the keyboard before attempting to change keys again.

VIA cannot save macros or reset keyboard after saving

1. Try changing the browser or using another device to connect to VIA.
2. Check if the keyboard is in the correct mode (mac/win) and if the key changes are in the corresponding layer (there are corresponding VIA layer instructions in the manual)
3. Confirm if the steps for setting up macros are correct (refer to the macro setting tutorial for specific steps)
4. Refresh the firmware and reset the keyboard before attempting to set and save the macro again.

The keyboard cannot adjust the lighting through VIA

1. Try changing the browser or using another device to connect to VIA.
2. Check if the keyboard is in the correct mode (mac/win) and if the key changes are in the corresponding layer (there are corresponding VIA layer instructions in the manual)
3. Refresh the firmware and reset the keyboard before attempting to adjust the lighting again. If the problem persists, try using the shortcut keys on the keyboard to adjust the lighting.
4. If the keyboard shortcut keys cannot adjust the lighting, but other functions can be adjusted, it may be a hardware problem (such as damaged light beads). It is recommended to contact after-sales service and provide detailed information as required for confirmation.

Abnormal keyboard backlight or side lights, such as inability to light up, abnormal brightness, abnormal flashing frequency, color display errors, etc

1. Check the instruction manual to confirm if the shortcut keys used to adjust the lights are correct.
2. After resetting the keyboard to factory settings, try adjusting the lighting effects through shortcut keys or VIA.
3. Confirm if the keyboard is in a low battery state. When the battery is low, the backlight of the keyboard may malfunction. You can try charging the keyboard and wait until the battery is sufficient before observing whether the backlight returns to normal. If the backlight issue occurs after updating the firmware, you can try resetting the keyboard to factory settings and then resetting the backlight parameters. If the problem persists, it may be due to hardware malfunction causing abnormal backlight. You can contact after-sales for hardware testing and repair.

Keyboard battery expansion

1. After turning off the power to the keyboard, carefully disconnect and unplug the battery cable. Remove the keyboard battery and only use the keyboard in wired mode.
2. Check the order information to confirm the keyboard warranty period, and contact after-sales for corresponding solutions.
3. Be careful to avoid keeping the keyboard plugged in or using fast charging to charge the keyboard when using wireless mode in the future.

The keyboard cannot be charged or the battery drains too quickly

1. Disassemble the keyboard to confirm if the battery is in good working condition and if the battery connection is loose. If the battery ages, is damaged, or bulges, it can lead to a shortened battery life. You can try unplugging the battery cable or replacing the original battery.
2. Turn off all the backlight and side lights of the keyboard, test the battery life of the keyboard in the absence of light, and confirm whether there is indeed a battery life issue with the keyboard.
3. Check the usage habits of the keyboard, such as whether a 5V USB charger is used during charging, whether the backlight is turned on for a long time (without turning on the keyboard sleep mode), and whether the keyboard is used for a long time with a data cable connected. When not in use, the keyboard can be turned off to save power and reduce keyboard battery consumption. If the problem persists, it may be due to battery damage. It is recommended to replace the battery after sales and avoid bad usage habits and using fast charging to charge the keyboard in the future.

The dip switch of the keyboard is damaged or unable to switch modes

1. Try disassembling the machine to check if the dip switch is loose or damaged.
2. If it cannot be repaired, it is recommended that the after-sales service replace the dip switch or PCB.

Switch pin bending

1. Try to straighten the pins of the switch and reinstall them.
2. If it cannot be repaired, it is recommended to replace the switch with a new one.

Upon receiving the keycap or keyboard, it is immediately discovered that there are non-human defects such as stains and scratches on the surface

1. Try wiping with a soft cloth and some water.
2. If it cannot be repaired and the order is within the warranty period, it is recommended to provide the problem description and relevant pictures to the after-sales department for replacement.