readme.md

ZMK Config for Sofle

This is a quick config key remap for Sofle Zmk.

One of our Sofle variant: Sofle Hybrid with Low profile thumb cfx keycap + MX alpha keys Geekark BOW

1. Use Keymap Editor to remap the keys.
2. This is for Sofle with encoders and oled screen.

Bluetooth Connection Manual

Steps

1. Fork this to your github, make sure you have created a github account.

2. Untick this so it allows you to copy niceview and oled branches, then create fork.

3. Click action

4. Click the left .github/workflows/build..., and click Run workflow on right. Wait it run for a few minutes until a green tick.

5. Go to Keymap Editor.

6. Choose Add/remove repo...

6. Sign in to your github account and select repo.., choose zmk_config_sofle and save.

7. Now choose your repo and correct branch, and you can start mapping. Once it is done click save, wait until it finished compiling then click Latest.

8. Scroll down and go to download Firmware.

Flashing uf2 to split

You may refer to the demo for flashing procedure. Details as follow:

1. Connect left and right splits to your pc (both connect together using type c cable). You also can flash one side each time without using two cables.
2. Put right into bootloader mode (press the reset button), one window is popped out showing "nicenano" folder. Dont do anything yet, remember this folder as right split.
3. Now press reset button on your left split, one window will be popped out as previous step.
4. Drag left and right uf2 to respective folders.
5. Do not disconnect right split yet.
6. Remove left split from type c cable. Proceed to First time bluetooth connection to connect your board to pc. If successfully connected, you shall able to type without cable now.
7. If so, remove the right split from type c cable. Both should be working good now!
8. If you dont have extra usb c cable...You can do left first, then quickly move to right so the right can sync with left.

How to charge?

1. Flip your power button on while charging. If you turn it off means nothing is charged.
2. You can charge both sides together with usb c cable, not a problem.
3. You can charge while using it, but we dont encourage to continuously plugging in because battery may degrades.
4. If you would like to do it in wired mode, you can plug in but flip the power button off. So charging doesnt occur and battery doesnt degrade.

Common Issues and Troubleshooting

1. Mac or Window OS connected but not responding, this is working for Bluetooth 5.2 Windows.
2. Master connected and can type, but not slave refer to Split Keyboard Halves Unable to Pair.
3. You may compile the reset.uf2 yourself or get it from setting reset.uf2.
4. The board is pre-flashed with the mouse-native.uf2. You may always use these to test the board.
5. No key is registering: have you toggled the power button? (if you have one)

Light indicator from Supermini MCU

1. Blue light: you are connected to usb c and the board is charging
2. Slight blue light blinking: you are connected to usb c but not connected to battery. Toggle power button to allow charging.
3. Blink red once: when you toggle the power button on
4. Flashing red: no firmware flashed to the mcu yet

Light indicator from Nicenano v2 MCU

1. Blue light: you are connected to usb c and the board is charging
2. Blue blinking: bootloader mode, no firmware is loaded

Further Troubleshooting Trial and Error

1. For supermini: when i connect cable to pc, double press it, call out a nicenano explorer to lemme drop the new uf2. If i dont drop new firmware and un-plug it, then re-plug back, the nicenano folder will still pop out. I cant type anything. << this is normal.
2. For supermini: by referring to above, if i unplug the cable. Flip power button off and on again. My firmware remains. I can type again, but i did not drop in new firmware. When i plug in the usb, no nicenano folder pop out. << this is normal.