Skip to content

v3.3.2 — BT tether polish + pwnagotchi relic cleanup

Choose a tag to compare

View all tags
@CoderFX CoderFX released this 12 Apr 12:26
· 51 commits to master since this release
v3.3.2
b5e574c

What's new

Focused on making the BT phone-tether flow more transparent and actionable, plus cleaning up stale pwnagotchi references.

BT tether reliability

  • Discoverable stays on — BlueZ default 180s DiscoverableTimeout was silently flipping the adapter invisible after 3 minutes. Fixed with a proper off→timeout=0→on sequence that cancels the running timer, plus a persistent /etc/bluetooth/main.conf patch that survives bluetoothd restarts.
  • Actionable error hints in the web UI — when a PAN connect fails, the Bluetooth card now shows a red-bordered hint box with a user-actionable message (e.g. "Bluetooth tethering isn't enabled on the phone" or "The phone forgot the pairing — pair again").
  • Robust DHCP — -4 IPv4-only flag, stale lease release before requesting, automatic dhclient fallback if dhcpcd fails, and DHCP failure hints surfaced to the dashboard.
  • State drift fix — the web API no longer briefly reports "BT OFF" for the first 2 seconds after daemon restart.
  • Passkey clears immediately — the dashboard pairing passkey box now disappears the instant Paired=true fires.

Diagnostics

  • PropertiesChanged watcher logs every Paired transition (true AND false) so field diagnostics can confirm the watcher is firing.

IP display

  • BT/USB IP rotation — when BT is tethered, the e-ink IP indicator alternates between BT <ip> and the USB IP every 5 loop cycles. USB-only when BT is off. (Adapted from wpa-2's PR #1)

Pwnagotchi relic cleanup

  • /etc/profile — 8 stale pwnagotchi aliases replaced with oxigotchi equivalents (config, oxilog, oxikill, status)
  • safe-shutdown.sh — removed systemctl stop pwnagotchi reference
  • pisugar-config.json — updated stale toggle-*.sh paths to correct pisugar-*.sh script names
    (Items surfaced by wpa-2's PR #1)

Documentation

  • BT Tethering Guide — dedicated step-by-step wiki page with per-OS phone instructions, error hint reference, phone quirks, and FAQ.
  • Clean-slate troubleshooting — "reset pairings on both sides" promoted to first step in all BT troubleshooting docs.
  • USB internet FAQ — Windows ICS / macOS Internet Sharing / Linux iptables steps.

Upgrade

Flash oxigotchi-v3.3.2-release.img.zip to a fresh SD card. If upgrading from v3.3.1 without reflashing, cross-compile and SCP the binary, then run sudo apply-oxigotchi-patches.sh to patch /etc/bluetooth/main.conf.

Assets 3
Loading