SolarOS 4.17.7 manual · app

funcgen

Audio-only function generator built on the shared real-time Synth service. It emits signed 16-bit stereo PCM and can use the default playback device or an explicitly selected runtime playback stream, including an attached LEDC PWM audio expansion.

Usage:

funcgen [--tui]

The graphical interface shows the exact generated PCM in the shared oscilloscope widget. The remaining controls select sine, square, triangle, saw, pulse, or noise output; frequency from 20 through 8000 Hz; amplitude; pulse width; a repeating linear sweep; sweep end frequency; sweep time; and playback stream. The TUI exposes the same controls. --tui forces it on a graphical shell.

Small graphical displays show one selected control at a time, with its position in the eight-control sequence. The waveform remains visible when space allows. Short terminals scroll the controls to keep the selection visible. Long output names are clipped to the available width.

Controls:

Left/Right selects a control.
Up/Down, +/-, or Enter adjusts the selected control.
Space starts or stops output.
Esc, Q, or the app-exit key closes the application.

The output is off initially. Frequency is capped below the selected stream's Nyquist limit during rendering. A sweep moves linearly from Frequency to Sweep end during Sweep time, then repeats without resetting oscillator phase. Suspending the UI leaves an active generator running; closing it stops the Synth worker and releases the stream.

All controls can be targeted by the shared control-binding system while Funcgen is active:

funcgen.waveform: 0 sine, 1 square, 2 triangle, 3 saw, 4 pulse, 5 noise.
funcgen.frequency: 20 through 8000 Hz, logarithmic.
funcgen.amplitude: 0 through 100 percent.
funcgen.pulse.width: 1 through 99 percent.
funcgen.sweep.enabled: 0 off or 1 on.
funcgen.sweep.end: 20 through 8000 Hz, logarithmic.
funcgen.sweep.time: 100 through 60000 ms, logarithmic.
funcgen.output: runtime output index; 0 follows the default output.
funcgen.enabled: 0 off or 1 on.