Atualizar Firmware - Versão Wireless
A Tergo Teclados pretende continuar realizando melhorias no firmware do teclado. Para atualizá-lo é fácil, basta seguir as instruções aqui presentes.
Onde baixar o firmware
Sempre que houver um lançamento de uma nova versão do firwmare, ela será publicada no repositório do Firmware e cada usuário notificado. Atente-se à dica abaixo para baixar o correto.
Basta clicar em cada arquivo do tipo .uf2 para baixar cada um.
Há 2 critérios a ter atenção ao baixar o arquivo para seu receptor, pois há 4 versões diferentes:
- Linguagem desejada: ABNT2 ou ANSI
- Versão ta tela utilizada: displayV1 ou displayV2
Baixe o arquivo que o nome equivale ao seu.
Qual versão da tela é a minha?
Basta verificar quando adquiriu o teclado ou o número do seu pedido.
- Se foi antes de 04/12/2025 (ou pedido 7261), você tem o displayV1
- Se foi depois de 04/12/2025 (ou pedido 7261), você tem o displayV2
Obs.: Ambas versões de telas são fisicamente iguais, mas usam tecnologias diferentes, por isso a diferença. Caso não tenha telas, qualquer uma delas pode ser utilizada. Se gravar a versão errada, não haverá danos no teclado, mas a tela apresentará erros visuais ou não funcionará.
Colocar firmware no teclado
O processo de gravação do firmware no teclado consiste em:
- Colocar a parte do teclado que receberá o firmware em modo de gravação
- Copiar e colar o arquivo especifico do firmware para essa parte na pasta que abrir no computador
- Repetir o processo conforme necessário para cada parte: receptor, metade esquerda e metade direita
Antes de gravar o firmware do teclado em sua respectiva parte, pode ser necessário gravar primeiro o firmware de reset.
Se você está atualizando o firmware pois alguma parte do teclado parou de funcionar e não apenas por atualizar funcionalidades, precisa gravar o reset-firmware antes de gravar o firmware próprio da parte.
Ou seja, o processo vira:
- Colocar em modo de gravação
- Colocar o firmware de reset
- Colocar novamente em modo de gravação
- Colocar firmware da parte do teclado
- Repetir o processo para cada parte
O reset-firmware é responsável por fazer com que o teclado tente parear novamente com as outras partes do teclado. Para isso, todas precisam terem sido resetadas usando esse firmware.
Atualizar o firmware pode acabar inesperadamente removendo as customizações que você realizou no teclado pelo ZMK Studio.
Por padrão, para resetar essas customizações isso é feito diretamente no painel do ZMK Studio.
Como gravar o firmware
Sequência de partes a gravar
Comece pelo receptor, e depois vá para as metades.
Passo a passo
1 - Desligue as metades do seu teclado
2 - Copie o arquivo que será gravado na parte do teclado
Lembre-se de decidir qual é seu caso com base no tópico anterior: gravar reset-firmware primeiro ou gravar diretamente o firmware dessa parte
3 - Com a parte do teclado a ser gravada conectada no computador, ative o modo de gravação dela.
Existem 2 caminhos para atualizar o firmware do seu teclado. Veja o que encaixa no seu caso:
- Método por atalhos no teclado: indicado para quem está customizando funcionalidades básicas do teclado, como camadas, funcionalidade do knob, macros, combos e outras funções similares, ou está apenas atualizando o firmware para uma nova versão oficial fornecida pela Tergo Teclados.
- Método físico: recomendado para quem precisa regravar todas as partes do teclado (receptor, metade esquerda e metade direita), pois trocou o receptor por um novo ou está tentando resolver algum problema (por exemplo, o teclado parou de responder após uma gravação).
4 - Uma pasta chamada NICENANO se abrirá no seu sistema operacional. Caso não abra automaticamente na sua tela, você pode procurar no menu de dispositivos:
5 - Cole o arquivo copiado na pasta que abriu.
Após isso, a pasta sumirá automaticamente e seu dispositivo estará utilizando a nova versão do firmware.
Pode ser que ao colocar o arquivo na pasta ela suma antes mesmo do sistema avisar que o arquivo foi transferido com sucesso, e assim aparecer na sua tela um erro de falha na transferência.
Isso é algo comum e que pode ser ignorado. Normalmente, o firmware foi gravado com sucesso e o que acontece é apenas uma falha de comunicação entre o sistema operacional e a placa do seu teclado, que fecha com o novo firwmare antes de avisar seu computador.
Se tiver algum outro problema tente ver a documentação oficial do ZMK ou nos notifique.
Sempre que você colocar o teclado em modo de gravação e abrir a pasta NICENANO, você não verá nela o arquivo do firmware que você colocou nela.
Isso é normal, pois o seu teclado "consome" o arquivo do firmware.
6 - Conforme necessário, faça os mesmos passos para cada parte do teclado: receptor, metade esquerda e metade direita.
Caso o teclado pare de responder a comandos após atualização, recomenda-se desligar e ligar todas as partes do teclado novamente.
Desconecte e conecte novamente o receptor ao seu computador. Caso o teclado ainda não responda, desligue e ligue novamente as metades do teclado.
Caso ainda assim, após tentar reiniciar todas as partes, o teclado não responda, repita todo o processo.
Ativar modo de gravação de cada parte fisicamente
Vídeo sobre o processo
Fizemos um vídeo que resume parte do passo a passo abaixo que pode ajudar você.
Ele explica um dos processos de gravação, que grava completamente todas as partes do teclado.
Entretanto, dependendo do seu objetivo, o processo pode ser mais simples que isso. Porém, o descrito no vídeo funcionará para todos.
Assim, recomendamos a leitura desse guia conforme necessário por possuir maior nível de detalhamento e ser mais atualizado.
Vídeo abaixo:
Fique atento também aos textos deste guia que são mais atualizados.
Ativar modo de gravação das partes do teclado
Para o receptor
Ao olhar para o seu receptor, você notará que ele possui um pequeno buraco na parte debaixo.
- Pegue um objeto metálico fino que possa ser inserido no buraco, como um clipe, uma pinça metálica, ou um pininho metálico
Nós enviamos um clipe com o teclado.
- Com o receptor conectado ao computador por cabo, toque brevemente 2 vezes na parte metálica vista nesse furo (normalmente dourada) com o objeto metálico
Às vezes 1 único toque, curto ou longo, basta para entrar em modo de gravação.
Espere um breve intervalo para ver se a pasta abrirá.
É normal que você não consiga de primeira, então tente novamente.
Caso você tenha feito isso com sucesso, deverá abrir a pasta de gravação do seu dispositivo no seu sistema operacional.
Grave o firwmare de reset, e então o firmware da partes específica do teclado.
Para as metades do teclado
Você precisará de acesso ao botão que está na placa eletrônica do seu teclado.
Para isso, você deverá abrir o protetor da placa controladora, que é a peça da parte de cima do teclado presa por 2 parafusos.
Use a chave philips que acompanha seu teclado para abrir os parafusos.
Remover apenas o parafuso que fica mais perto das teclas já te permite mover o protetor para o lado e ter acesso ao botão.
Assim, você encontrará um pequeno botão abaixo da chave de ligar/desligar.
Então, com a metade do teclado conectada ao seu computador por meio de cabo, pressione 2 vezes rapidamente o botão para o dispositivo entrar no modo de gravação.
Grave o firwmare de reset, e então o firmware da parte específica do teclado.
Use a parte de trás da chave (parte plástica) para pressionar o botão com facilidade.
Às vezes 1 único clique, curto ou longo, basta para entrar em modo de gravação.
Espere um breve intervalo para ver se a pasta abrirá.
É normal que você não consiga de primeira, então tente novamente.
Ativar modo de gravação por atalhos no teclado
Gravar o firmware no receptor
Muitas vezes customizações ou atualizações requerem apenas atualizar o firmware do receptor.
Esse método de mostra como fazer isso por meio de atalhos no teclado.
O processo é o seguinte:
1 - Copie o arquivo que será gravado no receptor
Se for necessário aplicar o firmware de reset, ele será gravado primeiro, e depois o processo repetido com o firmware correto.
2 - Com o receptor do teclado conectado ao seu computador e o teclado em pleno funcionamento, coloque o receptor em modo de gravação clicando ao mesmo tempo as 4 teclas abaixo no seu teclado:
3 - Uma pasta chamada NICENANO se abrirá no seu sistema operacional. Caso não abra automaticamente na sua tela, você pode procurar no menu de dispositivos:
4 - Cole o arquivo copiado na pasta que abriu
Após isso, a pasta sumirá automaticamente e seu dispositivo estará utilizando a nova versão do firmware.
5 - Teste se o teclado funciona
Caso o teclado pare de responder a comandos após atualização, recomenda-se desligar e ligar todas as partes do teclado novamente.
Desconecte e conecte novamente o receptor ao seu computador. Caso o teclado ainda não responda, desligue e ligue novamente as metades do teclado.
Caso ainda assim, após tentar reiniciar todas as partes, o teclado não responda, você provavelmente terá que aplicar o firmware de reset e gravar o firmware pelo método mais abaixo nesse guia: como ativar o modo de gravação fisicamente.
Gravar as metades do teclado
Caso você esteja realizando customizações no código-fonte do teclado por conta própria que alterem apenas o arquivo sofle.keymap, você geralmente só irá precisar atualizar o firmware do receptor, pois é ele que gere a maioria das funcionalidades.
Agora, para cada metade do teclado, você gravará a versão mais recente do firmware.
Repita os passos abaixo para cada metade:
5 - Copie o arquivo do firmware corresponde à metade do teclado que será atualizada (esquerda e então direita)
Grave primeiro a metade esquerda, pois facilita possíveis resoluções de problemas.
6 - Com o teclado em funcionamento, conecte um cabo USB extra do seu computador à metade do teclado que será atualizada
7 - Coloque a metade do teclado em modo de gravação. Para isso, segure a tecla de acesso a camada de ajustes (marcada em vermelho na imagem abaixo) e pressione a tecla que ativa o modo de gravação da metade desejada: Boot Left caso você vá gravar a metade esquerda do teclado ou Boot Right caso seja a direita.
Ambas teclas estão localizadas respectivamente no canto inferior esquerdo e canto inferior direito, conforme imagem abaixo:
8 - Repita os passos (3) e (4), que é localizar a pasta que abriu e colar o arquivo do firmware nela.
Repita para as metades do teclado.
Caso você tenha alterado a camada de ajustes e/ou a localização da tecla Bootloader (que é a tecla que ativa o modo de gravação), você pode acessar o software ZMK Studio e alocar a tecla Bootloader temporariamente na metade do teclado que você pretende colocar no modo de gravação.
Solução de problemas - teclado não responde após gravação
Caso seu teclado tenha parado de responder após atualizar alguma parte e você já tentou reiniciar individualmente cada parte, é provável que tenha acontecido algum dos itens abaixo:
- A atualização aplicada é disruptiva e ela requer a gravação prévia do firmware de reset ou ativação do modo de gravação fisicamente
- Você gravou o firmware de reset na parte do teclado que parou de funcionar e ainda não gravou o firmware da parte após isso
- Você usou uma versão customizada por você do firmware que contém algum erro
Para solucionar o problema, refaça o processo de gravação do firwmare fisicamente.