Siga as etapas de solução de problemas de acordo com sua plataforma e método de conexão atuais.
🌄 Na versão mais recente do plugin do aplicativo OneKey, o OneKey Bridge não é mais necessário para conectar sua carteira de hardware. O antigo método de conexão OneKey Bridge foi descontinuado.
Windows
Solução de problemas de conexão USB
Driver USB ausente para a carteira de hardware
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.
Abra o "Gerenciador de Dispositivos" do Windows e verifique em "Controladores de barramento serial universal" se há dispositivos que começam com "OneKey". Se um dispositivo mostrar um ponto de exclamação, atualize o driver do Windows usando o método abaixo.
Solução
Visite https://zadig.akeo.ie/ e baixe o pacote instalador "Zadig 2.9".
Após abrir o instalador, selecione "WinUSB" para instalar.
Reinicie o 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
Usando o aplicativo OneKey (versão 5.12 ou posterior), você pode conectar sua carteira de hardware ao seu 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.
Verifique se o Bluetooth está desabilitado em sua carteira de hardware. Para o OneKey Pro, desabilite também o modo Air-Gap. Em seguida, bloqueie e desbloqueie sua carteira de hardware e tente conectar via Bluetooth novamente.
Em "Configurações" - "Preferências", certifique-se de que a função Bluetooth para o aplicativo OneKey esteja habilitada.
Observação: A conexão Bluetooth não é suportada pela extensão do navegador. Por favor, use USB.
macOS
Solução de problemas de conexão USB
Autorização do sistema ausente para conexão de acessório USB
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.
Ao usar uma conexão USB-C, clique em "Permitir" no prompt de autorização.
Se você negou a autorização anteriormente e o prompt não aparece mais, vá para "Ajustes do Sistema" - "Privacidade e Segurança" - "Segurança" - "Acessórios" e mude a configuração para "Perguntar sempre". 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
Usando o aplicativo OneKey (versão 5.12 ou posterior), você pode conectar sua carteira de hardware ao seu 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.
Verifique se o Bluetooth está desabilitado em sua carteira de hardware. Para o OneKey Pro, desabilite também o modo Air-Gap. Em seguida, bloqueie e desbloqueie sua carteira de hardware e tente conectar via Bluetooth novamente.
Em "Configurações" - "Preferências", certifique-se de que a função Bluetooth para o aplicativo OneKey esteja habilitada.
Observação: A conexão Bluetooth não é suportada pela extensão do navegador. Por favor, use USB.
Linux
Solução de problemas de conexão USB
Regras udev não definidas
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.
Acesse https://data.onekey.so/onekey.rules para copiar as regras udev.
Crie um novo arquivo em /etc/udev/rules.d/99-onekey.rules e cole as regras copiadas nele.
No terminal, digite:
sudo udevadm control --reload-rules
Android
Solução de problemas de conexão Bluetooth
Permissões não habilitadas
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.
Reinicie o aplicativo OneKey e o dispositivo de hardware OneKey, e habilite individualmente as permissões de GPS e Bluetooth para o aplicativo OneKey em "Configurações do Sistema".
Observação: Se o seu modelo de carteira for OneKey Pro e o modo AirGap estiver ativado, o USB e o Bluetooth do dispositivo de hardware não estarão disponíveis. Eles estarão utilizáveis após desabilitar o modo AirGap.
iOS
Solução de problemas de conexão Bluetooth
Permissões não habilitadas
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.
Ative e desative o Modo Avião uma vez. Isso irá redefinir todos os módulos sem fio do seu telefone (Wi-Fi e Bluetooth).
Acesse Ajustes -> Privacidade e Segurança -> Bluetooth e certifique-se de que o alternador para o aplicativo OneKey esteja Ativado (verde).
Extensão Chrome
Usando o método de conexão WebUSB
Mudando de Hardware Bridge para WebUSB
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.
Abra o aplicativo OneKey, vá para Configurações > Rede > Comunicação de hardware e mude o método de conexão para "WebUSB".
Observação: A OneKey atualizou o Hardware Bridge para uma conexão WebUSB direta, 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 de atendimento ao cliente circular no canto inferior direito do site para entrar em contato com nosso suporte online.







