فرآیند به روز رسانی

تخصیص firmware/نرم‌افزار به دستگاه یا پروفایل دستگاه، فرآیند به‌روزرسانی را آغاز می‌کند. ThingsConnect پیشرفت به‌روزرسانی را دنبال می‌کند و آن را به ویژگی‌های دستگاه ادامه می‌دهد. پیشرفت به‌روزرسانی ممکن است یکی از حالت‌های زیر را داشته باشد. وضعیت به روز رسانی به عنوان یک ویژگی دستگاه ذخیره می شود و برای بصری کردن فرآیند به روز رسانی در داشبورد استفاده می شود.

حالت QUEUED

اولین وضعیت به روز رسانی سیستم عامل/نرم افزار. به این معنی که اعلان مربوط به سیستم عامل/نرم افزار جدید در صف قرار دارد اما هنوز به دستگاه ارسال نشده است. ThingsConnect اعلان‌های به‌روزرسانی را در صف می‌گذارد تا از بارگیری بیش از اندازه جلوگیری کند. صف با سرعت ثابت پردازش می شود. به طور پیش فرض، پیکربندی شده است تا حداکثر 100 دستگاه در دقیقه را مطلع کند. برای جزئیات بیشتر به ویژگی های پیکربندی مراجعه کنید.

حالت آغاز شده(INITIATED)

به این معنی که اعلان مربوط به سیستم عامل/نرم افزار از صف واکشی شده و به دستگاه منتقل می شود. ThingsConnect اعلان را به‌روزرسانی ویژگی‌های مشترک زیر تبدیل می‌کند:

• • fw(sf)_title – نام firmware (نرم افزار).
  • fw(sf)_version – نسخه firmware (نرم افزار).
  • fw(sf)_size – اندازه فایل firmware (نرم افزار) بر حسب بایت.
  • fw(sf)_checksum – مشخصه ای است که برای تأیید صحت فایل دریافتی استفاده می شود.

fw(sf)_checksum_algorithm – الگوریتمی که برای محاسبه checksum فایل استفاده می‌شود.

دستگاه می‌تواند با استفاده از MQTT، HTTP، CoAP یا LwM2M API عضو به‌روزرسانی ویژگی مشترک شود.

به روز رسانی وضعیت های گزارش شده توسط دستگاه

وضعیت‌های باقی‌مانده توسط firmware/نرم‌افزار دستگاهی که در حال پردازش به‌روزرسانی است، گزارش می‌شود. ما شرحی از آن حالت ها و نمونه برنامه های کاربردی را برای محبوب ترین پروتکل های نوشته شده در پایتون آماده کرده ایم. برنامه های کاربردی نمونه رفتار firmware/نرم افزار دستگاه را شبیه سازی می کنند و ممکن است به عنوان مرجعی برای پیاده سازی استفاده شوند.

• • دانلود – اعلان در مورد به روز رسانی سیستم عامل/نرم افزار جدید دریافت شد و دستگاه شروع به دانلود پکیج به روز رسانی کرد.
  • دانلود شده – دستگاه بارگیری پکیج به روز رسانی را کامل کرد.
  • تأیید شده – دستگاه checksum پکیج دانلود شده را تأیید کرد.
  • به روز رسانی – دستگاه به روز رسانی firmware/نرم افزار را شروع کرد. معمولاً قبل از راه اندازی مجدد دستگاه یا راه اندازی مجدد سرویس ارسال می شود.
  • به روز شد – سیستم عامل با موفقیت به نسخه بعدی به روز شد.
  • ناموفق – checksum تأیید نشد، یا دستگاه به‌روزرسانی نشد. برای جزئیات بیشتر به برگه «شکست دستگاه» در داشبورد Firmware مراجعه کنید.

پس از به‌روزرسانی firmware/نرم‌افزار، ThingsConnect انتظار دارد دستگاه تله‌متری زیر را ارسال کند:

برای firmware:

{"current_fw_title": "myFirmware", "current_fw_version": "1.2.3", "fw_state": "UPDATED"}

برای نرم افزار:

{"current_sw_title": "mySoftware", "current_sw_version": "1.2.3", "sw_state": "UPDATED"}

اگر به‌روزرسانی firmware/نرم‌افزار ناموفق بود، ThingsConnect انتظار دارد دستگاه تله‌متری زیر را ارسال کند:

برای firmware:

{"fw_state": "FAILED", "fw_error":  "the human readable message about the cause of the error"}

برای نرم افزار:

{"sw_state": "FAILED", "sw_error":  "the human readable message about the cause of the error"}

HTTP

برای نصب کتابخانه های HTTP و checksum دستور زیر را در ترمینال اجرا کنید:

pip3 install requests mmh3 --user

مسیر پوشه کلاینت را در ترمینال وارد کنید و دستور زیر را برای ThingsConnect اجرا کنید تا اسکریپت نمونه firmware را دریافت کنید:

python3 http_firmware_client.py

نمونه مشتری HTTP را دانلود کنید: http_firmware_client.py(لینک دانلود)

پس از دریافت پیام های زیر:

• Please write your ThingsConnect host or leave it blank to use default (localhost):

• از لوکال هاست خود استفاده کنید یا آدرس پلتفرم

• Please write your ThingsConnect port or leave it blank to use default (8080):

– شما می توانید با فشردن کلید enter ادامه دهید یا شماره پورت خود را وارد کنید.

• Please write accessToken for device:

– access token را از TB کپی کرده و درون ترمینال past کنید.

• Please write firmware chunk size in bytes or leave it blank to get all firmware by request:

– اگر خالی گذاشته شود، فایل دانلودی به یکباره به صورت سایز کامل دانلود خواهد شد. اگر شما بخواهید می توانید دانلود را به صورت بخش به بخش انجام دهید.

سیستم عامل دستگاه به روز شده است. برای مشاهده وضعیت آن، باید به داشبورد سیستم عامل همانطور که در پاراگراف زیر نشان داده شده است بروید. برای اطلاع از به‌روزرسانی firmware، باید درخواستی ارسال کنید و در ویژگی‌ها عضو شوید.

MQTT

برای نصب کتابخانه های mqtt و checksum دستور زیر را در ترمینال اجرا کنید:

pip3 install paho-mqtt mmh3 --user

مسیر پوشه کلاینت را در ترمینال وارد کنید و دستور زیر را برای ThingsConnect اجرا کنید تا اسکریپت نمونه firmware را دریافت کنید:

python3 mqtt_firmware_client.py

نمونه مشتری mqtt را دانلود کنید: mqtt_firmware_client.py(لینک دانلود)

پس از دریافت پیام های زیر:

• Please write your ThingsConnect host or leave it blank to use default (localhost):

• از لوکال هاست خود استفاده کنید یا آدرس پلتفرم

• Please write your ThingsConnect port or leave it blank to use default (1883):

– شما می توانید با فشردن کلید enter ادامه دهید یا شماره پورت خود را وارد کنید.

• Please write accessToken for device:

– access token را از TB کپی کرده و درون ترمینال past کنید.

• Please write firmware chunk size in bytes or leave it blank to get all firmware by request:

– اگر خالی گذاشته شود، فایل دانلودی به یکباره به صورت سایز کامل دانلود خواهد شد. اگر شما بخواهید می توانید دانلود را به صورت بخش به بخش انجام دهید.

سیستم عامل دستگاه به روز شده است. برای مشاهده وضعیت آن، باید به داشبورد سیستم عامل همانطور که در پاراگراف زیر نشان داده شده است بروید. برای اطلاع از به‌روزرسانی firmware، باید درخواستی ارسال کنید و در ویژگی‌ها عضو شوید.

CoAP

برای نصب کتابخانه های mqtt و checksum دستور زیر را در ترمینال اجرا کنید:

pip3 install asyncio aiocoap mmh3 --user

مسیر پوشه کلاینت را در ترمینال وارد کنید و دستور زیر را برای ThingsConnect اجرا کنید تا اسکریپت نمونه firmware را دریافت کنید:

python3 coap_firmware_client.py

نمونه مشتری CoAP را دانلود کنید: CoAP_firmware_client.py

پس از دریافت پیام های زیر:

• Please write your ThingsConnect host or leave it blank to use default (localhost):

• از لوکال هاست خود استفاده کنید یا آدرس پلتفرم

• Please write your ThingsConnect port or leave it blank to use default (5683):

– شما می توانید با فشردن کلید enter ادامه دهید یا شماره پورت خود را وارد کنید.

• Please write accessToken for device:

– access token را از TB کپی کرده و درون ترمینال past کنید.

• Please write firmware chunk size in bytes or leave it blank to get all firmware by request:

– اگر خالی گذاشته شود، فایل دانلودی به یکباره به صورت سایز کامل دانلود خواهد شد. اگر شما بخواهید می توانید دانلود را به صورت بخش به بخش انجام دهید.

سیستم عامل دستگاه به روز شده است. برای مشاهده وضعیت آن، باید به داشبورد سیستم عامل همانطور که در پاراگراف زیر نشان داده شده است بروید. برای اطلاع از به‌روزرسانی firmware، باید درخواستی ارسال کنید و در ویژگی‌ها عضو شوید.

داشبورد

ThingsConnect خلاصه‌ای از به‌روزرسانی firmware/نرم‌افزار را برای نظارت و ردیابی وضعیت به‌روزرسانی firmware/نرم‌افزار دستگاه شما ارائه می‌کند، مانند اینکه کدام دستگاه‌ها در حال به‌روزرسانی هستند، هر گونه مشکل بوت، و کدام یک قبلاً به‌روزرسانی شده‌اند.

داشبورد مانیتورینگ به روز رسانی سیستم عامل

داشبورد به‌طور خودکار برای هر تننت جدیدی که به ThingsConnect اضافه می‌کنید ایجاد می‌شود. همچنین می‌توانید JSON داشبورد را دانلود کرده:

https://github.com/thingsboard/thingsboard/blob/master/application/src/main/data/json/demo/dashboards/firmware.json

و آن را برای تننت موجود وارد کنید. در آنجا می توانید لیستی از تمام دستگاه ها را با اطلاعات کامل در مورد سیستم عامل آنها مشاهده کنید.

برای اطلاع از وضعیت به‌روزرسانی firmware دستگاه خاص، روی دکمه «History of the firmware updates» در کنار نام دستگاه کلیک کنید.

به روز رسانی نرم افزار داشبورد مانیتورینگ

داشبورد به‌طور خودکار برای هر تننت جدیدی که به ThingsConnect اضافه می‌کنید ایجاد می‌شود. همچنین می‌توانید JSON داشبورد را دانلود کرده و آن را برای تننت موجود وارد کنید.

https://github.com/thingsboard/thingsboard/blob/master/application/src/main/data/json/demo/dashboards/software.json

در آنجا می توانید لیستی از تمام دستگاه ها را با اطلاعات کامل در مورد نرم افزار آنها مشاهده کنید. برای اطلاع از وضعیت به‌روزرسانی نرم‌افزار دستگاه خاص، روی دکمه «سابقه به‌روزرسانی‌های نرم‌افزار» در کنار نام دستگاه کلیک کنید.

پیکربندی

سرعت پردازش صف: برای تنظیم حداکثر تعداد دستگاه هایی که در بازه زمانی انتخاب شده با استفاده از ویژگی های پیکربندی زیر مطلع می شوند:

export TB_QUEUE_CORE_FW_PACK_INTERVAL_MS=60000
export TB_QUEUE_CORE_FW_PACK_SIZE=100

تنظیم حداکثر اندازه

به طور پیش فرض، حداکثر اندازه firmware که می توانیم در پایگاه داده ذخیره کنیم 2 گیگابایت است. نمی توان آن را پیکربندی کرد.