• SubGHz
  • Advanced
  • 10 min
  • Serial CLI

Recipe · Advanced · SubGHz

How to load a SubGHz .sub file

Upload a .sub file to LittleFS and load it from SubGHz mode for CC1101 playback tests.

File transfer workflow between device and storage.
Start with read-only checks, then move to write, replay or automation only when the setup is understood.
Step 1

Commands

Use the shortest command path that matches the documented firmware workflow. When a mode needs setup, follow the prompts shown on first entry.

Result

What it means

The command path is working when the target responds and the firmware prints the expected menu, status or captured data.

Troubleshooting

  • Re-enter the mode setup when pins or peripherals are not already initialized.
  • Check common ground and target voltage before blaming software.
  • Prefer Serial CLI for long captures or high-volume output.
  • Repeat the read or capture to confirm stability.

Next steps

  • Save the output in your project notes.
  • Compare the result with the full wiki page for mode-specific details.
  • Create a shorter alias if you repeat this workflow often.

SubGHz .sub file loading FAQ

Where should .sub files be placed?

Upload them to the device LittleFS storage from the file interface, then enter SubGHz mode and run load to pick a file from the list.

What does load use from a .sub file?

It uses the file metadata and frames to configure playback details such as frequency, preset or protocol when the format contains enough information.

When is replaying a .sub file appropriate?

Use it only for your own devices, lab fixtures or authorized tests, and stay within local radio rules for frequency, power and duty cycle.

Go deeper