Configuração do Firmware do Nest Thermostat

🏆 Vencedor do FULU Bounty 🏆

Hack House e este projeto são os vencedores oficiais do FULU Bounty para Nest Learning Thermostat Gen 1/2

Alternativa de Hardware: Se você está interessado no lado do hardware, confira https://sett.homes para uma opção de substituição de PCB plug-and-play.

Instalação

Opção 1: Instalador GUI - Recomendado

📖 Siga o guia de instalação em docs.nolongerevil.com ou baixe a versão mais recente diretamente.

O instalador cuida de tudo — gravação do firmware e orientação durante a configuração. Durante a configuração, escolha seu modo de hospedagem:

• Hospedado na nuvem — conecta à plataforma No Longer Evil; nenhuma configuração de servidor necessária
• Auto-hospedado (Home Assistant) — descobre automaticamente sua instância do Home Assistant e conecta ao add-on No Longer Evil
• Auto-hospedado (Servidor NLE) — conecta a um servidor No Longer Evil independente em um IP e porta personalizados

Auto-hospedagem? Você precisará configurar sua infraestrutura de servidor separadamente antes de executar o instalador. Consulte o Guia de Auto-hospedagem.

Opção 2: Compilar a partir do código fonte

Se preferir compilar e executar o instalador você mesmo em vez de baixar uma versão:

Pré-requisitos

• Node.js 18+ e npm
• Docker — necessário apenas se for recompilar o firmware a partir do código fonte (Instalar Docker)
• macOS/Linux — Windows não é compatível para compilação ou gravação

1. Clone o Repositório

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

2. Compile o Firmware (opcional)

O repositório já inclui arquivos de firmware pré-compilados em firmware/installer/resources/firmware/. Esta etapa só é necessária se você quiser personalizar o firmware (por exemplo, uma URL de servidor diferente).

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

Isso compila para ambos Nest Gen 1 e Gen 2 dentro do Docker. Depois, copie a saída para o instalador:

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

3. Compile ou Execute o Instalador

cd firmware/installer
npm install

Execute diretamente (sem necessidade de compilação):

npm run electron:dev

Ou compile um distribuível:

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

A saída está em firmware/installer/dist/. Abra o aplicativo compilado e siga as instruções na tela.

Considerações de Segurança

Esta ferramenta fornece acesso de baixo nível ao processo de inicialização do dispositivo. Use com responsabilidade:

• Use apenas em dispositivos que você possui
• Firmware inadequado pode brickar seu dispositivo (Não me processe, mano)

Créditos e Agradecimentos

Este projeto se baseia no excelente trabalho de vários pesquisadores e desenvolvedores de segurança:

• grant-h / ajb142 - omap_loader, a ferramenta de bootloader USB usada para gravar dispositivos OMAP
• exploiteers (GTVHacker) - Pesquisa e desenvolvimento originais do ataque Nest DFU, que demonstrou a capacidade de gravar firmware personalizado em dispositivos Nest gen 1 e gen 2
• FULU e todos os apoiadores das recompensas - Por financiar o bounty do Nest Learning Thermostat Gen 1/2 e apoiar o movimento do direito ao reparo

Sem suas pesquisas inovadoras, contribuições de código aberto e defesa dos direitos de propriedade dos dispositivos, este trabalho não seria possível. Obrigado!

Compromisso com Código Aberto

Estamos comprometidos com a transparência e o movimento do direito ao reparo. As imagens de firmware e o código do servidor da API backend serão disponibilizados como código aberto em breve, permitindo que a comunidade audite, melhore e hospede sua própria infraestrutura.

Referências

• OMAP Loader by ajb142
• Nest DFU Attack by exploiteers