افزودن و اتصال دستگاه

گام اول: اضافه کردن دستگاه‌

 

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

• بعد از ورود به پلتفرم، به صفحه گروه‌های دستگاه‌ (Device Groups) مراجعه کنید.

• روی گروه ALL کلیک کنید، سپس در منوی باز شده با کلیک کردن روی دکمه باز کردن گروه دستگاه (Open Device Group) وارد صفحه دستگاه‌های زیرمجموعه این گروه شوید.

• در گوشه سمت راست و بالای صفحه، روی آیکن + کلیک کنید. سپس روی ایجاد یک دستگاه جدید (Create new device) کلیک کنید.

• نام دستگاه را وارد کنید. به عنوان مثال می‌توانید از MyNewDevice استفاده کنید. در این گام تغییرات دیگری مورد نیاز نیست و می‌توانید روی دکمه Add کلیک کنید تا دستگاه مورد نظر اضافه شود.

• از آن‌جایی که تینگزپاد به صورت پیش‌فرض لیست دستگاه‌ها را بر اساس زمان اضافه شدن آن‌ها مرتب می‌کند، دستگاهی که اضافه شد باید در ردیف اول قرار گرفته باشد.

 

 

گام دوم: اتصال دستگاه به پلتفرم

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

• روی ردیف دستگاه در لیست دستگاه‌ها کلیک کنید تا منوی جزئیات دستگاه برای شما نمایش داده شود.

• روی دکمه کپی کلید اعتباری (Copy access token) کلیک کنید تا توکن مورد نظر کپی شود. این توکن را می‌توانید در محلی امن ذخیره و نگهداری کنید.

 

 

حالا با داشتن این توکن شما قادر خواهید بود در نقش یک دستگاه، اطلاعاتی را به پلتفرم ارسال کنید. در اینجا با به کارگیری دستورات ساده‌ای، اطلاعاتی را از طریق MQTT و HTTP ارسال می‌کنیم.

 

۱. ارسال با HTTP

 

این شیوه ارسال در لینوکس، ویندوز و مک قابل استفاده می‌باشد.

برای نصب cURL در لینوکس از دستور زیر استفاده کنید:

 

Copysudo apt-get install curl        

 

برای نصب cURL در مک از دستور زیر استفاده کنید:

 

Copybrew install curl        

 

برای نصب cURL در ویندوز باید در نظر داشته باشید که این ابزار در ویندوز 10، ویرایش b17063 و بعد از آن، به صورت پیش‌فرض در دسترس است. اما در صورتی که از ویرایش قدیمی‌تری از ویندوز استفاده می‌کنید، می‌توانید بر اساس راهنمایی‌های وبسایت رسمی محصول در اینجا، آن را نصب کنید.

این دستور برای سیستم‌عامل‌های ویندوز، اوبونتو (لینوکس) و مک با در نظر داشتن اینکه ابزار cURL از قبل روی آن نصب باشد به خوبی کار خواهد کرد. لطفا مقدار ACCESS_TOKEN$ را با توکنی که از منوی جزئیات دستگاه کپی کردید جایگزین کنید.

 

Copycurl -v -X POST -d "{\"temperature\": 25}" https://thingspod.com/api/v1/$ACCESS_TOKEN/telemetry --header "Content-Type:application/json"        

 

به عنوان مثال، در صورتی که توکن یک دستگاه، abcdefABCDEF باشد، دستور بالا به صورت زیر خواهد بود:

 

Copycurl -v -X POST -d "{\"temperature\": 25}"  https://thingspod.com/api/v1/abcdefABCDEF/telemetry --header "Content-Type:application/json"        

 

وقتی که اطلاعاتی را با کلید temperature به پلتفرم ارسال کردید، می‌توانید اطلاعات دریافت شده را در بخش آخرین داده‌ها (Latest telemetry) دستگاه مشاهده کنید.

• روی ردیف دستگاه در لیست دستگاه‌ها کلیک کنید تا منوی جزئیات دستگاه برای شما نمایش داده شود.

• به بخش آخرین داده‌ها (Latest telemetry) مراجعه کنید.

 

 

۲. ارسال با MQTT در مک و لینوکس

 

برای نصب کلاینت MQTT در لینوکس از دستور زیر استفاده کنید:

 

Copysudo apt-get install mosquitto-clients        

 

برای نصب کلاینت MQTT در مک از دستور زیر استفاده کنید:

 

Copybrew install mosquitto-clients        

 

برای ارسال اطلاعات، مقدار ACCESS_TOKEN$ را با توکنی که از منوی جزئیات دستگاه کپی کردید جایگزین کنید. سپس آن را اجرا کنید.

 

Copymosquitto_pub -d -q 1 -h "thingspod.com" -p "31883" -t "v1/devices/me/telemetry" -u "$ACCESS_TOKEN" -m "{"temperature":25}"        

 

به عنوان مثال، در صورتی که توکن یک دستگاه، abcdefABCDEF باشد، دستور بالا به صورت زیر خواهد بود:

 

Copymosquitto_pub -d -q 1 -h "thingspod.com" -p "31883" -t "v1/devices/me/telemetry" -u "abcdefABCDEF" -m "{"temperature":25}"        

 

خروجی مورد انتظار باید به صورت زیر باشد:

 

CopyClient mosqpub|xxx sending CONNECT        
Client mosqpub|xxx received CONNACK
Client mosqpub|xxx sending PUBLISH (d0, q1, r0, m1, 'v1/devices/me/telemetry', ... (16 bytes))
Client mosqpub|xxx received PUBACK (Mid: 1)
Client mosqpub|xxx sending DISCONNECT

 

وقتی که اطلاعاتی را با کلید temperature به پلتفرم ارسال کردید، می‌توانید اطلاعات دریافت شده را در بخش آخرین داده‌های دستگاه مشاهده کنید.

• روی ردیف دستگاه در لیست دستگاه‌ها کلیک کنید تا منوی جزئیات دستگاه برای شما نمایش داده شود.

• به صفحه آخرین داده‌ها (Latest telemetry) مراجعه کنید.

 

 

۳. ارسال با MQTT در ویندوز

 

از سایت mqttx.app، نرم‌افزار MQTTX را دانلود کرده و نصب کنید. موارد زیر را انجام دهید:

• نرم‌افزار MQTTX را باز کنید.
• یک Connection جدید ایجاد کنید.
• بر اساس تنظیمات تصویر زیر، نرم افزار را پیکربندی کنید.

 

 

• کد اعتباری (Access token) را در کادر username وارد کنید.

• با کلیک کردن بر روی گزینه Connect به پلتفرم متصل شوید

 

تاپیک و محتوای پیام را وارد کنید. مطمئن شوید محتوای پیام یک سند JSON معتبر باشد و روی دکمه ارسال کلیک کنید.

 

 

وقتی که اطلاعاتی را با کلید temperature به پلتفرم ارسال کردید، می‌توانید اطلاعات دریافت شده را در بخش آخرین داده‌ها (Latest telemetry) دستگاه مشاهده کنید.

• روی ردیف دستگاه در لیست دستگاه‌ها کلیک کنید تا منوی جزئیات دستگاه برای شما نمایش داده شود.

• به بخش آخرین داده‌ها (Latest telemetry) مراجعه کنید.