Skip to content

Add Glasgow Interface Explorer setup instructions #186

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
37 changes: 37 additions & 0 deletions src/content/docs/getting-started/probe-setup.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -199,3 +199,40 @@ recommended to configure udev as described in [udev rules](#linux-udev-rules).
#### Windows, macOS

No driver installation required.


## [Glasgow Interface Explorer](https://glasgow-embedded.org/)

No additional drivers are required on any OS, but the device must be first configured using
the Python toolkit that comes with it. Refer to the [installation instructions](https://glasgow-embedded.org/latest/install.html)
for further details.

### Setup

Before running probe-rs, configure the target voltage and pinout using the `glasgow` CLI
command. For example, if your target's SWCLK is connected to pin "A0" and SWDIO is connected
to pin "A1", and it uses 3.3 V logic levels, use:

```console
$ glasgow run probe-rs -V A=3.3 --swclk A0 --swdio A1
```

The terminal output of the `glasgow` command will include the arguments needed to run probe-rs.

Note that the "*V" (voltage) pins provide power to the target, and the "*S" (sense) pins measure
the target's logic voltage level. If your target provides a reference voltage level (Vtg or similar),
for example, you could connect it to the "AS" pin and run the `glasgow` tool as:

```console
$ glasgow run probe-rs -V A=SA --swclk A0 --swdio A1
```

Do not back-power the probe by connecting a power source to the "*V" pins.

It is also possible to use the debug probe functionality together with other applets, such
as a serial terminal; for example, if your target's transmit wire is connected to pin "A2" and
receive wire to pin "A3":

```console
$ glasgow multi probe-rs -V A=3.3 --swclk A0 --swdio A1 ++ uart --rx A2 --tx A3 --auto-baud
```