• General
  • Beginner
  • 5 min
  • Profiles

Recipe · Beginner · General

How to save pin profiles and aliases

The General commands wiki lists global commands such as profile, alias, repeat, mode, man, wizard, logic and analogic.

Terminal shell showing a command prompt.
Once the wiring is known, profiles and aliases reduce friction for the next session.
Step 1

Commands

Open the profile shell for saved pins, create aliases for long commands, and use repeat for repeated tests.

Result

What success looks like

You can return to a known setup faster, with fewer manual pin-selection mistakes.

Troubleshooting

  • Alias hides a command that should be reviewed before use.
  • Profile made on one board is reused on a different pinout.
  • A repeated command drives a line that should be input-only.
  • Delay units are mixed up in command chains.

Next steps

  • Use profiles for known-good I2C/SPI/UART pin mappings.
  • Use aliases only for commands you understand and can audit.
  • Use the instruction syntax for protocol-level byte sequences.

Pin profile and alias FAQ

When should I save a pin profile?

Save a profile after the wiring has been verified on the actual board. That reduces repeated pin-selection mistakes when you return to the same target later.

Can I reuse a profile across ESP32 boards?

Only if the exposed pins and onboard peripherals match. A GPIO number can exist on the chip but be unavailable, reserved, or wired differently on another board.

How do profiles and aliases work together?

Profiles help restore known wiring and mode setup, while aliases shorten commands you run often. Use both only after the underlying workflow is tested manually.

Go deeper