SoflePLUS2
User Manual & Troubleshooting
Last updated
User Manual & Troubleshooting
Last updated
This is useful if you want to use the keyboard across different operating systems, especially Windows and macOS.
Open System Settings
Go to Keyboard
Click Modifier Keys
Swap Control and Command etc.
Click Done
Now on Windows, if you register LCTL(KC_B), it will send Control + B. But on macOS, it will send Command + B instead.
Adjusted values for wear_leveling_logical_size, backing_size, and dynamic_keymap_eeprom to support 16MB flash.
If you experience firmware resets, try lowering RGB brightness to a maximum of 80% and save the setting in Vial.
Update on 2025-3-5. Let us know if issues persist.
This is for pcb released after mid-dec 2024
Disable un-used azoteq gestures since they are not working, and interfered the usage (zoom, swipe x, swipe y)
Remove SPLIT_WATCHDOG_ENABLE and replace with #define USB_VBUS_PIN GP19
Update on 2025-1-25
This project is currently in beta.
For new pcb released in mid-dec 2024: spinning disk in v0.9, left PCB v2.09.
Remove #define SPLIT_WATCHDOG_ENABLE and usb detect and replace with #define SPLIT_WATCHDOG_ENABLE for re-plug issue
Center click (GP12) of spinning disk remains as left click, the rest remappable in Vial, new Col6 introduced with massive change on the code.
Update on 2024-12-13
This is for pcb released before mid-dec 2024 and with type-c connection.
Disable un-used azoteq gestures since they are not working, and interfered the usage (zoom, swipe x, swipe y)
Remove SPLIT_WATCHDOG_ENABLE and replace with #define USB_VBUS_PIN GP19
Update on 2025-1-25
The master OLED flickers when the keyboard goes to sleep on macOS. Otherwise, everything works fine, including returning to normal upon wake.
Update on 2024-12-6
Realise some lighting effects dont appear properly especially on heatmap etc. Issue fixed.
Fix default layer indicator for Layer 2, changes from yellow to the more appealing cyan.
Add last row of thumb keys and rgb underglow as layer and capslock indicator
Udate on 2024-11-27
This is for batch after 12.12.2024. Instruction: enable support, 15% infill (adjust according to your needs). Please get advice from us if you are not sure which one to download.
LP version
Batch before 12.12.2024. If you are not sure please dm us with your order number.
Kindly note that the thickness of acrylic layers may vary depending on batches or suppliers. This version has a 2.5mm design (actual thickness: 2.4mm).
Bottom silver screw m2*4
Inner standsoff m2*7, outer m2*13, oled cover m2*15, disk and trackpad holder m2*13
Top screw inner m2*4, outer m2*5
The SoflePlus2 supports both small (TPS43) and large (TPS65) trackpads. While we primarily supply the smaller TPS43 due to its compact and less protrusive design, you can opt for the larger TPS65 trackpad if preferred. Below are the details on how to request or retrofit the TPS65 trackpad.
Why TPS43 is Our Default
Compact size, reducing bulkiness.
More stable and secured.
Requesting TPS65 with Your Order
You can purchase the TPS65 kit directly from us via email when placing your order. We will include it with your board shipment.
The TPS65 kit includes:
TPS65 3D Mount with 0.5mm double-sided tape
1x Ribbon Cable (6-pin, 5-6cm, forward direction)
Case compatibility: Fits both TPS65 and TPS43 (LP version remains the same; MX version includes a right-side cutout)
Note: The overlay must be purchased separately.
Retrofitting TPS65 to Your Existing Build
If you’ve already purchased SoflePlus2 and want to switch to the TPS65 later, you’ll need:
6-Pin FFC/FPC Ribbon Cable (0.5mm pitch, 5-6 cm length, forward direction).
0.5mm Double-Sided Tape (to attach the trackpad to the mount).
Polypropylene Overlay (to cover the trackpad).
💡 Compatibility Tip: For low-profile builds, your existing case is compatible with both TPS43 and TPS65 trackpads. No new case is needed.
💡 Firmware Changes for TPS65: If you’re retrofitting, you’ll need to download or update the firmware to accommodate the TPS65 trackpad.
Other Users: Modify the code and recompile the firmware.
Prepare the Ribbon Cable:
Attach the Ribbon Cable to the PCB:
Mount the Trackpad:
Apply the Overlay:
Remove the seal and place the overlay carefully on top of the trackpad.
Troubleshooting and Tips
Ensure all connections are secure.
If the trackpad does not respond, verify the ribbon cable orientation.
After flashing new firmware, press DPI0 to enable the trackpad.
If the OLED screens on both sides display the same rocket animation and the keyboard is unresponsive:
Ensure the port supports data transmission: Some charging-only ports may not work for data, causing the keyboard to be unresponsive.
Verify that the Type-C cable supports data transfer: Make sure the Type-C cable you're using is capable of both data transfer and power delivery.
If the trackpad is unresponsive, which typically occurs after flashing new firmware:
Remap and press the DPI0 key to activate the trackpad. You can find this key under the User tab in Vial.
Refer to
To begin remapping your keyboard, download the Vial software or use the Vial web interface. You can access it at Read more on .
This update is in beta and requires testing. Refer if you are not familiar with update firmware.
For Starter or Standard (without RGB underglow, with per key only), download , .
For Signature (with RGB underglow and per key), download this , .
v3.01 (pcb after mid-dec 2024), v2.06 (pcb before mid-dec 2024). Refer if you are not familiar with update firmware.
For Starter or Standard (without RGB underglow, with per key only), download this , with large trackpad
For Signature (with RGB underglow and per key), download this , with large trackpad
For Starter or Standard without RGB underglow, please download this . Large trackpad .
For Signature or with RGB underglow and Per key, please download this .
For Starter or Standard (without RGB underglow, with per key only), download this . , .
For Signature (with RGB underglow and per key), download this . .
For Starter or Standard without RGB underglow, please download this
For Signature or with RGB underglow and Per key, please download this
For Starter or Standard without RGB underglow, please download this
For Signature or with RGB underglow and Per key, please download this
(v20250309)
If you wish to purchase TPS65, it’s available from .
(compatible with low-profile builds).
December 2024 Users: Download the updated firmware directly from the section.
