Incorrect documentation of pivy-tool

[anotherbridge]

After going through the setup of creating a certificate on a Nitrokey 3 (firmware v1.5.0) described in https://docs.nitrokey.com/nitrokey3/windows/piv I was not able to get a Nitrokey recognized by pivy tool. It is always prompting pivy-tool: no PIV cards/tokens found. Are there any steps missing in the documentation? If not I would like to have the documentation clarified on that usage.
FYI: I tested this on several Linux distributions as well as macOS and got the same result everytime.

Further the documentation states the usage as pivy-tool <operation> [options] while from pivy the correct usage is pivy-tool [options] <operation>.

[sosthene-nitrokey]

Hi!

PIV is currently not considered stable and is therefore only available on the stable releases of the firmware. To make piv functionality available, you will need to install a test release, marked as test in the name. The latest such firmware release is version 1.5.0-test.20231030.

You can install it with nitropy nk3 update --version v1.5.0-test.20231030.

Note that since these releases are considered unstable, updating the firmware might require reset of the unstable functionality, such as PIV.

This is documented at https://docs.nitrokey.com/nitrokey3/windows/firmware-update#firmware-release-types

[anotherbridge]

Thanks a lot @sosthene-nitrokey

Is there already an estimate on when this feature will be available in the stable release?

[daringer]

see https://github.com/Nitrokey/nitrokey-3-firmware/issues/389

[jans23]

I think the documentation is up to date and thus this issue is solved.