Manual de Atualização do 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.
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:
Para que atualizar o firwmare?
Alguns motivos do porquê você pode querer atualizar o firmware:
- Trocar entre a versão ABNT2 ou Internacional
- Instalar uma atualização nova do firmware fornecida pela Tergo Teclados
- Colocar sua versão customizada do firmware
- Usar um novo receptor para o teclado
Baixar firmware atualizado
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.
Baixe a versão mais recente do firwmare para garantir que você está em dia com as atualizações.
Basta clicar em cada arquivo do tipo .uf2 para baixar cada um.
Baixe o arquivo para o receptor com o padrão de linguagem desejado: internacional ou ABNT2. Escolha apenas um deles para gravar no seu receptor.
Colocar firmware no teclado
O processo de gravação do firmware no teclado consiste em colocar em modo de gravação e copiar e colar o arquivo do firmware de reset e então o arquivo de firmware dessa parte do teclado que precisa ser atualizada.
Atualizar o firmware não irá remover as customizações que você realizou no teclado pelo ZMK Studio. Isso é feito diretamente no painel do ZMK Studio.
Há 2 formas de colocar o teclado em modo de gravação
Você precisará colocar o teclado em modo de gravação para colocar o firmware.
Há 2 maneiras:
- Por meio de interações com componentes do seu teclado;
- Ou por meio de clicar uma combinação de atalhos no teclado.
A segunda é mais simples, mas apenas funcionará caso seu teclado esteja funcionando normalmente, como por exemplo:
- Instalar atualização no seu teclado que adicionou funcionalidades novas.
A primeira maneira funcionará para todos os casos. Por exemplo:
- Seu teclado parou de funcionar e precisa regravar o firmware;
- Você está trocando o receptor do seu teclado por um novo e precisa reconfigurá-lo.
Mais abaixo nesse guia te mostraremos isso.
Como gravar o firmware
Primeiramente, desligue as metades do seu teclado.
Então, o processo é o seguinte:
1 - Copie o arquivo que será gravado no receptor: Primeiramente será o de reset, e, em uma segunda gravação, o do receptor.
Antes de gravar o firwmare do teclado em sua respectiva parte, pode ser necessário gravar primeiro o firmware de reset.
Ou seja, a sequência para gravar o firmware acabará sendo:
Colocar em modo de gravação -> Colocar o firmware de reset -> Colocar novamente em modo de gravação -> Colocar firmware da parte do teclado
Alguns casos em que você não vai precisar gravar o firmware de reset é caso esteja instalando uma customização que requer gravar apenas o firmware no receptor, como:
- Customizações que você mesmo fez no firmware;
- Atualizações no firwmare que a Tergo Teclados deixou explícito que basta atualizar o receptor.
2 - Com a parte do teclado a ser gravada conectada no computador, ative o modo de gravação dela.
Isso é mostrado mais abaixo, em:
Como ativar modo de gravação (forma física).
Ou em como ativar modo de gravação por meio de atalhos no 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.
Em alguns dispositivos, pode ser que, ao colocar o arquivo na pasta, a pasta 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 na verdade o seu teclado "consome" o arquivo do firmware.
5 - Repita o processo após gravar o firmware de reset para gravar o firmware da parte do teclado.
6 - 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
Para cada parte do teclado você precisará ativar o modo de gravação dela para gravar o firmware nela.
Há uma técnica para ativar o modo de gravação por meio de atalhos no teclado, mostrada mais abaixo. Entretanto, ela é recomendada apenas para quem fez customizações no firmware e está atualizando apenas o receptor.
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.
Gravar o firmware no receptor - método por atalhos no teclado
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.