Using KKcli to debug your KeepKey

How to troubleshoot a device unable to connect to host

Using KKcli to debug your KeepKey

How to troubleshoot a device unable to connect to host

Repository: https://github.com/mrnerdhair/kkcli

Downloads:

• Linux
• Windows
• Mac

Usage

Unzip the file and enter the terminal:

On Windows, you must open the terminal by searching “cmd” from the Windows search. This guide uses the terminal heavily, so if you are a beginner, I recommend learning the CLI basics. Understanding the Windows Terminal

Now you must navigate to the kkcli you downloaded.

cd Downloads
dir

Review Commands.

Troubleshooting device

Use

to view your connected devices. If your device is not showing here:

• Disconnect and reconnect the device
• Replace the cable

Update KeepKey firmware

Download the latest firmware from the KeepKey repository: Releases · keepkey/keepkey-firmware

Place device in updater mode

1. Unplug the device
2. Hold down the button
3. While holding down the button, plug the device back in

Use KKCLI to update Bootloader

Download the bootloader: link and move it to be in the same directory as kkcli.

./kkcli firmware-update blupdater.bin

Note the location you downloaded the bootloader to. It must match the location where you unzipped the CLI as well. It is recommended to make a new folder to work in, and create directories with names identifying what version the firmware you downloaded was.

Use KKCLI to update firmware

./kkcli firmware-update firmware.keepkey.bin

Note the location you downloaded the firmware to. It must match the location where you unzipped the CLI as well.

Onboarding via CLI:

1. Update bootloader to the latest
2. Update firmware to the latest
3. Connect to app.shapeshift.com to initialize a new seed/restore

Dev Tools

Load seed:

./kkcli load-device "alcohol woman abuse must during monitor noble actual mixed trade anger aisle"

---