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

Onboarding ابزار فرزند

Onboarding مرحله‌ای است که Candidate محلی را به یک Child معتبر و Associated در AirNgin تبدیل می‌کند.

جریان Canonical​

Mobile: Add via Gateway
→ انتخاب Gateway مجاز
→ بازکردن HTML onboarding session
→ Discovery یا ورود دستی اطلاعات Native
→ Device lookup / Device definition
→ Compatibility check
→ جمع‌آوری gatewayConfig
→ up/onboard/req/AES
→ Backend authorization + Project rules
→ ایجاد/فعال‌سازی association
→ dn/onboard/rsp/{reqId}/AES
→ local activation + sync

Discovery با Onboarding فرق دارد​

Discovery فقط Candidate پیدا می‌کند. این موارد Authority ایجاد نمی‌کنند:

  • دیدن یک BLE advertisement
  • پیدا کردن Modbus slave
  • دریافت IP یا MAC
  • Device lookup
  • HTML temporary session

Association فقط بعد از موفقیت Backend Onboarding معتبر است.

same-Master​

اگر Child در Project دیگری است:

  • Unassigned → می‌تواند وارد Project مقصد شود.
  • Same Master + بدون Association فعال → Backend می‌تواند Project را جابه‌جا کرده و سپس Bind کند.
  • Same Master + Association فعال → اول Unbind صریح لازم است.
  • Different Master → Reject.

Reassociation​

Gateway A active association
→ explicit unbind
→ old row becomes historical
→ authorize/onboard Gateway B
→ create new active association

DeviceSerial و تاریخچه Child تغییر نمی‌کنند.

gatewayConfig​

برای هر Operation، تنظیمات Native موردنیاز Driver می‌تواند در parameterJson.gatewayConfig نگه‌داری شود؛ مثل driverKey, transport, protocol, busId, slaveId, register.

Backend این جزئیات Native را اجرا نمی‌کند؛ Driver روی Gateway آن‌ها را تفسیر می‌کند.