Fix issues connecting Jade via USB

Blockstream Jade is compatible with many different platforms, however each may require additional configurations to allow Jade to connect and communicate with your companion device properly. Below are some recommended steps to assist in connecting Jade to each supported platform:

• MacOS
• Windows
• Linux

Note: Issues may also arise from low quality USB cables, USB adapters or problems with specific ports on your computer. If you still experience trouble after following the relevant steps, it is recommend to try again with different cables, adapters or ports. Additionally, closing all applications on your computer except the one you are trying to use with Jade can also resolve any error messages.

MacOS

Option 1: Jade Not Recognized, Receiving Error Messages, or Upgrade Issues

If Jade is not recognized or you are experiencing error messages on your Jade or companion app while your device is connected, you may need to install an additional driver.

1. Download the driver linked here and navigate to the CH34XSER_MAC folder found in your downloads once completed.
2. Open the folder and double-click CH34xVCPDriver.pkg.
3. Continue through the installation helper until you see the Success message. If you encounter a "System Extension Blocked" error, choose to Open System Settings and select Allow under the prompt that shows that CH34xVCPDriver was blocked from loading.
4. Reboot Jade and try again. If you are still having issues, you may need to reboot your computer for the changes to take effect.

Option 2: If Jade is Still Not Recognized

If Jade is still not recognized by your computer, it may be that you need to install a relevant driver.

1. Download the CP210x VCP Mac OSX Driver and navigate to the macOS_VCP_Driver folder found in your downloads once completed.
2. Open the folder and double-click SiLabsUSBDriverDisk.dmg, then select Install CP210x VCP Driver. 
3. Continue through the installation helper until you see the Success message. If you encounter a "System Extension Blocked" error, choose to Open System Settings and select Allow under the prompt that shows that CP210xVCPDriver was blocked from loading.
4. Unplug Jade and reboot your machine for the changes to take effect.

Windows

Option 1: Jade Not Recognized or Upgrade Issues

If Jade is not recognized by your computer, it may be that you need to install a relevant driver.

1. Download the linked driver and select the folder found in your downloads folder once completed.
2. Click Extract all near the top of the File Explorer window while in the driver folder and choose Setup.exe to install the driver.
3. Unplug Jade and reboot your machine for the changes to take effect.

Option 2:

If Jade is Still Not Recognized

If Jade is not recognized by your computer, it may be that you need to install a separate relevant driver.

1. Download the CP210x Universal Windows Driver and select the folder found in your downloads once completed.
2. Click Extract all near the top of the File Explorer window while in the CP210X_Universal_Windows_Driver folder.
3. Once extracted, check the box next to the silabser file with the Setup Information type, right-click and select Install from the drop-down.
4. Choose Open and continue through the installation by allowing the driver to make changes to your device. You will then see a message that the driver was installed successfully.
5. Unplug Jade and reboot your machine for the changes to take effect.

Linux

Jade Not Recognized

If Jade is not recognized by your computer, you may need to add your user to the appropriate group.

1. Add your user to the dialout, plugdev, or uucp group using the following commands:
   
   sudo adduser yourusername dialout or
   sudo usermod -a -G dialout yourusername

sudo adduser yourusername plugdev or
   sudo usermod -a -G plugdev yourusername

sudo adduser yourusername uucp or
   sudo usermod -a -G uucp yourusername
   
   
2. Unplug Jade and reboot your machine for the changes to take effect.

Error Messages when Using Jade

If you are experiencing error messages on your Jade, this may be due to a known bug in caused by Linux distributions related to auto-suspend.

1. Create a custom udev rule: /etc/udev/rules.d/21-jade.rules
   

   ATTRS{idProduct}=="55d4",
   ATTRS{idVendor}=="1a86",
   SUBSYSTEM=="usb",
   TEST=="power/control",
   ATTR{power/control}="on",
   GROUP="plugdev",
   MODE="0660"

   And then run:

   udevadm control --reload-rules && udevadm trigger 

2. Unplug Jade and reboot your machine for the changes to take effect.