Instalando e atualizando o firmware (QMK / ZMK)

QMK e ZMK são os dois firmwares mais usados em teclados customizados. QMK é maduro, escrito em C e voltado principalmente para teclados com fio (controladores como Pro Micro, Elite-C e RP2040). ZMK é mais novo, baseado no Zephyr RTOS e foi desenhado para conexão sem fio via Bluetooth Low Energy (controladores como nice!nano). A escolha geralmente já vem definida pelo controlador do seu teclado.

Para gravar o firmware é preciso colocar o controlador em modo bootloader. Em controladores RP2040 e nice!nano, isso costuma ser feito tocando duas vezes no botão de reset; o teclado aparece como um pendrive (RPI-RP2 ou NICENANO) e basta arrastar o arquivo .uf2 para dentro. Em Pro Micro/Elite-C com QMK, use o QMK Toolbox: selecione o arquivo .hex, aperte reset uma vez e o programa grava automaticamente. Sempre grave a metade direita e a esquerda separadamente, com o firmware correto para cada lado.

Para gerar o firmware você tem três caminhos: o QMK Configurator e o ZMK Studio permitem editar pelo navegador e baixar o arquivo pronto; o QMK CLI e o GitHub Actions do ZMK permitem builds locais ou na nuvem a partir de um fork do repositório, ideal para customizações maiores. Antes de atualizar, anote seu keymap atual ou faça commit do seu fork — isso facilita reverter se algo der errado.