# mtk-wifi-fw (working name)

Tooling, documentation, and update tracking for MediaTek Connac2 WiFi
firmware blobs (`mt7915/7916/7981/7986_{wm,wa,rom_patch}.bin` as shipped in
linux-firmware) — the WiFi firmware running on Filogic 820/830 routers
(GL.iNet, Banana Pi, Xiaomi, Netgear, TP-Link, ...).

Status: pre-release. Working now: container extractor (`tools/mtk_fw_extract.py`).
Planned: ELF export for Ghidra/objdump, cross-version diff reports, CI that
tracks upstream blob updates, format + boot-architecture documentation.

No proprietary firmware bytes are committed to this repository. Tools operate
on blobs from your own linux-firmware copy (see `make extract`).

Quickstart:

    make extract          # carve every MediaTek Connac2 blob on this host
    python3 tools/mtk_fw_extract.py /lib/firmware/mediatek/mt7981_wm.bin -o extracted

Project plan and working notes: [PLAN.md](PLAN.md) (development log, quality
gates, decision function). Documentation as it lands: [docs/](docs/).

License: MIT (code), CC-BY-SA-4.0 (docs).