API Reference

Hides the top status bar and bottom panel while true, giving your app the full 800×480 canvas — useful for a maximized plot, graph, or video-style view. Set it directly; there's no signal to call. Most views enable it as soon as they load:

Component.onCompleted: fullscreen_mode = true

Component.onDestruction: fullscreen_mode = false

Reads one byte from the global settings table at slot id. The result is computed on the firmware side but never emitted back to QML — in practice, QML code reads settings from the locally-cached cfg_array (via the cfgGet(id) helper function) instead of this signal. Treat it as effectively non-functional for app use.

Writes value (truncated to a byte) to global settings slot id, persisted by the firmware. id is a numeric offset into the settings table (for example, slot 20 is the owner name, slot 117 is the UI language, slot 216 is USB mode) — the full offset table isn't part of this reference, so only call slots you've confirmed by reading how the built-in settings screens use them.

Sets the UI/system language to index val and persists it.

Sets the USB port mode (e.g. host / device / off) to val.

Sets the transmitter's registered owner name (up to 31 bytes).

Recomputes the current operating mode from settings. No parameters; exact scope beyond the name isn't confirmed from source alone.

Saves any pending changes to the current model, then (re)loads the model list.

Reports the currently loaded model's info back via onModelCur: (id, name, type, image, theme) — id is logged but doesn't select a different model.

Switches the active model to id: saves the previous model's pending changes, resets runtime state (timers, flight mode, ESC, stabi), loads and pushes the new model to the radio, then reports its bind serial via onModelBound: (serial).

Creates a new model named name of model type (plane / heli / copter / general) and selects it.

Deletes model name.

Renames the currently-selected model to name.

Duplicates the current model under the new name name.

Generic per-model settings setter. param is a field name string (e.g. "image", "theme", "timer_val_0", "options", "mix_type_0", "trim_adjust", and many more — see the built-in Model settings screens for the full set in context), value is the new value. Pushes the whole model to the radio and marks it changed.

Notifies that base model-type settings changed (wing/tail/engine/gear layout for a plane) and recomputes the channel list accordingly.

Starts (en = true) or stops (en = false) RF bind mode between the transmitter and a receiver.

Persists a new sort-order position index for model name in the model list.

Per-channel setter for channel id in the current flight mode. param selects the field: "delay", "rev" (reverse), "trim", "input", "dualrate_0"/"dualrate_1", "limit_0"/"limit_1", "expo", "curve_type", "curve_val_0"–"curve_val_8", "type" (channel type — also re-detects the throttle channel), "mix_input_0"–"mix_input_2".

Sends the current model's trim adjustment to the radio; starts a software trim timer if no physical trim input is assigned.

Starts stick/pot calibration mode on the radio hardware.

Ends calibration mode.

Adds a new flight mode named name to the current model.

Deletes flight mode name.

Renames flight mode oldn to newn.

Sets field param of flight mode id. Known fields: "input" (trigger switch/input), "enpos" (enable threshold), "priority", "delay" (transition delay, in centiseconds).

Sets stabilization parameter param to value, sent live to the stabilization unit. Depending on the parameter, it's stored either per-flight-mode or in the model-type-specific stabi config. param indices are firmware-defined and opaque outside the stabi config tables — confirm the index against a known-good screen before calling. Parameter 251 is a special "factory reset" trigger for the stabi unit's cached load state.

Enables/disables a per-flight-mode override for stabi parameter param.

Queries stabi parameter param's value across all flight modes; answered via the root window's stabiFMQuery(...) handler.

Requests a stabilization-unit event-log entry at address addr.

Clears the stabilization unit's event log.

Sets ESC parameter param to value. Special case: param == -1 instead initializes ESC parameter loading (needed for HobbyWing v5 ESCs) rather than writing a value.

Requests the receiver's current hardware data/config from the radio.

Sets receiver parameter param to value.

Rebuilds the SBUS channel mapping for the current model. No-op for plane model types.

Feeds timer id's current value/state into the alarm-evaluation engine, so timer-based alarms can trigger from it.

Creates a new alarm of type with condition opt/op/opt2, repeat behavior, and threshold val; refreshes the alarm list.

Updates existing alarm name with new condition/threshold fields (same meaning as signalAlarmAdd) and clears its "stopped" flag.

Persists alarm name to storage and refreshes the alarm list.

Deletes alarm name.

(Re)loads the alarm list for the current model.

Adds a spoken telemetry "report" of type with source input (channel, or -1 for none), enable position enpos, repeat behavior, and opt; refreshes the report list.

Updates the report matching type with new field values.

Persists report type and refreshes the list.

Deletes report type.

Requests aggregated flight statistics for the current model (flight time, max vibration, RPM min/max, capacity used, voltage/current min/max, peak power, max speed, max altitude, …), delivered to the stats_array property.

Scans storage for available flight log files.

Opens/loads log file name.

Deletes log file name.

Deletes all flight logs.

Fetches a data series from the open log: type/id select the channel to plot, from/to are a millisecond time range within the log. Answered synchronously.

Triggers a Wi-Fi network scan.

Turns Wi-Fi on (val truthy) or off (falsy).

Saves credentials for network site and connects to it. pwd may be an empty string for open networks.

Deletes saved credentials for site (or, if site is empty, just refreshes the saved-network list).

Sets Bluetooth mode to val. Special value 100 instead deletes the BT pairing/cache database — it's a "clear Bluetooth cache" command, not a normal mode.

Scans for nearby Bluetooth devices; results arrive via the btList handler. Requires Bluetooth to already be enabled.

Records mac as the remote device to connect to. In this build, the actual pairing/connect step is disabled, so this currently only stores the address.

Controls the Bluetooth-joystick/gamepad bridge. mode == -1 is a special "status poll" call rather than a real mode value — it reports current status and can (re)start the bridge helper.

Puts the main RC RF chip into test mode mode, disrupting the normal RC control link.

Requests RF spectrum-analysis data. Read-only diagnostic, but part of the factory-test tooling family.

Starts/stops a Wi-Fi simulation thread, used for QA testing without real Wi-Fi hardware. Not meant for production app use.

Shuts the device down: stops all comm/network/server threads, powers off connected accessory units, then powers off the unit itself. Never call without explicit, deliberate user confirmation.

Restarts the UI application (applying any staged UI update first), interrupting whatever's currently on screen.

Scans directory dir through the general-purpose file manager (used for browsing images/music/etc.). dir is a free-form path forwarded as-is — validate it before passing anything derived from outside input.

Synthesizes a voice clip named name from text. Progress/result surfaces via the download_act property (1 = in progress, 2 = success, -1 = failure).

Plays previously-generated voice clip name.

Retrieves the source text associated with voice clip name into the tts_text property.

Checks TTS engine/voice availability; result lands in the tts_check property (1 = ok, -1 = failed).

Downloads TTS voice data; clean requests removing old data first.

Loads the list of internet/media radio stations.

Plays media at addr (a station URL or local file reference).

Stops media playback.

Requests the current media-player state (playing/paused, track info).

Deletes stored media entry name.

Lists files under the on-device Music directory; results arrive via mediaMusicList.

Enables/disables live GPS map rendering. Call with true when your app's map view becomes visible, and false when leaving it.

Starts the built-in web server. Publishes the resulting address via the wifi_ip property.

Requests the web server to stop.

Polls whether the web server is currently running; updates the websrv_stat/wifi_ip properties.

Enables/disables remote touch input from a connected web client (this is exactly the "Allow control" toggle behind Wave Studio's Screen-tab remote control). Enabling it grants a network client interactive control of the device's touchscreen — don't turn it on without the user knowing.

Lists stored model/background images.

Deletes image id.

Sets trainer-link mode (0, 1, or 2) for the current model.

Checks trainer-link connection status; result lands in trainer_status. exit requests tearing the link down as part of the check.

Synchronizes model data over the trainer link; model_new indicates whether the receiving side should treat it as a brand-new model.

Checks model-sharing connectivity/status for mode.

Synchronizes/shares the current model with another device.

Lists installed apps; results arrive via the appsList handler.

Launches app name. If binary is false and the app has an app.qml, it's pushed onto the shared StackView — this is the exact mechanism your own app was loaded with, so it's also how one app could launch another (or reload itself). If binary is true (or there's no app.qml), the UI process restarts to hand off to a native binary instead.

Reads app name's persisted app.cfg settings file; results arrive via appsCfgList. Use this to load your own app's saved settings — pass your own app's name.

Writes/updates param = value in app name's app.cfg file, for persisting your own app's settings. As with signalAppsCfgLoad, name isn't automatically scoped to the calling app — always pass your own app's name.

Triggers a haptic vibration pulse lasting time milliseconds.

Plays a built-in UI sound effect, gated by the user's sound settings: 0 = keyboard click, 1 = value-picker tick, 2 = button click, 3 = side-panel/back sound. Other ids are ignored. Rate-limited to 20ms between triggers.

Plays an arbitrary audio file at path, non-blocking, with the same 20ms rate-limiting as osSoundEffect.