From 42d2918bcbc48fe69b9602a694dc02c70ad28384 Mon Sep 17 00:00:00 2001 From: Matias Bzurovski Date: Tue, 5 Nov 2024 12:04:20 +0100 Subject: [PATCH 1/2] update docs --- README.md | 19 +++++++++++++++++-- 1 file changed, 17 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 1be42741..b8d82077 100644 --- a/README.md +++ b/README.md @@ -70,10 +70,23 @@ For Nano X: You can install the locally built binaries onto your physical Ledger Nano S, or Nano S Plus by running a flash script from *host*, not from *shell*. Note that Nano X does not support this. -But before doing so you must install the prerequisites on your host. This requires Python3. +### Prerequisites +In order to allow sideloading, you must install the following prerequisites on your host. This requires Python3. + +Install python dependencies: +```sh +python3 -m pip config set global.break-system-packages true && pip3 install protobuf==3.20.3 && pip3 install ledgerwallet==0.5.1 && pip3 install ledgerblue +``` + +Install thumbv6m-none-eabi: ```sh -python3 -m pip config set global.break-system-packages true && pip3 install protobuf==3.20.3 && pip3 install ledgerwallet==0.5.1 +rustup target add thumbv6m-none-eabi +``` + +Export PATH: +```sh +export PATH="$PATH:/Applications/ArmGNUToolchain/12.2.mpacbti-rel1/arm-none-eabi/bin" ``` > [!NOTE] @@ -82,6 +95,8 @@ python3 -m pip config set global.break-system-packages true && pip3 install prot If you get hit by the notorious [Invalid status 6512 (Unknown Reason)](https://github.com/LedgerHQ/ledgerctl/issues/65) error, then you might need to try a newer version of [`ledgerwallet`](https://github.com/LedgerHQ/ledgerctl/releases) and or newer firmware. +### Sideload + Then you can finally sideload the built binary, like so: ```sh From 73f1cd3b57d0589ead60c8fa7975bebc7a692b51 Mon Sep 17 00:00:00 2001 From: Matias Bzurovski Date: Tue, 5 Nov 2024 12:18:47 +0100 Subject: [PATCH 2/2] updates --- README.md | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/README.md b/README.md index b8d82077..caf462e0 100644 --- a/README.md +++ b/README.md @@ -79,12 +79,8 @@ Install python dependencies: python3 -m pip config set global.break-system-packages true && pip3 install protobuf==3.20.3 && pip3 install ledgerwallet==0.5.1 && pip3 install ledgerblue ``` -Install thumbv6m-none-eabi: -```sh -rustup target add thumbv6m-none-eabi -``` -Export PATH: +Install thumbv6m-none-eabi, by downloading the installer from [here](https://developer.arm.com/-/media/Files/downloads/gnu/12.2.mpacbti-rel1/binrel/arm-gnu-toolchain-12.2.mpacbti-rel1-darwin-x86_64-arm-none-eabi.pkg?rev=2f38f68c2683438e895886abee9be5fc&hash=A0BB95236291FB90466A82ED4F7B11B6). Then export its PATH: ```sh export PATH="$PATH:/Applications/ArmGNUToolchain/12.2.mpacbti-rel1/arm-none-eabi/bin" ```