User manual: SoflePLUS2

TL;DR

  1. Use a USB-A to Type-C or Type-C to Type-C cable to connect your keyboard to your PC.
  2. Keep good practice to always connect type-c between split while the USB-C connection is still active. Doing so can cause issues. Some people experience problems even after making this mistake once, so be cautious.
  3. Insert your switches directly to your board. MX build comes with poron foam. For Choc builds, there’s a gap between the switch and the switch plate which is normal, this allows you to use a switch puller.
  4. If you have an Ergomech Enclosed Case for Sofle V2, read Installation Guide.

How to properly setup / connect your split keyboard

  1. First, connect the left and right halves of your keyboard using the Type-c cable. Ensure that the cable is fully inserted but not forced violently.
  2. Insert a USB-C (or Type-C) cable into the right side of your split keyboard.
  3. Note that you don’t need to insert a USB-C cable into both sides; only the right side requires it.
  4. Demo video.
  5.  The Type-C cable between split is already included.

 

Key remap

  1. Use Vial to remap the keys. You can download the software or use web interface to remap the keys. You may refer to Basic Vial Usage and Keymap Idea to explore Vial and keymap.
  2. Auto-detected in Vial, supports Win, Linux, and Mac. Real-time key remap software without the needs of code compilation. No load json is required.


Mac users

  1. LGUI/RGUI = Windows/Command/Meta
  2.  LALT = Option
  3. RALT = Option/AltGr
  4. Further please read Keycodes Overview

User Tab Explanation

  1. ATABF: alt+tab, cycle tab through window
  2. ATABR: alt+shift+tab, reverse cycle tab through window
  3. ATMU: alt + mousewheel allows you to control brush size in Photoshop or similar design software
  4. ATMD: alt + mousewheel allows you to control brush size in Photoshop or similar design software
  5. POWER: power button in window
  6. SCRUD: change scroll direction
  7. DPI+: increase the cursor speed, highest 9
  8. DPI-: decrease the cursor speed, lowest 1
  9. DPI0: reset to default cursor speed, default at 1

Troubleshooting

Certain keys are not registered

Check any bent pins on your switch.

Keys not mapping

Launch one application each time. Use Vial instead of Via. Do not launch together to avoid conflict.

Master is working, slave does not registering

If you have connected it the wrong way (removed or inserted the TRS cable while the USB-C connection was still active), it is possible that your MCU is already bricked. However, you can try these steps to troubleshoot.

Reconnect the cables (remove USB-C, ensure TRS cable is fully pushed, and re-insert USB-C).

If the issue persists, try different cables or ports and consider restarting your PC.

It was working, suddenly not.

Check the MCU to ensure it is not accidentally lifted. In certain builds, the MCU is socketed rather than soldered to the PCB.


Firmware

This is for SoflePLUS2 with usb-c to c connection and dpi spinning disk only.

Now comes with DPI- in User tab for easier customisation.

Enhance oled display to show DPI value of cursor speed. Limit it from 1 to 9 only. Capslock indicator is omitted as able to indicate through RGB. Numlock is simplified to fit in more info. N only shows if numlock is off.

0 (default rgb effect set by user), 
1 (purple), 
2 (orange), 
3 (cyan), 
4 (springgreen), 
5 (blue), 
6 (magenta), 
7 (white), 
8 (gold), 
9 (default rgb effect set by user), 
capslock (red)

 

Latest firmware v2.04 (beta) for default trackpad. Check here for list of firmware and flashing guide. Use the preset layout here if you messed up your keymap. Considering the time we’ve spent configuring the board firmware, we’ve decided not to release the open-source codes. You’re welcome to use the sofle branch, but please be aware that the board uses RP2040 instead of ATmega32U4 for compilation.