تحميل ubidots particle - تنزيل كود المصدر ubidots particle

ubidots particle

فئات أخرى

v3.1.4

تنزيل

جسيم

ستتعلم هنا كيفية إرسال البيانات إلى Ubidots باستخدام أجهزة Particle Photon أو Electron. كل ما تحتاجه هو تسمية المتغير والقيمة التي تريد إرسالها مع رمز Ubidots الصالح. بالإضافة إلى ذلك، يمكنك الحصول على القيمة الأخيرة للمتغير من حساب Ubidots الخاص بك.

متطلبات

جهاز الجسيمات
كابل مايكرو يو اس بي
اتصال بالإنترنت
ملاحظة: بالنسبة للإصدار الأخير من المكتبة، من الضروري أن يكون جهاز الجسيمات الخاص بك مزودًا بإصدار البرنامج الثابت 0.7.0 أو أعلى.

يثبت

قم بإعداد اتصال WiFi بالفوتون. هناك طريقتان للقيام بذلك:
- باستخدام هاتفك الذكي.
- توصيله بجهاز الكمبيوتر الخاص بك عبر USB.
بعد المطالبة بالفوتون الخاص بك وإعداد حساب Ubidots الخاص بك، دعنا ننتقل إلى Particle's Web IDE.
- في Particle's Web IDE، قم بإنشاء تطبيق جديد وقم بتعيين الاسم.
- انتقل إلى علامة تبويب المكتبة.
- في المكتبة المساهمة، اكتب Ubidots وحدد مكتبة Ubidots.
- انقر على تضمين في التطبيق . والعودة إلى "MYAPP.ino"

تقوم هذه المكتبة بإنشاء مصدر بيانات جديد بشكل افتراضي. سيكون اسم مصدر البيانات هذا هو "Particle" افتراضيًا، وستكون تسميته هي Particle ID.

الطريقة الافتراضية هي TCP، إذا كنت تريد تغييرها، فانتقل إلى أقسام الميزات واتبع المثال.

تحذير: حول شبكة الجسيمات

بعد الإعلان عن إهمال بروتوكول Particle Mesh IoT، حيث لم تعد Particle تنتج وحدات Mesh، قررت Ubidots التوقف عن دعمها خارج الصندوق في هذه المكتبة. إذا كنت لا تزال بحاجة إلى استخدام بروتوكول Mesh IoT في مشروعك بالتزامن مع مكتبتنا، فيرجى تجميع مشروعك من خلال Particle CLI مع الإصدار v3.1.4 من هذه المكتبة.

التوثيق

منشئ

أوبيدوتس

 Ubidots(char* token, UbiServer server, IotProtocol iot_protocol)

@الرمز المميز، [مطلوب]. الرمز المميز لحساب Ubidots الفريد الخاص بك.
@server، [اختياري]، [خيارات] = [ UBI_INDUSTRIAL ]، [افتراضي] = UBI_INDUSTRIAL .
@iot_protocol, [اختياري], [Options] = [ UBI_HTTP , UBI_TCP , UBI_UDP , UBI_PARTICLE ], [Default] = UBI_TCP . بروتوكول إنترنت الأشياء الذي ستستخدمه لإرسال البيانات أو استردادها.

إنشاء مثيل Ubidots.

ملحوظات

يرسل UBI_PARTICLE البيانات باستخدام خطافات الويب، لذا تأكد من اتباع التعليمات لإعداد خطاف الويب الخاص بك بشكل صحيح هنا.

طُرق

 void add(char *variable_label, float value, char *context, unsigned long dot_timestamp_seconds, unsigned int dot_timestamp_millis)

@variable_label، [مطلوب]. تسمية المتغير الذي سيتم تخزين النقطة فيه.
@القيمة، [مطلوب]. قيمة النقطة.
@السياق، [اختياري]. سياق النقطة.
@dot_timestamp_thanks، [اختياري]. الطابع الزمني للنقطة بالثواني.
@dot_timestamp_millis، [اختياري]. عدد الطابع الزمني للنقطة بالمللي ثانية. إذا لم يتم تعيين قيم المللي ثانية للطابع الزمني، فسيتم ضرب الثواني بـ 1000.

إضافة نقطة بقيمتها وسياقها وطابعها الزمني المرتبط بها ليتم إرسالها إلى مصدر بيانات معين، بمجرد استخدام add().

هام: الحد الأقصى لطول الحمولة هو 700 بايت، إذا كانت الحمولة الخاصة بك أكبر فلن يتم إرسالها بشكل صحيح. يمكنك أن ترى على وحدة التحكم التسلسلية الخاصة بك الحمولة التي سيتم إرسالها إذا قمت باستدعاء طريقة setDebug(bool debug) وتمرير قيمة حقيقية إليها.

 float get(const char* device_label, const char* variable_label)

@device_label، [مطلوب]. تسمية الجهاز الذي يحتوي على المتغير المراد استرداد القيم منه.
@variable_label، [مطلوب]. تسمية المتغير لاسترداد القيم منه.

يُرجع على شكل تعويم القيمة الأخيرة للنقطة من المتغير. IotProtocol getCloudProtocol()

 std::map<int, float> tcpMap getMultipleValues(const char* deviceLabel, const char* variableLabels)

@deviceLabel [إلزامي] المؤشر الذي يخزن تسمية الجهاز لاسترداد القيم منه.
@variableLabels [إلزامي] تسميات متغيرة مفصولة بفواصل لاسترداد القيم منها

تقوم بإرجاع قائمة خريطة مرتبة مع القيم التي تم استردادها لتسميات المتغيرات المتوفرة. يمكن الوصول إلى القيم عن طريق الفهرس، بدءًا من الموضع 0، ويتم تعيينها لكل مجموعة تسمية متغيرة في المصفوفة المفصولة بفواصل.

 void addContext(char *key_label, char *key_value)

@key_label، [مطلوب]. تسمية السياق الرئيسية لتخزين القيم.
@key_value، [مطلوب]. قيمة زوج المفاتيح.

يضيف إلى الذاكرة المحلية مفتاح سياق قيمة المفتاح الجديد. يجب أن تكون مدخلات الأسلوب عبارة عن مؤشرات char. تسمح الطريقة بتخزين ما يصل إلى 10 أزواج من قيمة المفتاح.

 void getContext(char *context)

@السياق، [مطلوب]. مؤشر char حيث سيتم تخزين السياق.

يبني السياق وفقًا للبروتوكول المختار ويخزنه في مؤشر حرف السياق.

 void setDebug(bool debug);;

@debug، [مطلوب]. نوع منطقي لإيقاف/تشغيل رسائل تصحيح الأخطاء.

إتاحة رسائل التصحيح من خلال المنفذ التسلسلي.

 bool send(const char* device_label, const char* device_name, PublishFlags flags);

@device_label، [اختياري]، [افتراضي] = معرف الجهاز الجزئي. تسمية الجهاز لإرسال البيانات. إذا لم يتم تعيينه، فسيتم استخدام معرف الجهاز الجزئي.
@device_name، [اختياري]، [افتراضي] = @device_label. تم تعيين اسم الجهاز بخلاف ذلك إذا لم يكن الجهاز موجودًا بالفعل في حساب Ubidots الخاص بك. إذا لم يتم تعيينه، فسيتم استخدام معلمة تسمية الجهاز. ملاحظة : يتم دعم اسم الجهاز فقط من خلال TCP/UDP، وإذا كنت تستخدم بروتوكولًا آخر، فسيكون اسم الجهاز هو نفس تسمية الجهاز.
@flags، [اختياري]، [خيارات] = [ PUBLIC ، PRIVATE ، WITH_ACK ، NO_ACK ]. أعلام خطاف الويب للجسيمات.

يرسل كافة البيانات المضافة باستخدام طريقة add(). يعود صحيحا إذا تم إرسال البيانات.