نحوه اتصال Mixed Input, 8-Channel Analog Cellular Logger به ThingsConnect

مقدمه

FDQ-99900 MI-8 یک سیستم جمع‌آوری داده (DAQ) کوچک و 24 بیتی است که برای اندازه‌گیری تا ده سنسور خارجی طراحی شده است. سپس مقادیر را به صورت محلی در یک کارت SD ذخیره می‌کند یا از طریق اتصال داده سلولار به ابر داده انتقال می‌دهد.
قابلیت‌های پیشرفته‌ای که به آن امکان‌پذیری را می‌دهد، به MI-8 این امکان را می‌دهد که با فقط انتقال رویدادهای مورد علاقه، فضای ذخیره سازی و داده شبکه را صرفه‌جویی کند.
مصرف توان پایین و دمای عملیاتی گسترده برای نصب‌های فضای باز و دورافتاده طراحی شده است.
MI-8 با و بدون یک جعبه در اختیار است که به حمایت از راه‌حل‌های بسته‌بندی سفارشی کمک می‌کند. به عنوان مثال، پیکربندی بدون جعبه (OEM) معمولاً به همراه سنسورها و سخت‌افزارهای پشتیبان درون یک جعبه NEMA با درجه‌بندی IP-67 نصب می‌شود.

در این راهنما، یاد می‌گیریم که چگونه دستگاه را در Thingsboard ایجاد کنیم.
سپس تنظیمات و اتصال دستگاه را پیکربندی کرده و داده‌ها را در ThingsBoard بررسی می‌کنیم.

پیش نیازها

برای ادامه کار با این راهنما، نیاز به موارد زیر داریم:

• Mixed Input, 8-Channel Analog Cellular Logger
• خواندن دفترچه راهنمای کاربر (اختیاری)
• حساب ThingsBoard

ایجاد دستگاه در ThingsBoard

به منظور سادگی، دستگاه را به صورت دستی با استفاده از رابط کاربری (UI) ارائه می‌دهیم.

• به نمونه ThingsBoard خود وارد شده و به صفحه “Entities” مراجعه کنید. سپس بر روی صفحه “Devices” کلیک کنید.
• بر روی آیکون “+” در گوشه بالا سمت راست جدول کلیک کرده و سپس “Add new device” را انتخاب کنید.
• نام دستگاه را وارد کنید. به عنوان مثال، “دستگاه من”. در این زمان تغییر دیگری لازم نیست. برای اضافه کردن دستگاه، بر روی “Add” کلیک کنید.
• دستگاه شما اضافه شده است.

//img

اتصال دستگاه به ThingsConnect

برای اتصال دستگاه به ThingsBoard، ابتدا باید اطلاعات احراز هویت دستگاه را دریافت کنید. ThingsBoard از انواع مختلف احراز هویت دستگاه پشتیبانی می‌کند. ما توصیه می‌کنیم از احراز هویت پیش‌فرض و خودکار استفاده کنید که یک توکن دسترسی است.

• برای باز کردن جزئیات دستگاه، بر روی ردیف دستگاه در جدول کلیک کنید.
• بر روی “Copy access token” کلیک کنید. توکن در کلیپ‌بورد شما کپی می‌شود. لطفاً آن را در یک مکان امن ذخیره کنید.

//img

با در دست داشتن توکن دسترسی، می‌توانیم MI-8 را پیکربندی کنیم.
تمامی دستگاه‌های MI-8 DAQ از طریق یک فایل در ریشه کارت SD خود به نام config.json پیکربندی می‌شوند.
در راهنمای کاربر MI-8، اطلاعات دقیقی برای ایجاد تغییرات در این فایل وجود دارد، اما برای این مثال ما بر روی فیلدهای نام و push تمرکز می‌کنیم.
این فیلدها در فایل پیکربندی وجود دارند.

{
   "name":"My MI-8 DAQ",
   "thermo_type":["k","k","k","k","k","k"],
   "num_thermo":3,
   "num_rtd":2,
   "ref_resistance":4000,
   "rtd_type":["pt100","pt100","pt100","pt100"],
   "rtd_connection":[4,4,4,4],
   "dig_in_mode":["pulldown","pulldown","pulldown"],
   "use_aux_header":false,
   "debug_level":255,
   "usb_mass_storage":true,
   "sleep_voltage":9.9,
   "wake_voltage":10.5,
   "display_sleep":10,
   "gnss_period":60,
   "flip_display":false,
   "network": {
      "apn":"hologram",
      "username":"",
      "password":""
   },
   "push": {
      "mode":"post",
      "path":"api/v1/YOUR_ACCESS_TOKEN/telemetry",
      "attributes_path":"api/v1/YOUR_ACCESS_TOKEN/attributes",
      "server": "demo.thingsboard.io",
      "port":80,
      "username":"",
      "password":"",
      "use_ssl":false,
      "use_json":true,
      "push_attributes":true,
      "include_name":false,
      "include_imei":false,
      "include_iccid":false,
      "track_min_max":false,
      "use_headers":false
   },
   "trigger":[ {
      "name":"Default",
      "channels":"ambient,tc0,tc1,tc2,rtd0,rtd1,an0,lat,lon,alt,vbat,rssi",
      "log_period":60,
      "push_period":300,
      "start_delay":0,
      "stop_delay":0,
      "condition":"1",
      "append_log":true
   }]
}

پارامترهای لازم برای تغییر برای اتصال:

//جدول

سایر پارامترهای پیکربندی:

• فیلد نام (name) اختیاری است. این نام در صفحه نمایش OLED MI-8 نمایش داده می‌شود و به عنوان یک ویژگی دستگاه به ThingsBoard ارسال می‌شود. بهتر است نام موجود در config.json با نام دستگاه در ThingsBoard مطابقت داشته باشد، اما این الزامی نیست. فیلد نام برای ارتباط داده‌های تلمتری بین MI-8 و ThingsBoard استفاده نمی‌شود. تنها به عنوان کمکی برای کاربر است.
• فیلد push اتصال به سرورهای ThingsBoard را توصیف می‌کند. در این مثال، از درخواست‌های HTTP POST (“mode”: “post”) استفاده می‌شود. پروتکل MQTT نیز پشتیبانی می‌شود، اما POST کمترین مصرف داده‌ی سلولار را دارد. آدرس URL درخواست HTTP از طریق فیلدهای server، port، use_ssl و path/attributes_path ساخته می‌شود.
• فیلد use_ssl نشان می‌دهد که از پروتکل HTTP یا HTTPS استفاده می‌شود. فیلد server همه چیز بین دو نقطه دوتایی (//) و نقطه سه‌گانه است. سپس پورت و یک خط کج دیگر آمده است. هر چیزی که بعد از آن قرار دارد، مسیر است.
• push_attributes را برابر true قرار دهید تا ویژگی‌ها (مانند شماره IMEI MI-8 که به طور مکرر تغییر نمی‌کنند) هر بار روشن شدن دستگاه یکبار به ThingsBoard ارسال شوند.
• use_json را برابر true قرار دهید. تمام داده‌های ارسال شده به ThingsBoard باید به صورت JSON فرمت‌بندی شوند.
• use_headers را برابر false قرار دهید. هدرهای HTTP برای ThingsBoard لازم نیستند، اما هر بار ارسال، مصرف داده‌ی سلولار اضافی را به همراه دارند.
• می‌توانید include_name، include_imei و include_iccid را برابر false قرار دهید. این فیلدها باعث اضافه شدن ICCID، IMEI و نام MI-8 در دستگاه تلمتری می‌شوند که ممکن است مصرف داده‌ی سلولار اضافی داشته باشد. اینها نیازی به اینجا وجود ندارند زیرا هر بار با توجه به یک درخواست HTTP جداگانه برای ویژگی‌ها به ThingsBoard ارسال می‌شوند.

بعد از اضافه کردن یا تغییر فایل پیکربندی، مراحل زیر را انجام دهید:

• فایل config.json را ذخیره کنید.
• کامپیوتر را از پورت USB MI-8 قطع کنید (اگر متصل و حافظه جمع‌آوری فعال باشد).
• MI-8 را راه‌اندازی کنید تا تنظیمات جدید اعمال شود.

بررسی داده ها در ThingsConnect

در این نقطه، MI-8 باید پیکربندی شده و آماده برقراری ارتباط با ThingsBoard باشد.
برای بررسی داده‌های ورودی، می‌توانید مراحل زیر را انجام دهید:

• به ThingsBoard وارد شوید و سپس به بخش گروه‌های دستگاه و سپس همه مراجعه کنید.
• روی دستگاهی که به تازگی به MI-8 اختصاص داده شده است کلیک کنید و سپس به بخش Latest Telemetry منتقل شوید.

//img

• همچنین می‌توانید ویژگی‌های دریافتی از دستگاه را بررسی کنید. برای این کار، به بخش Attributes منتقل شوید.
  ویژگی‌ها داده‌های اضافی هستند که از MI-8 به ThingsBoard ارسال می‌شوند و به طور معمول ثابت هستند و تغییر نمی‌کنند، مانند شماره IMEI مودم، شناسه SIM (ICCID) و نسخه firmware MI-8.

//img
تمام مقادیر سنسورهای پیکربندی شده در تریگر فعال MI-8 باید پس از روشن شدن MI-8 و برقراری اتصال سلولار حاضر باشند.
توجه کنید که مقادیر GPS تنها پس از اولین پیدایش GPS ارسال می‌شوند، که ممکن است بسته به مدت زمان از پیش رفته و فاصله‌ی MI-8 از پیشینه‌ی آخر، چند دقیقه طول بکشد.
مقادیر GPS (lat، lon و alt) تنها پس از حداقل یک بار ارسال شدن ظاهر می‌شوند.

نتیجه‌گیری

با دانش مشخص شده در این راهنما، می‌توانید به راحتی دستگاه Mixed Input، 8-Channel Analog Cellular Logger خود را به ThingsBoard متصل کرده و داده‌ها را ارسال کنید.

با مرور مستندات پلتفرم، می‌توانید بیشتر در مورد مفاهیم و ویژگی‌های کلیدی آن بیاموزید. به عنوان مثال، تنظیم قوانین هشدار یا داشبوردها.