انتقل إلى المحتوى الرئيسي

تحديث البرنامج الثابت

يتم تثبيت تحديثات البرنامج الثابت من صفحة التحديث في لوحة التحكم أثناء استمرار الجهاز في العمل. يستخدم Safi نظام A/B: يُكتب البرنامج الثابت الجديد في قسم احتياطي، ولا ينتقل الجهاز إليه إلا بعد إثبات قدرته على الإقلاع بنجاح. أي تحديث غير ناجح يتراجع تلقائيًا، ولا يمكن إتلاف الجهاز بملف تحديث تالف.

الحصول على ملفات التحديث

يوفّر كل إصدار في صفحة إصدارات GitHub ملف تحديث OTA مسبق البناء:

  • تحميل أحدث ملف Safi.bin (ملف OTA المباشر)
  • تُرفق بصمة التحقق SHA-256 وملفات التثبيت الأولي عبر USB في ملاحظات الإصدار. يلزم فقط ملف Safi.bin لإجراء التحديث الهوائي OTA.

الطريقة الأولى: الرفع من المتصفح

  1. افتح صفحة التحديث في لوحة التحكم.
  2. اختر ملف Safi.bin الذي قمت بتنزيله واضغط على زر الرفع.
  3. يتقدم شريط الرفع حتى 100 بالمئة (يُكتب الملف في القسم الاحتياطي أثناء الرفع)، ثم يُعيد الجهاز الإقلاع على البرنامج الثابت الجديد.
  4. تُعيد لوحة التحكم الاتصال تلقائيًا بمجرد بدء تشغيل البرنامج الثابت الجديد.

الطريقة الثانية: التنزيل من رابط مباشر

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

يتطلب التنزيل عبر الرابط افتراضيًا بروتوكول HTTPS بشهادة صالحة: يتحكم خيار التحقق من الشهادة في صفحة التحديث في ذلك ويظل مفعّلًا. يمكن لإصدارات الإنتاج تحديد الخادم المعتمد للتحديث بدقة. التفاصيل الكاملة في فصل تحديثات OTA للمطورين.

ما يحدث أثناء التحديث

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

أثناء إجراء التحديث

  • تعرض الشاشة واجهة التحديث مع نسبة التقدم وتحذير بعدم فصل الطاقة.
  • يتوقف التشغيل الصوتي مؤقتًا أثناء إعادة الإقلاع (بضع ثوانٍ).
  • انقطاع التيار أثناء التنزيل آمن تمامًا: يظل الجهاز يعمل بالبرنامج الثابت القديم، ويتم مسح القسم الاحتياطي غير المكتمل في المحاولة التالية.

عند تعذر التحديث

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