شروع کار با AirNgin
AirNgin یک پلتفرم اینترنت اشیا برای ثبت و مدیریت ابزار، ارتباط ابری، MQTT، سناریو، تنظیمات اختصاصی، داده و یکپارچهسازی ابزارهای مستقیم و گیتوی است.
اگر برای اولین بار وارد مستندات شدهاید، از این صفحه شروع کنید و سپس متناسب با نوع محصول خود مسیر مناسب را ادامه دهید.
مسیر مناسب را انتخاب کنید
ابزار مستقیم
اگر ابزار ش ما خودش به اینترنت و سرور AirNgin متصل میشود، مسیر ابزار مستقیم را دنبال کنید:
- ثبت ابزار
- آشنایی با MQTT
- اتصال به سرور MQTT
- مرجع کامل Topicهای Direct Device
- ورود ابزار به MQTT
- Publish و Subscribe
- امنیت ابزار
گیتوی دستگاه
اگر بعضی ابزارهای شما مستقیماً به AirNgin متصل نمیشوند و باید از طریق یک ابزار واسط مدیریت شوند، از معماری گیتوی دستگاه استفاده کنید.
در این معماری، خود گیتوی یک ابزار واقعی با هویت مستقل AirNgin است و ابزارهای فرزند نیز هویت و DeviceSerial مستقل خودشان را دارند. ارتباط ابری ابزار فرزند از مسیر گیتوی انجام میشود، اما ابزار فرزند در سامانه یک موجودیت مستقل باقی میماند.
قابلیتهای مهم پلتفرم
بعد از اتصال اولیه میتوانید بسته به محصول خود از بخشهای زیر استفاده کنید:
- تنظیمات اختصاصی ابزار
- سناریوهای درونابزاری
- دریافت زمان از سرور
- دیتابیس ابری
- آزمایشگاه و ابزارهای تست
- درگاه پیامکی و Push Notification
- ESP32
ثبتنام بهعنوان تولیدکننده
برای تعریف محصول و ابزار در AirNgin ابتدا وارد پنل شوید. در اولین ورود، پس از تأیید شماره تلفن باید اطلاعات مرکز تولیدکننده/تأمینکننده را تکمیل کنید.
در مرحله احراز هویت، اطلاعات هویتی را با دقت ثبت کنید و مطمئن شو ید مالکیت شماره تلفن و اطلاعات ثبتشده با فرآیند احراز هویت سازگار است.

چند نکته قبل از شروع توسعه Firmware
DeviceSerialهویت ابزار در AirNgin است؛ آن را با آدرس داخلی پروتکلهایی مثل Modbus/BLE/CAN یکی نکنید.- ابزار مستقیم و ابزار متصل از طریق گیتوی دو مسیر ارتباطی متفاوت دارند؛ Topicهای MQTT آنها را با هم مخلوط نکنید.
- مقادیر امنیتی و ClientId را از سرور دریافت و همان مقدار صادرشده را نگهداری کنید؛ آنها را در Firmware از روی حدس یا الگوی ظاهری بازسازی نکنید.
- در زمان قطع اینترنت، منطق اصلی و کنترل محلی محصول نباید فقط بهخاطر در دسترس نبودن AirNgin متوقف شود.