Skip to content

Commit 7158fbd

Browse files
committed
improve probe-run documentation
1 parent 7eb1b39 commit 7158fbd

1 file changed

Lines changed: 25 additions & 3 deletions

File tree

README.md

Lines changed: 25 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -45,12 +45,12 @@ The Neotron BIOS uses the [defmt](https://crates.io/crates/defmt) crate to provi
4545
* connect Pin 5 on the *Debugger* Pico to SWDIO on the *Neotron* Pico
4646
* connect USB on the *Debugger* Pico to your PC
4747

48-
2. Flash your *Debugger* Pico with https://github.com/majbthrd/DapperMime firmware (e.g. by copying the UF2 file to the USB Mass Storage device)
48+
2. Flash your *Debugger* Pico with https://github.com/raspberrypi/picoprobe or https://github.com/majbthrd/DapperMime firmware (e.g. by copying the UF2 file to the USB Mass Storage device)
4949

50-
3. On your PC, install [*probe-rs*](https://github.com/knurling-rs/probe-run), the programming tool from [Ferrous System's](https://www.ferrous-systems.com) [Knurling Project](https://github.com/knurling).
50+
3. On your PC, install [*probe-run*](https://github.com/knurling-rs/probe-run), the programming tool from [Ferrous System's](https://www.ferrous-systems.com) [Knurling Project](https://github.com/knurling).
5151

5252
```console
53-
user@host ~ $ cargo install probe-rs
53+
user@host ~ $ cargo install probe-run
5454
```
5555

5656
4. Power on your Neotron Pico.
@@ -86,6 +86,28 @@ user@host ~/neotron-pico-bios $ DEFMT_LOG=debug cargo run --release
8686

8787
You should see your Neotron Pico boot, both over RTT in the `probe-run` output, and also on the VGA output.
8888

89+
6a. Multiple probes
90+
91+
If you have multiple probe-rs compatible probes attached to your computer,
92+
you will receive an error message.
93+
94+
You can set the PROBE_RUN_PROBE environment variable to select one of the
95+
available probes, like so:
96+
97+
```console
98+
$ probe-run --list-probes
99+
the following probes were found:
100+
[0]: Picoprobe CMSIS-DAP (VID: 2e8a, PID: 000c, Serial: Exxxxxxxxxxxxxx6, CmsisDap)
101+
[1]: STLink V2 (VID: 0483, PID: 3748, Serial: 0xxxxxxxxxxxxxxxxxxxxxxE, StLink)
102+
user@host ~/neotron-pico-bios $ PROBE_RUN_PROBE='0483:3748' DEFMT_LOG=debug cargo run --release
103+
```
104+
105+
You can also just provide the probe Serial, for example if you have multiple
106+
identical probes.
107+
108+
The documentation for this feature can be found at
109+
<https://github.com/knurling-rs/probe-run#12-multiple-probes>
110+
89111
## Changelog
90112

91113
See [CHANGELOG.md](./CHANGELOG.md)

0 commit comments

Comments
 (0)