Skip to main content

Audio

These commands are available three ways — in the FREE-WILi GUI app, in a serial terminal, and on the device itself. See Connecting it to a computer for how to reach them.

Play Audio File​

Plays a .wav file from the device's sounds/ directory through the built‑in speaker (or headphone jack, if connected).

Examples​

chime
chime.wav
\sounds\chime.wav

Notes​

  • Only PCM .wav files are supported.
  • Playback is asynchronous — the call returns as soon as playback begins.
  • Use Stream Audio (s) to mirror audio to the host, or Record Audio (r) to capture from the microphone.

How to use it — press f. At the prompt, enter: audio file name.

What you enter — file_path.

Record Audio​

Records audio to a file (blank name = auto-named).

How to use it — press r. At the prompt, enter: File Name or blank for auto file name.

What you enter — file_name.

Play Audio Asset​

Plays a built-in audio asset by index or name.

How to use it — press a. At the prompt, enter: asset index or name.

What you enter — asset_name.

Stream Audio​

Enables or disables audio streaming to the host.

How to use it — press s. At the prompt, enter: 1 to enable 0 to disable.

What you enter — enable.

Numbers to Speech​

Speaks the given number aloud.

How to use it — press n. At the prompt, enter: number.

What you enter — number.

Play Tone​

Plays a tone of the given frequency, duration, and amplitude.

How to use it — press t. At the prompt, enter: frequency Duration and Amplitude.

What you enter — frequency, duration_ms, amplitude.

Text to Speech​

Speaks the given text aloud through the built‑in speaker (or headphone jack, if connected) using the device's onboard text‑to‑speech engine.

Examples​

hello world
The temperature is now seventy two degrees.
Warning: low battery

Notes​

  • Playback is asynchronous — the call returns as soon as speech begins.
  • To speak a numeric value, use Numbers to Speech (n) instead for proper digit/decimal pronunciation.
  • Use Play Tone (t), Play Audio File (f), or Play Audio Asset (a) for non‑speech audio output.

How to use it — press v. At the prompt, enter: text to speak.

What you enter — text.