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

Si utilizas Linux y tu BitBox02 no es reconocida por la BitBoxApp, los siguientes pasos te ayudarán a determinar si se trata de un problema de hardware o de permisos USB faltantes.

Paso 1: Comprobar si Linux detecta la BitBox02

Primero, verifica si tu sistema operativo reconoce el dispositivo.

1. Abre una terminal.
2. Ejecuta el siguiente comando:

   lsusb

3. Busca una entrada que contenga BitBox o el identificador de proveedor y producto:

   03eb:2403

• Si la BitBox02 no aparece, el problema probablemente esté relacionado con el cable USB, el puerto USB, un adaptador o el hardware.
• Si la BitBox02 aparece, Linux detecta el dispositivo correctamente y el problema está muy probablemente relacionado con permisos de acceso USB.

Paso 2: La BitBox02 es detectada, pero no aparece en la BitBoxApp

En Linux, la BitBoxApp se comunica con la BitBox02 a través de interfaces USB HID. Si faltan los permisos necesarios, el sistema operativo puede detectar el dispositivo, pero la BitBoxApp no podrá establecer la conexión.

Este problema se soluciona configurando las reglas udev correctas.

Existen dos métodos compatibles para instalar estas reglas. Ambos logran el mismo resultado, pero se diferencian en cómo se aplican y mantienen las reglas.

Método 1 (recomendado): Instalar las reglas udev mediante el script oficial de GitHub

Este es el método recomendado, especialmente si prefieres una configuración automatizada y adaptada a tu distribución.

El script:

• instala las reglas udev correctas
• utiliza los nombres de archivo y definiciones oficiales
• coincide con la configuración utilizada por los paquetes de las distribuciones
• reduce el riesgo de errores manuales

Descarga y ejecuta el script oficial de udev desde nuestro repositorio de GitHub:

frontends/qt/resources/deb-afterinstall.sh

Después de ejecutar el script:

• desconecta la BitBox02 del puerto USB y vuelve a conectarla
• reinicia la BitBoxApp
• cierra sesión y vuelve a iniciarla, o reinicia el sistema si es necesario

Método 2: Instalar las reglas udev manualmente

Este método está dirigido a usuarios avanzados que prefieren un control total o que no pueden ejecutar el script.

Ejecuta los siguientes comandos en una terminal:

sudo tee /etc/udev/rules.d/53-hid-bitbox02.rules > /dev/null <<EOF
SUBSYSTEM=="usb", ATTRS{idVendor}=="03eb", ATTRS{idProduct}=="2403", TAG+="uaccess", TAG+="udev-acl"
EOF

sudo tee /etc/udev/rules.d/54-hidraw-bitbox02.rules > /dev/null <<EOF
KERNEL=="hidraw*", SUBSYSTEM=="hidraw", ATTRS{idVendor}=="03eb", ATTRS{idProduct}=="2403", TAG+="uaccess", TAG+="udev-acl"
EOF

A continuación, recarga las reglas udev y aplícalas:

sudo udevadm control --reload
sudo udevadm trigger

Después, desconecta la BitBox02 del puerto USB y vuelve a conectarla.

Si la BitBox02 sigue sin ser reconocida

En algunas distribuciones de Linux se requieren permisos adicionales de grupo.

Añade tu usuario al grupo plugdev:

sudo usermod -aG plugdev $USER

Después, cierra sesión y vuelve a iniciarla, o reinicia el sistema.

Comprobaciones finales

Tras completar cualquiera de los dos métodos:

• reinicia la BitBoxApp
• vuelve a conectar la BitBox02
• reinicia el sistema si el problema persiste

Si la BitBox02 sigue sin ser reconocida después de completar todos los pasos, continúa con la sección «¿Sigues teniendo problemas?» y contacta con el soporte.

¿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.