blue-loader-python/README.md

1.5 KiB

Python tools for Ledger Blue and Nano S

This package contains Python tools to communicate with Ledger Blue and Nano S and manage applications life cycle.

It is recommended to install this package in a Virtual Environment in your native environment (not a Docker image) to avoid hidapi issues.

virtualenv ledger
source ledger/bin/activate
pip install ledgerblue

Installation pre-requisites

  • libudev-dev
  • libusb-1.0-0-dev
  • python-dev (python 2.7)
  • virtualenv

This package can optionally work with libsecp256k1 Python bindings compiled with ECDH support. If you wish to enable libsecp256k1 bindings, make sure to install libsecp256k1 as follows:

SECP_BUNDLED_EXPERIMENTAL=1 pip --no-cache-dir install --no-binary secp256k1 secp256k1

Giving permissions on udev

When running on Linux, make sure the following rules have been added to /etc/udev/rules.d/:

SUBSYSTEMS=="usb", ATTRS{idVendor}=="2c97", ATTRS{idProduct}=="0000", MODE="0660", TAG+="uaccess", TAG+="udev-acl" OWNER="<UNIX username>"
SUBSYSTEMS=="usb", ATTRS{idVendor}=="2c97", ATTRS{idProduct}=="0001", MODE="0660", TAG+="uaccess", TAG+="udev-acl" OWNER="<UNIX username>"

Target ID

Use the following Target IDs (--targetId option) when running commands directly:

  • 0x31100002 on Nano S (until firmware 1.3.1, included)
  • 0x31100003 on Nano S (after firmware 1.3.1)
  • 0x31000002 on Blue