Veuillez suivre les étapes de dépannage en fonction de votre plateforme et de votre méthode de connexion actuelles.
🌄 Dans la dernière version du plugin OneKey App, OneKey Bridge n'est plus requis pour connecter votre portefeuille matériel. L'ancienne méthode de connexion OneKey Bridge a été abandonnée.
Windows
Dépannage de la connexion USB
Pilote USB manquant pour le portefeuille matériel
Vérifiez si votre appareil a été mis à jour vers le dernier firmware. Reportez-vous à "Mise à jour du firmware du portefeuille matériel OneKey" pour les instructions de mise à jour.
Ouvrez le "Gestionnaire de périphériques" de Windows et vérifiez sous "Contrôleurs de bus USB" les périphériques commençant par "OneKey". Si un périphérique affiche un point d'exclamation, mettez à jour le pilote Windows en utilisant la méthode ci-dessous.
Solution
Visitez https://zadig.akeo.ie/ et téléchargez le package d'installation "Zadig 2.9".
Après avoir ouvert l'installeur, sélectionnez "WinUSB" à installer.
Redémarrez votre ordinateur après l'installation pour appliquer les modifications.
Dépannage de la connexion Bluetooth
Vérification de la version et des autorisations
En utilisant OneKey App (version 5.12 ou ultérieure), vous pouvez connecter votre portefeuille matériel à votre ordinateur via Bluetooth. Assurez-vous que votre portefeuille matériel OneKey exécute également la dernière version du firmware. Reportez-vous à "Mise à jour du firmware du portefeuille matériel OneKey" pour les instructions de mise à jour.
Vérifiez si le Bluetooth est désactivé sur votre portefeuille matériel. Pour OneKey Pro, désactivez également le mode Air-Gap. Ensuite, verrouillez et déverrouillez votre portefeuille matériel et réessayez la connexion via Bluetooth.
Dans "Paramètres" - "Préférences", assurez-vous que la fonction Bluetooth pour OneKey App est activée.
Remarque : la connexion Bluetooth n'est pas prise en charge par l'extension de navigateur. Veuillez utiliser l'USB.
macOS
Dépannage de la connexion USB
Autorisation système manquante pour la connexion d'accessoire USB
Vérifiez si votre appareil a été mis à jour vers le dernier firmware. Reportez-vous à "Mise à jour du firmware du portefeuille matériel OneKey" pour les instructions de mise à jour.
Lors de l'utilisation d'une connexion USB-C, cliquez sur "Autoriser" dans la fenêtre d'invite d'autorisation.
Si vous avez précédemment refusé l'autorisation et que l'invite n'apparaît plus, accédez à "Paramètres système" - "Confidentialité et sécurité" - "Sécurité" - "Accessoires" et changez le paramètre sur "Toujours demander". Cette option est principalement disponible sur les MacBooks avec Apple Silicon (M1/M2/M3, etc.).
Dépannage de la connexion Bluetooth
Vérification de la version et des autorisations
En utilisant OneKey App (version 5.12 ou ultérieure), vous pouvez connecter votre portefeuille matériel à votre ordinateur via Bluetooth. Assurez-vous que votre portefeuille matériel OneKey exécute également la dernière version du firmware. Reportez-vous à "Mise à jour du firmware du portefeuille matériel OneKey" pour les instructions de mise à jour.
Vérifiez si le Bluetooth est désactivé sur votre portefeuille matériel. Pour OneKey Pro, désactivez également le mode Air-Gap. Ensuite, verrouillez et déverrouillez votre portefeuille matériel et réessayez la connexion via Bluetooth.
Dans "Paramètres" - "Préférences", assurez-vous que la fonction Bluetooth pour OneKey App est activée.
Remarque : la connexion Bluetooth n'est pas prise en charge par l'extension de navigateur. Veuillez utiliser l'USB.
Linux
Dépannage de la connexion USB
Règles udev non définies
Vérifiez si votre appareil a été mis à jour vers le dernier firmware. Reportez-vous à "Mise à jour du firmware du portefeuille matériel OneKey" pour les instructions de mise à jour.
Allez sur https://data.onekey.so/onekey.rules pour copier les règles udev.
Créez un nouveau fichier à l'emplacement /etc/udev/rules.d/99-onekey.rules et collez-y les règles copiées.
Dans le terminal, tapez :
sudo udevadm control --reload-rules
Android
Dépannage de la connexion Bluetooth
Autorisations non activées
Vérifiez si votre appareil a été mis à jour vers le dernier firmware. Reportez-vous à "Mise à jour du firmware du portefeuille matériel OneKey" pour les instructions de mise à jour.
Redémarrez l'application OneKey et le périphérique matériel OneKey, et activez individuellement les autorisations GPS et Bluetooth pour l'application OneKey dans "Paramètres système".
Remarque : si votre modèle de portefeuille est OneKey Pro et que le mode AirGap est activé, l'USB et le Bluetooth de l'appareil matériel seront indisponibles. Ils seront utilisables après la désactivation du mode AirGap.
iOS
Dépannage de la connexion Bluetooth
Autorisations non activées
Vérifiez si votre appareil a été mis à jour vers le dernier firmware. Reportez-vous à "Mise à jour du firmware du portefeuille matériel OneKey" pour les instructions de mise à jour.
Activez puis désactivez le Mode Avion une fois. Cela réinitialisera tous les modules sans fil de votre téléphone (Wi-Fi et Bluetooth).
Allez dans Paramètres -> Confidentialité et sécurité -> Bluetooth et assurez-vous que le commutateur pour l'application OneKey est Activé (vert).
Extension Chrome
Utilisation de la méthode de connexion WebUSB
Passage du pont matériel à WebUSB
Vérifiez si votre appareil a été mis à jour vers le dernier firmware. Reportez-vous à "Mise à jour du firmware du portefeuille matériel OneKey" pour les instructions de mise à jour.
Ouvrez l'application OneKey, allez dans Paramètres > Réseau > Communication matérielle, et basculez la méthode de connexion sur "WebUSB".
Remarque : OneKey a mis à niveau le pont matériel vers une connexion WebUSB directe, aucune installation supplémentaire n'est donc requise.
Toujours des problèmes ?
💁♀️ Si vous ne parvenez toujours pas à connecter votre portefeuille matériel, veuillez cliquer sur le bouton rond du service client dans le coin inférieur droit du site Web pour contacter notre support en ligne.







