کانال‌های داده
کلید فنی، مقدار، دسترسی، مقدار اولیه و نگاشت سخت‌افزار را تعریف کنید.
کانال داده مقداری نام‌گذاری‌شده است که دستگاه گزارش می‌کند، دریافت می‌کند یا در تله‌متری ذخیره می‌شود. کنسول از آن در جزئیات دستگاه، داشبورد، اتوماسیون، تله‌متری و FlovaQL استفاده می‌کند.
افزودن کانال داده
۱. کنسول را باز کنید، یک قالب را انتخاب کنید و به کانال‌های داده بروید. ۲. افزودن کانال داده را بزنید. ۳. نام نمایشی و کلید فنی را وارد کنید. ۴. نوع مقدار و نوع تبادل را انتخاب کنید. ۵. اگر مقدار به ورودی یا خروجی فیزیکی مربوط است، نوع اتصال سخت‌افزار را انتخاب کنید. ۶. مقدار اولیه، مقدار امن، نمونه‌برداری و محدودیت‌های لازم را تنظیم کنید. ۷. کانال را ذخیره کنید و نسخهٔ قالب را از صفحهٔ نسخه‌ها منتشر کنید.
کلید فنی شناسهٔ ثابتی است که فریم‌ور، Studio، اتوماسیون، API و FlovaQL از آن استفاده می‌کنند. کلید باید با یک حرف انگلیسی شروع شود و فقط حروف انگلیسی، عدد و _ داشته باشد و حداکثر ۶۴ نویسه باشد. کلیدی مثل temperature_c یا LED بنویسید و نام فارسی کانال را جایگزین آن نکنید.
نوع مقدار و دسترسی
| فیلد | گزینه‌ها | کاربرد |
|---|---|---|
| نوع مقدار | روشن / خاموش، عدد، متن، ساختاریافته | شکل مقدار ارسالی یا ذخیره‌شده |
| نوع تبادل | فقط خواندن، فقط نوشتن، خواندن و نوشتن | مشخص می‌کند چه طرفی مقدار را گزارش یا تغییر دهد |
| واحد | برچسب کوتاه مثل °C یا % | نمایش و زمینهٔ کوئری |
| مقدار اولیه یا پیش‌فرض | مقدار هنگام شروع کانال | شروع قابل پیش‌بینی |
| مقدار امن | مقدار رفتار ایمن دستگاه | خروجی امن در شرایط لازم |
کنسول سازگاری اتصال سخت‌افزار، نوع مقدار و دسترسی را بررسی می‌کند. ورودی و خروجی دیجیتال مقدار روشن یا خاموش دارند. ورودی آنالوگ و خروجی PWM عددی هستند. وضعیت مجازی RGB یک مقدار ساختاریافتهٔ دوطرفه است.
برای سنسوری که فقط گزارش می‌دهد فقط خواندن را انتخاب کنید. برای فرمانی که دستگاه می‌پذیرد فقط نوشتن مناسب است. وقتی دستگاه وضعیت فعلی را گزارش می‌دهد و فلووا هم می‌تواند مقدار جدید بفرستد، خواندن و نوشتن را انتخاب کنید.
برای کانال‌های قابل نوشتن می‌توانید زمان‌بندی در وب اپلیکیشن را فعال کنید تا کاربر نهایی مقدار یا فرمان را برای زمان دیگری تنظیم کند.
اتصال کانال به سخت‌افزار
در نوع اتصال مشخص کنید فریم‌ور با کانال چه کند:
- ورودی دیجیتال: خواندن سیگنال روشن و خاموش از پایه.
- خروجی دیجیتال: نوشتن سیگنال روشن و خاموش روی پایه.
- ورودی آنالوگ: خواندن مقدار عددی ADC.
- خروجی PWM: نوشتن مقدار عددی شدت یا duty.
- وضعیت نرم‌افزاری و فرمان نرم‌افزاری: بدون نگاشت مستقیم GPIO.
- رنگ RGB: ذخیرهٔ رنگ ساختاریافته که مؤلفه‌های
r،gوbآن بین صفر تا ۲۵۵ هستند.
در پایهٔ سخت‌افزار مرجع پایهٔ برد را وارد کنید. بسته به فریم‌ور می‌توانید مقداری مثل D32، GPIO32، A0 یا ADC1_CH4 بنویسید. یک پایهٔ فیزیکی را در یک قالب به دو کانال ندهید. اگر مدار pull-up، pull-down یا فعال‌سازی با LOW دارد، همان گزینه را در فرم انتخاب کنید.
تنظیمات سخت‌افزار برای گزینه‌های عمومی برد است، مثل چراغ وضعیت و منبع بازنشانی کارخانه‌ای. این گزینه‌ها مستقل از کانال داده هستند.
مقدار فعلی و تاریخچه
کنسول دو نوع داده را نشان می‌دهد:
| نما | به چه پرسشی پاسخ می‌دهد؟ |
|---|---|
| مقدار فعلی | اکنون برای این دستگاه و کانال چه مقداری در دسترس است؟ |
| تاریخچه | در بازهٔ انتخابی چه مقدارها و رخدادهایی ثبت شده‌اند؟ |
مقدار فعلی ممکن است بدون ایجاد ردیف تاریخچه تغییر کند. آنلاین بودن دستگاه هم فقط حضور دستگاه را نشان می‌دهد و ثابت نمی‌کند که کانال مشخصی مقدار فرستاده است. برای تأیید ذخیره شدن تله‌متری، تاریخچه یا FlovaQL را بررسی کنید.
خطاهای اعتبارسنجی
- کلید نامعتبر: با حرف انگلیسی شروع کنید و فقط از حروف انگلیسی، عدد و
_استفاده کنید. - کلید تکراری: کلید هر کانال در همان قالب باید یکتا باشد.
- نوع مقدار نادرست: کانال دیجیتال را Boolean و کانال آنالوگ یا PWM را عددی انتخاب کنید.
- پایهٔ تکراری: پایهٔ استفاده‌شده را از کانال قبلی بردارید یا نگاشت دیگری انتخاب کنید.
- بازهٔ عددی نامعتبر: بیشینه باید از کمینه بزرگ‌تر باشد و مقدار اولیهٔ PWM داخل همین بازه قرار بگیرد.
- تغییر نکردن دستگاه: کانال را ذخیره، نسخهٔ قالب را منتشر و یکسان بودن کلید فریم‌ور و کنسول را بررسی کنید.
مثال‌های SDK و فریم‌ور را در مخزن فریم‌ور فلووا ببینید. Studio تعریف منتشرشدهٔ کانال را هنگام اتصال ویجت می‌خواند.