Si tu BitBox02 no se conecta a tu ordenador o no es detectada por la BitBoxApp, en la mayoría de los casos el problema se puede resolver de forma rápida y sencilla.

Esta guía te acompaña paso a paso por las causas más comunes, desde comprobaciones básicas hasta soluciones específicas para macOS, Windows y Linux. Así podrás identificar rápidamente si el problema está relacionado con la conexión USB, el software o el sistema operativo.

Primero, comprueba: ¿la app y el firmware están actualizados?

Antes de empezar con la solución de problemas, asegúrate de que:

• estás utilizando la última versión de la BitBoxApp, y
• el firmware de tu BitBox02 está actualizado.

Comprobaciones rápidas

Empieza siempre por estos pasos básicos. En la mayoría de los casos, el problema se resuelve aquí.

1. Prueba con otro cable USB
   Los cables USB defectuosos son la causa más común de los problemas de conexión, incluso si son nuevos. Si es posible, prueba con otro cable compatible.
2. Usa una conexión USB directa
   Conecta la BitBox02 directamente a un puerto USB de tu ordenador.
   Evita hubs USB, estaciones de acoplamiento o cables de extensión.
3. Cambia de puerto USB
   Prueba con otro puerto USB del ordenador.
4. Comprueba la orientación
   Conecta la BitBox02 de forma que la pantalla quede hacia arriba.
5. Reinicia el ordenador
   Un reinicio puede resolver problemas temporales de USB o de controladores.
6. Prueba en otro dispositivo
   Si es posible, conecta tu BitBox02 a:
   1. otro ordenador, o
   2. un smartphone Android.

Esto ayuda a determinar si el problema está en el ordenador o en la propia BitBox02.

Otras soluciones posibles

Si las comprobaciones rápidas no han funcionado, prueba lo siguiente:

• Actualiza software que pueda causar conflictos
  Aplicaciones como Citrix Workspace pueden interferir con la detección de dispositivos USB. Asegúrate de que estén actualizadas.
• Actualiza los controladores USB (Windows)
  Abre el Administrador de dispositivos y comprueba si hay actualizaciones disponibles para los controladores USB.
• Desactiva temporalmente el software de seguridad
  Algunos antivirus o firewalls pueden bloquear nuevos dispositivos USB.
  Desactívalos brevemente para probar y vuelve a activarlos inmediatamente después.
  Si esto soluciona el problema, añade la BitBoxApp a la lista de excepciones.
• Reinstala la BitBoxApp
  Si el sistema operativo detecta la BitBox02 pero la BitBoxApp no, la instalación de la app podría estar dañada.
  Descárgala de nuevo desde el sitio oficial y reinstálala.
• Retira la lámina protectora de la pantalla
  Si tu BitBox02 aún tiene una lámina protectora en la pantalla, retírala.

Comprueba si tu sistema operativo detecta la BitBox02

Aunque la BitBoxApp no muestre el dispositivo, es posible que el sistema operativo sí lo reconozca. Esta diferencia es clave para saber si se trata de un problema de hardware o de software.

macOS

1. Abre la aplicación Terminal.
2. Ejecuta el siguiente comando:

   ioreg -p IOUSB -l -w 0 | grep "BitBox"

3. Si macOS detecta la BitBox02, aparecerá una entrada que contiene “BitBox”.

Windows

1. Abre el Administrador de dispositivos.
2. Despliega Controladoras USB.
3. Busca USB Composite Device.
4. Haz clic derecho → Propiedades → pestaña Detalles.
5. Selecciona Id. de hardware.

Si aparecen VID_03EB y PID_2403, Windows reconoce tu BitBox02.

Linux

1. Abre un terminal.
2. Ejecuta:

   lsusb

3. Busca una entrada que contenga BitBox o 03eb:2403.

Solucionar permisos USB en Linux

Si lsusb detecta la BitBox02 pero la BitBoxApp no, es posible que falten permisos USB.

Esta sección está pensada para usuarios con experiencia en administración de sistemas Linux.

Alternativamente, puedes añadir las reglas manualmente:

printf "SUBSYSTEM==\"usb\", TAG+=\"uaccess\", TAG+=\"udev-acl\", SYMLINK+=\"bitbox_%%n\", ATTRS{idVendor}==\"03eb\", ATTRS{idProduct}==\"2403\"\n" | sudo tee /etc/udev/rules.d/53-hid-bitbox.rules > /dev/null

printf "KERNEL==\"hidraw*\", SUBSYSTEM==\"hidraw\", ATTRS{idVendor}==\"03eb\", ATTRS{idProduct}==\"2403\", TAG+=\"uaccess\", TAG+=\"udev-acl\", SYMLINK+=\"bitbox_%%n\"\n" | sudo tee /etc/udev/rules.d/54-hid-bitbox.rules > /dev/null

sudo udevadm control --reload
sudo udevadm trigger

Si el problema persiste, añade tu usuario al grupo plugdev:

sudo usermod -aG plugdev $USER

Después, desconecta y vuelve a conectar tu BitBox. Puede ser necesario reiniciar el sistema.

¿Sigues teniendo problemas?

Si has completado todos los pasos de esta guía, nuestro equipo de soporte estará encantado de ayudarte.

Por favor, incluye la siguiente información para que podamos asistirte de forma eficiente:

• el modelo de tu ordenador y la versión del sistema operativo
• la versión de la BitBoxApp que estás usando
• una breve descripción de lo que ya has probado
• los archivos de registro (logs) de la BitBoxApp

Cómo exportar los archivos de registro:
Cómo localizar y exportar los archivos de soporte de BitBoxApp 

Preguntas frecuentes (FAQ)

¿Mi BitBox02 está defectuosa si no se reconoce?

En la mayoría de los casos, no. Los problemas de conexión suelen deberse a cables, puertos USB, controladores, permisos o conflictos de software. Los fallos de hardware son poco frecuentes.

¿Por qué mi ordenador detecta la BitBox02 pero la BitBoxApp no?

Si el sistema operativo detecta la BitBox02, lo más probable es que el problema esté relacionado con la BitBoxApp, permisos insuficientes o software de seguridad que bloquea la conexión.

¿Puedo perder mis monedas por problemas de conexión?

No. Tus monedas no se almacenan en la BitBox02, sino en la blockchain. Mientras tus palabras de recuperación estén guardadas de forma segura, tus fondos no corren ningún riesgo.

La BitBox02 funciona en un dispositivo Android, pero no en mi ordenador. ¿Qué significa?

Esto indica que la BitBox02 funciona correctamente. El problema está casi con total seguridad en el ordenador o en su configuración de software.

¿Cuándo debo contactar con soporte?

Si has:

• probado varios cables y dispositivos,
• confirmado que el sistema operativo no detecta la BitBox02, o
• completado todos los pasos de esta guía,

contacta con nuestro equipo de soporte para que podamos ayudarte.