> ## Content Index
> Fetch the complete content index at: https://arabroot.io/llms.txt
> Use this file to discover other available public pages before exploring further.

# تحديث الأجهزة عن بعد OTA دون أن تتعطل
- URL: https://arabroot.io/articles/تحديث-الاجهزة-عن-بعد-ota-دون-ان-تتعطل/
- Published: 2026-11-06T01:47:31.000Z
- Updated: 2026-11-11T07:53:12.000Z
- Description: نرسل سبعة تحديثات إلى برنامج ESP32 حقيقي في محاكي QEMU، فنرى التوقيع ورفض الرجوع إلى نسخة أقدم والرجوع التلقائي يعمل، ونرى الخطأ الذي لا ينقذك منه إلا السلك.
- Author: فريق عرب رووت
- Tags: الأدلة التقنية, الإلكترونيات والطائرات المسيرة والطباعة ثلاثية الأبعاد, ESPHome

بعد شهرين من تشغيل أجهزة غرف التبريد اكتشف فريق الشركة الصغيرة خطأ في البرنامج الثابت Firmware: الجهاز يتوقف عن إرسال القراءات إذا انقطع Wi-Fi أكثر من ساعة، ولا يعود حتى يفصل أحدهم الكهرباء عنه ويعيدها. والإصلاح سطر واحد في الكود، والترجمة دقيقة، ولكن الأجهزة العشرة معلقة على جدران غرف التبريد، خلف الرفوف، في حرارة 4 درجات، وفك كل واحد منها ووصله بالحاسوب يعني يوم عمل كاملاً، وفتح أبواب الغرف مرات كثيرة. وهنا يأتي التحديث عن بعد Over-The-Air، واختصاراً OTA: ترسل البرنامج الجديد عبر الشبكة، ويكتبه الجهاز في ذاكرته، ويعيد التشغيل به. والفكرة بسيطة إلى حد يجعل الكثيرين ينسون أنها أخطر لحظة في حياة الجهاز، لأن الجهاز في هذه اللحظة يستبدل الشيء الوحيد الذي يجعله يعمل، وإذا فشل الاستبدال فلا يوجد أحد بجانبه ليعيده.

وفي هذا المقال سوف نبني التحديث الآمن خطوة خطوة على برنامج ESP32 حقيقي، يترجمه ESPHome بمحمل الإقلاع وجدول الأقسام والتوقيع كما يكتب على اللوحة، ويعمل في محاكي QEMU من Espressif ببطاقة شبكة محاكاة، وهي الطريقة نفسها التي تستخدمها فرق التطوير لاختبار البرنامج الثابت في أنظمة التكامل المستمر قبل أن يصل إلى العتاد. ثم نرسل إلى الجهاز سبعة تحديثات: تحديث صحيح، وكلمة مرور خاطئة، ونسخة أقدم، وصورة موقعة بمفتاح آخر، ونسخة تتعطل عند الإقلاع، ونسخة تحذف التحديث نفسه، ثم الاستعادة بالسلك. والمواضيع في السلسلة:

- [إنترنت الأشياء IoT من الحساس إلى لوحة المتابعة](https://arabroot.io/articles/%D8%A7%D9%86%D8%AA%D8%B1%D9%86%D8%AA-%D8%A7%D9%84%D8%A7%D8%B4%D9%8A%D8%A7%D8%A1-iot-%D9%85%D9%86-%D8%A7%D9%84%D8%AD%D8%B3%D8%A7%D8%B3-%D8%A7%D9%84%D9%89-%D9%84%D9%88%D8%AD%D8%A9-%D8%A7%D9%84%D9%85%D8%AA%D8%A7%D8%A8%D8%B9%D8%A9/).
- [بروتوكول MQTT مع Mosquitto](https://arabroot.io/articles/%D8%A8%D8%B1%D9%88%D8%AA%D9%88%D9%83%D9%88%D9%84-mqtt-%D9%85%D8%B9-mosquitto-%D9%83%D9%8A%D9%81-%D8%AA%D8%AA%D9%83%D9%84%D9%85-%D8%A7%D9%84%D8%A7%D8%AC%D9%87%D8%B2%D8%A9/).
- [Home Assistant مع ESPHome](https://arabroot.io/articles/home-assistant-%D9%85%D8%B9-esphome-%D8%A7%D8%AA%D9%85%D8%AA%D8%A9-%D8%A7%D9%84%D9%85%D8%B3%D8%AA%D9%88%D8%AF%D8%B9-%D8%B9%D9%84%D9%89-%D8%B3%D9%8A%D8%B1%D9%81%D8%B1%D9%83/).
- [لوحات المتابعة لإنترنت الأشياء مع Node-RED وGrafana](https://arabroot.io/articles/%D9%84%D9%88%D8%AD%D8%A7%D8%AA-%D8%A7%D9%84%D9%85%D8%AA%D8%A7%D8%A8%D8%B9%D8%A9-%D9%84%D8%A7%D9%86%D8%AA%D8%B1%D9%86%D8%AA-%D8%A7%D9%84%D8%A7%D8%B4%D9%8A%D8%A7%D8%A1-node-red-%D9%85%D8%B9-grafana/).
- تحديث الأجهزة عن بعد OTA دون أن تتعطل (الموضوع الحالي).
- [أمن إنترنت الأشياء: الأجهزة التي ينساها الجميع](https://arabroot.io/articles/%D8%A7%D9%85%D9%86-%D8%A7%D9%86%D8%AA%D8%B1%D9%86%D8%AA-%D8%A7%D9%84%D8%A7%D8%B4%D9%8A%D8%A7%D8%A1-iot-%D8%A7%D9%84%D8%A7%D8%AC%D9%87%D8%B2%D8%A9-%D8%A7%D9%84%D8%AA%D9%8A-%D9%8A%D9%86%D8%B3%D8%A7%D9%87%D8%A7-%D8%A7%D9%84%D8%AC%D9%85%D9%8A%D8%B9/).

وسوف نناقش في هذا المقال ما يلي:

- ما الذي يمكن أن يفشل في التحديث، وحادثة حقيقية أوقفت أجهزة Windows في المؤسسات بسبب تحديث محتوى واحد.
- التحديث بنسختين A/B: كيف يكتب البرنامج الجديد بجانب القديم، وحالات البرنامج في ESP-IDF.
- التوقيع Signing ورفض الرجوع إلى نسخة أقدم Downgrade Protection، ولماذا لا يكفي الاثنان دون الثالث، وهو الرجوع التلقائي Rollback.
- المختبر: برنامج ESP32 حقيقي في QEMU، ومشكلتان واجهتانا في المحاكاة وكيف حللناهما.
- سبع محاولات تحديث على الجهاز نفسه، بمخرجاتها كما هي.
- تجربة «ماذا يحدث إذا كان البرنامج الجديد يتعطل؟» وتجربة «ماذا يحدث إذا حذف البرنامج الجديد التحديث نفسه؟».
- تحديث أسطول الأجهزة على مراحل، والأخطاء الشائعة، وقائمة تحقق.

## لماذا التحديث Update هو أخطر لحظة؟

لنعدد ما يمكن أن يحدث خطأ أثناء التحديث، من الأبسط إلى الأخطر. أولاً قد تنقطع الكهرباء أو الشبكة في منتصف الكتابة، فيبقى في الذاكرة نصف برنامج. وثانياً قد تصل الصورة تالفة، بايت واحد تغير في الطريق. وثالثاً قد تصل صورة لم تكتبها أنت، من شخص وصل إلى الشبكة أو إلى خادم التحديثات. ورابعاً قد يرسل أحدهم عن قصد أو بالخطأ نسخة قديمة فيها ثغرة أغلقتها لاحقاً. وخامساً قد تكون الصورة سليمة وموقعة وجديدة، ولكن فيها خطأ برمجي يجعل الجهاز يتعطل عند الإقلاع. وسادساً، وهو الأخطر، قد تعمل الصورة الجديدة بشكل يبدو طبيعياً، ولكنها كسرت الطريق الذي تصل منه التحديثات نفسها، فلا تستطيع أن ترسل الإصلاح. وكل نوع من هذه يحتاج حماية مختلفة، وسوف نجربها كلها في المختبر.

وهذه ليست مخاطر نظرية تخص الأجهزة الصغيرة فقط. ففي 19 يوليو 2024 الساعة 04:09 بتوقيت UTC أرسلت شركة CrowdStrike تحديث محتوى لبرنامجها الأمني على Windows، وتقول [مراجعتها الأولية للحادثة](https://www.crowdstrike.com/en-us/blog/falcon-content-update-preliminary-post-incident-report/?ref=arabroot.io) إن خطأ في أداة التحقق من المحتوى سمح بمرور بيانات تسببت في قراءة خارج حدود الذاكرة، فتعطل Windows على كل جهاز متصل استقبل التحديث بين 04:09 و05:27، أي في 78 دقيقة فقط. ومن أهم ما التزمت به الشركة في المراجعة نفسها: نشر التحديثات على مراحل Staggered Deployment يبدأ بمجموعة صغيرة Canary، وإعطاء العملاء تحكماً في متى وأين تصلهم التحديثات. والدرس لنا مباشر: التحديث الذي يصل كل الأجهزة في الوقت نفسه يحول خطأ واحداً إلى عطل في كل مكان، والأجهزة التي لا يصل إليها أحد بسهولة هي أسوأ مكان لهذا العطل.

## التحديث بنسختين A/B: الجديد بجانب القديم

الحل البسيط للتحديث أن يمسح الجهاز برنامجه ويكتب الجديد مكانه، وهذه أسوأ الطرق على الإطلاق، لأن انقطاع الكهرباء بعد المسح وقبل اكتمال الكتابة يترك جهازاً بلا برنامج، لا يقلع ولا يقبل تحديثاً آخر. والحل الأنسب أن يكون في الذاكرة مكانان للبرنامج: يعمل الجهاز من أحدهما، ويكتب التحديث في الآخر، ثم يغير مؤشراً صغيراً يقول للمحمل Bootloader من أين يقلع في المرة القادمة. وهذا ما رأيناه في جدول الأقسام في [مقال Home Assistant مع ESPHome](https://arabroot.io/articles/home-assistant-%D9%85%D8%B9-esphome-%D8%A7%D8%AA%D9%85%D8%AA%D8%A9-%D8%A7%D9%84%D9%85%D8%B3%D8%AA%D9%88%D8%AF%D8%B9-%D8%B9%D9%84%D9%89-%D8%B3%D9%8A%D8%B1%D9%81%D8%B1%D9%83/)، والصورة التالية تبينه بالعناوين الحقيقية من المختبر:

![في الأعلى خريطة فلاش 4 MB: boot عند 0x1000 وotadata عند 0x9000 وapp0 ota_0 عند 0x10000 يعمل فيه 1.0.0 وapp1 ota_1 عند 0x1d0000 يكتب فيه 1.1.0 ثم nvs، وتحتها خمس خطوات: الكتابة في القسم الآخر والبرنامج القديم يعمل upload 21.6 s، ثم التحقق Verify بالتوقيع والإصدار، ثم تبديل otadata commit 3.3 s، ثم الإقلاع الأول تحت التجربة pending verify، ثم التأكيد بعد 30 ثانية أو الرجوع rollback، وفي الأسفل أن انقطاع الكهرباء قبل الخطوة 3 يبقي الجهاز على 1.0.0، وأن ثمن الطريقة نصف الفلاش تقريباً](https://arabroot.io/content/images/2026/11/ota-updates-01-ab-1.webp)

التحديث بنسختين: لا يمس البرنامج العامل حتى يكتمل الجديد ويتحقق منه

ولاحظ في الصورة أن انقطاع الكهرباء في أي لحظة قبل تبديل المؤشر لا يضر، فالجهاز يقلع من البرنامج القديم كأن شيئاً لم يحدث، ويعيد التحديث لاحقاً. ولكن الطريقة تحمي من النوع الأول والثاني فقط، أي الانقطاع والصورة التالفة، لأن الجهاز يتحقق من سلامة الصورة قبل التبديل، أما الأنواع الأخرى فتحتاج ثلاث آليات إضافية. والثمن واضح: نصف مساحة البرنامج محجوز لنسخة لا تعمل معظم الوقت، ففي جدول ESPHome لكل قسم 0x1C0000، أي 1.75 ميجابايت، والبرنامج نفسه في المختبر 393 كيلوبايت تقريباً، فالمساحة كافية بفارق كبير، ولكن في الأجهزة الأصغر قد يصبح هذا قراراً صعباً.

ويشرح [توثيق OTA في ESP-IDF](https://docs.espressif.com/projects/esp-idf/en/v5.5.6/esp32/api-reference/system/ota.html?ref=arabroot.io) ما يحدث بعد التبديل بحالات للبرنامج: البرنامج الجديد يبدأ بالحالة `ESP_OTA_IMG_NEW`، وعندما يختاره المحمل يصبح `ESP_OTA_IMG_PENDING_VERIFY`، أي تحت التجربة، ويجب أن يؤكد البرنامج نفسه أنه يعمل بالدالة `esp_ota_mark_app_valid_cancel_rollback` فيصبح `VALID`. أما إذا أعيد تشغيل الجهاز وهو ما زال تحت التجربة، فيقول التوثيق إن حالته تصبح `ESP_OTA_IMG_ABORTED`، ويرجع المحمل إلى البرنامج السابق، ولا يقلع البرنامج غير المؤكد مرة أخرى. وهذا هو الرجوع التلقائي Rollback، وهو الذي يحمي من النوع الخامس، البرنامج الذي يتعطل.

## التوقيع Signing: من يحق له أن يكتب البرنامج؟

الجهاز يقبل التحديث من أي أحد يعرف كلمة مرور OTA، وكلمة المرور موجودة في ملف الإعداد على حاسوب كل من عمل على المشروع، وربما في مستودع Git. والتوقيع الرقمي Digital Signature يغير السؤال من «هل تعرف كلمة المرور؟» إلى «هل هذه الصورة خرجت من مكان يملك المفتاح الخاص؟»: عند الترجمة توقع الصورة بمفتاح خاص Private Key لا يخرج من جهاز البناء، وفي البرنامج الذي على الجهاز المفتاح العام Public Key فقط، فيتحقق من التوقيع قبل أن يقبل التبديل. ولاحظ أن التوقيع لا يخفي محتوى الصورة، فهو ليس تشفيراً، وإنما يثبت مصدرها وأنها لم تتغير، وقد شرحنا الفرق بين التوقيع والتشفير والشهادات في [مقال الشهادات الرقمية](https://arabroot.io/articles/%D8%A7%D9%84%D8%B4%D9%87%D8%A7%D8%AF%D8%A7%D8%AA-%D8%A7%D9%84%D8%B1%D9%82%D9%85%D9%8A%D8%A9-tls-%D9%88-x509-%D9%88%D8%B5%D9%8A%D8%BA-pem-%D9%88-der/).

وفي ESPHome 2026 أصبح هذا خياراً في إعداد اللوحة نفسه، تصفه [صفحة منصة ESP32](https://esphome.io/components/esp32/?ref=arabroot.io) تحت الاسم `signed_ota_verification`: تضع مسار المفتاح الخاص، فيوقع ESPHome الصورة بأداة `espsecure` عند الترجمة، ويرفض الجهاز أي تحديث غير موقع بمفتاح يثق به. وفي الصفحة نفسها ثلاث ملاحظات يجب أن تعرفها قبل أن تفعله على أجهزة حقيقية:

- **الصورة الأولى يجب أن تكون موقعة:** فالجهاز يأخذ المفتاح العام الموثوق من البرنامج الذي يعمل عليه، فإذا كان البرنامج الأول بلا توقيع فلا يوجد ما يتحقق به لاحقاً.
- **فقدان المفتاح الخاص يعني لا تحديث:** تقول الصفحة إنك إذا فقدت المفتاح فلن تستطيع تحديث الأجهزة الموقعة به عبر الشبكة، وتحتاج إعادة الكتابة عبر المنفذ التسلسلي، أي أن تعود إلى فك الأجهزة من الجدران. فالمفتاح الخاص أهم ملف في المشروع، مكانه نسختان في مدير أسرار، وليس مجلد المشروع.
- **الخوارزمية تعتمد على الشريحة:** الخيار الافتراضي `rsa3072` يحتاج شريحة ESP32 من الإصدار 3.0 أو أحدث، و`ecdsa_v1` للشرائح الأقدم، وفي المختبر قالت الشريحة المحاكاة إنها `chip revision: v0.0`، فاخترنا `ecdsa_v1`.

وفي شركة صغيرة السؤال العملي هو: أين يعيش المفتاح الخاص، ومن يوقع؟ والطريقة البسيطة أن يوقع المطور على حاسوبه، وهذه أضعف الطرق، لأن المفتاح ينتقل مع الحاسوب وينسخ مع النسخ الاحتياطية، ويخرج مع أول موظف يترك الشركة. والطريقة الأنسب أن يكون التوقيع خطوة في خط البناء، على جهاز واحد مخصص لهذا، والمفتاح يأتيه من مدير الأسرار وقت البناء فقط، وكل صورة موقعة تسجل مع من طلبها ومن أي كود بنيت. وبهذا الشكل إذا تسربت كلمة مرور OTA، أو حاسوب مطور، تبقى الأجهزة ترفض أي صورة لم تمر بخط البناء، وهذا بالضبط ما رأيته في المحاولة الرابعة.

## رفض الرجوع Downgrade Protection: لماذا تمنع النسخة الأقدم؟

قد يبدو غريباً أن تمنع الجهاز من قبول نسخة قديمة موقعة بمفتاحك أنت، ولكن تخيل أنك أصلحت في الإصدار 1.1.0 ثغرة تسمح لأي أحد على الشبكة بتشغيل المرحل، ثم وصل مخترق إلى شبكة الأجهزة ومعه صورة الإصدار 1.0.0، وهي موقعة بمفتاحك لأنك أنت من أصدرها. دون حماية الرجوع يستطيع أن يعيد الجهاز إلى النسخة الضعيفة ثم يستغل الثغرة، والتوقيع لن يمنعه. ولذلك تشرح صفحة ESP32 في ESPHome الخيار `enable_ota_downgrade_protection`: يقرأ الجهاز رقم الإصدار من الحقل `project.version` داخل الصورة الموقعة، ويرفض الأقدم من الإصدار الذي يعمل. ولاحظ شرطين في الصفحة: الحماية تحتاج التوقيع، لأن التوقيع هو الذي يمنع صورة معدلة من أن تدعي إصداراً أعلى، وهي تخص التحديث عبر الشبكة فقط، أما الكتابة عبر المنفذ التسلسلي فلا تفحص الإصدار أبداً، حتى تبقى طريق الاستعادة مفتوحة.

## الرجوع التلقائي Rollback: ماذا يعني أن البرنامج «يعمل»؟

الرجوع يعتمد على سؤال واحد: متى يؤكد البرنامج الجديد أنه يعمل؟ وفي ESPHome الإجابة في المكون `safe_mode`، وتقول [صفحته](https://esphome.io/components/safe%5Fmode/?ref=arabroot.io) إن الإقلاع يعتبر ناجحاً بعد مدة `boot_is_good_after`، وقيمتها الافتراضية دقيقة واحدة، وتقول صفحة ESP32 إن الخيار `enable_ota_rollback` قيمته الافتراضية true، وإن البرنامج يعتبر صالحاً بعد هذه المدة، وإن المحمل يرجع إلى البرنامج السابق إذا تعطل الجهاز أو أعيد تشغيله قبل ذلك. وتذكر الصفحة أيضاً أن الرجوع يحتاج محملاً بني بدعمه، وأن التحديث عبر الشبكة لا يحدث المحمل، فالأجهزة القديمة قد تحتاج كتابة واحدة عبر المنفذ التسلسلي حتى تحصل عليه.

وفي المختبر جعلنا المدة 30 ثانية حتى تكون التجربة أسرع. ولكن فكر في معنى «يعمل» هنا: البرنامج الذي يعمل 30 ثانية دون أن يتعطل يعتبر صالحاً، حتى لو كان لا يرسل أي قراءة، أو لا يتصل بالشبكة، أو حذف المكون الذي يستقبل التحديثات. والتعريف الأفضل لكثير من الأجهزة أن يؤكد البرنامج نفسه فقط بعد أن يتصل بالشبكة ويصل إلى الخادم الذي يرسل له التحديثات، وتسمح صفحة `safe_mode` بذلك بالفعل `safe_mode.mark_successful` الذي تستدعيه من أتمتة عند نجاح الاتصال. وسوف نرى في التجربة السادسة لماذا هذا الفرق مهم.

## المختبر Lab: برنامج ESP32 حقيقي في QEMU

المحاكي QEMU برنامج مفتوح يحاكي معالجات وأجهزة كاملة، وشركة Espressif تطور نسخة منه فيها جهاز ESP32 كامل بالذاكرة والفلاش ومحمل الإقلاع الأصلي، وبطاقة شبكة محاكاة اسمها `open_eth`، ويشرح [دليل QEMU في ESP-IDF](https://docs.espressif.com/projects/esp-idf/en/stable/esp32/api-guides/tools/qemu.html?ref=arabroot.io) استخدامه لتشغيل التطبيقات واختبارها دون عتاد. وفي ESPHome نوع شبكة سلكية اسمه `OPENETH`، تقول [صفحة Ethernet](https://esphome.io/components/ethernet/?ref=arabroot.io) إنه لـ QEMU ولشريحة ESP32 فقط. أي أن البرنامج الذي سوف نشغله هو نفسه الذي يكتب على اللوحة، بفرق واحد: بطاقة الشبكة بدل Wi-Fi. والصورة التالية تبين المختبر:

![داخل إطار iot-ota-net: على اليمين Container لـ ESPHome 2026.10.2 للبناء والرفع فيه coldroom-qemu.yaml وESP-IDF 5.5.6 وتوقيع ecdsa_v1، والمفتاح الخاص يبقى هنا ولا يصل إلى الجهاز، وسهم OTA على المنفذ 3232 مع كلمة المرور ثم الصورة، وعلى اليسار iot-ota-dev فيه QEMU 9.2.2 بجهاز esp32 وبطاقة open_eth وflash.bin بحجم 4 MB في Volume وسكربت run-qemu.sh يعيد التشغيل كأنه قطع للكهرباء](https://arabroot.io/content/images/2026/11/ota-updates-02-lab-1.webp)

المختبر: ESPHome يبني ويوقع ويرسل، وQEMU يشغل البرنامج نفسه بمحمل الإقلاع وجدول الأقسام

المحاكي في Image صغير فوق Python، ينزل النسخة الجاهزة من [إصدار Espressif](https://github.com/espressif/qemu/releases/tag/esp-develop-9.2.2-20260417?ref=arabroot.io) مع esptool:

```dockerfile
# Espressif's QEMU fork (ESP32 machine with an open_eth network card), prebuilt release
FROM python:3.13.18-slim
RUN apt-get update && apt-get install -y --no-install-recommends libglib2.0-0 libpixman-1-0 libslirp0 libsdl2-2.0-0 libgcrypt20 curl xz-utils ca-certificates \
 && rm -rf /var/lib/apt/lists/*
RUN curl -sL https://github.com/espressif/qemu/releases/download/esp-develop-9.2.2-20260417/qemu-xtensa-softmmu-esp_develop_9.2.2_20260417-x86_64-linux-gnu.tar.xz \
  | tar -xJ -C /opt && ln -s /opt/qemu/bin/qemu-system-xtensa /usr/local/bin/
RUN pip install --no-cache-dir esptool==5.1.0 2>/dev/null || pip install --no-cache-dir esptool
WORKDIR /w
```

```text
QEMU emulator version 9.2.2 (esp_develop_9.2.2_20260417)
5.1.0
```

ثم ملف الجهاز `coldroom-qemu.yaml`، ورقم الإصدار والخطأ المتعمد فيه بديلان Substitutions نغيرهما من سطر الأوامر:

```yaml
# Cold room node built for a real ESP32, running in Espressif's QEMU with the emulated open_eth network card.
# Version and the deliberate crash are substitutions: esphome -s version 1.1.0 -s crash true compile coldroom-qemu.yaml
substitutions:
  version: "1.0.0"
  crash: "false"

esphome:
  name: coldroom-ota
  friendly_name: Cold room OTA test
  project:
    name: "coldstore.coldroom"
    version: "${version}"
  on_boot:
    priority: 600
    then:
      - lambda: |-
          ESP_LOGI("fw", "firmware ${version} booting");
          if (${crash}) { ESP_LOGE("fw", "simulated bug in ${version}: crash during setup"); abort(); }

esp32:
  board: esp32dev
  framework:
    type: esp-idf
    advanced:
      enable_ota_rollback: true                 # default true: bootloader returns to the old app if the new one never confirms
      enable_ota_downgrade_protection: true     # refuse an OTA image with an older project version
      signed_ota_verification:
        signing_key: ota_signing_key.pem        # images are signed at build time; unsigned or foreign-key images are refused
        signing_scheme: ecdsa_v1
    sdkconfig_options:
      CONFIG_ESP_TASK_WDT_TIMEOUT_S: "60"         # flash erase/write is slow under emulation; the 5 s default watchdog fired during OTA

ethernet:
  type: OPENETH

logger:
  level: INFO

ota:
  - platform: esphome
    password: !secret ota_password

safe_mode:
  boot_is_good_after: 30s

text_sensor:
  - platform: template
    name: "Firmware version"
    lambda: return {"${version}"};
    update_interval: 60s
```

وقبل الترجمة أنشأنا مفتاحين بأداة `espsecure` من الـ Image الخاص بـ ESPHome: مفتاحنا، ومفتاحاً ثانياً يمثل مخترقاً عنده صورة يريد أن يزرعها:

```bash
espsecure generate-signing-key --version 1 ota_signing_key.pem
espsecure generate-signing-key --version 1 attacker_key.pem
```

```text
espsecure v5.4.0
ECDSA NIST256p private key in PEM format written to "ota_signing_key.pem".
espsecure v5.4.0
ECDSA NIST256p private key in PEM format written to "attacker_key.pem".
```

ثم الترجمة بالأمر نفسه الذي استخدمناه في مقال ESPHome، مع Volume دائم لأدوات ESP-IDF، والمخرج المهم:

```text
INFO Signed OTA verification is enabled. Keep your signing key safe! If you lose the signing key, you will NOT be able to OTA update devices running firmware signed with this key. Without the key, you'll need to reflash via serial.
Signed 3072 bytes of data from /config/.esphome/build/coldroom-ota/build/partition_table/partition-table-unsigned.bin
/config/ota_signing_key.pem public key extracted to /config/.esphome/build/coldroom-ota/build/signature_verification_key.bin
Signed 393136 bytes of data from /config/.esphome/build/coldroom-ota/build/coldroom-ota-unsigned.bin
RAM:   [=         ]  13.8% (used 24988 bytes from 180736 bytes)
Flash: [==        ]  19.1% (used 350635 bytes from 1835008 bytes)
INFO Created: /config/.esphome/build/coldroom-ota/build/firmware.factory.bin
INFO Created: /config/.esphome/build/coldroom-ota/build/firmware.ota.bin
INFO Successfully compiled program.
```

وفي المخرج لاحظ التالي:

- ESPHome يذكرك بخطر فقدان المفتاح في كل ترجمة، وهذا التحذير في مكانه.
- التوقيع وقع على جدول الأقسام نفسه أيضاً، وليس على البرنامج فقط، والمفتاح العام استخرج إلى `signature_verification_key.bin` ودخل في الصورة، أما المفتاح الخاص فبقي في المجلد على جهاز البناء.
- البرنامج الموقع أكبر من غير الموقع بـ 68 بايت، من 393136 إلى 393204، وهذه مساحة التوقيع.
- هذا البرنامج أصغر من برنامج المقال السابق، 13.8% من الذاكرة مقابل 24.8%، لأنه بلا Wi-Fi ولا واجهة برمجية لـ Home Assistant.

والملف `firmware.factory.bin` هو ما يكتب عبر المنفذ التسلسلي أول مرة، ويبدأ من العنوان 0 وفيه المحمل عند 0x1000، فأكملناه بالقيمة 0xFF حتى 4 ميجابايت ليصبح صورة فلاش كاملة `flash.bin`، ثم شغلنا المحاكي:

```bash
qemu-system-xtensa -nographic -no-reboot -machine esp32 -m 4M -drive file=/f/flash.bin,if=mtd,format=raw \
  -nic user,model=open_eth,hostfwd=tcp::3232-:3232
```

```text
rst:0x1 (POWERON_RESET),boot:0x12 (SPI_FAST_FLASH_BOOT)
I (749) boot: ESP-IDF v5.5.6 2nd stage bootloader
I (864) boot: chip revision: v0.0
I (908) boot: Partition Table:
I (908) boot: ## Label            Usage          Type ST Offset   Length
I (908) boot:  0 otadata          OTA data         01 00 00009000 00002000
I (909) boot:  1 phy_init         RF data          01 01 0000b000 00001000
I (909) boot:  2 app0             OTA app          00 10 00010000 001c0000
I (910) boot:  3 app1             OTA app          00 11 001d0000 001c0000
I (910) boot:  4 nvs              WiFi data        01 02 00390000 00070000
I (950) boot: No factory image, trying OTA 0
I (1664) boot: Loaded app from partition at offset 0x10000
I (1666) boot: Set actual ota_seq=1 in otadata[0]
[I][fw:017]: firmware 1.0.0 booting
[E][esp32:113]: Failed to read a valid MAC address from eFuse
[I][app:166]: Project coldstore.coldroom version 1.0.0
[I][ethernet:145]: Connected
[I][safe_mode:154]: Boot seems successful; resetting boot loop counter
```

وفي سجل الإقلاع لاحظ التالي:

- هذا محمل ESP-IDF 5.5.6 الحقيقي، وهو يقرأ جدول الأقسام كما وصفناه: `app0` عند 0x10000 و`app1` عند 0x1d0000، و`otadata` فارغ في البداية، فيقول `No factory image, trying OTA 0` ويكتب في `otadata` أن التسلسل الحالي 1.
- `Failed to read a valid MAC address from eFuse` سببه أن ذاكرة eFuse في المحاكي فارغة، وهي على اللوحة الحقيقية تحمل عنوان MAC من المصنع، فهذا السطر لا يظهر على العتاد.
- بعد 30 ثانية قال `safe_mode` إن الإقلاع ناجح، أي أن البرنامج الأول أصبح مؤكداً.

وقد يتساءل البعض: هل يكفي المحاكي لنثق بالنتائج؟ والإجابة أن ما نختبره هنا هو منطق التحديث نفسه، أي المحمل وجدول الأقسام والتوقيع وحالات البرنامج، وكلها كود يعمل كما هو على الشريحة، أما توقيت الإرسال وسلوك Wi-Fi واستهلاك الكهرباء فتختبرها على اللوحة قبل النشر، وهذا بالضبط الترتيب الذي نقترحه في قسم النشر على مراحل.

### مشكلتان واجهتانا في المحاكاة Emulation Problems

في المحاولة الأولى للتحديث، قبل سطر `sdkconfig_options` في الملف، بدأ الإرسال ثم ظهر في سجل الجهاز:

```text
[W][component:290]: esphome.ota set Warning flag: unspecified
E (130227) task_wdt: Task watchdog got triggered. The following tasks/users did not reset the watchdog in time:
E (130227) task_wdt:  - loopTask (CPU 1)
E (130227) task_wdt: Aborting.
```

ومؤقت المراقبة Watchdog مؤقت في الشريحة يعيد تشغيلها إذا توقفت مهمة عن الاستجابة مدة معينة، والقيمة الافتراضية في ESP-IDF خمس ثوان. ومسح الفلاش وكتابته في المحاكي أبطأ بكثير منه على الشريحة، فطالت عملية واحدة أكثر من خمس ثوان، فظن المؤقت أن البرنامج علق. والحل في المختبر رفع المدة إلى 60 ثانية بالخيار `CONFIG_ESP_TASK_WDT_TIMEOUT_S`، أما على اللوحة فاترك القيمة الافتراضية، فهي جزء من حماية الجهاز من التعليق. ولاحظ أن هذا العطل نفسه أثناء التحديث لم يضر شيئاً، فالجهاز أعيد تشغيله على البرنامج القديم، لأن المؤشر في `otadata` لم يتغير بعد، وهذا بالضبط ما وعدت به طريقة A/B.

والمشكلة الثانية ظهرت بعد إعادة التشغيل التي سببها المؤقت، فقد دخل الجهاز في حلقة:

```text
rst:0xc (SW_CPU_RESET),boot:0x12 (SPI_FAST_FLASH_BOOT)
I (10497) boot: Loaded app from partition at offset 0x10000
Guru Meditation Error: Core  0 panic'ed (InstrFetchProhibited). Exception was unhandled.
rst:0xc (SW_CPU_RESET),boot:0x12 (SPI_FAST_FLASH_BOOT)
```

وعددنا 72 إعادة تشغيل في السجل، كلها بالسبب `SW_CPU_RESET` وكلها تنتهي بالخطأ نفسه، مع أن البرنامج نفسه أقلع بلا مشكلة عند التشغيل الأول بالسبب `POWERON_RESET`. أي أن المشكلة في إعادة التشغيل البرمجية داخل هذه النسخة من المحاكي، وليست في البرنامج. والحل أن نجعل كل إعادة تشغيل تشبه قطع الكهرباء: الخيار `-no-reboot` يجعل QEMU ينتهي عند أي إعادة تشغيل، وسكربت صغير يشغله من جديد بالملف نفسه:

```bash
#!/bin/sh
# Runs the emulated ESP32. Every reset (OTA reboot, crash, watchdog) ends QEMU (-no-reboot) and the loop starts it
# again from the same flash file, like a power cycle: Espressif's QEMU did not boot cleanly after a software reset.
n=0
while true; do
  n=$((n+1)); echo "=== power on #$n $(date -u +%T)"
  qemu-system-xtensa -nographic -no-reboot -machine esp32 -m 4M -drive file=/f/flash.bin,if=mtd,format=raw \
    -nic user,model=open_eth,hostfwd=tcp::3232-:3232
  sleep 1
done
```

وهذا التعديل لا يغير ما نختبره، فالمحمل في الشريحة الحقيقية يقرأ `otadata` وحالة البرنامج من الفلاش في كل إقلاع، سواء كان بعد قطع الكهرباء أو بعد إعادة تشغيل برمجية، والفلاش هنا ملف يبقى كما هو بين التشغيلات. وكل سطر `power on` في السجلات التالية هو إقلاع جديد.

## سبع محاولات تحديث OTA Attempts

### الأولى: تحديث صحيح Successful Update إلى 1.1.0

```bash
esphome -s version 1.1.0 compile coldroom-qemu.yaml
esphome -s version 1.1.0 upload coldroom-qemu.yaml --device iot-ota-dev
```

```text
INFO Connecting to 172.18.0.2 port 3232...
INFO Uploading /config/.esphome/build/coldroom-ota/build/coldroom-ota.bin (393204 bytes)
INFO Connection established; device supports OTA version 2
INFO Compressed to 231752 bytes (deflate)
INFO Handshake complete
INFO Upload took 21.63 seconds, waiting for result...
INFO Update took 25.03 seconds (prepare 0.12, upload 21.63, commit 3.27)
INFO OTA successful
```

وسجل الجهاز:

```text
[I][esphome.ota:612]: Update complete
=== power on #2 01:58:38
I (2097) boot: Loaded app from partition at offset 0x1d0000
[I][fw:017]: firmware 1.1.0 booting
[I][app:166]: Project coldstore.coldroom version 1.1.0
[I][safe_mode:154]: Boot seems successful; resetting boot loop counter
```

الصورة ضغطت من 393 إلى 232 كيلوبايت قبل الإرسال، والإرسال استغرق 21.6 ثانية في المحاكي، وهو أسرع على اللوحة الحقيقية، ثم 3.3 ثانية للتحقق والتبديل. وبعد إعادة التشغيل أقلع الجهاز من `0x1d0000`، أي من القسم الثاني، بالإصدار الجديد، وأكد نفسه بعد 30 ثانية، وبقي الإصدار 1.0.0 في القسم الأول كما هو.

### الثانية: كلمة مرور خاطئة Wrong Password

```text
INFO Compressed to 231752 bytes (deflate)
ERROR receiving auth result: Authentication invalid. Is the password correct?
WARNING Failed to upload to ['iot-ota-dev']

[W][esphome.ota:917]: Auth: Password mismatch
```

رفض الجهاز في المصافحة، قبل أن يكتب أي بايت في الفلاش، وهذه أول بوابة وأضعفها، لأن كلمة المرور يعرفها كل من عنده ملف الإعداد.

### الثالثة: الرجوع إلى 1.0.0 Downgrade

```text
INFO Upload took 20.38 seconds, waiting for result...
ERROR receiving update end result: The device rejected the update because it has OTA downgrade protection enabled: the new firmware's version must be newer than the version the device is currently running.

[E][ota:238]: Rejecting downgrade: image version '1.0.0' is older than running version '1.1.0'
[W][esphome.ota:597]: End update err 147
```

الصورة موقعة بمفتاحنا الصحيح، ومع ذلك رفضها الجهاز لأن إصدارها أقدم. ولاحظ متى رفضها: بعد أن استقبلها كاملة في 20 ثانية، لأن الإصدار يقرأ من داخل الصورة الموقعة، والتحقق يكون بعد اكتمال الصورة. أي أن الجهاز في الحالات المرفوضة يكتب الصورة في القسم الآخر ثم لا يبدل المؤشر، فالبرنامج العامل لم يمس.

### الرابعة: صورة موقعة بمفتاح آخر Foreign Key

ترجمنا الإصدار 9.9.9، أي «أحدث» من أي شيء، ولكن بالمفتاح الثاني الذي يمثل المخترق:

```text
INFO Upload took 20.83 seconds, waiting for result...
ERROR receiving update end result: Firmware signature verification failed. The firmware was not signed with the correct key. Ensure the signing key matches the one used to build the firmware currently running on the device.

[I][esp-idf:000]: E (214596) esp_ota_ops: New image failed verification
[E][ota:208]: esp_ota_end failed (err=0x1503)
[E][ota:250]: OTA validation failed (err=0x1503) - possible signature verification failure
```

رفض الجهاز الصورة لأن توقيعها لا يطابق المفتاح العام الذي يحمله، ورقم الإصدار الكبير لم ينفع، وهذا ما قصدناه بأن التوقيع يمنع صورة غريبة من أن تدعي إصداراً أعلى. والخطأ جاء من ESP-IDF نفسه `esp_ota_ops: New image failed verification`، أي أن التحقق في مكتبة الشريحة وليس في كود ESPHome فقط. ولاحظ أن كلمة المرور في هذه المحاولة كانت صحيحة، وهذا مقصود: افترضنا أن المخترق يعرفها، لأنها في ملف الإعداد، ومع ذلك لم يستطع.

## ماذا يحدث إذا كان البرنامج الجديد يتعطل؟ What If

المحاولة الخامسة هي التي يخافها الجميع: صورة صحيحة وموقعة بمفتاحنا وإصدارها أحدث 1.2.0، ولكن فيها خطأ برمجي يجعلها تتعطل في أول ثانية، وهنا بالمتغير `crash: true` الذي يستدعي `abort()` أثناء الإقلاع:

```bash
esphome -s version 1.2.0 -s crash true compile coldroom-qemu.yaml
esphome -s version 1.2.0 -s crash true upload coldroom-qemu.yaml --device iot-ota-dev
```

```text
INFO Update took 25.65 seconds (prepare 0.14, upload 21.96, commit 3.55)
INFO OTA successful
```

والأداة تقول «OTA successful»، وهي صادقة من جهتها، فالصورة وصلت وتحقق منها الجهاز وبدل المؤشر. أما ما حدث بعد ذلك فهذا سجل الجهاز:

```text
=== power on #3 02:03:42
I (1766) boot: Loaded app from partition at offset 0x10000
[I][fw:017]: firmware 1.2.0 booting
[E][fw:018]: simulated bug in 1.2.0: crash during setup
abort() was called at PC 0x400db6cf on core 1
=== power on #4 02:04:03
I (2095) boot: Loaded app from partition at offset 0x1d0000
[I][fw:017]: firmware 1.1.0 booting
[I][app:166]: Project coldstore.coldroom version 1.1.0
[W][safe_mode:094]: OTA rollback detected! Rolled back from partition 'app0'
[I][safe_mode:154]: Boot seems successful; resetting boot loop counter
```

ولنقرأ القصة: الصورة الجديدة كتبت في القسم الأول `app0` عند 0x10000، لأن الإصدار 1.1.0 كان يعمل من الثاني، وأقلع الجهاز منها، فتعطل في أقل من ثانية قبل أن يؤكد نفسه. وعند الإقلاع التالي وجد المحمل أن البرنامج في `app0` ما زال تحت التجربة، فاعتبره فاشلاً وأقلع من `app1`، أي الإصدار 1.1.0، وكتب ESPHome في السجل صراحة `OTA rollback detected! Rolled back from partition 'app0'`. ومن الإقلاع الفاشل إلى عودة الجهاز إلى العمل مرت 21 ثانية في المحاكي.

وهنا ملاحظتان مهمتان. الأولى أن الأداة قالت «OTA successful» والجهاز رجع، فإذا كان نظام التحديث عندك يعتمد على رد الأداة وحده فسوف يسجل أن الجهاز على 1.2.0 وهو في الحقيقة على 1.1.0، ولذلك تحقق دائماً من الإصدار الذي يعلنه الجهاز بعد التحديث، وهذا سبب وجود الكيان `Firmware version` في الملف. والثانية أن الرجوع أنقذ الجهاز، ولكنه لا يصلح الخطأ، فالإصدار 1.2.0 ما زال خاطئاً، وإذا أرسلته إلى عشرة أجهزة فسوف ترجع العشرة، وهذا أفضل بكثير من عشرة أجهزة متوقفة، ولكنه يعني أنك تحتاج أن تلاحظ الرجوع وتوقف النشر.

![سبع بطاقات على خط من اليمين: 1.1.0 نجح من 0x10000 إلى 0x1d0000 في 25 ثانية، ثم كلمة مرور رفض قبل أي كتابة Password mismatch، ثم 1.0.0 رفض الرجوع بعد إرسال الصورة كاملة Rejecting downgrade، ثم 9.9.9 بمفتاح آخر التوقيع لا يطابق failed verification، ثم 1.2.0 تعطل ثم رجع abort في setup ثم 1.1.0 من 0x1d0000 OTA rollback detected، ثم 1.3.0 نجح ولكن بلا مكون ota وأكد نفسه بعد 30 ثانية Connection reset لا تحديث بعده، ثم 1.4.0 عبر السلك بإعادة كتابة الفلاش firmware 1.4.0 booting](https://arabroot.io/content/images/2026/11/ota-updates-03-timeline-1.webp)

المحاولات السبع على الجهاز نفسه، وما فعله الجهاز في كل منها

## ماذا يحدث إذا حذف البرنامج الجديد التحديث نفسه؟ OTA Lockout

المحاولة السادسة هي النوع السادس في قائمتنا: برنامج لا يتعطل، ولكنه كسر الطريق الذي تصل منه التحديثات. وأبسط مثال واقعي أن يحذف أحدهم كتلة `ota:` من الملف بالخطأ أثناء تنظيف الإعداد، فنسخنا الملف بلا هذه الكتلة باسم `coldroom-qemu-noota.yaml` وترجمناه بالإصدار 1.3.0\. وهنا أول خبر جيد، فقد نبهت الترجمة إلى المشكلة:

```text
WARNING Signed OTA verification is enabled but no OTA component is configured. The initial firmware will be signed but OTA updates won't be possible until an OTA component is added.
```

والخبر الجيد الثاني أن أداة الرفع نفسها رفضت أن ترسله بهذا الملف:

```text
ERROR Cannot upload Over the Air as the ota configuration is not present or does not include platform: esphome or platform: web_server
```

ولكن هذا الحاجز في الأداة وليس في الجهاز، ففي الواقع قد تبنى الصورة في نظام ويرسلها نظام آخر لا يعرف ملف الإعداد، فأرسلناها عن قصد بالملف القديم الذي فيه `ota:`، كما قد يحدث في خط نشر يرسل آخر صورة بنيت:

```text
INFO Update took 22.54 seconds (prepare 0.15, upload 19.32, commit 3.07)
INFO OTA successful

=== power on #5 02:06:51
I (1748) boot: Loaded app from partition at offset 0x10000
[I][fw:017]: firmware 1.3.0 booting
[I][app:166]: Project coldstore.coldroom version 1.3.0
[I][safe_mode:154]: Boot seems successful; resetting boot loop counter
```

أقلع الجهاز بالإصدار 1.3.0، ولم يتعطل، وبعد 30 ثانية أكد نفسه، فأصبح البرنامج الصالح الوحيد في نظر المحمل. ثم حاولنا إرسال الإصلاح 1.4.0:

```text
INFO Uploading /config/.esphome/build/coldroom-ota/build/coldroom-ota.bin (393204 bytes)
WARNING receiving version response: [Errno 104] Connection reset by peer
ERROR Upload failed after 3 attempts: receiving version response: [Errno 104] Connection reset by peer
WARNING Failed to upload to ['iot-ota-dev']
```

لا يوجد في الجهاز من يستقبل التحديث، والرجوع لن ينقذنا لأن البرنامج «يعمل» بتعريف `safe_mode`، فهو لم يتعطل خلال 30 ثانية. والطريق الوحيد الباقي هو السلك: تفك الجهاز من الجدار، وتصله بمحول USB إلى المنفذ التسلسلي UART مثل الذي في الصورة التالية، وتكتب البرنامج الصحيح عبر `esptool`:

![لوحة إلكترونية صغيرة بنية على قاعدة، عليها منفذ USB وشريحة تحويل خضراء ومفتاح لاختيار الجهد، وأطراف خضراء للتوصيل، وبطاقة تحتها مكتوب عليها أسماء الأطراف RXD وTXD وDSR وRI وDCD وDTR وCTS وRTS وVCC وGND](https://arabroot.io/content/images/2026/11/ota-updates-06-usb-serial-1.webp)

محول من USB إلى المنفذ التسلسلي TTL، وهو طريق الاستعادة الأخير لأي جهاز. الصورة: Dilshan Jayakody، رخصة CC BY-SA 2.0، المصدر: [Wikimedia Commons](https://commons.wikimedia.org/wiki/File:USB%5Fto%5F3.3V%5F5V%5Fserial%5FTTL%5Fadapter%5F%2820166029421%29.jpg?ref=arabroot.io) (تم تحويلها إلى WebP).

وفي المختبر كان المقابل لذلك أن نوقف المحاكي ونكتب ملف الفلاش من جديد بصورة `factory.bin` للإصدار 1.4.0، كما يفعل `esptool` عبر السلك:

```text
reflashed 4194304
=== power on #1 02:09:04
I (2573) boot: Loaded app from partition at offset 0x10000
[I][fw:017]: firmware 1.4.0 booting
[I][app:166]: Project coldstore.coldroom version 1.4.0
```

وعاد الجهاز، ولكن تذكر أمرين: الكتابة عبر السلك تمسح الفلاش كله بما فيه قسم `nvs`، أي الإعدادات والحالات المحفوظة، وحماية الرجوع لا تطبق عليها، فهي تقبل أي إصدار، وهذا مقصود في التصميم حتى تبقى طريق الاستعادة مفتوحة دائماً. ومع جهاز واحد هذه نصف ساعة، ومع أسطول كامل هذه أيام. والدرس من هذه التجربة أوضح من أي قاعدة: الجهاز يجب ألا يعتبر نفسه سليماً لمجرد أنه لم يتعطل، وإنما بعد أن يثبت أنه يستطيع استقبال التحديث القادم، أي بعد أن يتصل بالشبكة وبالخادم، ولذلك اجعل `safe_mode.mark_successful` بعد نجاح الاتصال، واجعل فحص وجود كتلة `ota:` في خط البناء نفسه، قبل أن تخرج الصورة.

## ماذا يحدث إذا انقطعت الكهرباء أثناء الكتابة؟ Power Loss

رأينا انقطاعاً من هذا النوع دون أن نقصده، عندما أعاد مؤقت المراقبة تشغيل الجهاز في منتصف الإرسال، فلنفهم لماذا لم يضر. ترتيب الخطوات في التحديث هو كل شيء: الجهاز يكتب الصورة الجديدة في القسم الذي لا يعمل منه، وهذا القسم لا يعني المحمل في شيء ما دام المؤشر لا يشير إليه، ثم يتحقق من الصورة كاملة، ثم يكتب المؤشر في قسم `otadata`. وهذا القسم في جدول ESPHome حجمه 0x2000، أي قطاعان من الفلاش، وفي سجل الإقلاع الأول رأيت السطر `Set actual ota_seq=1 in otadata[0]`، أي أن المحمل يكتب رقم تسلسل في نسخة من نسختين، ويختار عند الإقلاع النسخة السليمة ذات الرقم الأعلى. فإذا انقطعت الكهرباء أثناء كتابة الصورة يبقى المؤشر على القديم، وإذا انقطعت أثناء كتابة المؤشر نفسه تبقى النسخة الأخرى سليمة، فلا توجد لحظة في الطريقة كلها يكون فيها الجهاز بلا برنامج يقلع منه.

وقد يتساءل البعض: إذا كانت الطريقة آمنة بهذا الشكل، فلماذا نهتم بالكهرباء أصلاً؟ والإجابة أن هناك أشياء خارج هذا الترتيب. فالكتابة عبر المنفذ التسلسلي لا تمر به، وهي تمسح المحمل نفسه وتكتبه، فانقطاع في منتصفها يحتاج إعادتها، ولكنك تكون أمام الجهاز عندها. والإعدادات في قسم `nvs` تكتب بطريقة خاصة بها، وتقول صفحة التفضيلات في ESPHome إنها تكتب مرة كل دقيقة بالقيمة الافتراضية، كما رأينا في مقال Home Assistant. أما الخطر الحقيقي للكهرباء فهو في الأجهزة التي تعمل على بطارية: التحديث يحتاج أن يبقى الراديو شغالاً عشرات الثواني، والبطارية الضعيفة قد تنطفئ في كل محاولة فتعيدها كل مرة، ولذلك تفحص الأجهزة الجيدة مستوى البطارية قبل أن تقبل التحديث، وتؤجله إذا كان منخفضاً.

## من يبدأ التحديث؟ الدفع Push أم السحب Pull

في المختبر كنا نحن من يتصل بالجهاز على المنفذ 3232 ويرسل له الصورة، وهذا هو الدفع Push، وهو مناسب عندما يكون الجهاز في الشبكة نفسها التي فيها أداة البناء، أو في شبكة يصل إليها Home Assistant. ولكنه يتطلب أن يكون للجهاز منفذ مفتوح يستقبل عليه، وأن يصل إليه من يرسل التحديث، وهذا غير ممكن لجهاز خلف NAT في مستودع بعيد، وغير مرغوب أمنياً، فكل منفذ مفتوح باب. والطريقة الأخرى السحب Pull: الجهاز نفسه يسأل خادم التحديثات كل فترة أو عند أمر، ويحمل الصورة بطلب HTTPS، ثم يكتبها بالطريقة نفسها. وفي ESPHome منصة لهذا اسمها `http_request`، تقول [صفحتها](https://esphome.io/components/ota/http%5Frequest/?ref=arabroot.io) إنها مفيدة خصوصاً للأجهزة المستقلة أو التي تتكلم MQTT فقط، والإجراء `ota.http_request.flash` يأخذ عنوان الصورة وعنوان ملف MD5 لها، فإذا لم يطابق الملخص احتفظ الجهاز ببرنامجه الحالي.

ولاحظ أن ملخص MD5 هنا يحمي من الصورة التالفة في الطريق، ولا يحمي من صورة يضعها شخص آخر على الخادم ومعها ملخصها الصحيح، فمن يستطيع أن يغير الصورة يستطيع أن يغير الملخص بجانبها. ولذلك مع السحب تبقى الحماية الحقيقية هي نفسها التي جربناها: التوقيع بمفتاح لا يوجد على خادم التحديثات أصلاً، ورفض الرجوع. ومع السحب يصبح النشر على مراحل أسهل، فخادم التحديثات يقرر أي جهاز يرى الإصدار الجديد ومتى، والجهاز يبلغ بإصداره بعد التحديث، وهذا ما تفعله منصات إدارة الأجهزة بشكل عام.

## من المحاكي إلى اللوحة: ما الذي يتغير؟ From QEMU to the Board

- **الكتابة الأولى عبر السلك:** اللوحة الجديدة تحتاج `firmware.factory.bin` عبر USB مرة واحدة، وفيها المحمل الذي يدعم الرجوع والصورة الموقعة الأولى، وبعدها كل شيء عبر الشبكة. وإذا كانت عندك أجهزة قديمة بمحمل لا يدعم الرجوع، فتذكر ما تقوله صفحة ESP32 في ESPHome: التحديث عبر الشبكة لا يحدث المحمل.
- **خوارزمية التوقيع وإصدار الشريحة:** اقرأ إصدار شريحتك من سجل الإقلاع، السطر `chip revision`، فإذا كانت 3.0 أو أحدث فالخيار الافتراضي `rsa3072` متاح، وإلا فـ `ecdsa_v1` كما في المختبر.
- **Wi-Fi بدل الشبكة السلكية:** الإرسال أسرع من المحاكي في الغالب، ولكن الشبكة أقل ثباتاً داخل غرفة التبريد، وهنا تظهر قيمة الإرسال على القسم الآخر، فالانقطاع لا يضر.
- **مؤقت المراقبة:** احذف سطر `CONFIG_ESP_TASK_WDT_TIMEOUT_S` الذي أضفناه للمحاكاة، فهو ليس مشكلة على الشريحة.
- **إعلان التوقيع:** تقول صفحة ESP32 إن الأجهزة المبنية بالتوقيع تعلن `ota_signed=1` في سجلات mDNS، ولكن غياب السجل لا يثبت أن الجهاز يقبل صوراً غير موقعة، فلا تعتمد عليه في التدقيق، وإنما على تجربة رفض حقيقية مثل المحاولة الرابعة.
- **مكان الأجهزة:** اكتب أين علقت كل لوحة، ومعها رقمها وإصدارها، فيوم تحتاج السلك سوف تبحث عن الجهاز خلف الرفوف في حرارة 4 درجات.

## تحديث أسطول الأجهزة على مراحل Staged Rollout

كل ما سبق يحمي جهازاً واحداً من تحديث سيئ، أما حماية الأسطول فتحتاج طريقة نشر. والفكرة التي التزمت بها CrowdStrike بعد حادثتها هي نفسها التي تستخدمها فرق الأجهزة منذ سنوات: لا يصل التحديث إلى كل الأجهزة في وقت واحد، وإنما على مراحل، وبين كل مرحلتين قاعدة توقف واضحة:

![أربع خطوات من اليمين: 1. المختبر بالمحاكي أو لوحة على المكتب وكل التجارب والانقطاعات، 2. جهاز واحد في الميدان Canary في غرفة أقل أهمية مع يوم كامل من المراقبة، 3. مجموعة صغيرة مثل مستودع واحد ومن يتابعها حاضر، 4. البقية على دفعات وليس في وقت واحد، وفي الأسفل قاعدة التوقف: غياب أي جهاز أو رجوع Rollback أو قراءات خارج المعتاد](https://arabroot.io/content/images/2026/11/ota-updates-04-rollout-1.webp)

النشر على مراحل: الرجوع يحمي جهازاً واحداً، وقاعدة التوقف تحمي البقية

- **المختبر أولاً:** كل إصدار يمر على المحاكي بالتجارب التي رأيتها، والتحديث إليه ومنه، وقطع الكهرباء أثناء الإرسال، وهذا يمكن أن يكون خطوة آلية في التكامل المستمر CI، فالمحاكي يعمل في Container.
- **جهاز واحد في الميدان Canary:** في غرفة أقل حساسية، يوماً كاملاً، والسؤال ليس «هل أقلع؟» فقط، وإنما «هل يرسل قراءات طبيعية؟ وهل يستقبل تحديثاً تجريبياً بعده؟».
- **مجموعة صغيرة ثم البقية على دفعات:** مع شخص حاضر يستطيع أن يذهب إلى المستودع، وفي وقت لا تكون فيه شحنات كبيرة، وليس قبل عطلة نهاية الأسبوع.
- **قاعدة التوقف:** أي جهاز يغيب بعد التحديث، أو أي رجوع تلقائي، أو قراءات خارج المعتاد، توقف النشر حتى تفهم السبب. وهذا يحتاج أن تعرف إصدار كل جهاز من الجهاز نفسه، كما ذكرنا، لا من سجل أداة النشر.

ولاحظ أن ما بنيناه هنا يخص ESPHome وESP32، ولكن الفكرة نفسها موجودة في كل مكان بأسماء مختلفة: في المتحكمات الأخرى ومع نظام Zephyr هناك محمل الإقلاع المفتوح [MCUboot](https://docs.mcuboot.com/?ref=arabroot.io) الذي يقوم بالتبديل بين صورتين والتحقق من التوقيع، وفي أجهزة Linux المدمجة أدوات تحديث تعمل بقسمين للنظام كاملاً بالفكرة نفسها. والأسئلة التي تسألها لأي منها واحدة: أين الصورة القديمة أثناء الكتابة؟ ومن يتحقق من التوقيع؟ ومتى يعتبر الجديد سليماً؟ وكيف تعود إذا لم يكن؟

## ماذا تراقب بعد كل تحديث؟ Post-update Monitoring

قاعدة التوقف في النشر على مراحل لا تعمل إلا إذا كانت عندك أرقام تقرر بها، والسجلات التي رأيتها في المختبر تقول لك ما هي هذه الأرقام. الأول توزيع الإصدارات: كم جهازاً على كل إصدار الآن، كما يعلنه الجهاز بنفسه في كيان مثل `Firmware version`، وليس كما سجلته أداة النشر، فقد رأيت أن الأداة قالت إن التحديث نجح والجهاز عاد إلى الإصدار السابق. فإذا بقي جهاز على الإصدار القديم بعد ساعة من النشر فهذا إما رجوع وإما تحديث لم يصل، والاثنان يستحقان التوقف.

والثاني سبب آخر إعادة تشغيل: في سجل الإقلاع سطر `rst:` يقول لماذا أقلعت الشريحة، ورأيت منه في المختبر `POWERON_RESET` عند التشغيل و`SW_CPU_RESET` بعد التحديث أو التعطل، ورأيت قبله رسائل مؤقت المراقبة `task_wdt` عندما علقت مهمة. فإذا أعلن كل جهاز سبب إقلاعه الأخير وعدد إعادات التشغيل منذ التحديث، فإن ارتفاعاً مفاجئاً في عدد إعادات التشغيل على الإصدار الجديد هو أول علامة على خطأ لا يكفي لإسقاط الجهاز تماماً، ولكنه يجعله يتعطل كل بضع ساعات.

والثالث أي رجوع تلقائي، فالسطر `OTA rollback detected!` الذي كتبه ESPHome في التجربة الخامسة يجب أن يصل إليك تنبيهاً، لا أن يبقى في سجل جهاز لا يقرؤه أحد. والرابع، وهو الأهم للعمل نفسه، أن يستمر الجهاز في فعل ما وجد من أجله: هل وصلت القراءات بالمعدل نفسه بعد التحديث؟ وهل قيمها في المدى الطبيعي؟ فالإصدار الذي يقلع ويؤكد نفسه ويستقبل التحديثات، ولكنه يقرأ الحساس خطأً بعد تغيير في المكتبة، أخطر من الإصدار الذي يتعطل، لأن كل آليات الحماية في هذا المقال تراه سليماً، ولا يكشفه إلا من يقارن القراءات قبل التحديث وبعده. ولذلك اجعل لوحة المتابعة تعرض القراءات بحسب الإصدار أثناء النشر، فإذا اختلفت أجهزة الإصدار الجديد عن جيرانها في الغرفة نفسها فهذا سبب كاف للتوقف.

## أخطاء شائعة Common Mistakes

- **الوثوق برد أداة الرفع:** «OTA successful» ظهرت والجهاز رجع إلى الإصدار السابق.
- **تعريف «سليم» بأنه «لم يتعطل»:** الإصدار 1.3.0 لم يتعطل وأغلق باب التحديث.
- **كلمة مرور OTA وحدها:** يعرفها كل من عنده ملف الإعداد، والتوقيع هو الذي منع الصورة الغريبة.
- **التوقيع دون رفض الرجوع:** النسخة القديمة الموقعة بمفتاحك تعيد ثغرة أغلقتها.
- **المفتاح الخاص في مجلد المشروع أو في Git:** من يملكه يستطيع أن يكتب برنامج كل أجهزتك، ومن يفقده لا يستطيع أن يحدثها.
- **أول صورة بلا توقيع:** لا يوجد مفتاح موثوق يتحقق به الجهاز لاحقاً.
- **نشر التحديث على كل الأجهزة معاً:** الرجوع ينقذ كل جهاز، ولكن خطأً يصل الأسطول كله في ساعة يبقى مشكلة.
- **رفع مدة مؤقت المراقبة على اللوحة لأنها رفعت في المحاكي:** القيمة 60 ثانية للمحاكاة فقط.

## قائمة تحقق Checklist قبل أول تحديث عن بعد

| البند            | ما يجب أن تراه                                                 |
| ---------------- | -------------------------------------------------------------- |
| الأقسام          | قسمان للبرنامج ota\_0 وota\_1، والبرنامج أقل من نصف القسم      |
| المحمل           | مبني بدعم الرجوع، ومكتوب عبر السلك مرة واحدة على كل جهاز       |
| التوقيع          | كل صورة موقعة، والأولى أيضاً، والجهاز يرفض المفتاح الغريب      |
| المفتاح الخاص    | خارج جهاز المطور وGit، بنسختين في مدير أسرار                   |
| رفض الرجوع       | مفعل، ورقم الإصدار في project.version يزيد مع كل نشر           |
| تعريف السليم     | التأكيد بعد الاتصال بالشبكة والخادم، وليس بعد مدة فقط          |
| خط البناء        | يرفض صورة بلا مكون ota                                         |
| التحقق بعد النشر | الإصدار يقرأ من الجهاز نفسه، وأي رجوع ينبه                     |
| النشر            | مختبر، ثم جهاز واحد، ثم مجموعة، ثم البقية، مع قاعدة توقف       |
| الاستعادة        | محول USB إلى UART وصورة factory.bin جاهزان، وتعرف مكان كل جهاز |

## تدريب عملي Practice

1. غير `boot_is_good_after` إلى `false`، وأضف إلى `on_boot` أتمتة تستدعي `safe_mode.mark_successful` بعد نجاح الاتصال بالشبكة فقط، ثم كرر التجربة السادسة بنسخة تفصل الشبكة بدل أن تحذف ota، وانظر هل يرجع الجهاز.
2. أوقف المحاكي أثناء الإرسال في المحاولة الأولى، بعد عشر ثوان من بدايته، ثم شغله وتأكد من الإصدار الذي أقلع به.
3. جرب `signing_scheme: rsa3072` مع المحاكي، واقرأ ما تقوله الترجمة أو الجهاز عن إصدار الشريحة.

## حذف المختبر Cleanup

```bash
docker rm -f iot-ota-dev
docker network rm iot-ota-net
docker volume rm iot-ota-build iot-ota-flash iot-esphome-cache
docker image rm iot-ota-qemu:1 ghcr.io/esphome/esphome:2026.10.2
rm -f ota_signing_key.pem attacker_key.pem
```

والـ Volume `iot-esphome-cache` فيه أدوات ESP-IDF من مقال ESPHome، وحجمه قرابة 1.9 جيجابايت. واحذف المفتاحين فقط إذا كانا للتجربة، أما مفتاح أجهزتك الحقيقية فلا تحذفه أبداً، ولا تتركه في المجلد.

## الخلاصة Summary

- التحديث بنسختين يكتب البرنامج الجديد بجانب القديم، فانقطاع الكهرباء أو الصورة التالفة لا يضران، والثمن نصف مساحة البرنامج.
- التوقيع يمنع الصورة التي لم تخرج من مفتاحك، ورفض الرجوع يمنع نسختك القديمة الضعيفة، ورأينا الاثنين يرفضان في المختبر بعد أن وصلت الصورة كاملة.
- الرجوع التلقائي أعاد الجهاز من 1.2.0 المتعطل إلى 1.1.0 في الإقلاع التالي، بينما قالت أداة الرفع إن التحديث نجح.
- البرنامج الذي يعمل ولكنه حذف التحديث لا ينقذه الرجوع، والطريق الوحيد بعده السلك، فعرف «السليم» بأنه القادر على التحديث القادم.
- والأسطول يحميه النشر على مراحل مع قاعدة توقف، وهو الدرس نفسه الذي خرجت به CrowdStrike من حادثة 19 يوليو 2024.

[![](https://arabroot.io/content/images/2026/11/iot-security-cover-cover-1.webp)دليلأمن إنترنت الأشياء IoT: الأجهزة التي ينساها الجميعنهاجم وسيط MQTT في مختبر غرفة التبريد كما يفعل من يدخل الشبكة، فنطفئ الضاغط ونسرق كلمة المرور، ثم نغلقه بالتشفير والصلاحيات وتقسيم الشبكة ونعيد الهجوم.](https://arabroot.io/articles/%D8%A7%D9%85%D9%86-%D8%A7%D9%86%D8%AA%D8%B1%D9%86%D8%AA-%D8%A7%D9%84%D8%A7%D8%B4%D9%8A%D8%A7%D8%A1-iot-%D8%A7%D9%84%D8%A7%D8%AC%D9%87%D8%B2%D8%A9-%D8%A7%D9%84%D8%AA%D9%8A-%D9%8A%D9%86%D8%B3%D8%A7%D9%87%D8%A7-%D8%A7%D9%84%D8%AC%D9%85%D9%8A%D8%B9/)[![](https://arabroot.io/content/images/2026/10/certificates-cover-cover.webp)دليلالشهادات الرقمية TLS للمبتدئين وصيغ ملفاتهاكيف يعرف المتصفح أنه يتحدث مع الموقع الحقيقي، وماذا يوجد داخل الشهادة، ولماذا تأتي ملفاتها بأكثر من صيغة.](https://arabroot.io/articles/%D8%A7%D9%84%D8%B4%D9%87%D8%A7%D8%AF%D8%A7%D8%AA-%D8%A7%D9%84%D8%B1%D9%82%D9%85%D9%8A%D8%A9-tls-%D9%88-x509-%D9%88%D8%B5%D9%8A%D8%BA-pem-%D9%88-der/)[![](https://arabroot.io/content/images/2026/11/secrets-managers-cover-cover.webp)دليلإدارة الأسرار Secrets Manager: OpenBao أم Infisical؟نشغل OpenBao ثم Infisical على المسار نفسه، من هوية التطبيق إلى كلمات مرور تنتهي وحدها وسجل يقول من قرأ السر، ونرى ما تعطيه كل أداة دون رخصة.](https://arabroot.io/articles/%D8%A7%D8%AF%D8%A7%D8%B1%D8%A9-%D8%A7%D9%84%D8%A7%D8%B3%D8%B1%D8%A7%D8%B1-secrets-manager-openbao-%D8%A7%D9%85-infisical/)[![](https://arabroot.io/content/images/2026/11/incident-response-cover-cover.webp)دليلإدارة الحوادث Incident Response: من التنبيه إلى عودة الخدمةنعيش حادثة حقيقية على PostgreSQL من التنبيه إلى الإغلاق بخط زمني مسجل بالثواني، ونرى لماذا لم تنفع إعادة التشغيل وما الذي أنهى الحادثة.](https://arabroot.io/articles/%D8%A7%D8%AF%D8%A7%D8%B1%D8%A9-%D8%A7%D9%84%D8%AD%D9%88%D8%A7%D8%AF%D8%AB-incident-response-%D9%85%D9%86-%D8%A7%D9%84%D8%AA%D9%86%D8%A8%D9%8A%D9%87-%D8%A7%D9%84%D9%89-%D8%B9%D9%88%D8%AF%D8%A9-%D8%A7%D9%84%D8%AE%D8%AF%D9%85%D8%A9/)

وفي [المقال الأخير من السلسلة](https://arabroot.io/articles/%D8%A7%D9%85%D9%86-%D8%A7%D9%86%D8%AA%D8%B1%D9%86%D8%AA-%D8%A7%D9%84%D8%A7%D8%B4%D9%8A%D8%A7%D8%A1-iot-%D8%A7%D9%84%D8%A7%D8%AC%D9%87%D8%B2%D8%A9-%D8%A7%D9%84%D8%AA%D9%8A-%D9%8A%D9%86%D8%B3%D8%A7%D9%87%D8%A7-%D8%A7%D9%84%D8%AC%D9%85%D9%8A%D8%B9/) بإذن الله سوف نهاجم المختبر نفسه كما يفعل المخترق، ثم نغلقه.

## سجل التحديثات Changelog

- نوفمبر 2026: كتابة المقال، والتجربة على ESPHome 2026.10.2 مع ESP-IDF 5.5.6 للوحة esp32dev، وتوقيع ecdsa\_v1 بأداة espsecure 5.4.0، ومحاكي Espressif QEMU 9.2.2 (esp-develop-9.2.2-20260417) مع esptool 5.1.0، على Docker Engine 29.8.0، والمعلومات من توثيق ESPHome وESP-IDF ومراجعة CrowdStrike الأولية كما قرأناها في 6 نوفمبر 2026.