AMLgsMenu

简体中文说明

Transparent OSD and configuration UI for AML-based fbdev + GLES targets. Uses EGL/OpenGL ES2 + libinput; ImGui is bundled as a submodule. Background is fully transparent except the menu panel. Embedded terminal functionality is adapted from the MIT-licensed ImGui-Terminal project—thanks to its author for the advanced terminal emulator.

Features

• OSD mock (or MAVLink) data: horizon, signals (dBm), flight mode, GPS + home distance, video bitrate/resolution/refresh, battery, sky/ground temps. In WFB mode, ground antenna readings and bitrate parse the latest RX_ANT/PKT entries from the wifibroadcast journal; in ap_mode=1, signal and bitrate switch to iw dev <wlan> link (RSSI plus WiFi link bitrate). The top-left label shows %d WIFI PLUGGED based on monitor-mode interfaces from iw dev (real data only).
• Channel list aligned to Digi: 2.4G 1–13 + 5G {32,36,40,44,48,52,56,60,64,68,96,100,104,108,112,116,120,124,128,132,136,140,144,149,153,157,161,165,169,173,177}. Bandwidth 10/20/40 MHz.
• Sky modes aligned to Digi: 1280x720@120, 1920x1080@90, 1920x1080@60, 2240x1260@60, 3200x1800@30, 3840x2160@20. Ground modes auto-read from /sys/class/amhdmitx/amhdmitx0/modes with fallback.
• Command-line: -t <font.ttf> custom UI font (recommend bold CJK font), -T <font.ttf> custom terminal font, -m 1 forces mock data; default binds MAVLink UDP 0.0.0.0:14452.
• The command executor runs continuously in the background. Every minute it prints [CommandExecutor] queue depth: N, which helps monitoring command backlog (large values usually mean remote operations stuck).
• UDP config push (fire-and-forget) to 127.0.0.1:14650/14651: channel, bandwidth, sky mode (size/fps, restart majestic), bitrate (Mbps→kbps), sky power (p*50 mBm). Ground channel applies to local monitor interfaces via iw (with HT20/HT40+ suffix); ground power targets monitor interfaces in WFB mode and the configured wlan interface when ap_mode=1.
• Icons default path /storage/digitalfpv/icons/ (PNG, e.g., 48x48). Text is white with black outline, menu opaque; OSD fully transparent behind.
• Firmware transport toggle: CC edition (UDP loopback) or Official (SSH to root@10.5.0.10, password 12345). Both use the same command.cfg templates; switch inside the menu and the app transparently swaps transports.
• Sound controls: toggle “Sound” to write sound=0|1 in wfb.conf and send sound=1|0 via UDP to 127.0.0.1:5612; adjust the volume dropdown (0%–100%) to send pactl set-sink-volume @DEFAULT_SINK@ XX%.
• Custom text overlays for arbitrary commands (see the icons/fonts section for format).

Build

Deps: C++17, CMake 3.16+, EGL/OpenGL ES2, libinput/udev, libpng/zlib, libssh; ImGui submodule under third_party/imgui.

CoreELEC cross example (from user toolchain):

export TOOLCHAIN=/home/docker/CoreELEC/build.CoreELEC-Amlogic-ng.arm-21/toolchain
export SYSROOT=${TOOLCHAIN}/armv8a-libreelec-linux-gnueabihf/sysroot
export CXX=${TOOLCHAIN}/bin/armv8a-libreelec-linux-gnueabihf-g++
export CC=${TOOLCHAIN}/bin/armv8a-libreelec-linux-gnueabihf-gcc
cmake -S . -B build-ng \
  -DCMAKE_C_COMPILER=${CC} \
  -DCMAKE_CXX_COMPILER=${CXX} \
  -DCMAKE_SYSROOT=${SYSROOT} \
  -DIMGUI_ROOT=$(pwd)/third_party/imgui \
  -DAML_ENABLE_GLES=ON
cmake --build build-ng

Run

./AMLgsMenu -t /path/to/font.ttf      # optional UI font
./AMLgsMenu -T /path/to/font.ttf      # optional terminal font
./AMLgsMenu -m 1                      # force mock
./AMLgsMenu -c /flash/command.cfg     # override command template config (default /flash/command.cfg)
./AMLgsMenu -f /storage/digitalfpv/wfb.conf        # override wfb.conf path (default /storage/digitalfpv/wfb.conf)
./AMLgsMenu -h | --help               # show usage summary

Right-click or gamepad X toggles the menu; controller navigation enabled.

Firmware modes

• Menu entry “Firmware” lets you choose CC edition (UDP) or Official (SSH). UDP mode targets the classic CC firmware and keeps talking to 127.0.0.1:14650/14651. Official mode opens a short-lived SSH session to root@10.5.0.10 (default password 12345) for every command/query；set ssh_pass=<newpass> in /storage/digitalfpv/wfb.conf if the target password changes. The command.cfg templates stay the same—the app simply swaps transports.
• The selection is persisted inside /storage/digitalfpv/wfb.conf under firmware=cc|official (the file is auto-copied from /flash/wfb.conf if missing). Edit the file manually or use the menu; switching triggers a one-shot remote state sync so the dropdowns reflect the other side.
• SSH support relies on libssh; make sure the dependency is available in your CoreELEC toolchain/sysroot.

MAVLink

• Receiver binds 0.0.0.0:14452 UDP; first message logs once. Flight mode hidden if unknown. Mock mode bypasses receiver.

Icons & fonts

• Default icon lookup: /storage/digitalfpv/icons/. Use ~48x48 transparent PNGs.
• Use a bold CJK-compatible font for clarity; pass via -t. Terminal still follows -T (falls back to the UI font when unset).
• Custom overlays: extend command.cfg with

  [osd]
  cpu = 80|60|sh -c 'printf \"CPU %.1f%%\" $(awk \'{print $1}\' /tmp/cpu)'
  temp = 80|90|cat /storage/digitalfpv/temp.txt

  Coordinates are in screen pixels from the top-left origin.

Input tips

• Mouse: right-click toggles the menu; left-clicking also wakes it when hidden, and left-click/wheel behave like a desktop app.
• Keyboard: Alt toggles the menu; arrows move focus; Enter confirms combos/buttons; Ctrl+C quits the app. When the terminal is open, keyboard events are captured by the terminal (menu navigation falls back to mouse).
• Gamepad (Xbox layout): X toggles the menu; D-Pad moves; A confirms selection.
• For the embedded terminal, best experience is with both keyboard and mouse attached; avoid relying on the controller while the terminal window is active.

Safety / license

• Licensed under GPL-3.0-only (see LICENSE). No warranty; commercial/illegal use is forbidden and entirely at user’s own risk.