> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flova.ir/llms.txt
> Use this file to discover all available pages before exploring further.

# اولین دستگاه فلووا

> از ساخت Device Type تا اتصال اولین دستگاه با universal firmware.

این راهنما برای سریع‌ترین مسیر آزمایشی است: یک برد ESP32 یا ESP8266، یک
universal firmware و یک Device Type. در پایان باید دستگاه را از QR فعال کنید،
آن را آنلاین ببینید و یک مقدار را در dashboard تغییر دهید.

## ۱. Device Type را بسازید

در Console یک Device Type تازه بسازید. برای شروع دو datastream کافی است:

| کلید          | نوع  | حالت             | کاربرد      |
| ------------- | ---- | ---------------- | ----------- |
| `temperature` | عدد  | فقط خواندنی      | نمایش سنسور |
| `relay`       | بولی | خواندنی و نوشتنی | کنترل خروجی |

کلیدها باید با نامی که firmware یا mapping استفاده می‌کند دقیقاً یکی باشند.
واحد و بازهٔ مقدار را هم از ابتدا تعیین کنید؛ این اطلاعات بعداً برای فرم‌ها،
automation و widgetها استفاده می‌شود.

## ۲. Firmware را فلش کنید

برای برد انتخابی یکی از imageهای universal را بسازید و با USB روی برد فلش
کنید. universal firmware برای چنین شروعی مناسب است چون Wi-Fi، setup channel،
ذخیرهٔ تنظیمات، mappingهای پایه، OTA و چرخهٔ restart را خودش مدیریت می‌کند.
جزئیات نصب در [ساخت و فلش firmware](/docs/sdk/build-flash) آمده است.

## ۳. QR را در Console بسازید

در صفحهٔ Device Type گزینهٔ ساخت دستگاه یا provisioning را باز کنید. Console
یک QR مخصوص همان دستگاه می‌سازد. QR را مثل credential نگه دارید و آن را برای
دستگاهی که قرار است فعال شود استفاده کنید.

## ۴. گوشی را به دستگاه وصل کنید

اپ Flova یا PWA را باز کنید و QR را اسکن کنید. در حالت SoftAP، گوشی موقتاً به
شبکهٔ setup دستگاه وصل می‌شود و نام و گذرواژهٔ Wi-Fi خانه یا محل کار را به
دستگاه می‌دهد. دستگاه پس از ذخیرهٔ اطلاعات restart می‌شود، به Wi-Fi معمولی
می‌رود و اتصال خود را برقرار می‌کند.

در PWA، اگر مرورگر اجازهٔ تغییر خودکار شبکه را ندهد، مراحل اتصال به شبکهٔ
`Flova-Setup-*` را از تنظیمات Wi-Fi گوشی انجام دهید و به صفحهٔ setup برگردید.

## ۵. وضعیت را بررسی کنید

فعال‌شدن credential به‌تنهایی پایان کار نیست. دستگاه باید پس از restart نسخهٔ
پیکربندی را بازیابی و گزارش کند. وقتی این مرحله تمام شود، وضعیت دستگاه در
Console از provisioning یا verifying به online می‌رسد.

## بعد از اولین اتصال

* یک مقدار `temperature` گزارش کنید و آن را در dashboard ببینید.
* یک switch برای `relay` بسازید و مسیر نوشتن آن را امتحان کنید.
* یک automation ساده برای تغییر `relay` بسازید.
* تاریخچه را با [اولین query FlovaQL](/docs/flovaql/examples) بخوانید.

اگر به برنامهٔ Arduino موجود متصل می‌شوید، این راهنما را با [custom firmware](/docs/guides/custom-device)
ادامه دهید.