discover · compare · collections · requirements · contribute · feed · watching · stats · help with your tokens
Saddytech/openwrt-nx679j · source

Snapshot 0 · 2026-11-04T12:47:28Z · C · MIT
Content fingerprint
7f248bf97f94124828165b8eebaea2981a42c40940a1af0b0ac08cbfdca35d15
GitHub description at capture

OpenWrt nativo su Nubia RedMagic 7 (NX679J, SM8450): documentazione verificata, reverse engineering della catena di boot, payload del port. MIT (codice) + CC BY 4.0 (documentazione).
README at capture

# NX679J — OpenWrt nativo su un Nubia RedMagic 7 (SM8450)

Port completo di **OpenWrt 25.12.5** su un telefono **Nubia RedMagic 7 (NX679J, Snapdragon 8 Gen 1 / SM8450)**: OpenWrt gira in chroot sullo **slot B** con il **kernel vendor 5.10.66 lasciato intatto**, il **modem X65** come uplink, e un'**interfaccia utente nativa sul display del telefono** (tasti laterali + standby senza burn-in).

> ⚖️ **Progetto indipendente.** Non è affiliato, approvato né sponsorizzato dal progetto OpenWrt. «OpenWrt» è un marchio registrato di Software Freedom Conservancy, usato qui in forma descrittiva e fattuale (il sistema portato è la release OpenWrt 25.12.5); nessun logo di terzi è utilizzato. «Nubia», «RedMagic», «Qualcomm» e gli altri nomi citati appartengono ai rispettivi titolari.

> 📄 **Il documento principale è [`DOCUMENTAZIONE.md`](DOCUMENTAZIONE.md)** (~249 KB, 22 sezioni): la storia completa e verificata del progetto — le radici (reverse-engineering della catena di boot, secure boot/AVB, EDL/QDL, XBL/ABL/UEFI), il port (immagine, sistema, modem X65, interfaccia, kernel e display), i **crediti** (strumenti e fonti di conoscenza, con URL), più cronologia, scheda hardware, manuale operativo e archivio del progetto.

> 🔧 **Gli artefatti non inclusi (firmware, moduli, boot image…) si ricostruiscono tutti**: [`ESTRAZIONE-BLOB.md`](ESTRAZIONE-BLOB.md) contiene le **procedure complete e verificate** (dall'OTA ufficiale e dal proprio dispositivo).

## Cos'è questo progetto

Un telefono Android vincolato che diventa un router Linux. La catena di boot Qualcomm è stata studiata fino in fondo; l'immagine di boot viene ricostruita attorno al kernel stock; il sistema vive in un chroot sul ramdisk; il modem viene pilotato direttamente via QMI/QRTR (senza ModemManager); una UI C scritta a mano disegna su DRM/KMS le funzioni di controllo. Ogni affermazione nella documentazione porta la sua evidenza: comandi, offset, md5, righe di log.

## Nomi redatti: convenzione

In 12 file compaiono segnaposto come `«redacted»` (questo README e `08-skill/LEGGIMI.md` spiegano la convenzione): la redazione automatica ha mascherato percorsi e nomi ritenuti sensibili. Il percorso del progetto è `/home/user/nx679j-stock`; la dir degli strumenti sul device è `/usr/lib/*/modem/`. I file del progetto hanno prefisso `nx679j-`: se in una copia il prefisso appare troncato, il file reale è quello con `nx679j-`.

## Contenuto del repository

| Cartella | Cosa contiene |
|---|---|
| `DOCUMENTAZIONE.md` | La storia completa e verificata del progetto — **il punto di partenza** |
| `ESTRAZIONE-BLOB.md` | **Come ricostruire ogni artefatto escluso**: firmware stock, partizioni, moduli vendor, firmware touch, DTB/DTBO, boot image, loader Firehose, sorgenti GPL, GPT, EFS |
| `LICENSES/` | I **testi integrali** delle licenze dei componenti di terzi (GPL-2.0, LGPL-2.1, Apache-2.0, BSD-3-Clause, musl, svg-spinners) con la provenienza di ciascuno |
| `THIRD_PARTY_LICENSES.md` | Licenze e attribuzione del codice di terzi incluso (e di quello citato ma escluso) |
| `01-documenti/` | Documenti storici e snapshot datati degli stessi; i documenti singoli identici a uno snapshot sono stati deduplicati (l'elenco con le copie canoniche è in `DEDUPLICA.md`) |
| `02-sorgenti/` | Script e sorgenti: builder delle immagini (`build-v*.py`), payload del ramdisk (`payload-build-v64/`), UI C, strumenti, workdir delle fasi init |
| `04-persistenza/` | I tar di persistenza (etc/luci/tools) **sanificati**, come iniettati nel ramdisk |
| `05-bootchain-re/` | Il reverse-engineering della catena: analisi ABL/XBL/UEFI (testo, offset, quote), readback EDL verificato, fatti del dispositivo |
| `06-ricerche/` | Le ricerche su display/DSI/idle_pc_state e il lavoro di porting (DTB swap, device facts) |
| `07-evidenze-runtime/` | Prove raccolte dal device: interrupts, dmesg, properties, getvar, pinctrl |
| `08-skill/` | Le procedure operative del progetto: passi verificati e **trappole già pagate** |
| `09-albero-originale/` | Il resto dell'albero di lavoro, non-blocco: RE di EDL/QDL (`edl-recovery/`), analisi dei fallimenti (`phase2-failure-analysis/`), build headless e log dei tentativi di boot (`native-openwrt-usb-build/`), verifiche UEFI/OTA (`verified-*`), prove sul bootloader (`hypervisor-bypass/`), i **tool QMI/QRTR** e altri strumenti del progetto |

## Cosa NON troverai qui (e perché)

Immagini di boot, moduli vendor, firmware e dump di partizioni restano fuori **per scelta precisa**: contengono software proprietario Qualcomm/Nubia, e la documentazione li descrive e li referenzia come artefatti locali del dispositivo — coerentemente con la natura di interoperabilità del progetto. In questa revisione sono stati rimossi anche gli artefatti vendor che erano rimasti (firmware modem `.mbn`, DTB/DTBO, ramdisk e `init` vendor) e le copie del rootfs OpenWrt.

**E per ricostruirli tutti c'è la procedura completa**: [`ESTRAZIONE-BLOB.md`](ESTRAZIONE-BLOB.md) — firmware stock dall'OTA ufficiale, immagini di partizione dal proprio device (root), moduli vendor, firmware del touch (debugfs), DTB/DTBO, boot image, loader Firehose, sorgenti kernel GPL, GPT ed EFS, con i comandi verificati del progetto.

## Metodo

Una sola regola: **nessun risultato senza verifica**. Il documento è stato revisionato sezione per sezione contro i sorgenti originali (audit indipendenti), e ogni contributo esterno — strumenti, repository, thread, documentazione — è accreditato per intero nelle due sezioni di crediti. Questo lavoro poggia su molto di altrui: i crediti appartengono ai loro autori.

## Licenza

**Codice: MIT** (file [`LICENSE`](LICENSE)) — **documentazione: CC BY 4.0** (file [`LICENSE-docs`](LICENSE-docs)).
Attribuzione richiesta: «Saddytech — NX679J OpenWrt» con link a questo repository.

Il codice e i documenti di **terzi** inclusi mantengono le proprie licenze: l'attribuzione è in [`THIRD_PARTY_LICENSES.md`](THIRD_PARTY_LICENSES.md).

## Avvertenza

Progetto di ricerca e interoperabilità su un dispositivo di proprietà degli autori. Nessuna garanzia: le procedure di flash vanno seguite solo con backup verificati, come descritto nel manuale operativo della documentazione.