Configurazione Firmware Nest Thermostat

🏆 Vincitore del FULU Bounty 🏆

Hack House e questo progetto sono i vincitori ufficiali del FULU Bounty per Nest Learning Thermostat Gen 1/2

Alternativa Hardware: Se sei interessato al lato hardware, dai un'occhiata a https://sett.homes per un'opzione di sostituzione PCB drop-in.

Installazione

Opzione 1: Installer GUI - Consigliata

📖 Segui la guida all'installazione su docs.nolongerevil.com oppure scarica l'ultima release direttamente.

L'installer gestisce tutto — il flashing del firmware e ti accompagna nella configurazione. Durante la configurazione, scegli la modalità di hosting:

• Cloud-hosted — si connette alla piattaforma No Longer Evil; nessuna configurazione del server richiesta
• Self-hosted (Home Assistant) — rileva automaticamente la tua istanza Home Assistant e si connette all'add-on No Longer Evil
• Self-hosted (NLE Server) — si connette a un server No Longer Evil autonomo su IP e porta personalizzati

Self-hosting? Dovrai configurare la tua infrastruttura server separatamente prima di eseguire l'installer. Consulta la Guida Self-Hosted.

Opzione 2: Compila dal Sorgente

Se preferisci compilare ed eseguire l'installer da solo invece di scaricare una release:

Prerequisiti

• Node.js 18+ e npm
• Docker — necessario solo se ricompili il firmware dal sorgente (Installa Docker)
• macOS/Linux — Windows non è supportato per la compilazione o il flashing

1. Clona il Repository

git clone https://github.com/codykociemba/NoLongerEvil-Thermostat.git
cd NoLongerEvil-Thermostat

2. Compila il Firmware (opzionale)

Il repository include già file firmware pre-compilati in firmware/installer/resources/firmware/. Questo passaggio è necessario solo se vuoi personalizzare il firmware (ad es. un URL server diverso).

cd firmware/builder
./docker-build.sh --generation both --enable-root-access --yes

Questo compila sia per Nest Gen 1 che Gen 2 all'interno di Docker. Successivamente, copia l'output nell'installer:

cp firmware/builder/firmware/* firmware/installer/resources/firmware/

3. Compila o Esegui l'Installer

cd firmware/installer
npm install

Esegui direttamente (nessuna build necessaria):

npm run electron:dev

Oppure crea un distributibile:

npm run package:mac    # macOS
npm run package:linux  # Linux

L'output si trova in firmware/installer/dist/. Apri l'app compilata e segui i passaggi a schermo.

Considerazioni sulla Sicurezza

Questo strumento fornisce accesso a basso livello al processo di boot del dispositivo. Usalo in modo responsabile:

• Usalo solo su dispositivi di tua proprietà
• Un firmware errato può brickare il tuo dispositivo (Non denunciarmi, bro)

Crediti e Ringraziamenti

Questo progetto si basa sull'eccellente lavoro di diversi ricercatori di sicurezza e sviluppatori:

• grant-h / ajb142 - omap_loader, il bootloader USB utilizzato per il flashing dei dispositivi OMAP
• exploiteers (GTVHacker) - Ricerca e sviluppo originali dell'attacco DFU Nest, che ha dimostrato la capacità di flashare firmware personalizzato sui dispositivi Nest gen 1 e gen 2
• FULU e tutti i sostenitori del bounty - Per aver finanziato il bounty Nest Learning Thermostat Gen 1/2 e sostenuto il movimento per il diritto alla riparazione

Senza la loro ricerca innovativa, i contributi open-source e la difesa dei diritti di proprietà dei dispositivi, questo lavoro non sarebbe stato possibile. Grazie!

Impegno Open Source

Siamo impegnati per la trasparenza e il movimento per il diritto alla riparazione. Le immagini del firmware e il codice del server API backend saranno presto open source, consentendo alla community di revisionare, migliorare e gestire in autonomia la propria infrastruttura.

Riferimenti

• OMAP Loader di ajb142
• Nest DFU Attack di exploiteers