diff --git a/README.md b/README.md index 0410232..5ec8ca3 100644 --- a/README.md +++ b/README.md @@ -20,8 +20,10 @@ > > Check application [Installation Wiki](https://github.com/librekeys/picoforge/wiki/Installation) for installation guide of the PicoForge app on your system. > -> PicoForge only supports v7.2 of the PICO FIDO series of firmwares. Support to v7.4 and above -> is WIP. +> PicoForge targets Pico FIDO firmware 7.6 for FIDO fallback reads and management. +> Hardware configuration from FIDO-only mode is firmware-dependent: 7.0/7.2 support +> a limited legacy configuration path, while 7.4/7.6 require rescue/PCSC mode for +> hardware configuration changes. ## About @@ -34,7 +36,7 @@ PicoForge is a modern desktop application for configuring and managing Pico FIDO - Real-time system logging and diagnostics - Support for multiple hardware variants and vendors -> **BETA Status**: This application is currently under active development and in beta stage. Users should expect bugs and are encouraged to report them. The app has been tested on Linux and Windows 10 with the official Raspberry Pi Pico2 & ESP32-S3 and, currently supports Pico FIDO firmware version 7.2 only. +> **BETA Status**: This application is currently under active development and in beta stage. Users should expect bugs and are encouraged to report them. The app has been tested on Linux and Windows 10 with the official Raspberry Pi Pico2 & ESP32-S3 and, currently targets Pico FIDO firmware version 7.6, with limited legacy FIDO-only configuration support for 7.0/7.2. ## Screenshots diff --git a/docs/Home.md b/docs/Home.md index 3867293..d65bf70 100644 --- a/docs/Home.md +++ b/docs/Home.md @@ -3,7 +3,7 @@ **PicoForge** is a modern desktop application for configuring and managing **Pico FIDO** security keys. Built with Rust, Tauri, and Svelte, it provides an intuitive interface. > [!WARNING] -> **Beta Status**: This application is currently under active development and in beta stage. Users should expect bugs and are encouraged to report them. The app has been tested on Linux and Windows 10/11 with the official Raspberry Pi Pico2, WaveShare RP2350 One & ESP32-S3 and, currently supports Pico FIDO firmware version 7.2 only. +> **Beta Status**: This application is currently under active development and in beta stage. Users should expect bugs and are encouraged to report them. The app has been tested on Linux and Windows 10/11 with the official Raspberry Pi Pico2, WaveShare RP2350 One & ESP32-S3 and, currently targets Pico FIDO firmware version 7.6. FIDO-only hardware configuration is available only for legacy 7.0/7.2 firmware; 7.4/7.6 require rescue/PCSC mode for hardware configuration. > > It does not support all the features exposed by the `pico-fido` firmware and `pico-hsm`. diff --git a/docs/Troubleshooting.md b/docs/Troubleshooting.md index 17c22cb..842f578 100644 --- a/docs/Troubleshooting.md +++ b/docs/Troubleshooting.md @@ -8,11 +8,13 @@ When this happens the device status on the lower left corner of the application To avoid this issue we plan to obtain a valid VID/PID that can freely be used by the open source community and to communicate it to pcsc-lite team so that they can include it in their CCID driver. But for now there are 3 ways to work around this issue. -### 1.1. Use the fido fallback implemented in picoforge to update the VID and PID -When connected to the key with the fido fallback there are some limitations. Only a limited set of configuration parameters can be read or written. -While in this mode it is possible to change the VID/PID to use the ones of a known vendor. -But note that **a security pin needs to be set** before being able to change the configuration when in fido only mode. -Then, after unplugging and re-plugging the key for the change to be taken into account, the key should be correctly detected by pcsc and you will be able to view and modify to the full set of configuration parameters. +### 1.1. Use the fido fallback implemented in picoforge +When connected to the key with the fido fallback there are some limitations. PicoForge can read FIDO/device information on newer firmware, but hardware configuration support depends on the pico-fido firmware version. + +- Firmware 7.0/7.2: PicoForge can write a limited hardware configuration set from FIDO-only mode: VID/PID, LED GPIO, LED brightness, LED dimmable/steady, and power-cycle/reset behavior. **A security pin needs to be set** before being able to change the configuration when in FIDO-only mode. +- Firmware 7.4/7.6: PicoForge does not write hardware configuration from FIDO-only mode. Use rescue/PCSC mode for VID/PID, product name, LED, touch timeout, LED driver, and curve settings. + +After changing VID/PID on firmware that supports legacy FIDO configuration, unplug and re-plug the key for the change to be taken into account. The key should then be correctly detected by pcsc and you will be able to view and modify the full set of configuration parameters. **Be mindfull of the legal implications when you change the VID:PID on a key that you plan to distribute to somebody else**. You will probably want to set it back to the generic VID:PID before you distribute it. ### 1.2. Flash a firmware that you built from source with USB VID/PID known by pcsc-lite