This repo is designed for advanced users to enable mousekeys supports.
- main-with-native-mouse: For niceview with mouse support (for advanced users)
- oled-with-native-mouse: For oled with mouse support (for advanced users)
Please test before flashing to avoid complicating troubleshoot procedure.
After you make sure that the board can be connected and every key is registering, you can proceed to remap the keys according to your needs.
1. Please fork this main-with-native-mouse github repo. |
2. Go to keymap editor to edit keymap. Choose Github from the list. 3. Sign in your github account. |
4. Choose github repo you just forked in 1. Make sure you select the correct Branch main-with-native-mouse for mouse repo. |
5. Start edit your keymap, after finish click SAVE. |
6. For mouse keys, please refer to Keycode. Head to corne.keymap and key in mouse keycode. You can refer to layer 7 in Keymap Editor for some samples. |
7. Click save or commit changes. If it does not auto run, Go to Actions , click Build , Run workflow |
8. Click firmware and extract the two uf2 out. Drop to left and right respectively. |
Kindly note that some keycodes are different from zmk mouse repo, please refer to native-keycode for full list. Use these keycodes in corne.keymap
, some codes are not available and synced with Keymap Editor, you are not encouraged to remap mouse key in Keymap Editor.
You may refer to the demo for flashing procedure. Details as follow:
- Connect left and right splits to your pc (both connect together using type c cable).
- 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.
- Now press reset button on your left split, one window will be popped out as previous step.
- Drag left and right uf2 to respective folders.
- Do not disconnect right split yet.
- 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. - If so, remove the right split from type c cable. Both should be working good now!
- 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.
- Mac or Window OS connected but not responding, this is working for Bluetooth 5.2 Windows.
- Master connected and can type, but not slave refer to Split Keyboard Halves Unable to Pair.
- You may compile the reset.uf2 yourself or get it from setting reset.uf2.
- The board is pre-flashed with the mouse-native.uf2. You may always use these to test the board.
- No key is registering: have you toggled the power button? (if you have one)
- Blue light: you are connected to usb c and the board is charging
- Slight blue light blinking: you are connected to usb c but not connected to battery. Toggle power button to allow charging.
- Blink red once: when you toggle the power button on
- Flashing red: no firmware flashed to the mcu yet
- Blue light: you are connected to usb c and the board is charging
- Blue blinking: bootloader mode, no firmware is loaded