Skip to content

Commit 24c536a

Browse files
authored
Merge pull request #186 from whitequark/patch-1
Add Glasgow Interface Explorer setup instructions
2 parents 37e7ec5 + 143ae45 commit 24c536a

File tree

1 file changed

+36
-0
lines changed

1 file changed

+36
-0
lines changed

src/content/docs/getting-started/probe-setup.mdx

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -208,3 +208,39 @@ recommended to configure udev as described in [udev rules](#linux-udev-rules).
208208
No driver installation required.
209209

210210
Some ESP32 devices have an incorrect WinUSB Descriptor. If ``probe-rs list`` shows your device, but ``probe-rs info`` fails with ``Could not find DeviceInterfaceGUIDs in registry``, you may need to reinstall the driver using Zadig. You can find more information in this GitHub discussion: https://github.com/probe-rs/probe-rs/discussions/3193
211+
212+
## [Glasgow Interface Explorer](https://glasgow-embedded.org/)
213+
214+
No additional drivers are required on any OS, but the device must be first configured using
215+
the Python toolkit that comes with it. Refer to the [installation instructions](https://glasgow-embedded.org/latest/install.html)
216+
for further details.
217+
218+
### Setup
219+
220+
Before running probe-rs, configure the target voltage and pinout using the `glasgow` CLI
221+
command. For example, if your target's SWCLK is connected to pin "A0" and SWDIO is connected
222+
to pin "A1", and it uses 3.3 V logic levels, use:
223+
224+
```console
225+
$ glasgow run probe-rs -V A=3.3 --swclk A0 --swdio A1
226+
```
227+
228+
The terminal output of the `glasgow` command will include the arguments needed to run probe-rs.
229+
230+
Note that the "*V" (voltage) pins provide power to the target, and the "*S" (sense) pins measure
231+
the target's logic voltage level. If your target provides a reference voltage level (Vtg or similar),
232+
for example, you could connect it to the "AS" pin and run the `glasgow` tool as:
233+
234+
```console
235+
$ glasgow run probe-rs -V A=SA --swclk A0 --swdio A1
236+
```
237+
238+
Do not back-power the probe by connecting a power source to the "*V" pins.
239+
240+
It is also possible to use the debug probe functionality together with other applets, such
241+
as a serial terminal; for example, if your target's transmit wire is connected to pin "A2" and
242+
receive wire to pin "A3":
243+
244+
```console
245+
$ glasgow multi probe-rs -V A=3.3 --swclk A0 --swdio A1 ++ uart --rx A2 --tx A3 --auto-baud
246+
```

0 commit comments

Comments
 (0)