Customizing key layout and swapping keycaps

Customizing key layout

Each of us has a different hand size and shape, typing habits, and different application needs.

Go60 and its open-source ZMK-based firmware make it easy for you to customize your Go60 to have exactly the key layout you want.

There are a few ways to change the key layout. The easiest way is to use the MoErgo Layout Editor. An alternative is to edit the keymap file and compile your own ZMK firmware For more information on this, please see Appendix: ZMK.

After you have built a new ZMK firmware with the new key layout using either approach, you will have to load the firmware onto Go60. To do this, follow the instructions in the Loading new ZMK firmware onto your Go60 section.

MoErgo Layout Editor

MoErgo Layout Editor not yet available

The Go60 Layout Editor at https://my.moergo.com/go60 is not yet enabled for public access.

MoErgo Layout Editor is an optional MoErgo service designed to complement your Go60. MoErgo Layout Editor is an on-line web app accessible on most modern browsers, including on desktops and mobile devices. With MoErgo Layout Editor you can graphically design your own layout, and generate the firmware without any application installation.

MoErgo Layout Editor

To use MoErgo Layout Editor, you will need to create an account, subject to its terms of use.

MoErgo Layout Editor is simple to use and learn. The MoErgo Layout Editor Guide is here.

Loading new ZMK firmware onto your Go60

The MoErgo Layout Editor generates a .uf2 file which is the new firmware containing the new key layout. This new firmware needs to be loaded onto both halves of your Go60.

To do this safely, you will need:

• A spare keyboard or on-screen keyboard (as safety insurance)
• A USB-C cable to connect from your computer to Go60

The steps to load the new firmware are:

1. First plug in the USB-C cable to the right half of your Go60 and to the host computer.
2. Put the right half into bootloader mode. On the default key layout, this is done by pressing the keys Magic + \ (note: single-quote). If this doesn’t work or if you have changed your layout, please see the section on Putting Go60 into Bootloader for Firmware Loading.
3. If successful, the bootloader will present a USB Mass Storage Device. As an example, on Windows you will see a File Explorer window with the name GO60RHBOOT.

Tips

We have multiple reports from users that a faulty USB hub or a faulty USB cable causing issues for firmware flashing, despite the cable and USB hub being able to transmit keystrokes. Please refer to this Troubleshooting FAQ entry if you suspect such an issue.

Note

If you need to leave the bootloader without loading new firmware, simply power Go60 off and on again using the power switch.

4. Copy the .UF2 file onto this Mass Storage Device. If successful the Mass Storage Device will disappear.

Note

There is no need to rename the UF2 file to CURRENT.UF2. Any filename with the extension of .UF2 suffices

Warning

Recent versions of macOS fail to perform the file copy if the UF2 filename is too long. To work around this issue, simply rename the file with a shorter name before copying it. Please see this Troubleshooting FAQ entry for details.

5. Next plug in the USB-C cable to the left half of your Go60 and to the host computer.
6. Put the left half into bootloader mode. On the default key layout, this is done by pressing the keys Magic + Tab. If this doesn’t work, or if you have changed your layout, please see the section Putting Go60 into Bootloader for Firmware Loading.
7. If successful, the bootloader will present a USB Mass Storage Device. As an example, on Windows you will see a File Explorer window with the name GO60LHBOOT.

8. Copy the .UF2 file into this Mass Storage Device. If successful the Mass Storage Device will disappear.

9. After a firmware version change or changes made to Advanced Configuration, it is generally recommended to perform a Configuration factory reset and re-pairing left and right halves procedure.

Putting Go60 into Bootloader for firmware loading

The bootloader is the piece of software that runs immediately after you turn on a Go60 half. Normally it will simply pass the control over to the ZMK firmware. However, it also has the ability to load new ZMK firmware by presenting a USB mass storage device.

There are two ways to put Go60 into the bootloader mass storage device mode for firmware loading. The first way (Entering bootloader mass storage device mode on power-up) is more reliable as it does not require a working ZMK installation, nor a connection between the left half and the right half. It works even if the two halves have different ZMK firmware versions. This is the recommended method.

You can tell if a Go60 half has successfully entered into bootloader mass storage device mode by the slow pulsing red LED next to the power switch. If the red LED is fast flashing, it indicates that the Go60 half is in bootloader mode but there is no USB connection with the host. If the red LED is solid red or off, the Go60 is not in bootloader mode.

Entering bootloader mass storage device mode on power-up

To put the left half into the bootloader mass storage device mode:

1. Switch off the power switch of the left half
2. Connect a USB cable from the host to the left half
3. Referring to the row-column key above, hold T3 + C3R3 (Ctrl + D on the default layout)
4. While holding the two keys, switch on the power switch of the left half

To put the right half into the bootloader mass storage device mode:

1. Switch off the power switch of the right half
2. Connect a USB cable from the host to the right half
3. Referring to the row-column key above, hold T3 + C3R3 (Alt + K on the default layout)
4. While holding the two keys, switch on the power switch of the right half

Entering bootloader mass storage device mode from ZMK

Another way is to use the key mapping on the ZMK key layout by activating the &bootloader behavior on the half of the Go60 that you want to load new firmware.

On the default key layout, you can do so by

• First connect a USB cable from the host to the half of Go60 you want to load firmware
• Pressing Magic + Tab for the left half
• Pressing Magic + \ for the right half

Warning

This method does not work if the ZMK installation is corrupted, or the left half and the right half are not communicating, or the two halves have different ZMK firmware versions. If keystrokes from your right half are not getting through to the host, this method is not likely to work. Please use Entering bootloader mass storage device mode on power-up instead.

Replacing keycaps to match key layout

Changing the key layout will change the behavior of the keys; however, if you are using labeled keycaps, the labels will no longer match the now function of the modified keys.

Go60 is designed so that all keys use the same keycap profile, which means the keycaps are freely interchangeable between any two keys.

Be gentle when pulling the keycaps off

Here is how to match the keycaps with the modified key layout:

1. Use the included keycap puller to gently pull out the keycaps that no longer match the key layout.

Danger

DO NOT APPLY EXCESSIVE FORCE. It is important that you pull out the keycap gently; excess force can cause permanent damage to the key switch . DAMAGE CAUSED BY KEYCAP REPLACEMENT IS NOT COVERED BY THE WARRANTY.

2. Push the correct keycaps gently onto the switches to match the modified key layout.