پرش به مطلب اصلی

گیت‌وی دستگاه در AirNgin

گیت‌وی دستگاه برای محصولاتی است که یک یا چند Child Device را روی شبکه یا باس محلی مدیریت می‌کنند و فقط خود Physical Gateway به Cloud AirNgin متصل می‌شود.

تفاوت با درگاه پیامک

در این بخش «گیت‌وی» یعنی Device Gateway / گیت‌وی دستگاه. این مفهوم با درگاه پیامکی و Push Notification متفاوت است.

از کجا شروع کنم؟​

اگر در حال توسعه Firmware هستید، این ترتیب پیشنهاد می‌شود:

  1. معماری و هویت
  2. Provisioning و اتصال Cloud
  3. مرجع کامل MQTT Topicهای Gateway
  4. امنیت و AES
  5. Onboarding ابزار فرزند
  6. Driver، Protocol و Compatibility
  7. Discovery
  8. Command و Execution ACK
  9. Shadow، Telemetry و Event
  10. Hybrid Sync API
  11. HTML Live MQTT
  12. Gateway Analyzer
  13. Offline-first Runtime
  14. Backend Association
  15. چک‌لیست پیاده‌سازی
  16. رفع اشکال

سه نقش مستقل​

Direct Device​

ابزاری که خودش با قرارداد Direct Device به AirNgin متصل می‌شود و Topicهای Direct Device را استفاده می‌کند.

Physical Gateway​

یک Device واقعی AirNgin با DeviceSerial مستقل است. تنها Principal دائمی MQTT/AES در معماری Gateway همین Physical Gateway است.

Child Device​

Child نیز Device مستقل AirNgin با DeviceSerial مستقل است، اما MQTT Credential مستقل برای مسیر Gateway ندارد. Cloud Traffic آن از طریق Gateway فعالش منتقل می‌شود.

معماری در یک نگاه​

AirNgin Cloud
    │
    │ Gateway MQTT + HTTPS
    ▼
Physical Gateway
    │
    ├── Gateway Driver ── Native Protocol ── Child A
    ├── Gateway Driver ── Native Protocol ── Child B
    └── Gateway Driver ── Native Protocol ── Child C

AirNgin یک Protocol واحد بین Gateway و Child تحمیل نمی‌کند. Driver می‌تواند Modbus، BLE، CAN، LAN یا Protocol اختصاصی تولیدکننده را مدیریت کند.

قوانین کلیدی v1​

  • Gateway و Child هر دو از DeviceSerial استاندارد AirNgin استفاده می‌کنند.
  • DeviceSerial با ClientId، slaveId، MAC، IP یا آدرس Native یکی نیست.
  • هر Child در هر لحظه حداکثر یک Gateway فعال دارد.
  • Direct Device Topicها برای Childهای Gateway استفاده نمی‌شوند.
  • تمام Gateway Cloud Topicهای فعال با /AES محافظت می‌شوند.
  • HTML Live Topicها استثنا هستند: WSS/TLS + Temporary Credential و بدون /AES.
  • Analyzer فقط Uplink است؛ Downlink همیشه از Driver عبور می‌کند.
  • MQTT PUBACK موفقیت اجرای Command روی Child نیست.
  • قطع Cloud نباید Runtime محلی و Driverهای قبلاً Sync شده را متوقف کند.

وضعیت پیاده‌سازی​

این صفحات قرارداد Canonical Gateway v1 را توضیح می‌دهند. بعضی APIها/Topicها ممکن است قبل از پیاده‌سازی نهایی Backend/Firmware در محیط Production وجود نداشته باشند؛ در این صورت Contract این مستندات مرجع پیاده‌سازی است، نه ادعای وجود Runtime فعلی.