PocketWUI 2.0: USB network + drive, QR sign-in, search, ZIP, previews, WebDAV, new UI

[AFetisa]

Renames the project to PocketWUI and adds the features discussed. The goal is something non-technical people can use and show off, not just a tool for tinkerers.

What changes for users

• Scan to connect. The device's side button cycles through two QR codes: one joins the Cardputer's Wi‑Fi, the other signs you in. The sign-in code works once and expires after 2 minutes.
• USB cable. Plugged into a computer, the Cardputer shows up as a network adapter at http://192.168.7.1, and the computer keeps its own internet. It can also lend the SD card to the computer as a USB drive.
• Files.
  • Search the whole card, or filter the current folder as you type.
  • Sort columns and select several items at once.
  • Download a folder or a selection as one ZIP. The size is known up front, and archives over 4 GB work (ZIP64).
  • Trash, copy, a "Replace?" prompt on name clashes, SHA‑256 checksums, folder sizes.
  • Paste to upload; uploads go in 256 KB chunks.
• Previews. Photo gallery, video and music with seeking, PDF, Markdown, text editor.
• Wi‑Fi.
  • Remembers up to five networks and joins the strongest one in range.
  • Quietly retries saved networks from hotspot mode, but never while a phone is connected to the hotspot.
  • Captive portal on the hotspot; network scan.
  • Hotspot key, device name, and a "keep the hotspot on" option.
  • The device clock is set from the browser, or from the internet (NTP).
• WebDAV network drive at /dav/.
• M5Launcher.
  • A Back to Launcher button.
  • Under Launcher the device never flashes firmware itself; it checks an uploaded .bin and says to install it from Launcher.
  • Installed standalone, it updates itself, and rolls back if the new version fails to start.
• New web UI. Light and dark themes, works on phones, a Settings panel. Still one self-contained 24 KB page that works offline.
• Device screen. Battery level, USB status, dims when idle, a USB-drive screen.

Under the hood

• Platform: moved to pioarduino (Arduino core 3.3.12), which EspUsbDevice needs.
• USB mode: the build uses USB-OTG (TinyUSB) mode with no USB serial console. A compile-time check stops the build if the mode is wrong.
• Flash layout: partitions.csv has two app slots, so standalone installs can update themselves.
• Responsiveness: long downloads and ZIPs run on background threads. The SD lock is held for one chunk at a time, not a whole transfer.
• Code layout: the server is split into api_files, api_device, dav, stream, jobs, usb, firmware and small helper modules.
• Review fixes (hardware-only issues):
  • USB drive: the computer's reads and writes now run under the SD lock, fixing a use-after-free when the card is handed back.
  • Copy and checksum jobs now yield, so a long one can't trip the watchdog.
  • The Wi‑Fi join and the reconnect loop can no longer interfere with each other.
  • An idle upload is no longer closed while it is still being written.
  • Update rollback now actually works.

Testing

• test/hostsim compiles the firmware's real server code for a PC, with stand-ins for esp_http_server, the SD card and the radio. It replaces tools/mock_server.py.
• make -C test host: unit tests for paths, QR text, text helpers, ZIP (including a real archive over 4 GB when WUI_ZIP64_TEST=1) and firmware images, plus the browser upload loop.
• make -C test sim: 59 API checks and 30 Chromium UI checks against the simulator. All of these run in CI along with the firmware build.
• rclone sync, check, copy back and move over WebDAV worked against the simulator.
• Not yet run on a real Cardputer: Wi‑Fi, the USB network adapter and drive, the screen, the battery reading, Back to Launcher and self-update. This PR is ready for hands-on testing with build/PocketWUI.bin from M5Launcher.

🤖 Generated with Claude Code

https://claude.ai/code/session_01XgGV6mvKRxDHTmFyWfaSME

---

Generated by Claude Code