Troubleshooting

Troubleshooting

Touch works in evtest / i2cdetect but taps do nothing in the app

On Raspberry Pi OS Bookworm with labwc/Wayland, Xwayland usually delivers mouse events for the panel, not SDL FINGER* events. If /etc/flightscnr.env has TOUCH_USE_FINGER_EVENTS=True, taps can be dropped on older builds:

sudo sed -i 's/^TOUCH_USE_FINGER_EVENTS=.*/TOUCH_USE_FINGER_EVENTS=False/' /etc/flightscnr.env
sudo systemctl restart flightscnr

Current builds also fall back to the mouse path automatically when no FINGER* events arrive (see issue #14).

Pinch-to-zoom does nothing

Tracked in issue #21.

Pinch only works when SDL delivers multi-touch as FINGERDOWN / FINGERMOTION / FINGERUP. That is independent of TOUCH_USE_FINGER_EVENTS (which only chooses the tap/swipe path). Under Xwayland, touch is often pointer-emulated as a single mouse cursor — mouse events cannot represent two fingers, so pinch is impossible on that path. Check:

sudo journalctl -u flightscnr -b | grep -E 'Touch:|pinch:|FINGER'

• If you never see FINGER events detected / pinch: session ARMED, the display stack is not sending multi-touch to SDL.
• Keep TOUCH_USE_FINGER_EVENTS=False for reliable taps under Xwayland; flipping it to True does not invent FINGER* events.
• Change range without pinch: on-device Settings → Options → Range (or the portal radar range control).
• Free finger-drag pan of the map is not a radar gesture (swipe changes screens). Use Settings → Recenter for map pan calibration.
• Optional debug: set TOUCH_DEBUG=1 in /etc/flightscnr.env, restart, pinch on radar, and inspect journalctl -u flightscnr -f | grep touch.

Blank Waveshare panel after boot

• Confirm the correct overlay in config.txt / /boot/firmware/config.txt (see Installation).
• On Pi 5 / Compute Module, try the DSI0 overlay line instead of DSI1.
• Power off fully before reseating the DSI ribbon.

Web portal not reachable

• Confirm the Pi is on the same LAN and try http://<hostname>.local (default hostname from Imager).
• Check the service: sudo systemctl status flightscnr and sudo journalctl -u flightscnr -f.
• Port defaults to 80; override with WEB_PORT in /etc/flightscnr.env.

Useful log commands

sudo journalctl -u flightscnr -f
sudo journalctl -u flightscnr -b | grep -E 'Touch:|pinch:|FINGER'