مستندات فلووا

به‌روزرسانی از راه دور (OTA)

نسخهٔ فریم‌ور را منتشر کنید، rollout بسازید و خطاهای دستگاه‌ها را مدیریت کنید.

OTA فایل فریم‌ور را منتشر می‌کند و آن را از طریق شبکه به دستگاه‌های سازگار می‌فرستد. نسخه همان فایل فریم‌ور ثبت‌شده است و rollout عملیاتی است که دستگاه‌ها را انتخاب و نسخه را برای آن‌ها ارسال می‌کند.

انتشار نسخهٔ فریم‌ور

۱. کنسول یا صفحهٔ OTA یک قالب را باز کنید. ۲. ایجاد و سپس انتشار نسخهٔ OTA را بزنید. ۳. یک فایل .bin انتخاب کنید. کنسول حجم فایل را با سقف عمومی و سقف دستگاه هدف مقایسه می‌کند. ۴. برای بستهٔ فریم‌ور فلووا اجازه دهید نسخه و هدف از فایل خوانده شود. برای فایل سفارشی، گزینهٔ فایل بدون اطلاعات Flova را فعال و نسخه و هدف را وارد کنید. ۵. در صورت نیاز یادداشت انتشار بنویسید و فایل را منتشر کنید.

بارگذاری سه مرحله دارد: آماده‌سازی، ارسال فایل و ثبت نسخه. اگر یک مرحله خطا داد، شبکه و فایل را بررسی و دوباره تلاش کنید. فایل ارسال‌شده تا وقتی ثبت نسخه موفق نشده باشد rollout محسوب نمی‌شود.

ساخت rollout

۱. ایجاد و سپس ایجاد rollout را بزنید. ۲. نسخهٔ OTA را انتخاب کنید. ۳. صبر کنید بررسی سازگاری تمام شود. ۴. قالب سازگار را انتخاب کنید. در صفحهٔ OTA یک قالب، همان قالب از قبل انتخاب می‌شود. ۵. دستگاه‌های سازگار را ببینید، با نام، شناسه یا نسخهٔ فعلی جست‌وجو کنید و مواردی را که نباید فعلاً به‌روزرسانی شوند از انتخاب خارج کنید. ۶. شروع فوری یا زمان‌بندی‌شده را انتخاب کنید. ۷. rollout را بسازید.

کنسول هدف OTA، نسخهٔ boot layout، فریم‌ور فعلی، قالب و وضعیت دستگاه را بررسی می‌کند. اگر دستگاه سازگاری باقی نمانده باشد، rollout ساخته نمی‌شود.

تنظیمات ایمنی rollout

تنظیمات پیشرفته سرعت انتشار را کنترل می‌کنند:

تنظیممقدار پیش‌فرض کنسولکاربرد
اندازهٔ batch۱۰تعداد دستگاه‌های هر مرحله
فاصله۳۰۰ ثانیهمکث بین batchها
توقف با خطا۲۰٪توقف وقتی سهم خطا به این مقدار برسد
توقف با آفلاین۵۰٪توقف وقتی سهم دستگاه‌های در دسترس نبودن به این مقدار برسد

زمان شروع بر اساس منطقهٔ زمانی تهران تنظیم می‌شود. دستگاه‌های legacy فقط وقتی وارد rollout می‌شوند که ریسک نداشتن rollback خودکار را صریحاً بپذیرید.

پیگیری و کنترل rollout

ردیف rollout را باز کنید تا دستگاه‌ها، فریم‌ور فعلی، نتیجهٔ به‌روزرسانی و جزئیات خطا را ببینید. وضعیت rollout می‌تواند زمان‌بندی‌شده، در حال اجرا، متوقف‌شده، کامل‌شده، ناموفق یا لغوشده باشد.

  • توقف: ارسال به دستگاه‌های باقی‌مانده را متوقف می‌کند.
  • ادامه: rollout متوقف‌شده را ادامه می‌دهد.
  • لغو: کار باقی‌مانده را متوقف می‌کند. دستگاه‌های قبلاً به‌روزشده برنمی‌گردند.
  • تلاش مجدد خطاها: برای دستگاه‌های ناموفق دوباره تلاش می‌کند.

نتیجهٔ rollout فقط عملیات به‌روزرسانی را توصیف می‌کند. برای بررسی اتصال دوباره و گزارش بعد از نصب، نتیجه را با پایش و timeline دستگاه مقایسه کنید.

خطاهای رایج

  • قالب سازگار پیدا نشد: هدف یا boot layout نسخه با دستگاه‌ها هم‌خوان نیست.
  • فایل رد شد: فایل .bin را داخل سقف عمومی و سقف دستگاه هدف نگه دارید.
  • دستگاه سازگار وجود ندارد: دستگاه ممکن است آفلاین، قبلاً روی همین نسخه، غیرفعال یا خارج از قالب انتخابی باشد.
  • rollout خودکار متوقف شد: آستانهٔ خطا و آفلاین را بررسی کنید و بعد ادامه دهید.
  • دستگاه نصب کرده ولی آنلاین نیست: timeline، نسخهٔ فعلی فریم‌ور و لاگ شبکه یا boot را بررسی کنید.

جزئیات بسته و بخش دستگاه OTA در مخزن فریم‌ور فلووا آمده است.