ESP32 Bit Pirate home
  • GPIO
  • Beginner
  • 5 min
  • Serial CLI

Recipe · Beginner · GPIO

How to use wizard to identify an unknown GPIO signal

Use the global wizard command to monitor a GPIO and detect whether the pin looks digital, analog, clock-like or active.

GPIO signal measurement trace.
Wizard is a quick signal triage tool for unknown pins.

Wiring View

BP signalGPIOGNDBP GND
Generated from the wiring summary: to BP.
Step 1

Commands

These commands are documented as global or quick-start commands.

Result

What it means

If the command returns the expected output, the firmware and terminal session are ready for the next workflow.

Troubleshooting

  • If the signal is always high, check pull-ups or idle state.
  • If nothing changes, try a slower action on the target device.
  • If the result looks like a clock, switch to a protocol or logic capture workflow.

Next steps

  • Try the same workflow on a known safe pin or target.
  • Save the useful command as a note or alias.
  • Move to the protocol-specific recipe once the basics work.

GPIO wizard FAQ

What does the wizard tell me about an unknown pin?

It helps triage whether a pin looks idle, digital, analog-like, clock-like or active. It is a discovery tool, not a full protocol decoder.

Why should wizard be used before driving a pin?

Wizard is observational. It helps you avoid driving a line that is already an output, pulled to an unexpected level, or actively changing on the target board.

What should I do after wizard finds activity?

Move to a focused DIO measurement, logic trace or protocol-specific recipe. Wizard narrows the search; the next tool should confirm timing, voltage and meaning.

Go deeper