قالب‌ها و نسخه‌ها
قالب دستگاه را بسازید، آن را به بخش‌های فلووا وصل کنید و تغییرات را منتشر کنید.
قالب مشخص می‌کند دستگاه‌های یک گروه چه ورودی، خروجی، فرمان و تنظیمات فریم‌وری دارند. داشبوردهای Studio، کوئری‌های FlovaQL، اتوماسیون‌ها و انتشارهای OTA از همین قالب استفاده می‌کنند.
ساخت قالب
۱. کنسول فلووا را باز کنید و ساخت قالب را بزنید.
۲. نامی وارد کنید که سخت‌افزار یا محصول را توضیح دهد، مثل ESP32 LED یا کنترلر اتاق.
۳. روش راه‌اندازی را انتخاب کنید: Wi-Fi، BLE یا Ethernet.
۴. قالب را بسازید. کانال‌های داده را از صفحهٔ کانال‌های داده قالب اضافه کنید.
روش راه‌اندازی مشخص می‌کند دستگاه اطلاعات اولیهٔ شبکه را چطور دریافت کند. این گزینه جای فریم‌ور و روش اتصال آن را نمی‌گیرد. فریم‌ور باید جریان راه‌اندازی انتخاب‌شده را پشتیبانی کند.
ارتباط قالب با بخش‌های دیگر
| بخش | چیزی که قالب در اختیار آن می‌گذارد |
|---|---|
| دستگاه‌ها | تعریف کانال‌ها و سخت‌افزار مشترک دستگاه‌ها |
| داشبوردهای Studio | فهرست کانال‌هایی که ویجت‌ها می‌خوانند یا می‌نویسند |
| FlovaQL | زمینهٔ قالب و کانال برای کوئری تله‌متری |
| اتوماسیون‌ها | کانال‌های قابل استفاده در محرک، شرط و عمل |
| OTA | خانوادهٔ دستگاه برای بررسی سازگاری و rollout |
هنگام ساخت داشبورد در Studio، همین قالب را انتخاب کنید. داشبوردی که به قالب دیگری وصل است نمی‌تواند از کانال‌های این قالب استفاده کند.
تنظیمات قالب
از صفحهٔ تنظیمات قالب، نام آن را تغییر دهید یا قالب را آرشیو کنید. آرشیو قالب، دستگاه‌های فعال آن را هم آرشیو می‌کند؛ پیش از تأیید، فهرست دستگاه‌ها را بررسی کنید. در صفحهٔ کانال‌های داده، بخش تنظیمات فریم‌ور برای پارامترهایی است که فریم‌ور از قالب می‌خواند. هر پارامتر یک کلید، نوع و مقدار اولیه دارد. پیش از انتشار نسخه، پارامتر را ذخیره کنید.
در تنظیمات سخت‌افزار گزینه‌هایی مثل چراغ وضعیت و منبع بازنشانی کارخانه‌ای قرار دارند. چراغ وضعیت یک کانال عادی نیست و تنظیم جداگانه‌ای دارد. نام پایه را با فریم‌ور یکسان نگه دارید، مثلاً GPIO2 یا D32.
انتشار نسخه
تغییرات قالب در یک نسخه نگه‌داری می‌شوند تا هر ویرایش بلافاصله به دستگاه‌های فعال نرسد.
۱. کانال‌ها، پارامترهای فریم‌ور یا نمودار اتوماسیون را ویرایش کنید. ۲. صفحهٔ نسخه‌ها را باز کنید و شماره و وضعیت اعتبارسنجی نسخه را ببینید. ۳. نسخه‌ای را که وضعیت آمادهٔ انتشار دارد منتشر کنید. ۴. انتشار را تأیید کنید. کنسول پیکربندی منتشرشده را برای دستگاه‌های فعال این قالب ارسال می‌کند.
| وضعیت | معنی |
|---|---|
| پیش‌نویس | نسخه هنوز در حال ویرایش است. |
| آمادهٔ انتشار | اعتبارسنجی موفق بوده و نسخه آمادهٔ انتشار است. |
| منتشرشده | این نسخه پیکربندی فعال قالب است. |
| آرشیوشده | نسخه در تاریخچه نگه داشته شده و قابل بازگردانی است. |
انتشار نسخهٔ قالب، داشبورد Studio را منتشر نمی‌کند. داشبورد را جداگانه در Studio منتشر کنید.
بازگردانی نسخه
در نسخه‌ها، یک نسخهٔ آرشیوشده را پیدا و بازگردانی نسخه را انتخاب کنید. کنسول نسخه را اعتبارسنجی می‌کند، آن را نسخهٔ منتشرشده قرار می‌دهد و پیکربندی آن را برای دستگاه‌های فعال قالب می‌فرستد. بازگردانی، پیکربندی قالب را تغییر می‌دهد و تله‌متری ذخیره‌شده یا فریم‌ور نصب‌شده را برنمی‌گرداند.
خطاهای رایج
- دستگاه ساخته نمی‌شود: قالب نسخهٔ منتشرشده ندارد. ابتدا یک نسخه منتشر کنید.
- کانال در Studio دیده نمی‌شود: یکسان بودن قالب داشبورد و نسخهٔ منتشرشده را بررسی کنید.
- نسخه منتشر نمی‌شود: پیام اعتبارسنجی را باز کنید و کانال ناقص، کلید تکراری، پایهٔ نامعتبر یا نمودار ناقص اتوماسیون را اصلاح کنید.
- قالب نباید در کارهای روزمره دیده شود: آن را از تنظیمات آرشیو کنید. این کار دستگاه‌های فعال قالب را هم آرشیو می‌کند، پس ابتدا فهرست دستگاه‌ها را ببینید.
برای جزئیات فیلدهای کانال به کانال‌های داده بروید. مسیر کامل اتصال ESP32 در شروع سریع آمده است.