zacheryasc/mtk-wifi-fw
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Tooling, docs, and update tracking for MediaTek Connac2 WiFi firmware (mt7915/16/7981/86) — Filogic routers
5 commits 1 branch 1 tag 182 KiB
Python 97.3%
Shell 1.5%
Makefile 1.2%
Find a file
Zachery Aaron Shores-Chmielewski be11e41043 Diff engine: region-aligned byte-equality + plausible string set diffs; pilot reports mt7981 wm/wa across 2022/2024/2026 builds
2026-08-20 21:22:54 +04:00
dataset linux-firmware history walker: 54 revisions across mt79xx wm/wa/patch (+wo sha-only), hidden build-string recovery per revision 2026-08-20 21:20:43 +04:00
docs Diff engine: region-aligned byte-equality + plausible string set diffs; pilot reports mt7981 wm/wa across 2022/2024/2026 builds 2026-08-20 21:22:54 +04:00
tests ELF emitter: EM_NDS32 ET_EXEC, PT_LOAD per region at true addresses; readelf-validated; tests (structure + segment fidelity); MTK_FW_DIR env override 2026-08-20 21:13:54 +04:00
tools Diff engine: region-aligned byte-equality + plausible string set diffs; pilot reports mt7981 wm/wa across 2022/2024/2026 builds 2026-08-20 21:22:54 +04:00
.gitignore Scaffold: licenses, Makefile, README, PLAN w/ decision function; extractor parses container + hidden build-string trailer; findings log F1-F4 + unknowns registry 2026-08-20 21:09:43 +04:00
LICENSE Scaffold: licenses, Makefile, README, PLAN w/ decision function; extractor parses container + hidden build-string trailer; findings log F1-F4 + unknowns registry 2026-08-20 21:09:43 +04:00
Makefile ELF emitter: EM_NDS32 ET_EXEC, PT_LOAD per region at true addresses; readelf-validated; tests (structure + segment fidelity); MTK_FW_DIR env override 2026-08-20 21:13:54 +04:00
PLAN.md Scaffold: licenses, Makefile, README, PLAN w/ decision function; extractor parses container + hidden build-string trailer; findings log F1-F4 + unknowns registry 2026-08-20 21:09:43 +04:00
README.md Scaffold: licenses, Makefile, README, PLAN w/ decision function; extractor parses container + hidden build-string trailer; findings log F1-F4 + unknowns registry 2026-08-20 21:09:43 +04:00

README.md

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 (development log, quality gates, decision function). Documentation as it lands: docs/.

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