History

Joel Challis e068f7a8d1 RESET -> QK_BOOT user keymaps (#18560 )		2022-10-01 17:47:12 +01:00
..
keymaps	RESET -> QK_BOOT user keymaps (#18560 )	2022-10-01 17:47:12 +01:00
lib
config.h	Remove `UNUSED_PINS` (#17931 )	2022-08-06 23:23:35 +10:00
info.json	Move keyboard USB IDs and strings to data driven: M (#17859 )	2022-08-03 17:15:43 +10:00
mercutio.c	feat: encoder map, OLED & encoder kb-level config (#17767 )	2022-07-26 21:25:23 +01:00
mercutio.h
readme.md
rules.mk

readme.md

Mercutio

A through-hole 40% keyboard kit featuring an encoder and oled display.

Keyboard Maintainer: Kyle McCreery
Hardware Supported: Mercutio v1.0
Hardware Availability: Mercutio on MechWild

Make example for this keyboard (after setting up your build environment):

make mechwild/mercutio:default

Bootloader

Uses usbasploader, which has been preflashed on the atmega328p before being shipped to you. The usbasploader build available on hsgw's repository will work if you need to flash a new and unprepared replacement microcontroller. To flash this onto your fresh atmega328p, you will need to use the provided ISP headers and an external ISP programmer.

In order to put the board into bootloader mode you must first hold the boot button (labeled BOOT) and while holding the boot button, press the reset button (labeled RESET) and release it. Wait for another second, then release the boot button as well. The microcontroller will now be in bootloader mode if the bootloader is present and prepared correctly. Continue to flash as you normally would from this point (ie. QMK Toolbox). If you have autoflash enabled on QMK Toolbox, it will do it automatically now. Reset the board once more in order to use the new firmware (you can do this by unplugging and replugging it or by pressing and releasing the reset button.)

By default, Mercutio firmware has bootmagic enabled (lite). This means that instead of holding or pressing either of the small buttons, you are able to unplug the Mercutio, hold the top left button (tab), plug the Mercutio back in, and then release the top left button (tab). This will work the same to put the Mercutio into bootloader mode. For more information, see the bootmagic feature page. Reset the board once more in order to use the new firmware (you can do this by unplugging and replugging it or by pressing and releasing the reset button.)

See the build environment setup and the make instructions for more information. Brand new to QMK? Start with our Complete Newbs Guide.