إعداد البرنامج الثابت لمنظّم حرارة Nest

🏆 فائز بجائزة FULU 🏆

Hack House وهذا المشروع هما الفائزان الرسميان بـ جائزة FULU لمنظّم الحرارة Nest التعليمي من الجيلين 1 و2

بديل الأجهزة: إذا كنت مهتمًا بالجانب المتعلق بالأجهزة، فتفقّد https://sett.homes للحصول على خيار استبدال لوحة PCB دون الحاجة إلى تعديلات.

التثبيت

الخيار الأول: مثبّت الواجهة الرسومية - موصى به

📖 اتبع دليل التثبيت على docs.nolongerevil.com أو حمّل أحدث إصدار مباشرةً.

يتولى المثبّت كل شيء — من وميض البرنامج الثابت إلى إرشادك خلال الإعداد خطوة بخطوة. أثناء الإعداد، اختر وضع الاستضافة الخاص بك:

الاستضافة السحابية — يتصل بمنصة No Longer Evil؛ لا يتطلب إعداد خادم
الاستضافة الذاتية (Home Assistant) — يكتشف تلقائيًا مثيل Home Assistant لديك ويتصل بالوظيفة الإضافية No Longer Evil
الاستضافة الذاتية (خادم NLE) — يتصل بخادم No Longer Evil مستقل على عنوان IP ومنفذ مخصصين

استضافة ذاتية؟ ستحتاج إلى إعداد البنية التحتية للخادم الخاص بك بشكل منفصل قبل تشغيل المثبّت. راجع دليل الاستضافة الذاتية.

الخيار الثاني: البناء من المصدر

إذا كنت تفضّل بناء المثبّت وتشغيله بنفسك بدلًا من تنزيل إصدار جاهز:

المتطلبات الأساسية

Node.js 18+ وnpm
Docker — مطلوب فقط إذا أعدت بناء البرنامج الثابت من المصدر (ثبّت Docker)
macOS/Linux — نظام Windows غير مدعوم للبناء أو الوميض

1. استنساخ المستودع

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

2. بناء البرنامج الثابت (اختياري)

يتضمن المستودع بالفعل ملفات برنامج ثابت مبنية مسبقًا في firmware/installer/resources/firmware/. هذه الخطوة مطلوبة فقط إذا أردت تخصيص البرنامج الثابت (على سبيل المثال، عنوان URL مختلف للخادم).

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

يبني هذا لكلا الإصدارين Nest Gen 1 وNest Gen 2 داخل Docker. بعد ذلك، انسخ المخرجات إلى المثبّت:

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

3. بناء المثبّت أو تشغيله

cd firmware/installer
npm install

التشغيل المباشر (بدون الحاجة إلى بناء):

npm run electron:dev

أو بناء نسخة قابلة للتوزيع:

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

تكون المخرجات في firmware/installer/dist/. افتح التطبيق المبني واتبع الخطوات التي تظهر على الشاشة.

اعتبارات الأمان

توفر هذه الأداة وصولًا منخفض المستوى إلى عملية إقلاع الجهاز. استخدمها بمسؤولية:

استخدمها فقط على الأجهزة التي تملكها
البرنامج الثابت غير السليم قد يعطّل جهازك نهائيًا (لا تقاضِني يا أخي)

الشكر والتقدير

يستند هذا المشروع إلى العمل الممتاز الذي أنجزه العديد من باحثي ومطوّري الأمن:

grant-h / ajb142 - omap_loader، أداة محمّل الإقلاع عبر USB المستخدمة لوميض أجهزة OMAP
exploiteers (GTVHacker) - البحث والتطوير الأصليان لهجوم Nest DFU، الذي أظهر القدرة على وميض برنامج ثابت مخصص لأجهزة Nest من الجيلين 1 و2
FULU وجميع الداعمين للجوائز - لتمويل جائزة منظّم الحرارة Nest التعليمي من الجيلين 1 و2 ودعم حركة الحق في الإصلاح

لولا أبحاثهم الرائدة، ومساهماتهم مفتوحة المصدر، ومناصرتهم لحقوق ملكية الأجهزة، لما أمكن تحقيق هذا العمل. شكرًا لكم!

الالتزام بالمصدر المفتوح

نحن ملتزمون بالشفافية وبحركة الحق في الإصلاح. ستُتاح قريبًا صور البرنامج الثابت وكود خادم واجهة برمجة التطبيقات (API) الخلفي كمصدر مفتوح، مما يتيح للمجتمع تدقيقها وتحسينها واستضافة البنية التحتية الخاصة به.

NoLongerEvil-Thermostat

الأكثر شعبية