Using KKcli to debug your KeepKey

How to troubleshoot a device unable to connect to host

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

Downloads:

(linux)

(windows)

(Mac)

Usage

unzip File

enter terminal:

On windows you must open the terminal, search “cmd” from the windows search

This guide uses terminal heavily, 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 ./kkcli list to view your connected devices.

If your device is not showing in here.

• Disconnect and reconnect device
• replace cable

Update KeepKey firmware

Download Latest firmware from KeepKey repo:

Releases · keepkey/keepkey-firmware

Place device is updater mode

1. unplug device

2. hold down button

3. while holding down button plug device back in

Use KKCLI to update Bootloader

download bootloader: (link)

move it to be in the same directory as kkcli

./kkcli firmware-update blupdater.bin

Note the location you downloaded the bootloader too. It must match the location that you unzipped the cli into as well.

It is recommended you make a new folder to work in.

As well as creating 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 too. It must match the location that you unzipped the cli into as well.

Onboarding via CLI:

1. Update bootloader to latest
2. Updater firmware to latest

3. Connect to app.shapeshift.com to initialize new seed/restore

Dev Tools

load seed

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