DEV Community

a2n
a2n

Posted on

Flashing the Lily58 R2G with QMK

Lately I got a Lily58 R2G (from mechboards uk) and broke the code for some reason. So to fix that I have to flash the keyboard with the default layout for Vial.

The process is not so hard, but the lack of clear examples can lead to lost time and errors, so here is the full to-do:

  1. The first step is quite simple: you have to install QMK MSYS exactly as described here at step #2: https://docs.qmk.fm/newbs_getting_started#set-up-your-environment
  2. After having QMK MSYS installed, the next step is to set it up, but not from the original repo, instead from the MechboardsLTD one (https://github.com/MechboardsLTD/vial-qmk/tree/r2g/keyboards/mechboards/lily58/r2g). For that we have to execute the following command: qmk setup MechboardsLTD/vial-qmk. If this command doesn't work, another solution is to execute qmk setup, then clone the repository and use the clone to set up QMK with qmk setup -H path/to/the/clone
  3. Here we need to switch to the r2g branch with a good old git checkout r2g (obviously you have to be in the repository to do that)
  4. To test that everything is correct, you can execute this command and check if the result lists mechboards/lily58/r2g: qmk list-keyboards | grep mechboards
  5. If everything is correct, you can now edit the config file if wanted and then build the uf2 file with qmk compile -kb mechboards/lily58/r2g -km vial
  6. In my case, the uf2 file was generated in the root folder of the vial-qmk repository we set up at step 2
  7. When you have this file, you have to plug the main part only of the keyboard into your PC while pressing the bootloader physical button located at the back of the board, the button is here:

photo of the flash button at the back of the keyboard

  1. While pressing the button and plugging in the keyboard, a new USB device should appear on your system, the name should be RPI-RP2. If this is the case, you simply have to place the uf2 file in the folder and the keyboard should reset itself
  2. Unplug the keyboard, replug the right part, replug the keyboard and voilà :)

Top comments (0)