SoflePLUS2

Introduction

Features and Highlights

---

Essential Knowledge

Getting Started

---

Software and Firmware

Software

To begin remapping your keyboard, download the Vial software or use the Vial web interface. You can access it at https://get.vial.today/.

Read more on Software Key Remapping.

Firmware

Latest Firmware: v3.00 beta, v2.05a

Basic Configuration

• Vial support

• 10 Layers

• 32 Tap dance

• 32 Combo

• 32 Key overrides

• Qmk settings

• Mousekey

• Mediakey

RGB Support

• RGB lighting

• RGB matrix

Special Keycode

• ATABF (cycle window forward), ATABR (cycle window previous)

• ATMWU (alt mouse wheel up), ATMWD (alt mouse wheel down)

---

v3.00 beta

• 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.

• For Starter or Standard without RGB underglow, please download this v3.00. Large trackpad v3.00_65.

• For Signature or with RGB underglow and Per key, please download this v3.00 Signature.

• Update on 2024-12-13

---

v2.05a - Master oled flickering on mac

• The master OLED flickers when the keyboard goes to sleep on macOS. Otherwise, everything works fine, including returning to normal upon wake.

• For Starter or Standard without RGB underglow, please download this v2.05a

• For Signature or with RGB underglow and Per key, please download this v2.05ua

• Update on 2024-12-6

---

v2.05 - RGB matrix fix

• 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

• For Starter or Standard without RGB underglow, please download this v2.05

• For Signature or with RGB underglow and Per key, please download this v2.05u

• Udate on 2024-11-27

Keymap

Layout Inspiration

---

Hardware Modifications

3D Case

Large Trackpad

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.

If you wish to purchase TPS65, it’s available from Keycapsss (Germany).

---

Requesting TPS65 with Your Order

If you want to use TPS65 instead of TPS43, please leave a note during checkout or contact us directly. We’ll include the following items free of charge in your package:

• TPS65 3D Mount

• Ribbon Cable (6-Pin, 5-6 cm, Forward Direction)

• 0.3mm Polypropylene Overlay

⚠️ Note: The TPS43, OLED display and OLED acrylic cover will not be included in the package. We’ll test the TPS65 trackpad before shipment to ensure functionality.

---

Retrofitting TPS65 to Your Existing Build

If you’ve already purchased SoflePlus2 and want to switch to the TPS65 later, you’ll need:

1. TPS65 3D Mount (compatible with low-profile builds).

2. 6-Pin FFC/FPC Ribbon Cable (0.5mm pitch, 5-6 cm length, forward direction).

3. 0.5mm Double-Sided Tape (to attach the trackpad to the mount).

4. 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.

• December 2024 Users: Download the updated firmware directly from the Software and Firmware section.

• Other Users: Modify the code and recompile the firmware.

---

Installation Guide

1. Prepare the Ribbon Cable:

   

   Gently pull down the clip of the header.

   

   Insert the ribbon cable with the blue sticker facing you.

   

   Push back the clip to secure it.

2. Attach the Ribbon Cable to the PCB:

   

   Slot the ribbon cable through pcb with the trackpad from the top.

   

   Pull up the clip of the header on the PCB gently.

   

   Insert the other side of the ribbon cable, ensuring the blue sticker faces you.

   

   Push the clip back to secure the cable to the PCB.

3. Mount the Trackpad:

   

   Push the excess ribbon cable towards the front.

   

   Remove the seal from the double-sided tape on the 3D mount.

   

   Position the trackpad on the mount, ensuring the orientation matches the reference photo. Incorrect orientation may invert the trackpad direction.

4. 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.

---

Common Issues and Fixes

Keyboard Not Responding - Same Animation on Both Sides

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.

Trackpad Not Responsive

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.