If the BitBoxApp on your computer does not detect your BitBox, please try the following:
- Ensure that you have removed the screen protection sticker.
- Ensure the BitBox02 is plugged in with the display pointing upwards. (The logo sticks out on that side).
- Plug your BitBox02 in without an adapter or cable if possible.
- Try using a different USB port.
- Try using a different computer, or an Android phone.
- When using the extension cable: Make sure the logo on the cable is on the same side as the BitBox02 display.
To check if your computer detects the BitBox at all:
Mac
- Plug in the BitBox02 and tap on the side to choose the display orientation and connect the device.
- run
ioreg -p IOUSB -l -w 0 | grep "Bit"in Terminal. - You should see an entry containing “BitBox”.
Windows
- Plug in the BitBox02 and tap on the side to choose the display orientation and connect the device.
- Open “Device Manager”.
- Go to “Universal Serial Bus”.
- Look for “USB composite device” (there could be multiple).
- For each of the “USB composite devices”:
- right-click and select “Properties”.
- in the dropdown select “Hardware Ids”.
- if the ID contains “VID_03EB” and “PID_2403” it is a BitBox.
Linux
- Plug in the BitBox02 and tap on the side to choose the display orientation and connect the device.
- Run
lsusbin the command line. - You should see an entry containing “BitBox”.
If the device is not detected by the app, you may need to manually adjust USB permissions. To do this for most recent distributions, copy and execute the following commands in a terminal (sudo permissions required):
printf "SUBSYSTEM==\"usb\", TAG+=\"uaccess\", TAG+=\"udev-acl\", SYMLINK+=\"bitbox02_%%n\", ATTRS{idVendor}==\"03eb\", ATTRS{idProduct}==\"2403\"\n" | sudo tee /etc/udev/rules.d/53-hid-bitbox02.rules > /dev/null && printf "KERNEL==\"hidraw*\", SUBSYSTEM==\"hidraw\", ATTRS{idVendor}==\"03eb\", ATTRS{idProduct}==\"2403\", TAG+=\"uaccess\", TAG+=\"udev-acl\", SYMLINK+=\"bitbox02_%%n\"\n" | sudo tee /etc/udev/rules.d/54-hid-bitbox02.rules > /dev/null
printf "SUBSYSTEM==\"usb\", TAG+=\"uaccess\", TAG+=\"udev-acl\", SYMLINK+=\"dbb%%n\", ATTRS{idVendor}==\"03eb\", ATTRS{idProduct}==\"2402\"\n" | sudo tee /etc/udev/rules.d/51-hid-digitalbitbox.rules > /dev/null && printf "KERNEL==\"hidraw*\", SUBSYSTEM==\"hidraw\", ATTRS{idVendor}==\"03eb\", ATTRS{idProduct}==\"2402\", TAG+=\"uaccess\", TAG+=\"udev-acl\", SYMLINK+=\"dbbf%%n\"\n" | sudo tee /etc/udev/rules.d/52-hid-digitalbitbox.rules > /dev/null
Run the following commands and then replug your device:
sudo udevadm control --reload
sudo udevadm trigger
Alternatively, you can download this script from our GitHub repository (containing the same commands) and execute it instead.
If the above does not work for your distribution, add your user to the "plugdev" group. If you're not already a member, a reboot may be required on some distributions.
Copy and exute the following commands in a terminal (sudo permissions required):
printf "SUBSYSTEM==\"usb\", SYMLINK+=\"bitbox02_%%n\", GROUP=\"plugdev\", MODE=\"0664\", ATTRS{idVendor}==\"03eb\", ATTRS{idProduct}==\"2403\"\n" | sudo tee /etc/udev/rules.d/53-hid-bitbox02.rules > /dev/null && printf "KERNEL==\"hidraw*\", SUBSYSTEM==\"hidraw\", SYMLINK+=\"bitbox02_%%n\", GROUP=\"plugdev\", MODE=\"0664\", ATTRS{idVendor}==\"03eb\", ATTRS{idProduct}==\"2403\"\n" | sudo tee /etc/udev/rules.d/54-hid-bitbox02.rules > /dev/null
printf "SUBSYSTEM==\"usb\", SYMLINK+=\"dbb%%n\", GROUP=\"plugdev\", MODE=\"0664\", ATTRS{idVendor}==\"03eb\", ATTRS{idProduct}==\"2402\"\n" | sudo tee /etc/udev/rules.d/51-hid-digitalbitbox.rules > /dev/null && printf "KERNEL==\"hidraw*\", SUBSYSTEM==\"hidraw\", SYMLINK+=\"dbbf%%n\", GROUP=\"plugdev\", MODE=\"0664\", ATTRS{idVendor}==\"03eb\", ATTRS{idProduct}==\"2402\"\n" | sudo tee /etc/udev/rules.d/52-hid-digitalbitbox.rules > /dev/null
Run the following commands and then replug your device:
sudo udevadm control --reload
sudo udevadm trigger
Note: On some distributions, the plugdev group might not exist yet. If you're still facing issues, try to create the group first and add your user to it. Proceed with the steps from above again.