Passar para o conteúdo principal

Solução de problemas para falhas de conexão da carteira de hardware com o App OneKey

95% dos usuários que encontram problemas de conexão com a carteira de hardware podem resolvê-los seguindo as etapas abaixo

Atualizado hoje

Por favor, siga as etapas de solução de problemas de acordo com sua plataforma atual e método de conexão.

🌄 Na versão mais recente do plugin do App OneKey, o OneKey Bridge não é mais necessário para conectar sua carteira de hardware. O método de conexão antigo, OneKey Bridge, foi descontinuado.


Windows

Solução de problemas de conexão USB

Driver USB ausente para a carteira de hardware

  1. Verifique se o seu dispositivo foi atualizado para o firmware mais recente. Consulte "Atualizando o firmware da carteira de hardware OneKey" para obter instruções de atualização.

  2. Abra o "Gerenciador de Dispositivos" do Windows e verifique em "Controladores USB (barramento serial universal)" por dispositivos que comecem com "OneKey". Se um dispositivo apresentar um ponto de exclamação, atualize o driver do Windows usando o método abaixo.

Solução

  1. Visite https://zadig.akeo.ie/ e baixe o pacote de instalação do "Zadig 2.9".

  2. Após abrir o instalador, selecione "WinUSB" para instalar.

    Reinicie o seu computador após a instalação para aplicar as alterações.

Solução de problemas de conexão Bluetooth

Verificação de versão e permissão

  1. Usando o App OneKey (versão 5.12 ou posterior), você pode conectar sua carteira de hardware ao computador via Bluetooth. Certifique-se de que sua carteira de hardware OneKey também esteja executando a versão de firmware mais recente. Consulte "Atualizando o firmware da carteira de hardware OneKey" para obter instruções de atualização.

  2. Verifique se o Bluetooth está desativado na sua carteira de hardware. Para o OneKey Pro, desative também o modo Air-Gap. Em seguida, bloqueie e desbloqueie sua carteira de hardware e tente conectar via Bluetooth novamente.

  3. Em "Configurações" - "Preferências", garanta que a função Bluetooth para o App OneKey esteja ativada.

Nota: A conexão Bluetooth não é compatível com a extensão do navegador. Por favor, use USB.


macOS

Solução de problemas de conexão USB

Autorização de sistema ausente para conexão de acessórios USB

  1. Verifique se o seu dispositivo foi atualizado para o firmware mais recente. Consulte "Atualizando o firmware da carteira de hardware OneKey" para obter instruções de atualização.

  2. Ao usar uma conexão USB-C, clique em "Permitir" no aviso de autorização.

  3. Se você negou a autorização anteriormente e o aviso não aparece mais, vá para "Ajustes do Sistema" - "Privacidade e Segurança" - "Segurança" - "Acessórios" e altere a configuração para "Sempre perguntar". Esta opção está disponível principalmente em MacBooks com Apple Silicon (M1/M2/M3, etc.).

Solução de problemas de conexão Bluetooth

Verificação de versão e permissão

  1. Usando o App OneKey (versão 5.12 ou posterior), você pode conectar sua carteira de hardware ao computador via Bluetooth. Certifique-se de que sua carteira de hardware OneKey também esteja executando a versão de firmware mais recente. Consulte "Atualizando o firmware da carteira de hardware OneKey" para obter instruções de atualização.

  2. Verifique se o Bluetooth está desativado na sua carteira de hardware. Para o OneKey Pro, desative também o modo Air-Gap. Em seguida, bloqueie e desbloqueie sua carteira de hardware e tente conectar via Bluetooth novamente.

  3. Em "Configurações" - "Preferências", garanta que a função Bluetooth para o App OneKey esteja ativada.

Nota: A conexão Bluetooth não é compatível com a extensão do navegador. Por favor, use USB.



Linux

Solução de problemas de conexão USB

Regras udev não definidas

  1. Verifique se o seu dispositivo foi atualizado para o firmware mais recente. Consulte "Atualizando o firmware da carteira de hardware OneKey" para obter instruções de atualização.

  2. Acesse https://data.onekey.so/onekey.rules para copiar as regras udev.

  3. Crie um novo arquivo em /etc/udev/rules.d/99-onekey.rules e cole as regras copiadas nele.

  4. No terminal, insira:

    sudo udevadm control --reload-rules

Android

Solução de problemas de conexão Bluetooth

Permissões não ativadas

  1. Verifique se o seu dispositivo foi atualizado para o firmware mais recente. Consulte "Atualizando o firmware da carteira de hardware OneKey" para obter instruções de atualização.

  2. Reinicie o App OneKey e o dispositivo de hardware OneKey, e ative individualmente as permissões de GPS e Bluetooth para o App OneKey em "Configurações do Sistema".

Nota: Se o modelo da sua carteira for OneKey Pro e o modo AirGap estiver ativado, o USB e o Bluetooth do dispositivo de hardware ficarão indisponíveis. Eles estarão utilizáveis após desativar o modo AirGap.


iOS

Solução de problemas de conexão Bluetooth

Permissões não ativadas

  1. Verifique se o seu dispositivo foi atualizado para o firmware mais recente. Consulte "Atualizando o firmware da carteira de hardware OneKey" para obter instruções de atualização.

  2. Ative e desative o Modo Avião uma vez. Isso redefinirá todos os módulos sem fio do seu telefone (Wi-Fi e Bluetooth).

  3. Vá para Ajustes -> Privacidade e Segurança -> Bluetooth e certifique-se de que a chave para o App OneKey esteja Ativada (verde).


Extensão do Chrome

Usando o método de conexão WebUSB

Mudando de Hardware Bridge para WebUSB

  1. Verifique se o seu dispositivo foi atualizado para o firmware mais recente. Consulte "Atualizando o firmware da carteira de hardware OneKey" para obter instruções de atualização.

  2. Abra o App OneKey, vá para Configurações > Rede > Comunicação de Hardware e altere o método de conexão para "WebUSB".

Nota: A OneKey atualizou o Hardware Bridge para uma conexão direta via WebUSB, portanto, nenhuma instalação adicional é necessária.


Ainda com problemas?

💁‍♀️ Se você ainda não consegue conectar sua carteira de hardware, clique no botão circular de atendimento ao cliente no canto inferior direito do site para entrar em contato com nosso suporte online.

Respondeu à sua pergunta?