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
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 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
Visite https://zadig.akeo.ie/ e baixe o pacote de instalação do "Zadig 2.9".
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
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.
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.
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
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 aviso de autorização.
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
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.
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.
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
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, insira:
sudo udevadm control --reload-rules
Android
Solução de problemas de conexão Bluetooth
Permissões não ativadas
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 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
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 redefinirá todos os módulos sem fio do seu telefone (Wi-Fi e Bluetooth).
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
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 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.







