Skip to content

Troubleshooting

This article covers common issues with Ergohaven products and how to resolve them. The article is continuously updated, and you are welcome to contribute by editing the page on GitHub.

Initial Diagnostics

Initial diagnostics are recommended to rule out common issues unrelated to the electronics of Ergohaven products.

Switch Devices

Check whether the issue occurs on another device (PC, laptop, tablet, smartphone, etc.). If using a USB hub, try connecting directly to the device or switching to a different USB port.

Switch Operating Systems

Check whether the issue occurs on a different operating system (Windows, macOS, Linux, etc.).

Switch Connection Interface

If using a wired connection between the halves or to your computer, replace the cable between the halves or to the computer.

Reset to Factory Settings / Update Firmware

Flash your Ergohaven device with the standard firmware.

Update Drivers

Reinstall the USB or Bluetooth driver on your device (PC, laptop, etc.).

Windows built-in drivers do not always work correctly with USB and Bluetooth devices. Use drivers provided by the device manufacturer.

Key Press Issues

A key does not register or registers intermittently

The issue may be related to the switch or the hot-swap socket. To identify the cause:

  1. Remove the switch from the problematic position using a switch puller.
  2. Inspect the switch pins — make sure they are not bent or broken.
  3. Inspect the socket — check for bent contact leaves inside.
  4. Insert a known-working switch into the problematic position:
    • Problem is gone → the original switch is faulty, replace it.
    • Problem persists → the socket is faulty, contact support.
Never insert a switch with a bent pin — it may damage the socket.
Multiple consecutive keys are not working

If a group of adjacent keys is not working, the issue is most likely with a row or column in the matrix.

  1. Make sure all switches in that area are fully seated in their sockets.
  2. Check whether any debris or liquid has gotten under the PCB.
  3. Reset to factory settings and test again.
  4. If the issue persists — contact support for PCB diagnostics.

Wireless Connection

Device does not appear in the Bluetooth list

Charge the device

Charge the device to rule out a depleted battery

Reset the Bluetooth profile

Clear the selected Bluetooth profile on the device and remove its previous pairing from the PC if it is still present

Try another device

Check whether the device can connect to another PC, phone, or other compatible device

Perform a cold reset of the PC

Shut down the computer, disconnect its power supply for 30–60 seconds, and discharge residual power by pressing the power button

Flash the settings reset firmware

Reflash the device using the settings reset firmware

Software Issues

Trackball: poor pointer accuracy, jerky cursor movement
Enhanced pointer precision (also known as mouse acceleration) is a feature that changes cursor speed depending on how fast you move the mouse. When using a trackball, it is often disabled for predictable, linear movement.

In Windows, this feature is called “Enhance pointer precision”. To disable it:

  1. Open Settings (press Win + I).
  2. Go to Bluetooth & devices → Mouse.
  3. On the right side, click Additional mouse settings.
  4. In the “Mouse Properties” window, go to the Pointer Options tab.
  5. Under Motion, uncheck “Enhance pointer precision”.
  6. Click Apply, then OK.

Note: Changes take effect immediately. You can also adjust the Pointer speed slider here if needed.

If Nothing Helped

Contact Ergohaven support — write to @Andrey_ergohaven with a description of the issue and, if possible, a photo or video. For warranty cases, an order number will be required.

Ergohaven Support
Message @Andrey_ergohaven on Telegram
Community
English chat in the Telegram group