Skip to content

Commit

Permalink
Merge branch 'readme-help-update'
Browse files Browse the repository at this point in the history
Update readme
Handle error on Windows with missing backend

Fixes Nitrokey#28
Connected Nitrokey#27
  • Loading branch information
szszszsz committed Jul 28, 2020
2 parents d3759a6 + 7fd8d3c commit 8342293
Show file tree
Hide file tree
Showing 2 changed files with 14 additions and 5 deletions.
11 changes: 7 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,13 +3,12 @@
A command line interface for the Nitrokey FIDO2 and Nitrokey Start.

## Current state
Project is in alpha stage, not meant yet to be used by end-users (not everything was tested), although almost all features should work out-of-the-box. The strings referring to the device were not changed yet as well.
Update to latest firmware versions on the Nitrokey Start and Nitrokey FIDO2 devices was tested. Windows support is for Nitrokey Start is not added yet.

Differences:
Additional features:
- handle `status` command for displaying touch button status (2.0.0 firmware and later);
- firmware signing adjusted for Nitrokey FIDO2 bootloader
- monitor command with timestamps
- disabled automatic update (however manual update works)

## Installation

Expand All @@ -21,10 +20,14 @@ pip3 install --user pynitrokey
```

### Windows
Note: support for Nitrokey Start under Windows 10 is not working without installing libusb libraries (to be described).

1. Download the latest `.msi` installer from the [releases](https://github.com/Nitrokey/pynitrokey/releases/)
1. Double-click the installer and click through (`Next` and `Finish`)
1. Open the windows start menu and type `cmd` and press enter
1. Open the command console in the administrator mode (Windows 10: press the right mouse button on the Menu Start and select "Windows PowerShell (Admin)" from the menu).
1. Enter `nitropy`

Without administrator privileges tool might not be able to communicate to device.

## Nitrokey FIDO2
### Firmware Update
Expand Down
8 changes: 7 additions & 1 deletion pynitrokey/start/gnuk_token.py
Original file line number Diff line number Diff line change
Expand Up @@ -634,7 +634,13 @@ def gnuk_devices():


def gnuk_devices_by_vidpid():
busses = usb.busses()
try:
busses = usb.busses()
except usb.core.NoBackendError:
print("Warning: no backend was found to use for communication. "
"Please refer to documentation how to install additional libraries.")
return []

for bus in busses:
devices = bus.devices
for dev in devices:
Expand Down

0 comments on commit 8342293

Please sign in to comment.