Prerequisites
1
Be in debug mode
Run
/debug or click the Debug button. The instrument tools are unavailable in act and plan modes.2
Connect the PicoScope over USB
Plug the scope into the host over USB — it’s USB-powered, no bench supply or LAN needed.
3
Install Pico's drivers
Install PicoScope 7 or the PicoSDK from picotech.com/downloads:
- macOS / Windows: PicoScope 7 T&M Instruments
- Linux: the
libps*packages from Pico’s apt repo
Run
hardware_status. A ready PicoScope shows up under the picoscope provider with its model and series.4
Wire your probes
- Analog: BNC scope probes to inputs A–D. Coupling is DC or AC only — PicoScope inputs have no GND coupling.
- Digital (MSO models): the D0–D15 flying leads to your DUT signals. Note which channel goes where — you’ll mention them in your prompt.
- Signal generator: the AWG / Gen output to the node you want to stimulate.
Supported models
Every PicoScope series works, and the scope is auto-detected when you plug it in. MSO models add digital capture on top of analog.The Logic capture (MSO) column marks series that offer digital pods. Your specific unit still has to be an MSO variant with the pods fitted — a non-MSO scope in the same series captures analog only.
Example prompts
Describe the symptom or the measurement — Embedder picks the analog, digital, or generator path and writes the script. Analog capture on an edge trigger:embedder
embedder
embedder
embedder
embedder
How it differs from a bench oscilloscope
If you’ve used Embedder’s LAN/SCPI oscilloscope, the same prompts work — with a few USB-specific differences:
There’s no screenshot on a PicoScope because there’s no front-panel display — every capture comes back as an interactive chart in the Console panel instead.
What the agent does for you
The agent writes a Python script under.embedder/hardware/ that opens the PicoScope over USB, configures channels, timebase, and trigger (or the digital ports, or the signal generator), runs the capture, and publishes the result — analog traces to the Power tab, digital traces to the Logic tab. You’ll see the script in the tool call before it runs, and you can stop or edit it if needed.
Common gotchas
PicoScope not detected
PicoScope not detected
Check the USB cable — the scope is USB-powered, so a charge-only cable won’t enumerate it. Quit the PicoScope desktop app (the USB device is single-client), then re-run
hardware_status.Detected but won't connect
Detected but won't connect
Pico’s drivers probably aren’t installed — the setup prompt reports this. Install PicoScope 7 or the PicoSDK from picotech.com/downloads, then retry.
The trace clips flat at the top or bottom
The trace clips flat at the top or bottom
The V/div scale is too small — full scale is only ±4 × scale. A 3.3 V line needs 1 V/div; at 0.5 V/div it runs into the range limit. Ask the agent to widen the range.
Captured amplitude reads about 10× low
Captured amplitude reads about 10× low
A ×10 probe is switched to ×10 but the capture assumed ×1. Tell the agent “I’ve got a ×10 probe on channel A” so it corrects the range, reported volts, and trigger levels.
Capture spans less time than I asked for
Capture spans less time than I asked for
The shared capture buffer clamped the window rather than failing. Lower the sample rate, shorten the window, or disable unused channels and ports to free buffer.
Legacy scope on an Apple Silicon Mac won't connect
Legacy scope on an Apple Silicon Mac won't connect
Pico ships the legacy 3000 / 4000 / 5000 / 6000 series drivers as Intel-only. On Apple Silicon, use an Intel Mac, Windows, or Linux for these older scopes.
Next steps
Oscilloscope
Compare with the LAN/SCPI bench scope — screenshots and GND coupling.
Logic analyzer
Protocol decoding with a Saleae or Digilent when you need decoded frames, not raw transitions.
Combined workflows
Mix the PicoScope with GDB and power profiling in one debug session.
Debug mode overview
Back to the Observe → Hypothesize → Probe → Verify loop.
