شروع سریع
در حدود ده دقیقه یک ESP32 را به فلووا وصل کنید و LED داخلی آن را از داشبورد کنترل کنید.
در این راهنما یک برد ESP32 را به فلووا وصل می‌کنید و LED داخلی آن را از داشبورد روشن و خاموش می‌کنید.
پیش از شروع، این موارد را آماده کنید:
- یک برد ESP32 که LED داخلی آن روی
GPIO2قرار دارد - کابل USB دارای انتقال داده
- تلفن یا رایانهٔ متصل به Wi-Fi
- PlatformIO یا Arduino IDE برای نصب و فلش میان‌افزار
۱. حساب و قالب دستگاه را بسازید
به کنسول فلووا بروید و یک حساب بسازید. در فلووا، نوع دستگاه (Device Type) همان قالب دستگاه (template) است که بخش‌های مختلف پلتفرم را به هم وصل می‌کند. دستگاه‌ها، داشبوردها، کوئری‌ها، اتوماسیون‌ها و همهٔ بخش‌های دیگر پلتفرم به همین قالب متصل هستند.
پس از ورود، یک نوع دستگاه با نام ESP32 LED بسازید و روش راه‌اندازی را روی Wi-Fi بگذارید.
این روش همان SoftAP (اتصال موقت) است که در ادامه برای فرستادن اطلاعات Wi-Fi
استفاده می‌کنیم.
در صفحهٔ کانال‌های داده، یک کانال با مشخصات زیر اضافه کنید:
| فیلد | مقدار |
|---|---|
| نام کانال | LED داخلی |
| کلید فنی | LED |
| نوع مقدار | روشن / خاموش |
| نوع تبادل | خواندن و نوشتن |
| نوع اتصال | خروجی دیجیتال |
| پایهٔ سخت‌افزار | GPIO2 |
| سطح فعال | HIGH |
| وضعیت اولیه و امن | خاموش |
کلید فنی را دقیقاً LED وارد کنید. داشبورد بعداً با همین کلید به LED دستگاه
وصل می‌شود. سپس روی انتشار نسخه بزنید و بعد ادامه دهید. فلووا تا وقتی نوع
دستگاه منتشر نشده باشد، اجازهٔ ساخت دستگاهی از آن را نمی‌دهد.
۲. میان‌افزار عمومی را روی ESP32 نصب کنید
ابتدا یک پوشهٔ پروژه بسازید، بستهٔ منتشرشدهٔ FlovaSDK را نصب کنید، کد
میان‌افزار عمومی را در پروژه بگذارید و سپس برد را از طریق USB فلش کنید. مسیر
مناسب خود را انتخاب کنید.
برای اطلاعات بیشتر و دیدن مثال‌ها به مخزن فریم‌ور فلووا مراجعه کنید.
یک اسکچ جدید Arduino بسازید و آن را در یک پوشهٔ جدید، مثلاً flova-esp32،
ذخیره کنید. پیش از نصب SDK، از مسیر Tools → Board → Boards Manager عبارت
esp32 از Espressif Systems را جست‌وجو و بستهٔ پشتیبانی بردهای ESP32 را نصب
کنید. سپس از مسیر Tools → Manage Libraries عبارت FlovaSDK را جست‌وجو و
آن را نصب کنید.
از مسیر Tools → Board برد ESP32 متناسب با سخت‌افزار خود را انتخاب کنید و در مسیر Tools → Port درگاه سریال USB را انتخاب کنید. کد اسکچ را با این کد جایگزین کنید:
#include <Arduino.h>
#include <FlovaSDK.h>
FlovaUniversalEsp32 device;
void setup() {
Serial.begin(115200);
device.begin();
}
void loop() {
device.run();
}برد را با یک کابل USB داده وصل کنید و روی Upload بزنید. Arduino IDE اسکچ را کامپایل می‌کند و تصویر کامل میان‌افزار، شامل bootloader و جدول پارتیشن، را روی برد فلش می‌کند.
این میان‌افزار در اولین اجرا یک شبکهٔ موقت با نامی شبیه Flova-Setup-* می‌سازد.
نام و گذرواژهٔ Wi-Fi را در مرحلهٔ راه‌اندازی وارد می‌کنید، پس لازم نیست آن‌ها را
داخل کد بنویسید.
۳. دستگاه را بسازید
به صفحهٔ دستگاه‌ها در کنسول برگردید، همان نوع
دستگاه را باز کنید و افزودن دستگاه را انتخاب کنید.
یک نام مثل چراغ آزمایشی وارد کنید و دستگاه را بسازید. کنسول برای آن یک QR و
یک کد دستی فعال‌سازی نشان می‌دهد.
۴. دستگاه را در وب اپلیکیشن به حساب خود اضافه کنید
به وب اپلیکیشن فلووا بروید و وارد حساب کاربری شوید. این وب اپلیکیشن فضای کاربری (user space) فلوواست و با فضای کاری (workspace) شما در کنسول و استودیو فرق دارد. شما در فضای کاری نوع دستگاه و داشبورد را می‌سازید؛ مشتریان و کاربران نهایی از وب اپلیکیشن برای اضافه کردن دستگاه‌هایشان و دیدن داشبوردهایی استفاده می‌کنند که برای محصولات و تجربه‌های شما ساخته‌اید.
از بخش افزودن دستگاه دوربین را باز کنید، QR ساخته‌شده در کنسول را اسکن کنید، نامی برای دستگاه انتخاب کنید و ادامه دهید.
اگر دوربین در دسترس نیست، گزینهٔ ورود دستی فعال‌سازی را انتخاب کنید و کدی را که کنسول نشان می‌دهد وارد کنید.
دستگاه به حساب کاربری واردشده اضافه می‌شود. برای تنظیم Wi-Fi، وقتی وب اپلیکیشن
وارد مرحلهٔ راه‌اندازی شد، تلفن یا رایانه را به شبکه‌ای که نامش با
Flova-Setup- شروع می‌شود وصل کنید. سپس به وب اپلیکیشن برگردید، نام و گذرواژهٔ
Wi-Fi معمولی خود را در فرم وارد کنید و ارسال را بزنید.
وب اپلیکیشن صفحهٔ راه‌اندازی محلی دستگاه را باز می‌کند و اطلاعات را به ESP32 می‌فرستد. پس از دیدن پیام پذیرش، تلفن یا رایانه را دوباره به Wi-Fi معمولی و اینترنت برگردانید.
ESP32 تنظیمات را ذخیره می‌کند، راه‌اندازی مجدد می‌شود و به فلووا وصل می‌شود. در کنسول، وضعیت دستگاه باید از راه‌اندازی و همگام‌سازی به آنلاین برسد.
اگر وب اپلیکیشن دستگاه را پیدا نکرد، بررسی کنید که تلفن یا رایانه هنوز به شبکهٔ
Flova-Setup-* وصل باشد. مرورگر باید روی همان شبکهٔ محلی باشد تا به صفحهٔ
راه‌اندازی ESP32 دسترسی داشته باشد.
۵. داشبورد کنترل LED را بسازید
به استودیو بروید و داشبورد جدید را انتخاب کنید.
یک نام وارد کنید، در بخش قالب دستگاه، ESP32 LED را انتخاب کنید و در بخش
طرح آغازین، گزینهٔ نمای کلی دستگاه را بگذارید. سپس داشبورد را ایجاد کنید.
در ویرایشگر، پنل ویجت‌ها را باز کنید و یک Toggle به صفحه اضافه کنید.
Toggle را انتخاب کنید، به تنظیمات اتصال داده بروید و در انتخاب منبع مقدار،
گزینهٔ LED داخلی را انتخاب کنید. توضیح این گزینه باید کلید فنی LED، نوع
روشن / خاموش و دسترسی خواندن و نوشتن را نشان دهد. این کانال با همین تنظیمات در
بخش ۱ ساخته شد.
صبر کنید پیش‌نویس ذخیره شود و سپس روی انتشار بزنید. وب اپلیکیشن فقط داشبوردهای منتشرشده را نمایش می‌دهد؛ ذخیره شدن پیش‌نویس به‌تنهایی آن را روی دستگاه در دسترس نمی‌کند.
به وب اپلیکیشن فلووا برگردید، دستگاهی را که به حساب
اضافه کردید باز کنید و داشبورد آن را ببینید. Toggle را تغییر دهید و روشن و خاموش
شدن LED داخلی را بررسی کنید. وب اپلیکیشن نوشتن مقدار LED را از طریق فلووا لینک
به دستگاه می‌فرستد و میان‌افزار عمومی آن را روی GPIO2 اعمال می‌کند.
اگر LED در فهرست انتخاب منبع مقدار دیده نمی‌شود، منتشر بودن نسخهٔ نوع دستگاه
ESP32 LED و یکسان بودن قالب دستگاه داشبورد با همان نوع دستگاه را بررسی کنید.
اگر داشبورد در صفحهٔ دستگاه دیده نمی‌شود، انتشار داشبورد و بارگذاری دوبارهٔ صفحهٔ
دستگاه را بررسی کنید.
اگر چیزی درست پیش نرفت
اگر دستگاه آنلاین نمی‌شود، اول اتصال Wi-Fi و برگشتن از شبکهٔ Flova-Setup-* به
اینترنت را بررسی کنید. اگر Toggle تغییر نمی‌کند، منتشر بودن نوع دستگاه و داشبورد
و یکسان بودن کلید LED در نوع دستگاه و اتصال استودیو را بررسی کنید. برای خطاهای
مراحل بعدی، وضعیت دستگاه را در کنسول ببینید.