مشاركة عبر

البرنامج التعليمي: إرسال بيانات تتبع الاستخدام من جهاز IoT Plug and Play إلى Azure IoT Hub

استعراض التعليمة البرمجية

في هذا التشغيل السريع، تتعلم سير عمل أساسي لتطوير تطبيقات Azure IoT. يمكنك استخدام Azure CLI وIoT Explorer لإنشاء مركز Azure IoT وجهاز. ثم تستخدم عينة SDK لجهاز Azure IoT لتشغيل وحدة تحكم في درجة الحرارة، وتوصيلها بأمان بالمركز، وإرسال بيانات تتبع الاستخدام. يعمل تطبيق نموذج وحدة التحكم في درجة الحرارة على جهازك المحلي ويقوم بإنشاء بيانات مستشعر محاكاة لإرسالها إلى IoT Hub.

المتطلبات

يعمل هذا التشغيل السريع على أنظمة التشغيل Windows و Linux و Raspberry Pi. تم اختباره على إصدارات نظام التشغيل والأجهزة التالية:

  • نوافذ 10
  • أوبونتو 20.04 LTS
  • Raspberry Pi OS (Raspbian) الإصدار 10 ، يعمل على Raspberry Pi 3 Model B +

قم بتثبيت المتطلبات الأساسية التالية على جهاز التطوير الخاص بك باستثناء ما هو مذكور ل Raspberry Pi:

  • إذا لم يكن لديك اشتراك Azure، فأنشئ اشتراكاً مجاناً قبل البدء.
  • جيت.
  • Azure IoT Explorer: أداة مساعدة عبر الأنظمة الأساسية المستندة إلى واجهة المستخدم الرسومية لمراقبة Azure IoT وإدارته. إذا كنت تستخدم Raspberry Pi كنظام أساسي للتطوير، فإننا نوصي بتثبيت IoT Explorer على جهاز كمبيوتر آخر. إذا كنت لا ترغب في تثبيت IoT Explorer، فيمكنك استخدام Azure CLI لتنفيذ نفس الخطوات.
  • Azure CLI لديك خياران لتشغيل أوامر Azure CLI في هذا التشغيل السريع:
    • استخدم Azure Cloud Shell، وهو غلاف تفاعلي يقوم بتشغيل أوامر CLI في المستعرض الخاص بك. يوصى بهذا الخيار لأنك لست بحاجة إلى تثبيت أي شيء. إذا كنت تستخدم Cloud Shell لأول مرة، فقم بتسجيل الدخول إلى مدخل Microsoft Azure. اتبع الخطوات الواردة في بدء استخدام Azure Cloud Shellلبدء تشغيل Cloud Shellوتحديد بيئة Bash.
    • اختياريا، قم بتشغيل Azure CLI على جهازك المحلي. إذا كان Azure CLI مثبتا بالفعل، فقم بالتشغيل az upgrade لترقية واجهة سطر الأوامر (CLI) والملحقات إلى الإصدار الحالي. لتثبيت Azure CLI، راجع تثبيت Azure CLI. إذا كنت تستخدم Raspberry Pi كنظام أساسي للتطوير، فإننا نوصي باستخدام Azure Cloud Shell أو تثبيت Azure CLI على كمبيوتر آخر.

قم بتثبيت المتطلبات الأساسية المتبقية لنظام التشغيل الخاص بك.

Linux أو Raspberry Pi OS

لإكمال هذا التشغيل السريع على Linux أو Raspberry Pi OS ، قم بتثبيت البرنامج التالي:

قم بتثبيت GCCوGitوCMake والتبعيات المطلوبة باستخدام الأمر apt-get :

sudo apt-get update
sudo apt-get install -y git cmake build-essential curl libcurl4-openssl-dev libssl-dev uuid-dev

تحقق من أن إصدار CMake هو 3.13 أو أحدث، وأن إصدار GCC هو 4.4.7 أو أحدث.

cmake --version
gcc --version

Windows

لإكمال هذا التشغيل السريع على Windows، قم بتثبيت Visual Studio 2022 وإضافة المكونات المطلوبة لتطوير C وC ++.

  1. للمستخدمين الجدد، قم بتثبيت Visual Studio (المجتمع أو الاحترافي أو المؤسسة) 2022. قم بتنزيل الإصدار الذي تريد تثبيته ، وابدأ برنامج التثبيت.

    ملاحظة

    بالنسبة لمستخدمي Visual Studio 2022 الحاليين، حدد ابدأ Windows، واكتب Visual Studio Installer، وقم بتشغيل برنامج التثبيت، ثم حدد تعديل.

  2. في علامة التبويب أحمال عمل المثبت، حدد تطوير سطح المكتب مع حمل عمل C++‎ .
  3. شغّل التثبيت.

إنشاء مركز IoT

في هذا المقطع، يمكنك استخدام Azure CLI لإنشاء مركز IoT ومجموعة موارد. مجموعة موارد Azure هي حاوية منطقية يتم بها نشر موارد Azure وإدارتها. يعمل مركز إنترنت الأشياء كمركز رسائل مركزي للاتصال ثنائي الاتجاه بين تطبيق إنترنت الأشياء والأجهزة.

لإنشاء مركز IoT ومجموعة موارد:

  1. قم بتشغيل Azure CLI:

    • إذا كنت تستخدم Cloud Shell، فحدد الزر Try It في أوامر CLI لتشغيل Cloud Shell في نافذة مستعرض منقسمة. أو يمكنك فتح Cloud Shell في علامة تبويب مستعرض منفصلة.
    • إذا كنت تستخدم Azure CLI محليا، فافتح وحدة تحكم مثل Windows CMD أو PowerShell أو Bash وقم بتسجيل الدخول إلى Azure CLI.

    لتشغيل أوامر CLI في بقية هذا التشغيل السريع: انسخ بناء جملة الأمر، والصقه في نافذة Cloud Shell أو وحدة تحكم CLI، وقم بتحرير قيم المتغيرات، واضغط على Enter.

  2. قم بتشغيل «az extension add» لتثبيت أو ترقية ملحق azure-iot إلى الإصدار الحالي.

    az extension add --upgrade --name azure-iot

  3. قم بتشغيل الأمر az group create لإنشاء مجموعة موارد. يقوم الأمر التالي بإنشاء مجموعة موارد تسمى MyResourceGroup في موقعeastus.

    ملاحظة

    يمكنك اختياريا تعيين موقع بديل. لمشاهدة المواقع المتوفرة، قم بتشغيل az account list-locations. يستخدم هذا البرنامج التعليمي eastus كما هو موضح في أمر المثال.

    az group create --name MyResourceGroup --location eastus

  4. قم بتشغيل الأمر «az iot hub create» لإنشاء مركز IoT. قد يستغرق إنشاء مركز IoT بضع دقائق.

    اسم YourIotHub. استبدل هذا العنصر النائب والأقواس المحيطة في الأمر التالي، باستخدام الاسم الذي اخترته لمركز IoT. يجب أن يكون اسم مركز IoT فريدًا بشكل عمومي في Azure. استخدم اسم مركز IoT الخاص بك في بقية هذا التشغيل السريعة أينما رأيت العنصر النائب.

    az iot hub create --resource-group MyResourceGroup --name {YourIoTHubName}

    تلميح

    بعد إنشاء مركز IoT، ستستخدم Azure IoT Explorer للتفاعل مع مركز IoT في بقية هذا التشغيل السريع. IoT Explorer هو تطبيق واجهة المستخدم الرسومية (GUI) يتيح لك الاتصال بمركز IoT موجود وإضافة الأجهزة وإدارتها ومراقبتها. لمعرفة المزيد، راجع تثبيت مستكشف Azure IoT واستخدامه. اختياريا، يمكنك الاستمرار في استخدام أوامر CLI.

تكوين مستكشف IoT

في بقية هذا التشغيل السريع، يمكنك استخدام IoT Explorer لتسجيل جهاز في مركز IoT الخاص بك وعرض بيانات تتبع الاستخدام للجهاز. في هذا القسم، يمكنك تكوين IoT Explorer للاتصال بمركز IoT الذي قمت بإنشائه وقراءة نماذج التوصيل والتشغيل من مستودع النموذج العام.

ملاحظة

يمكنك أيضا استخدام Azure CLI لتسجيل جهاز. استخدم الأمر az iot hub device-identity create --device-id mydevice --hub-name {YourIoTHubName} لتسجيل جهاز جديد والأمر az iot hub device-identity connection-string show --device-id mydevice --hub-name {YourIoTHubName} للحصول على سلسلة الاتصال الأساسية للجهاز. بمجرد تدوين سلسلة اتصال الجهاز، يمكنك التخطي إلى الأمام إلى تشغيل نموذج الجهاز.

لإضافة اتصال إلى مركز IoT الخاص بك:

  1. قم بتشغيل الأمر az iot hub connection-string show للحصول على سلسلة الاتصال لمركز IoT الخاص بك.

    az iot hub connection-string  show --hub-name {YourIoTHubName}

  2. انسخ سلسلة الاتصال بدون أحرف الاقتباس المحيطة.

  3. في Azure IoT Explorer، حدد مراكز IoT في القائمة اليسرى، ثم حدد + إضافة اتصال.

  4. الصق سلسلة الاتصال في مربع سلسلة الاتصال .

  5. حدد حفظ..

    لقطة شاشة لإضافة اتصال في IoT Explorer

  6. إذا نجح الاتصال، ينتقل IoT Explorer إلى طريقة عرض الأجهزة .

عرض إعدادات مستودع النماذج العامة:

  1. في IoT Explorer، حدد الصفحة الرئيسية للعودة إلى طريقة العرض الرئيسية.

  2. في القائمة اليسرى، حدد IoT أجهزة التوصيل و التشغيل Settings.

  3. يمكنك رؤية إدخال موجود لمستودع النموذج العام في https://devicemodels.azure.com.

    لقطة شاشة لإضافة مستودع النموذج العام في IoT Explorer

تسجيل جهاز

في هذا القسم، يمكنك إنشاء مثيل جهاز جديد وتسجيله في مركز IoT الذي قمت بإنشائه. يمكنك استخدام معلومات الاتصال للجهاز المسجل حديثا لتوصيل جهازك بشكل آمن في قسم لاحق.

لتسجيل جهاز:

  1. من طريقة العرض الرئيسية في IoT Explorer، حدد مراكز IoT.

  2. يجب أن يظهر الاتصال الذي أضفته مسبقا. حدد عرض الأجهزة في هذا المركز أسفل خصائص الاتصال.

  3. حدد + جديد وأدخل معرف الجهاز لجهازك ؛ على سبيل المثال، MyDevice. اترك جميع الخصائص الأخرى دون تغيير.

  4. حدد إنشاء.

    لقطة شاشة لهوية جهاز Azure IoT Explorer

  5. انسخ القيمة وقم بتدوينها في حقل سلسلة الاتصال الأساسية . تحتاج إلى سلسلة الاتصال هذه لاحقا.

قم بتشغيل نموذج الجهاز

في هذا القسم، يمكنك استخدام C SDK لإرسال رسائل من جهاز إلى مركز IoT الخاص بك. يمكنك تشغيل عينة تنفذ وحدة تحكم في درجة الحرارة باستخدام مستشعري ترموستات.

إنشاء العينة

  1. افتح وحدة تحكم جديدة لتثبيت SDK لجهاز Azure IoT C وتشغيل نموذج التعليمات البرمجية. بالنسبة لنظام التشغيل Windows، حدد ابدأ، واكتب موجه أوامر المطور ل VS 2019، وافتح وحدة التحكم. بالنسبة لنظام التشغيل Linux وRaspberry Pi OS، افتح محطة طرفية لأوامر Bash.

    ملاحظة

    إذا كنت تستخدم تثبيتا محليا ل Azure CLI، فقد يكون لديك الآن نافذتان مفتوحتان لوحدة التحكم. تأكد من إدخال الأوامر الموجودة في هذا القسم في وحدة التحكم التي فتحتها للتو، وليس الأوامر التي كنت تستخدمها لواجهة سطر الأوامر (CLI).

  2. انتقل إلى مجلد محلي حيث تريد استنساخ نموذج المستودع.

  3. استنساخ SDK لجهاز Azure IoT C إلى جهازك المحلي:

    git clone https://github.com/Azure/azure-iot-sdk-c.git

  4. انتقل إلى المجلد الجذر ل SDK، وقم بتشغيل الأمر التالي لتحديث التبعيات:

    cd azure-iot-sdk-c
git submodule update --init

    تستغرق هذه العملية بضع دقائق.

  5. لإنشاء SDK والعينات، قم بتشغيل الأوامر التالية:

    cmake -Bcmake -Duse_prov_client=ON -Dhsm_type_symm_key=ON -Drun_e2e_tests=OFF
cmake --build cmake

  6. قم بتعيين متغيرات البيئة التالية، لتمكين جهازك من الاتصال ب Azure IoT.

    • قم بتعيين متغير بيئة يسمى IOTHUB_DEVICE_CONNECTION_STRING. بالنسبة لقيمة المتغير، استخدم سلسلة اتصال الجهاز التي قمت بحفظها في القسم السابق.
    • قم بتعيين متغير بيئة يسمى IOTHUB_DEVICE_SECURITY_TYPE. بالنسبة للمتغير ، استخدم قيمة connectionStringالسلسلة الحرفية .

    سي إم دي

    set IOTHUB_DEVICE_CONNECTION_STRING=<your connection string here>
set IOTHUB_DEVICE_SECURITY_TYPE=connectionString

    ملاحظة

    بالنسبة إلى Windows CMD ، لا توجد علامات اقتباس تحيط بقيم السلسلة لكل متغير.

    باش

    export IOTHUB_DEVICE_CONNECTION_STRING="<your connection string here>"
export IOTHUB_DEVICE_SECURITY_TYPE="connectionString"

تشغيل التعليمات البرمجية

  1. قم بتشغيل نموذج التعليمات البرمجية، باستخدام الأمر المناسب لوحدة التحكم الخاصة بك.

    سي إم دي

    cmake\iothub_client\samples\pnp\pnp_temperature_controller\Debug\pnp_temperature_controller.exe

    باش

    cmake/iothub_client/samples/pnp/pnp_temperature_controller/pnp_temperature_controller

    ملاحظة

    يستخدم نموذج التعليمات البرمجية هذا Azure IoT Plug and Play، والذي يتيح لك دمج الأجهزة الذكية في حلولك دون أي تكوين يدوي. بشكل افتراضي، تستخدم معظم العينات في هذه الوثائق IoT Plug and Play. لمعرفة المزيد حول مزايا IoT PnP، وحالات استخدامه أو عدم استخدامه، راجع ما هو IoT Plug and Play؟.

يتصل النموذج بأمان بمركز IoT الخاص بك كجهاز قمت بتسجيله ويبدأ في إرسال رسائل القياس عن بعد. يظهر نموذج الإخراج في وحدة التحكم الخاصة بك.

عرض بيانات تتبع الاستخدام

يمكنك عرض بيانات تتبع الاستخدام للجهاز باستخدام IoT Explorer. اختياريا، يمكنك عرض بيانات تتبع الاستخدام باستخدام Azure CLI.

لعرض بيانات تتبع الاستخدام في Azure IoT Explorer:

  1. من مركز IoT في IoT Explorer، حدد عرض الأجهزة في هذا المركز، ثم حدد جهازك من القائمة.

  2. في القائمة اليمنى لجهازك، حدد بيانات تتبع الاستخدام.

  3. تأكد من تعيين استخدام مركز الأحداث المضمن إلى نعم ثم حدد ابدأ.

  4. اعرض بيانات تتبع الاستخدام أثناء إرسال الجهاز رسائل إلى السحابة.

    لقطة شاشة لبيانات تتبع الاستخدام للجهاز في IoT Explorer

  5. حدد إيقاف لإنهاء أحداث الاستلام.

لقراءة بيانات تتبع الاستخدام المرسلة بواسطة مكونات الجهاز الفردية، يمكنك استخدام ميزات التوصيل والتشغيل في IoT Explorer. على سبيل المثال ، تحتوي وحدة التحكم في درجة الحرارة في هذا التشغيل السريع على اثنين من منظمات الحرارة: ترموستات 1 وترموستات 2. لمعرفة درجة الحرارة التي تم الإبلاغ عنها بواسطة منظم الحرارة 1:

  1. على جهازك في IoT Explorer، حدد مكونات IoT Plug and Play من القائمة اليسرى. ثم حدد منظم الحرارة 1 من قائمة المكونات.

  2. في جزء مكون منظم الحرارة1 ، حدد بيانات تتبع الاستخدام من القائمة العلوية.

  3. في جزء بيانات تتبع الاستخدام ، اتبع نفس الخطوات التي قمت بها سابقا. تأكد من تعيين استخدام مركز الأحداث المضمن إلى نعم ثم حدد ابدأ.

لعرض بيانات تتبع الاستخدام للجهاز باستخدام Azure CLI:

  1. قم بتشغيل الأمر az iot hub monitor-events لمراقبة الأحداث المرسلة من الجهاز إلى مركز IoT الخاص بك. استخدم الأسماء التي قمت بإنشائها مسبقا في Azure IoT لجهازك ومركز IoT.

    az iot hub monitor-events --output table --device-id mydevice --hub-name {YourIoTHubName}

  2. اعرض تفاصيل الاتصال وإخراج بيانات تتبع الاستخدام في وحدة التحكم.

    Starting event monitor, filtering on device: mydevice, use ctrl-c to stop...
event:
  component: ''
  interface: dtmi:com:example:TemperatureController;1
  module: ''
  origin: mydevice
  payload: '{"workingSet":1251}'

event:
  component: thermostat1
  interface: dtmi:com:example:TemperatureController;1
  module: ''
  origin: mydevice
  payload: '{"temperature":22.00}'

استعراض التعليمة البرمجية

في هذا التشغيل السريع، تتعلم سير عمل أساسي لتطوير تطبيقات Azure IoT. يمكنك استخدام Azure CLI وIoT Explorer لإنشاء مركز Azure IoT وجهاز. ثم تستخدم عينة SDK لجهاز Azure IoT لتشغيل وحدة تحكم في درجة الحرارة، وتوصيلها بأمان بالمركز، وإرسال بيانات تتبع الاستخدام. يعمل تطبيق نموذج وحدة التحكم في درجة الحرارة على جهازك المحلي ويقوم بإنشاء بيانات مستشعر محاكاة لإرسالها إلى IoT Hub.

المتطلبات

يعمل هذا التشغيل السريع على أنظمة التشغيل Windows و Linux و Raspberry Pi. تم اختباره على إصدارات نظام التشغيل والأجهزة التالية:

  • نوافذ 10
  • أوبونتو 20.04 LTS
  • Raspberry Pi OS (Raspbian) الإصدار 10 ، يعمل على Raspberry Pi 3 Model B +

قم بتثبيت المتطلبات الأساسية التالية على جهاز التطوير الخاص بك باستثناء ما هو مذكور ل Raspberry Pi:

  • إذا لم يكن لديك اشتراك Azure، فأنشئ اشتراكاً مجاناً قبل البدء.
  • جيت.
  • .NET 6.0 SDK. تأكد من تثبيت .NET SDK، وليس وقت التشغيل فقط. للتحقق من إصدار .NET SDK ووقت التشغيل المثبت على جهازك، قم بتشغيل dotnet --info.
  • Azure IoT Explorer: أداة مساعدة عبر الأنظمة الأساسية المستندة إلى واجهة المستخدم الرسومية لمراقبة Azure IoT وإدارته. إذا كنت تستخدم Raspberry Pi كنظام أساسي للتطوير، فإننا نوصي بتثبيت IoT Explorer على جهاز كمبيوتر آخر. إذا كنت لا ترغب في تثبيت IoT Explorer، فيمكنك استخدام Azure CLI لتنفيذ نفس الخطوات.
  • Azure CLI لديك خياران لتشغيل أوامر Azure CLI في هذا التشغيل السريع:
    • استخدم Azure Cloud Shell، وهو غلاف تفاعلي يقوم بتشغيل أوامر CLI في المستعرض الخاص بك. يوصى بهذا الخيار لأنك لست بحاجة إلى تثبيت أي شيء. إذا كنت تستخدم Cloud Shell لأول مرة، فقم بتسجيل الدخول إلى مدخل Microsoft Azure. اتبع الخطوات الواردة في بدء استخدام Azure Cloud Shellلبدء تشغيل Cloud Shellوتحديد بيئة Bash.
    • اختياريا، قم بتشغيل Azure CLI على جهازك المحلي. إذا كان Azure CLI مثبتا بالفعل، فقم بالتشغيل az upgrade لترقية واجهة سطر الأوامر (CLI) والملحقات إلى الإصدار الحالي. لتثبيت Azure CLI، راجع تثبيت Azure CLI. إذا كنت تستخدم Raspberry Pi كنظام أساسي للتطوير، فإننا نوصي باستخدام Azure Cloud Shell أو تثبيت Azure CLI على كمبيوتر آخر.

مهم

يجب عليك استخدام .NET 6.0 SDK لإنشاء نموذج التعليمات البرمجية C# وتشغيله في هذا التشغيل السريع. لا يعمل النموذج حاليا مع الإصدارات الأحدث من SDK.

إنشاء مركز IoT

في هذا المقطع، يمكنك استخدام Azure CLI لإنشاء مركز IoT ومجموعة موارد. مجموعة موارد Azure هي حاوية منطقية يتم بها نشر موارد Azure وإدارتها. يعمل مركز إنترنت الأشياء كمركز رسائل مركزي للاتصال ثنائي الاتجاه بين تطبيق إنترنت الأشياء والأجهزة.

لإنشاء مركز IoT ومجموعة موارد:

  1. قم بتشغيل Azure CLI:

    • إذا كنت تستخدم Cloud Shell، فحدد الزر Try It في أوامر CLI لتشغيل Cloud Shell في نافذة مستعرض منقسمة. أو يمكنك فتح Cloud Shell في علامة تبويب مستعرض منفصلة.
    • إذا كنت تستخدم Azure CLI محليا، فافتح وحدة تحكم مثل Windows CMD أو PowerShell أو Bash وقم بتسجيل الدخول إلى Azure CLI.

    لتشغيل أوامر CLI في بقية هذا التشغيل السريع: انسخ بناء جملة الأمر، والصقه في نافذة Cloud Shell أو وحدة تحكم CLI، وقم بتحرير قيم المتغيرات، واضغط على Enter.

  2. قم بتشغيل «az extension add» لتثبيت أو ترقية ملحق azure-iot إلى الإصدار الحالي.

    az extension add --upgrade --name azure-iot

  3. قم بتشغيل الأمر az group create لإنشاء مجموعة موارد. يقوم الأمر التالي بإنشاء مجموعة موارد تسمى MyResourceGroup في موقعeastus.

    ملاحظة

    يمكنك اختياريا تعيين موقع بديل. لمشاهدة المواقع المتوفرة، قم بتشغيل az account list-locations. يستخدم هذا البرنامج التعليمي eastus كما هو موضح في أمر المثال.

    az group create --name MyResourceGroup --location eastus

  4. قم بتشغيل الأمر «az iot hub create» لإنشاء مركز IoT. قد يستغرق إنشاء مركز IoT بضع دقائق.

    اسم YourIotHub. استبدل هذا العنصر النائب والأقواس المحيطة في الأمر التالي، باستخدام الاسم الذي اخترته لمركز IoT. يجب أن يكون اسم مركز IoT فريدًا بشكل عمومي في Azure. استخدم اسم مركز IoT الخاص بك في بقية هذا التشغيل السريعة أينما رأيت العنصر النائب.

    az iot hub create --resource-group MyResourceGroup --name {YourIoTHubName}

    تلميح

    بعد إنشاء مركز IoT، ستستخدم Azure IoT Explorer للتفاعل مع مركز IoT في بقية هذا التشغيل السريع. IoT Explorer هو تطبيق واجهة المستخدم الرسومية (GUI) يتيح لك الاتصال بمركز IoT موجود وإضافة الأجهزة وإدارتها ومراقبتها. لمعرفة المزيد، راجع تثبيت مستكشف Azure IoT واستخدامه. اختياريا، يمكنك الاستمرار في استخدام أوامر CLI.

تكوين مستكشف IoT

في بقية هذا التشغيل السريع، يمكنك استخدام IoT Explorer لتسجيل جهاز في مركز IoT الخاص بك وعرض بيانات تتبع الاستخدام للجهاز. في هذا القسم، يمكنك تكوين IoT Explorer للاتصال بمركز IoT الذي قمت بإنشائه وقراءة نماذج التوصيل والتشغيل من مستودع النموذج العام.

ملاحظة

يمكنك أيضا استخدام Azure CLI لتسجيل جهاز. استخدم الأمر az iot hub device-identity create --device-id mydevice --hub-name {YourIoTHubName} لتسجيل جهاز جديد والأمر az iot hub device-identity connection-string show --device-id mydevice --hub-name {YourIoTHubName} للحصول على سلسلة الاتصال الأساسية للجهاز. بمجرد تدوين سلسلة اتصال الجهاز، يمكنك التخطي إلى الأمام إلى تشغيل نموذج الجهاز.

لإضافة اتصال إلى مركز IoT الخاص بك:

  1. قم بتشغيل الأمر az iot hub connection-string show للحصول على سلسلة الاتصال لمركز IoT الخاص بك.

    az iot hub connection-string  show --hub-name {YourIoTHubName}

  2. انسخ سلسلة الاتصال بدون أحرف الاقتباس المحيطة.

  3. في Azure IoT Explorer، حدد مراكز IoT في القائمة اليسرى، ثم حدد + إضافة اتصال.

  4. الصق سلسلة الاتصال في مربع سلسلة الاتصال .

  5. حدد حفظ..

    لقطة شاشة لإضافة اتصال في IoT Explorer

  6. إذا نجح الاتصال، ينتقل IoT Explorer إلى طريقة عرض الأجهزة .

عرض إعدادات مستودع النماذج العامة:

  1. في IoT Explorer، حدد الصفحة الرئيسية للعودة إلى طريقة العرض الرئيسية.

  2. في القائمة اليسرى، حدد IoT أجهزة التوصيل و التشغيل Settings.

  3. يمكنك رؤية إدخال موجود لمستودع النموذج العام في https://devicemodels.azure.com.

    لقطة شاشة لإضافة مستودع النموذج العام في IoT Explorer

تسجيل جهاز

في هذا القسم، يمكنك إنشاء مثيل جهاز جديد وتسجيله في مركز IoT الذي قمت بإنشائه. يمكنك استخدام معلومات الاتصال للجهاز المسجل حديثا لتوصيل جهازك بشكل آمن في قسم لاحق.

لتسجيل جهاز:

  1. من طريقة العرض الرئيسية في IoT Explorer، حدد مراكز IoT.

  2. يجب أن يظهر الاتصال الذي أضفته مسبقا. حدد عرض الأجهزة في هذا المركز أسفل خصائص الاتصال.

  3. حدد + جديد وأدخل معرف الجهاز لجهازك ؛ على سبيل المثال، MyDevice. اترك جميع الخصائص الأخرى دون تغيير.

  4. حدد إنشاء.

    لقطة شاشة لهوية جهاز Azure IoT Explorer

  5. انسخ القيمة وقم بتدوينها في حقل سلسلة الاتصال الأساسية . تحتاج إلى سلسلة الاتصال هذه لاحقا.

قم بتشغيل نموذج الجهاز

في هذا القسم، ستستخدم C# SDK لإرسال رسائل من جهاز إلى مركز IoT الخاص بك. ستقوم بتشغيل عينة تنفذ وحدة تحكم في درجة الحرارة مع مستشعري منظم الحرارة.

  1. افتح وحدة تحكم جديدة مثل Windows CMD أو PowerShell أو Bash. في الخطوات التالية، ستستخدم وحدة التحكم هذه لتثبيت .NET SDK والعمل مع نموذج التعليمات البرمجية C#‎.

    ملاحظة

    إذا كنت تستخدم تثبيتا محليا ل Azure CLI، فقد يكون لديك الآن نافذتان مفتوحتان لوحدة التحكم. تأكد من إدخال الأوامر الموجودة في هذا القسم في وحدة التحكم التي فتحتها للتو، وليس الأوامر التي كنت تستخدمها لواجهة سطر الأوامر (CLI).

  2. استنساخ Microsoft Azure IoT SDK ل C# (.NET) إلى جهازك المحلي:

    git clone https://github.com/Azure/azure-iot-sdk-csharp.git

  3. انتقل إلى نموذج الدليل:

    نوافذ

    cd azure-iot-sdk-csharp\iothub\device\samples\solutions\PnpDeviceSamples\TemperatureController

    Linux أو Raspberry Pi OS

    cd azure-iot-sdk-csharp/iothub/device/samples/solutions/PnpDeviceSamples/TemperatureController

  4. قم بتثبيت Azure IoT C# SDK والتبعيات الضرورية:

    dotnet restore

    يقوم هذا الأمر بتثبيت التبعيات المناسبة كما هو محدد في ملف TemperatureController.csproj .

  5. قم بتعيين كل من متغيرات البيئة التالية، لتمكين جهازك من الاتصال ب Azure IoT.

    • قم بتعيين متغير بيئة يسمى IOTHUB_DEVICE_CONNECTION_STRING. بالنسبة لقيمة المتغير، استخدم سلسلة اتصال الجهاز التي قمت بحفظها في القسم السابق.
    • قم بتعيين متغير بيئة يسمى IOTHUB_DEVICE_SECURITY_TYPE. بالنسبة للمتغير ، استخدم قيمة connectionStringالسلسلة الحرفية .

    CMD (Windows)

    set IOTHUB_DEVICE_CONNECTION_STRING=<your connection string here>
set IOTHUB_DEVICE_SECURITY_TYPE=connectionString

    ملاحظة

    بالنسبة إلى Windows CMD ، لا توجد علامات اقتباس تحيط بقيم السلسلة لكل متغير.

    بوويرشيل

    $env:IOTHUB_DEVICE_CONNECTION_STRING='<your connection string here>'
$env:IOTHUB_DEVICE_SECURITY_TYPE='connectionString'

    باش

    export IOTHUB_DEVICE_CONNECTION_STRING="<your connection string here>"
export IOTHUB_DEVICE_SECURITY_TYPE="connectionString"

  6. قم بتشغيل نموذج التعليمات البرمجية:

    dotnet run

    ملاحظة

    يستخدم نموذج التعليمات البرمجية هذا Azure IoT Plug and Play، والذي يتيح لك دمج الأجهزة الذكية في حلولك دون أي تكوين يدوي. بشكل افتراضي، تستخدم معظم العينات في هذه الوثائق IoT Plug and Play. لمعرفة المزيد حول مزايا IoT PnP، وحالات استخدامه أو عدم استخدامه، راجع ما هو IoT Plug and Play؟.

يتصل النموذج بأمان بمركز IoT الخاص بك كجهاز قمت بتسجيله ويبدأ في إرسال رسائل القياس عن بعد. يظهر نموذج الإخراج في وحدة التحكم الخاصة بك.

عرض بيانات تتبع الاستخدام

يمكنك عرض بيانات تتبع الاستخدام للجهاز باستخدام IoT Explorer. اختياريا، يمكنك عرض بيانات تتبع الاستخدام باستخدام Azure CLI.

لعرض بيانات تتبع الاستخدام في Azure IoT Explorer:

  1. من مركز IoT في IoT Explorer، حدد عرض الأجهزة في هذا المركز، ثم حدد جهازك من القائمة.

  2. في القائمة اليمنى لجهازك، حدد بيانات تتبع الاستخدام.

  3. تأكد من تعيين استخدام مركز الأحداث المضمن إلى نعم ثم حدد ابدأ.

  4. اعرض بيانات تتبع الاستخدام أثناء إرسال الجهاز رسائل إلى السحابة.

    لقطة شاشة لبيانات تتبع الاستخدام للجهاز في IoT Explorer

  5. حدد إيقاف لإنهاء أحداث الاستلام.

لقراءة بيانات تتبع الاستخدام المرسلة بواسطة مكونات الجهاز الفردية، يمكنك استخدام ميزات التوصيل والتشغيل في IoT Explorer. على سبيل المثال ، تحتوي وحدة التحكم في درجة الحرارة في هذا التشغيل السريع على اثنين من منظمات الحرارة: ترموستات 1 وترموستات 2. لمعرفة درجة الحرارة التي تم الإبلاغ عنها بواسطة منظم الحرارة 1:

  1. على جهازك في IoT Explorer، حدد مكونات IoT Plug and Play من القائمة اليسرى. ثم حدد منظم الحرارة 1 من قائمة المكونات.

  2. في جزء مكون منظم الحرارة1 ، حدد بيانات تتبع الاستخدام من القائمة العلوية.

  3. في جزء بيانات تتبع الاستخدام ، اتبع نفس الخطوات التي قمت بها سابقا. تأكد من تعيين استخدام مركز الأحداث المضمن إلى نعم ثم حدد ابدأ.

لعرض بيانات تتبع الاستخدام للجهاز باستخدام Azure CLI:

  1. قم بتشغيل الأمر az iot hub monitor-events لمراقبة الأحداث المرسلة من الجهاز إلى مركز IoT الخاص بك. استخدم الأسماء التي قمت بإنشائها مسبقا في Azure IoT لجهازك ومركز IoT.

    az iot hub monitor-events --output table --device-id mydevice --hub-name {YourIoTHubName}

  2. اعرض تفاصيل الاتصال وإخراج بيانات تتبع الاستخدام في وحدة التحكم.

    Starting event monitor, filtering on device: mydevice, use ctrl-c to stop...
event:
  component: thermostat1
  interface: dtmi:com:example:TemperatureController;2
  module: ''
  origin: mydevice
  payload:
    temperature: 39.8

event:
  component: thermostat2
  interface: dtmi:com:example:TemperatureController;2
  module: ''
  origin: mydevice
  payload:
    temperature: 36.7

  3. حدد CTRL+C لإنهاء المراقبة.

استعراض التعليمة البرمجية

في هذا التشغيل السريع، تتعلم سير عمل أساسي لتطوير تطبيقات Azure IoT. يمكنك استخدام Azure CLI وIoT Explorer لإنشاء مركز Azure IoT وجهاز. ثم تستخدم عينة SDK لجهاز Azure IoT لتشغيل وحدة تحكم في درجة الحرارة، وتوصيلها بأمان بالمركز، وإرسال بيانات تتبع الاستخدام. يعمل تطبيق نموذج وحدة التحكم في درجة الحرارة على جهازك المحلي ويقوم بإنشاء بيانات مستشعر محاكاة لإرسالها إلى IoT Hub.

المتطلبات

يعمل هذا التشغيل السريع على أنظمة التشغيل Windows و Linux و Raspberry Pi. تم اختباره على إصدارات نظام التشغيل والأجهزة التالية:

  • نوافذ 10
  • أوبونتو 20.04 LTS
  • Raspberry Pi OS (Raspbian) الإصدار 10 ، يعمل على Raspberry Pi 3 Model B +

قم بتثبيت المتطلبات الأساسية التالية على جهاز التطوير الخاص بك باستثناء ما هو مذكور ل Raspberry Pi:

  • إذا لم يكن لديك اشتراك Azure، فأنشئ اشتراكاً مجاناً قبل البدء.
  • جيت.
  • Azure IoT Explorer: أداة مساعدة عبر الأنظمة الأساسية المستندة إلى واجهة المستخدم الرسومية لمراقبة Azure IoT وإدارته. إذا كنت تستخدم Raspberry Pi كنظام أساسي للتطوير، فإننا نوصي بتثبيت IoT Explorer على جهاز كمبيوتر آخر. إذا كنت لا ترغب في تثبيت IoT Explorer، فيمكنك استخدام Azure CLI لتنفيذ نفس الخطوات.
  • Azure CLI لديك خياران لتشغيل أوامر Azure CLI في هذا التشغيل السريع:
    • استخدم Azure Cloud Shell، وهو غلاف تفاعلي يقوم بتشغيل أوامر CLI في المستعرض الخاص بك. يوصى بهذا الخيار لأنك لست بحاجة إلى تثبيت أي شيء. إذا كنت تستخدم Cloud Shell لأول مرة، فقم بتسجيل الدخول إلى مدخل Microsoft Azure. اتبع الخطوات الواردة في بدء استخدام Azure Cloud Shellلبدء تشغيل Cloud Shellوتحديد بيئة Bash.
    • اختياريا، قم بتشغيل Azure CLI على جهازك المحلي. إذا كان Azure CLI مثبتا بالفعل، فقم بالتشغيل az upgrade لترقية واجهة سطر الأوامر (CLI) والملحقات إلى الإصدار الحالي. لتثبيت Azure CLI، راجع تثبيت Azure CLI. إذا كنت تستخدم Raspberry Pi كنظام أساسي للتطوير، فإننا نوصي باستخدام Azure Cloud Shell أو تثبيت Azure CLI على كمبيوتر آخر.

قم بتثبيت المتطلبات الأساسية المتبقية لنظام التشغيل الخاص بك.

Windows

لإكمال هذا التشغيل السريع على Windows، قم بتثبيت البرنامج التالي:

  • Java SE Development Kit 8 أو أحدث. يمكنك تنزيل Java 8 (LTS) JDK لمنصات متعددة من تنزيل Zulu Builds of OpenJDK. في برنامج التثبيت، حدد خيار إضافة إلى المسار .

  • أباتشي مافن 3. بعد استخراج التنزيل إلى مجلد محلي، أضف المسار الكامل إلى مجلد Maven /bin إلى متغير بيئة Windows PATH .

Linux أو Raspberry Pi OS

لإكمال هذا التشغيل السريع على Linux أو Raspberry Pi OS ، قم بتثبيت البرنامج التالي:

ملاحظة

تستند الخطوات الواردة في هذا القسم إلى توزيعات Linux Ubuntu/Debian. (يعتمد نظام التشغيل Raspberry Pi OS على Debian.) إذا كنت تستخدم توزيعة Linux مختلفة، فستحتاج إلى تعديل الخطوات وفقا لذلك.

  • OpenJDK (Open Java Development Kit) 8 أو أحدث. يمكنك استخدام الأمر java -version للتحقق من إصدار Java المثبت على نظامك. تأكد من تثبيت JDK ، وليس فقط وقت تشغيل Java (JRE).

    1. لتثبيت OpenJDK لنظامك، أدخل الأوامر التالية:

      لتثبيت الإصدار الافتراضي من OpenJDK لنظامك (OpenJDK 11 ل Ubuntu 20.04 و Raspberry Pi OS 10 في وقت كتابة هذا التقرير):

      sudo apt update
sudo apt install default-jdk

      بدلا من ذلك، يمكنك تحديد إصدار من JDK لتثبيته. على سبيل المثال:

      sudo apt update
sudo apt install openjdk-8-jdk

    2. إذا كان نظامك يحتوي على إصدارات متعددة من Java مثبتة، فيمكنك استخدام الأوامر التالية لتكوين الإصدارات الافتراضية (التلقائية) من Java ومترجم Java.

      update-java-alternatives --list          #list the Java versions installed
sudo update-alternatives --config java   #set the default Java version
sudo  update-alternatives --config javac #set the default Java compiler version

    3. قم بتعيين JAVA_HOME متغير البيئة إلى مسار تثبيت JDK الخاص بك. (هذا بشكل عام دليل فرعي تم إصداره في دليل /usr/lib/jvm .)

      export JAVA_HOME=$(readlink -f /usr/bin/java | sed "s:bin/java::")

      مهم

      يقوم هذا الأمر بتعيين المتغير JAVA_HOME في بيئة shell الحالية. نوصي بإضافة الأمر إلى ملفك ~/.bashrc أو /etc/profile لجعله متاحا كلما فتحت قذيفة جديدة.

    4. تحقق من إصدار Java JDK (و JRE) المثبت، وأن إصدار مترجم Java الخاص بك يطابق إصدار JDK، وأن JAVA_HOME متغير البيئة قد تم تعيينه بشكل صحيح.

      java -version
javac -version
echo $JAVA_HOME

  • أباتشي مافن 3. يمكنك استخدام الأمر mvn --version للتحقق من إصدار Maven المثبت على نظامك.

    1. لتثبيت Maven ، أدخل الأوامر التالية:

      sudo apt-get update
sudo apt-get install maven

    2. أدخل الأمر التالي للتحقق من التثبيت.

      mvn --version

إنشاء مركز IoT

في هذا المقطع، يمكنك استخدام Azure CLI لإنشاء مركز IoT ومجموعة موارد. مجموعة موارد Azure هي حاوية منطقية يتم بها نشر موارد Azure وإدارتها. يعمل مركز إنترنت الأشياء كمركز رسائل مركزي للاتصال ثنائي الاتجاه بين تطبيق إنترنت الأشياء والأجهزة.

لإنشاء مركز IoT ومجموعة موارد:

  1. قم بتشغيل Azure CLI:

    • إذا كنت تستخدم Cloud Shell، فحدد الزر Try It في أوامر CLI لتشغيل Cloud Shell في نافذة مستعرض منقسمة. أو يمكنك فتح Cloud Shell في علامة تبويب مستعرض منفصلة.
    • إذا كنت تستخدم Azure CLI محليا، فافتح وحدة تحكم مثل Windows CMD أو PowerShell أو Bash وقم بتسجيل الدخول إلى Azure CLI.

    لتشغيل أوامر CLI في بقية هذا التشغيل السريع: انسخ بناء جملة الأمر، والصقه في نافذة Cloud Shell أو وحدة تحكم CLI، وقم بتحرير قيم المتغيرات، واضغط على Enter.

  2. قم بتشغيل «az extension add» لتثبيت أو ترقية ملحق azure-iot إلى الإصدار الحالي.

    az extension add --upgrade --name azure-iot

  3. قم بتشغيل الأمر az group create لإنشاء مجموعة موارد. يقوم الأمر التالي بإنشاء مجموعة موارد تسمى MyResourceGroup في موقعeastus.

    ملاحظة

    يمكنك اختياريا تعيين موقع بديل. لمشاهدة المواقع المتوفرة، قم بتشغيل az account list-locations. يستخدم هذا البرنامج التعليمي eastus كما هو موضح في أمر المثال.

    az group create --name MyResourceGroup --location eastus

  4. قم بتشغيل الأمر «az iot hub create» لإنشاء مركز IoT. قد يستغرق إنشاء مركز IoT بضع دقائق.

    اسم YourIotHub. استبدل هذا العنصر النائب والأقواس المحيطة في الأمر التالي، باستخدام الاسم الذي اخترته لمركز IoT. يجب أن يكون اسم مركز IoT فريدًا بشكل عمومي في Azure. استخدم اسم مركز IoT الخاص بك في بقية هذا التشغيل السريعة أينما رأيت العنصر النائب.

    az iot hub create --resource-group MyResourceGroup --name {YourIoTHubName}

    تلميح

    بعد إنشاء مركز IoT، ستستخدم Azure IoT Explorer للتفاعل مع مركز IoT في بقية هذا التشغيل السريع. IoT Explorer هو تطبيق واجهة المستخدم الرسومية (GUI) يتيح لك الاتصال بمركز IoT موجود وإضافة الأجهزة وإدارتها ومراقبتها. لمعرفة المزيد، راجع تثبيت مستكشف Azure IoT واستخدامه. اختياريا، يمكنك الاستمرار في استخدام أوامر CLI.

تكوين مستكشف IoT

في بقية هذا التشغيل السريع، يمكنك استخدام IoT Explorer لتسجيل جهاز في مركز IoT الخاص بك وعرض بيانات تتبع الاستخدام للجهاز. في هذا القسم، يمكنك تكوين IoT Explorer للاتصال بمركز IoT الذي قمت بإنشائه وقراءة نماذج التوصيل والتشغيل من مستودع النموذج العام.

ملاحظة

يمكنك أيضا استخدام Azure CLI لتسجيل جهاز. استخدم الأمر az iot hub device-identity create --device-id mydevice --hub-name {YourIoTHubName} لتسجيل جهاز جديد والأمر az iot hub device-identity connection-string show --device-id mydevice --hub-name {YourIoTHubName} للحصول على سلسلة الاتصال الأساسية للجهاز. بمجرد تدوين سلسلة اتصال الجهاز، يمكنك التخطي إلى الأمام إلى تشغيل نموذج الجهاز.

لإضافة اتصال إلى مركز IoT الخاص بك:

  1. قم بتشغيل الأمر az iot hub connection-string show للحصول على سلسلة الاتصال لمركز IoT الخاص بك.

    az iot hub connection-string  show --hub-name {YourIoTHubName}

  2. انسخ سلسلة الاتصال بدون أحرف الاقتباس المحيطة.

  3. في Azure IoT Explorer، حدد مراكز IoT في القائمة اليسرى، ثم حدد + إضافة اتصال.

  4. الصق سلسلة الاتصال في مربع سلسلة الاتصال .

  5. حدد حفظ..

    لقطة شاشة لإضافة اتصال في IoT Explorer

  6. إذا نجح الاتصال، ينتقل IoT Explorer إلى طريقة عرض الأجهزة .

عرض إعدادات مستودع النماذج العامة:

  1. في IoT Explorer، حدد الصفحة الرئيسية للعودة إلى طريقة العرض الرئيسية.

  2. في القائمة اليسرى، حدد IoT أجهزة التوصيل و التشغيل Settings.

  3. يمكنك رؤية إدخال موجود لمستودع النموذج العام في https://devicemodels.azure.com.

    لقطة شاشة لإضافة مستودع النموذج العام في IoT Explorer

تسجيل جهاز

في هذا القسم، يمكنك إنشاء مثيل جهاز جديد وتسجيله في مركز IoT الذي قمت بإنشائه. يمكنك استخدام معلومات الاتصال للجهاز المسجل حديثا لتوصيل جهازك بشكل آمن في قسم لاحق.

لتسجيل جهاز:

  1. من طريقة العرض الرئيسية في IoT Explorer، حدد مراكز IoT.

  2. يجب أن يظهر الاتصال الذي أضفته مسبقا. حدد عرض الأجهزة في هذا المركز أسفل خصائص الاتصال.

  3. حدد + جديد وأدخل معرف الجهاز لجهازك ؛ على سبيل المثال، MyDevice. اترك جميع الخصائص الأخرى دون تغيير.

  4. حدد إنشاء.

    لقطة شاشة لهوية جهاز Azure IoT Explorer

  5. انسخ القيمة وقم بتدوينها في حقل سلسلة الاتصال الأساسية . تحتاج إلى سلسلة الاتصال هذه لاحقا.

قم بتشغيل نموذج الجهاز

في هذا القسم، يمكنك استخدام Java SDK لإرسال رسائل من جهاز إلى مركز IoT الخاص بك. ستقوم بتشغيل عينة تنفذ وحدة تحكم في درجة الحرارة مع مستشعري منظم الحرارة.

  1. افتح وحدة تحكم لتثبيت SDK لجهاز Azure IoT Java، وإنشاء نموذج التعليمات البرمجية وتشغيله. ستستخدم وحدة التحكم هذه في الخطوات التالية.

    ملاحظة

    إذا كنت تستخدم تثبيتا محليا ل Azure CLI، فقد يكون لديك الآن نافذتان مفتوحتان لوحدة التحكم. تأكد من إدخال الأوامر الموجودة في هذا القسم في وحدة التحكم التي فتحتها للتو، وليس الأوامر التي كنت تستخدمها لواجهة سطر الأوامر (CLI).

    Linux و Raspberry Pi OS

    تأكد من تعيين متغير البيئة JAVA_HOME (echo $JAVA_HOME). للحصول على معلومات حول إعداد JAVA_HOME، راجع المتطلبات الأساسية ل Linux/Raspberry Pi.

  2. استنساخ SDK لجهاز Azure IoT Java إلى جهازك المحلي:

    git clone https://github.com/Azure/azure-iot-sdk-java.git

  3. انتقل إلى المجلد الجذر ل SDK وقم بتشغيل الأمر التالي لإنشاء SDK وتحديث العينات.

    cd azure-iot-sdk-java
mvn install -T 2C -DskipTests

    تستغرق هذه العملية عدة دقائق.

  4. قم بتعيين متغيرات البيئة التالية، لتمكين جهازك من الاتصال ب Azure IoT.

    • قم بتعيين متغير بيئة يسمى IOTHUB_DEVICE_CONNECTION_STRING. بالنسبة لقيمة المتغير، استخدم سلسلة اتصال الجهاز التي قمت بحفظها في القسم السابق.
    • قم بتعيين متغير بيئة يسمى IOTHUB_DEVICE_SECURITY_TYPE. بالنسبة للمتغير ، استخدم قيمة connectionStringالسلسلة الحرفية .

    سي إم دي

    set IOTHUB_DEVICE_CONNECTION_STRING=<your connection string here>
set IOTHUB_DEVICE_SECURITY_TYPE=connectionString

    ملاحظة

    بالنسبة إلى Windows CMD ، لا توجد علامات اقتباس تحيط بقيم السلسلة لكل متغير.

    باش

    export IOTHUB_DEVICE_CONNECTION_STRING="<your connection string here>"
export IOTHUB_DEVICE_SECURITY_TYPE="connectionString"

  5. انتقل إلى نموذج الدليل.

    سي إم دي

    cd device\iot-device-samples\pnp-device-sample\temperature-controller-device-sample

    باش

    cd device/iot-device-samples/pnp-device-sample/temperature-controller-device-sample

  6. قم بتشغيل نموذج التعليمات البرمجية.

    java -jar -Dexec.mainClass="samples.com.microsoft.azure.sdk.iot.device.TemperatureController"

    ملاحظة

    يستخدم نموذج التعليمات البرمجية هذا Azure IoT Plug and Play، والذي يتيح لك دمج الأجهزة الذكية في حلولك دون أي تكوين يدوي. بشكل افتراضي، تستخدم معظم العينات في هذه الوثائق IoT Plug and Play. لمعرفة المزيد حول مزايا IoT PnP، وحالات استخدامه أو عدم استخدامه، راجع ما هو IoT Plug and Play؟.

يتصل النموذج بأمان بمركز IoT الخاص بك كجهاز قمت بتسجيله ويبدأ في إرسال رسائل القياس عن بعد. يظهر نموذج الإخراج في وحدة التحكم الخاصة بك.

عرض بيانات تتبع الاستخدام

يمكنك عرض بيانات تتبع الاستخدام للجهاز باستخدام IoT Explorer. اختياريا، يمكنك عرض بيانات تتبع الاستخدام باستخدام Azure CLI.

لعرض بيانات تتبع الاستخدام في Azure IoT Explorer:

  1. من مركز IoT في IoT Explorer، حدد عرض الأجهزة في هذا المركز، ثم حدد جهازك من القائمة.

  2. في القائمة اليمنى لجهازك، حدد بيانات تتبع الاستخدام.

  3. تأكد من تعيين استخدام مركز الأحداث المضمن إلى نعم ثم حدد ابدأ.

  4. اعرض بيانات تتبع الاستخدام أثناء إرسال الجهاز رسائل إلى السحابة.

    لقطة شاشة لبيانات تتبع الاستخدام للجهاز في IoT Explorer

  5. حدد إيقاف لإنهاء أحداث الاستلام.

لقراءة بيانات تتبع الاستخدام المرسلة بواسطة مكونات الجهاز الفردية، يمكنك استخدام ميزات التوصيل والتشغيل في IoT Explorer. على سبيل المثال ، تحتوي وحدة التحكم في درجة الحرارة في هذا التشغيل السريع على اثنين من منظمات الحرارة: ترموستات 1 وترموستات 2. لمعرفة درجة الحرارة التي تم الإبلاغ عنها بواسطة منظم الحرارة 1:

  1. على جهازك في IoT Explorer، حدد مكونات IoT Plug and Play من القائمة اليسرى. ثم حدد منظم الحرارة 1 من قائمة المكونات.

  2. في جزء مكون منظم الحرارة1 ، حدد بيانات تتبع الاستخدام من القائمة العلوية.

  3. في جزء بيانات تتبع الاستخدام ، اتبع نفس الخطوات التي قمت بها سابقا. تأكد من تعيين استخدام مركز الأحداث المضمن إلى نعم ثم حدد ابدأ.

لعرض بيانات تتبع الاستخدام للجهاز باستخدام Azure CLI:

  1. قم بتشغيل الأمر az iot hub monitor-events لمراقبة الأحداث المرسلة من الجهاز إلى مركز IoT الخاص بك. استخدم الأسماء التي قمت بإنشائها مسبقا في Azure IoT لجهازك ومركز IoT.

    az iot hub monitor-events --output table --device-id mydevice --hub-name {YourIoTHubName}

  2. اعرض تفاصيل الاتصال وإخراج بيانات تتبع الاستخدام في وحدة التحكم.

    Starting event monitor, filtering on device: mydevice, use ctrl-c to stop...
event:
  component: thermostat1
  interface: dtmi:com:example:TemperatureController;2
  module: ''
  origin: mydevice
  payload:
    temperature: 24.1

event:
  component: thermostat2
  interface: dtmi:com:example:TemperatureController;2
  module: ''
  origin: mydevice
  payload:
    temperature: 33.3

استعراض التعليمة البرمجية

في هذا التشغيل السريع، تتعلم سير عمل أساسي لتطوير تطبيقات Azure IoT. يمكنك استخدام Azure CLI وIoT Explorer لإنشاء مركز Azure IoT وجهاز. ثم تستخدم عينة SDK لجهاز Azure IoT لتشغيل وحدة تحكم في درجة الحرارة، وتوصيلها بأمان بالمركز، وإرسال بيانات تتبع الاستخدام. يعمل تطبيق نموذج وحدة التحكم في درجة الحرارة على جهازك المحلي ويقوم بإنشاء بيانات مستشعر محاكاة لإرسالها إلى IoT Hub.

المتطلبات

يعمل هذا التشغيل السريع على أنظمة التشغيل Windows و Linux و Raspberry Pi. تم اختباره على إصدارات نظام التشغيل والأجهزة التالية:

  • نوافذ 10
  • أوبونتو 20.04 LTS
  • Raspberry Pi OS (Raspbian) الإصدار 10 ، يعمل على Raspberry Pi 3 Model B +

قم بتثبيت المتطلبات الأساسية التالية على جهاز التطوير الخاص بك باستثناء ما هو مذكور ل Raspberry Pi:

  • إذا لم يكن لديك اشتراك Azure، فأنشئ اشتراكاً مجاناً قبل البدء.
  • جيت.
  • Node.js الإصدار 12 أو أحدث. للتحقق من إصدار العقدة الخاص بك قم بتشغيل node --version.
  • Azure IoT Explorer: أداة مساعدة عبر الأنظمة الأساسية المستندة إلى واجهة المستخدم الرسومية لمراقبة Azure IoT وإدارته. إذا كنت تستخدم Raspberry Pi كنظام أساسي للتطوير، فإننا نوصي بتثبيت IoT Explorer على جهاز كمبيوتر آخر. إذا كنت لا ترغب في تثبيت IoT Explorer، فيمكنك استخدام Azure CLI لتنفيذ نفس الخطوات.
  • Azure CLI لديك خياران لتشغيل أوامر Azure CLI في هذا التشغيل السريع:
    • استخدم Azure Cloud Shell، وهو غلاف تفاعلي يقوم بتشغيل أوامر CLI في المستعرض الخاص بك. يوصى بهذا الخيار لأنك لست بحاجة إلى تثبيت أي شيء. إذا كنت تستخدم Cloud Shell لأول مرة، فقم بتسجيل الدخول إلى مدخل Microsoft Azure. اتبع الخطوات الواردة في بدء استخدام Azure Cloud Shellلبدء تشغيل Cloud Shellوتحديد بيئة Bash.
    • اختياريا، قم بتشغيل Azure CLI على جهازك المحلي. إذا كان Azure CLI مثبتا بالفعل، فقم بالتشغيل az upgrade لترقية واجهة سطر الأوامر (CLI) والملحقات إلى الإصدار الحالي. لتثبيت Azure CLI، راجع تثبيت Azure CLI. إذا كنت تستخدم Raspberry Pi كنظام أساسي للتطوير، فإننا نوصي باستخدام Azure Cloud Shell أو تثبيت Azure CLI على كمبيوتر آخر.

إنشاء مركز IoT

في هذا المقطع، يمكنك استخدام Azure CLI لإنشاء مركز IoT ومجموعة موارد. مجموعة موارد Azure هي حاوية منطقية يتم بها نشر موارد Azure وإدارتها. يعمل مركز إنترنت الأشياء كمركز رسائل مركزي للاتصال ثنائي الاتجاه بين تطبيق إنترنت الأشياء والأجهزة.

لإنشاء مركز IoT ومجموعة موارد:

  1. قم بتشغيل Azure CLI:

    • إذا كنت تستخدم Cloud Shell، فحدد الزر Try It في أوامر CLI لتشغيل Cloud Shell في نافذة مستعرض منقسمة. أو يمكنك فتح Cloud Shell في علامة تبويب مستعرض منفصلة.
    • إذا كنت تستخدم Azure CLI محليا، فافتح وحدة تحكم مثل Windows CMD أو PowerShell أو Bash وقم بتسجيل الدخول إلى Azure CLI.

    لتشغيل أوامر CLI في بقية هذا التشغيل السريع: انسخ بناء جملة الأمر، والصقه في نافذة Cloud Shell أو وحدة تحكم CLI، وقم بتحرير قيم المتغيرات، واضغط على Enter.

  2. قم بتشغيل «az extension add» لتثبيت أو ترقية ملحق azure-iot إلى الإصدار الحالي.

    az extension add --upgrade --name azure-iot

  3. قم بتشغيل الأمر az group create لإنشاء مجموعة موارد. يقوم الأمر التالي بإنشاء مجموعة موارد تسمى MyResourceGroup في موقعeastus.

    ملاحظة

    يمكنك اختياريا تعيين موقع بديل. لمشاهدة المواقع المتوفرة، قم بتشغيل az account list-locations. يستخدم هذا البرنامج التعليمي eastus كما هو موضح في أمر المثال.

    az group create --name MyResourceGroup --location eastus

  4. قم بتشغيل الأمر «az iot hub create» لإنشاء مركز IoT. قد يستغرق إنشاء مركز IoT بضع دقائق.

    اسم YourIotHub. استبدل هذا العنصر النائب والأقواس المحيطة في الأمر التالي، باستخدام الاسم الذي اخترته لمركز IoT. يجب أن يكون اسم مركز IoT فريدًا بشكل عمومي في Azure. استخدم اسم مركز IoT الخاص بك في بقية هذا التشغيل السريعة أينما رأيت العنصر النائب.

    az iot hub create --resource-group MyResourceGroup --name {YourIoTHubName}

    تلميح

    بعد إنشاء مركز IoT، ستستخدم Azure IoT Explorer للتفاعل مع مركز IoT في بقية هذا التشغيل السريع. IoT Explorer هو تطبيق واجهة المستخدم الرسومية (GUI) يتيح لك الاتصال بمركز IoT موجود وإضافة الأجهزة وإدارتها ومراقبتها. لمعرفة المزيد، راجع تثبيت مستكشف Azure IoT واستخدامه. اختياريا، يمكنك الاستمرار في استخدام أوامر CLI.

تكوين مستكشف IoT

في بقية هذا التشغيل السريع، يمكنك استخدام IoT Explorer لتسجيل جهاز في مركز IoT الخاص بك وعرض بيانات تتبع الاستخدام للجهاز. في هذا القسم، يمكنك تكوين IoT Explorer للاتصال بمركز IoT الذي قمت بإنشائه وقراءة نماذج التوصيل والتشغيل من مستودع النموذج العام.

ملاحظة

يمكنك أيضا استخدام Azure CLI لتسجيل جهاز. استخدم الأمر az iot hub device-identity create --device-id mydevice --hub-name {YourIoTHubName} لتسجيل جهاز جديد والأمر az iot hub device-identity connection-string show --device-id mydevice --hub-name {YourIoTHubName} للحصول على سلسلة الاتصال الأساسية للجهاز. بمجرد تدوين سلسلة اتصال الجهاز، يمكنك التخطي إلى الأمام إلى تشغيل نموذج الجهاز.

لإضافة اتصال إلى مركز IoT الخاص بك:

  1. قم بتشغيل الأمر az iot hub connection-string show للحصول على سلسلة الاتصال لمركز IoT الخاص بك.

    az iot hub connection-string  show --hub-name {YourIoTHubName}

  2. انسخ سلسلة الاتصال بدون أحرف الاقتباس المحيطة.

  3. في Azure IoT Explorer، حدد مراكز IoT في القائمة اليسرى، ثم حدد + إضافة اتصال.

  4. الصق سلسلة الاتصال في مربع سلسلة الاتصال .

  5. حدد حفظ..

    لقطة شاشة لإضافة اتصال في IoT Explorer

  6. إذا نجح الاتصال، ينتقل IoT Explorer إلى طريقة عرض الأجهزة .

عرض إعدادات مستودع النماذج العامة:

  1. في IoT Explorer، حدد الصفحة الرئيسية للعودة إلى طريقة العرض الرئيسية.

  2. في القائمة اليسرى، حدد IoT أجهزة التوصيل و التشغيل Settings.

  3. يمكنك رؤية إدخال موجود لمستودع النموذج العام في https://devicemodels.azure.com.

    لقطة شاشة لإضافة مستودع النموذج العام في IoT Explorer

تسجيل جهاز

في هذا القسم، يمكنك إنشاء مثيل جهاز جديد وتسجيله في مركز IoT الذي قمت بإنشائه. يمكنك استخدام معلومات الاتصال للجهاز المسجل حديثا لتوصيل جهازك بشكل آمن في قسم لاحق.

لتسجيل جهاز:

  1. من طريقة العرض الرئيسية في IoT Explorer، حدد مراكز IoT.

  2. يجب أن يظهر الاتصال الذي أضفته مسبقا. حدد عرض الأجهزة في هذا المركز أسفل خصائص الاتصال.

  3. حدد + جديد وأدخل معرف الجهاز لجهازك ؛ على سبيل المثال، MyDevice. اترك جميع الخصائص الأخرى دون تغيير.

  4. حدد إنشاء.

    لقطة شاشة لهوية جهاز Azure IoT Explorer

  5. انسخ القيمة وقم بتدوينها في حقل سلسلة الاتصال الأساسية . تحتاج إلى سلسلة الاتصال هذه لاحقا.

قم بتشغيل نموذج الجهاز

في هذا القسم، ستستخدم Node.js SDK لإرسال رسائل من جهاز إلى مركز IoT الخاص بك. ستقوم بتشغيل عينة تنفذ وحدة تحكم في درجة الحرارة مع مستشعري منظم الحرارة.

  1. افتح وحدة تحكم جديدة مثل Windows CMD أو PowerShell أو Bash. في الخطوات التالية، ستستخدم وحدة التحكم هذه لتثبيت Node.js SDK والعمل مع نموذج التعليمات البرمجية Node.js.

    ملاحظة

    إذا كنت تستخدم تثبيتا محليا ل Azure CLI، فقد يكون لديك الآن نافذتان مفتوحتان لوحدة التحكم. تأكد من إدخال الأوامر الموجودة في هذا القسم في وحدة التحكم التي فتحتها للتو، وليس الأوامر التي كنت تستخدمها لواجهة سطر الأوامر (CLI).

  2. استنساخ عينات أجهزة Azure IoT Node.js SDK إلى جهازك المحلي:

    git clone https://github.com/Azure/azure-iot-sdk-node

  3. انتقل إلى نموذج الدليل:

    نوافذ

    cd azure-iot-sdk-node\device\samples\javascript

    Linux أو Raspberry Pi OS

    cd azure-iot-sdk-node/device/samples/javascript

  4. قم بتثبيت Azure IoT Node.js SDK والتبعيات الضرورية:

    npm install

    يقوم هذا الأمر بتثبيت التبعيات المناسبة كما هو محدد في ملف package.json في دليل عينات الجهاز.

  5. قم بتعيين كل من متغيرات البيئة التالية، لتمكين جهازك من الاتصال ب Azure IoT.

    • قم بتعيين متغير بيئة يسمى IOTHUB_DEVICE_CONNECTION_STRING. بالنسبة لقيمة المتغير، استخدم سلسلة اتصال الجهاز التي قمت بحفظها في القسم السابق.
    • قم بتعيين متغير بيئة يسمى IOTHUB_DEVICE_SECURITY_TYPE. بالنسبة للمتغير ، استخدم قيمة connectionStringالسلسلة الحرفية .

    CMD (Windows)

    set IOTHUB_DEVICE_CONNECTION_STRING=<your connection string here>
set IOTHUB_DEVICE_SECURITY_TYPE=connectionString

    ملاحظة

    بالنسبة إلى Windows CMD ، لا توجد علامات اقتباس تحيط بقيم السلسلة لكل متغير.

    بوويرشيل

    $env:IOTHUB_DEVICE_CONNECTION_STRING='<your connection string here>'
$env:IOTHUB_DEVICE_SECURITY_TYPE='connectionString'

    باش

    export IOTHUB_DEVICE_CONNECTION_STRING="<your connection string here>"
export IOTHUB_DEVICE_SECURITY_TYPE="connectionString"

  6. قم بتشغيل نموذج التعليمات البرمجية التالي:

    node pnp_temperature_controller.js

    ملاحظة

    يستخدم نموذج التعليمات البرمجية هذا Azure IoT Plug and Play، والذي يتيح لك دمج الأجهزة الذكية في حلولك دون أي تكوين يدوي. بشكل افتراضي، تستخدم معظم العينات في هذه الوثائق IoT Plug and Play. لمعرفة المزيد حول مزايا IoT PnP، وحالات استخدامه أو عدم استخدامه، راجع ما هو IoT Plug and Play؟.

يتصل النموذج بأمان بمركز IoT الخاص بك كجهاز قمت بتسجيله ويبدأ في إرسال رسائل القياس عن بعد. يظهر نموذج الإخراج في وحدة التحكم الخاصة بك.

عرض بيانات تتبع الاستخدام

يمكنك عرض بيانات تتبع الاستخدام للجهاز باستخدام IoT Explorer. اختياريا، يمكنك عرض بيانات تتبع الاستخدام باستخدام Azure CLI.

لعرض بيانات تتبع الاستخدام في Azure IoT Explorer:

  1. من مركز IoT في IoT Explorer، حدد عرض الأجهزة في هذا المركز، ثم حدد جهازك من القائمة.

  2. في القائمة اليمنى لجهازك، حدد بيانات تتبع الاستخدام.

  3. تأكد من تعيين استخدام مركز الأحداث المضمن إلى نعم ثم حدد ابدأ.

  4. اعرض بيانات تتبع الاستخدام أثناء إرسال الجهاز رسائل إلى السحابة.

    لقطة شاشة لبيانات تتبع الاستخدام للجهاز في IoT Explorer

  5. حدد إيقاف لإنهاء أحداث الاستلام.

لقراءة بيانات تتبع الاستخدام المرسلة بواسطة مكونات الجهاز الفردية، يمكنك استخدام ميزات التوصيل والتشغيل في IoT Explorer. على سبيل المثال ، تحتوي وحدة التحكم في درجة الحرارة في هذا التشغيل السريع على اثنين من منظمات الحرارة: ترموستات 1 وترموستات 2. لمعرفة درجة الحرارة التي تم الإبلاغ عنها بواسطة منظم الحرارة 1:

  1. على جهازك في IoT Explorer، حدد مكونات IoT Plug and Play من القائمة اليسرى. ثم حدد منظم الحرارة 1 من قائمة المكونات.

  2. في جزء مكون منظم الحرارة1 ، حدد بيانات تتبع الاستخدام من القائمة العلوية.

  3. في جزء بيانات تتبع الاستخدام ، اتبع نفس الخطوات التي قمت بها سابقا. تأكد من تعيين استخدام مركز الأحداث المضمن إلى نعم ثم حدد ابدأ.

لعرض بيانات تتبع الاستخدام للجهاز باستخدام Azure CLI:

  1. قم بتشغيل الأمر az iot hub monitor-events لمراقبة الأحداث المرسلة من الجهاز إلى مركز IoT الخاص بك. استخدم الأسماء التي قمت بإنشائها مسبقا في Azure IoT لجهازك ومركز IoT.

    az iot hub monitor-events --output table --device-id mydevice --hub-name {YourIoTHubName}

  2. اعرض تفاصيل الاتصال وإخراج بيانات تتبع الاستخدام في وحدة التحكم.

    Starting event monitor, filtering on device: mydevice, use ctrl-c to stop...
event:
  component: thermostat1
  interface: dtmi:com:example:TemperatureController;2
  module: ''
  origin: mydevice
  payload:
    temperature: 70.5897683228018

event:
  component: thermostat2
  interface: dtmi:com:example:TemperatureController;2
  module: ''
  origin: mydevice
  payload:
    temperature: 52.87582619316418

استعراض التعليمة البرمجية

في هذا التشغيل السريع، تتعلم سير عمل أساسي لتطوير تطبيقات Azure IoT. يمكنك استخدام Azure CLI وIoT Explorer لإنشاء مركز Azure IoT وجهاز. ثم تستخدم عينة SDK لجهاز Azure IoT لتشغيل وحدة تحكم في درجة الحرارة، وتوصيلها بأمان بالمركز، وإرسال بيانات تتبع الاستخدام. يعمل تطبيق نموذج وحدة التحكم في درجة الحرارة على جهازك المحلي ويقوم بإنشاء بيانات مستشعر محاكاة لإرسالها إلى IoT Hub.

المتطلبات

يعمل هذا التشغيل السريع على أنظمة التشغيل Windows و Linux و Raspberry Pi. تم اختباره على إصدارات نظام التشغيل والأجهزة التالية:

  • Windows 10 أو Windows 11
  • أوبونتو 20.04 LTS
  • Raspberry Pi OS (Raspbian) الإصدار 10 ، يعمل على Raspberry Pi 3 Model B +

قم بتثبيت المتطلبات الأساسية التالية على جهاز التطوير الخاص بك باستثناء ما هو مذكور ل Raspberry Pi:

  • إذا لم يكن لديك اشتراك Azure، فأنشئ اشتراكاً مجاناً قبل البدء.
  • جيت.
  • Python. تحقق من Azure IoT Python SDK لمعرفة متطلبات إصدار Python الحالية. للتحقق من إصدار Python الخاص بك ، قم بتشغيل python3 --version.
  • Azure IoT Explorer: أداة مساعدة عبر الأنظمة الأساسية المستندة إلى واجهة المستخدم الرسومية لمراقبة Azure IoT وإدارته. إذا كنت تستخدم Raspberry Pi كنظام أساسي للتطوير، فإننا نوصي بتثبيت IoT Explorer على جهاز كمبيوتر آخر. إذا كنت لا ترغب في تثبيت IoT Explorer، فيمكنك استخدام Azure CLI لتنفيذ نفس الخطوات.
  • Azure CLI لديك خياران لتشغيل أوامر Azure CLI في هذا التشغيل السريع:
    • استخدم Azure Cloud Shell، وهو غلاف تفاعلي يقوم بتشغيل أوامر CLI في المستعرض الخاص بك. يوصى بهذا الخيار لأنك لست بحاجة إلى تثبيت أي شيء. إذا كنت تستخدم Cloud Shell لأول مرة، فقم بتسجيل الدخول إلى مدخل Microsoft Azure. اتبع الخطوات الواردة في بدء استخدام Azure Cloud Shellلبدء تشغيل Cloud Shellوتحديد بيئة Bash.
    • اختياريا، قم بتشغيل Azure CLI على جهازك المحلي. إذا كان Azure CLI مثبتا بالفعل، فقم بالتشغيل az upgrade لترقية واجهة سطر الأوامر (CLI) والملحقات إلى الإصدار الحالي. لتثبيت Azure CLI، راجع تثبيت Azure CLI. إذا كنت تستخدم Raspberry Pi كنظام أساسي للتطوير، فإننا نوصي باستخدام Azure Cloud Shell أو تثبيت Azure CLI على كمبيوتر آخر.

إنشاء مركز IoT

في هذا المقطع، يمكنك استخدام Azure CLI لإنشاء مركز IoT ومجموعة موارد. مجموعة موارد Azure هي حاوية منطقية يتم بها نشر موارد Azure وإدارتها. يعمل مركز إنترنت الأشياء كمركز رسائل مركزي للاتصال ثنائي الاتجاه بين تطبيق إنترنت الأشياء والأجهزة.

لإنشاء مركز IoT ومجموعة موارد:

  1. قم بتشغيل Azure CLI:

    • إذا كنت تستخدم Cloud Shell، فحدد الزر Try It في أوامر CLI لتشغيل Cloud Shell في نافذة مستعرض منقسمة. أو يمكنك فتح Cloud Shell في علامة تبويب مستعرض منفصلة.
    • إذا كنت تستخدم Azure CLI محليا، فافتح وحدة تحكم مثل Windows CMD أو PowerShell أو Bash وقم بتسجيل الدخول إلى Azure CLI.

    لتشغيل أوامر CLI في بقية هذا التشغيل السريع: انسخ بناء جملة الأمر، والصقه في نافذة Cloud Shell أو وحدة تحكم CLI، وقم بتحرير قيم المتغيرات، واضغط على Enter.

  2. قم بتشغيل «az extension add» لتثبيت أو ترقية ملحق azure-iot إلى الإصدار الحالي.

    az extension add --upgrade --name azure-iot

  3. قم بتشغيل الأمر az group create لإنشاء مجموعة موارد. يقوم الأمر التالي بإنشاء مجموعة موارد تسمى MyResourceGroup في موقعeastus.

    ملاحظة

    يمكنك اختياريا تعيين موقع بديل. لمشاهدة المواقع المتوفرة، قم بتشغيل az account list-locations. يستخدم هذا البرنامج التعليمي eastus كما هو موضح في أمر المثال.

    az group create --name MyResourceGroup --location eastus

  4. قم بتشغيل الأمر «az iot hub create» لإنشاء مركز IoT. قد يستغرق إنشاء مركز IoT بضع دقائق.

    اسم YourIotHub. استبدل هذا العنصر النائب والأقواس المحيطة في الأمر التالي، باستخدام الاسم الذي اخترته لمركز IoT. يجب أن يكون اسم مركز IoT فريدًا بشكل عمومي في Azure. استخدم اسم مركز IoT الخاص بك في بقية هذا التشغيل السريعة أينما رأيت العنصر النائب.

    az iot hub create --resource-group MyResourceGroup --name {YourIoTHubName}

    تلميح

    بعد إنشاء مركز IoT، ستستخدم Azure IoT Explorer للتفاعل مع مركز IoT في بقية هذا التشغيل السريع. IoT Explorer هو تطبيق واجهة المستخدم الرسومية (GUI) يتيح لك الاتصال بمركز IoT موجود وإضافة الأجهزة وإدارتها ومراقبتها. لمعرفة المزيد، راجع تثبيت مستكشف Azure IoT واستخدامه. اختياريا، يمكنك الاستمرار في استخدام أوامر CLI.

تكوين مستكشف IoT

في بقية هذا التشغيل السريع، يمكنك استخدام IoT Explorer لتسجيل جهاز في مركز IoT الخاص بك وعرض بيانات تتبع الاستخدام للجهاز. في هذا القسم، يمكنك تكوين IoT Explorer للاتصال بمركز IoT الذي قمت بإنشائه وقراءة نماذج التوصيل والتشغيل من مستودع النموذج العام.

ملاحظة

يمكنك أيضا استخدام Azure CLI لتسجيل جهاز. استخدم الأمر az iot hub device-identity create --device-id mydevice --hub-name {YourIoTHubName} لتسجيل جهاز جديد والأمر az iot hub device-identity connection-string show --device-id mydevice --hub-name {YourIoTHubName} للحصول على سلسلة الاتصال الأساسية للجهاز. بمجرد تدوين سلسلة اتصال الجهاز، يمكنك التخطي إلى الأمام إلى تشغيل نموذج الجهاز.

لإضافة اتصال إلى مركز IoT الخاص بك:

  1. قم بتشغيل الأمر az iot hub connection-string show للحصول على سلسلة الاتصال لمركز IoT الخاص بك.

    az iot hub connection-string  show --hub-name {YourIoTHubName}

  2. انسخ سلسلة الاتصال بدون أحرف الاقتباس المحيطة.

  3. في Azure IoT Explorer، حدد مراكز IoT في القائمة اليسرى، ثم حدد + إضافة اتصال.

  4. الصق سلسلة الاتصال في مربع سلسلة الاتصال .

  5. حدد حفظ..

    لقطة شاشة لإضافة اتصال في IoT Explorer

  6. إذا نجح الاتصال، ينتقل IoT Explorer إلى طريقة عرض الأجهزة .

عرض إعدادات مستودع النماذج العامة:

  1. في IoT Explorer، حدد الصفحة الرئيسية للعودة إلى طريقة العرض الرئيسية.

  2. في القائمة اليسرى، حدد IoT أجهزة التوصيل و التشغيل Settings.

  3. يمكنك رؤية إدخال موجود لمستودع النموذج العام في https://devicemodels.azure.com.

    لقطة شاشة لإضافة مستودع النموذج العام في IoT Explorer

تسجيل جهاز

في هذا القسم، يمكنك إنشاء مثيل جهاز جديد وتسجيله في مركز IoT الذي قمت بإنشائه. يمكنك استخدام معلومات الاتصال للجهاز المسجل حديثا لتوصيل جهازك بشكل آمن في قسم لاحق.

لتسجيل جهاز:

  1. من طريقة العرض الرئيسية في IoT Explorer، حدد مراكز IoT.

  2. يجب أن يظهر الاتصال الذي أضفته مسبقا. حدد عرض الأجهزة في هذا المركز أسفل خصائص الاتصال.

  3. حدد + جديد وأدخل معرف الجهاز لجهازك ؛ على سبيل المثال، MyDevice. اترك جميع الخصائص الأخرى دون تغيير.

  4. حدد إنشاء.

    لقطة شاشة لهوية جهاز Azure IoT Explorer

  5. انسخ القيمة وقم بتدوينها في حقل سلسلة الاتصال الأساسية . تحتاج إلى سلسلة الاتصال هذه لاحقا.

قم بتشغيل نموذج الجهاز

في هذا القسم، يمكنك استخدام Python SDK لإرسال رسائل من جهاز إلى مركز IoT الخاص بك. ستقوم بتشغيل عينة تنفذ وحدة تحكم في درجة الحرارة مع مستشعري منظم الحرارة.

  1. افتح وحدة تحكم جديدة مثل Windows CMD أو PowerShell أو Bash. في الخطوات التالية، ستستخدم وحدة التحكم هذه لتثبيت Python SDK والعمل مع نموذج التعليمات البرمجية Python.

    ملاحظة

    إذا كنت تستخدم تثبيتا محليا ل Azure CLI، فقد يكون لديك الآن نافذتان مفتوحتان لوحدة التحكم. تأكد من إدخال الأوامر الموجودة في هذا القسم في وحدة التحكم التي فتحتها للتو، وليس الأوامر التي كنت تستخدمها لواجهة سطر الأوامر (CLI).

  2. استنساخ عينات جهاز Azure IoT Python SDK إلى جهازك المحلي:

    git clone --branch v2 https://github.com/Azure/azure-iot-sdk-python

  3. انتقل إلى نموذج الدليل:

    نوافذ

    cd azure-iot-sdk-python\samples\pnp

    Linux أو Raspberry Pi OS

    cd azure-iot-sdk-python/samples/pnp

  4. قم بتثبيت Azure IoT Python SDK:

    pip3 install azure-iot-device

  5. قم بتعيين متغيرات البيئة التالية، لتمكين جهازك من الاتصال ب Azure IoT.

    • قم بتعيين متغير بيئة يسمى IOTHUB_DEVICE_CONNECTION_STRING. بالنسبة لقيمة المتغير، استخدم سلسلة اتصال الجهاز التي قمت بحفظها في القسم السابق.
    • قم بتعيين متغير بيئة يسمى IOTHUB_DEVICE_SECURITY_TYPE. بالنسبة للمتغير ، استخدم قيمة connectionStringالسلسلة الحرفية .

    CMD (Windows)

    set IOTHUB_DEVICE_CONNECTION_STRING=<your connection string here>
set IOTHUB_DEVICE_SECURITY_TYPE=connectionString

    ملاحظة

    بالنسبة إلى Windows CMD ، لا توجد علامات اقتباس تحيط بقيم السلسلة لكل متغير.

    بوويرشيل

    $env:IOTHUB_DEVICE_CONNECTION_STRING='<your connection string here>'
$env:IOTHUB_DEVICE_SECURITY_TYPE='connectionString'

    باش

    export IOTHUB_DEVICE_CONNECTION_STRING="<your connection string here>"
export IOTHUB_DEVICE_SECURITY_TYPE="connectionString"

  6. قم بتشغيل التعليمات البرمجية لنموذج الملف التالي.

    python temp_controller_with_thermostats.py

    ملاحظة

    يستخدم نموذج التعليمات البرمجية هذا Azure IoT Plug and Play، والذي يتيح لك دمج الأجهزة الذكية في حلولك دون أي تكوين يدوي. بشكل افتراضي، تستخدم معظم العينات في هذه الوثائق IoT Plug and Play. لمعرفة المزيد حول مزايا IoT Plug and Play، وحالات استخدامه أو عدم استخدامه، راجع ما هو IoT Plug and Play؟.

يتصل النموذج بأمان بمركز IoT الخاص بك كجهاز قمت بتسجيله ويبدأ في إرسال رسائل القياس عن بعد. يظهر نموذج الإخراج في وحدة التحكم الخاصة بك.

عرض بيانات تتبع الاستخدام

يمكنك عرض بيانات تتبع الاستخدام للجهاز باستخدام IoT Explorer. اختياريا، يمكنك عرض بيانات تتبع الاستخدام باستخدام Azure CLI.

لعرض بيانات تتبع الاستخدام في Azure IoT Explorer:

  1. من مركز IoT في IoT Explorer، حدد عرض الأجهزة في هذا المركز، ثم حدد جهازك من القائمة.

  2. في القائمة اليمنى لجهازك، حدد بيانات تتبع الاستخدام.

  3. تأكد من تعيين استخدام مركز الأحداث المضمن إلى نعم ثم حدد ابدأ.

  4. اعرض بيانات تتبع الاستخدام أثناء إرسال الجهاز رسائل إلى السحابة.

    لقطة شاشة لبيانات تتبع الاستخدام للجهاز في IoT Explorer

  5. حدد إيقاف لإنهاء أحداث الاستلام.

لقراءة بيانات تتبع الاستخدام المرسلة بواسطة مكونات الجهاز الفردية، يمكنك استخدام ميزات التوصيل والتشغيل في IoT Explorer. على سبيل المثال ، تحتوي وحدة التحكم في درجة الحرارة في هذا التشغيل السريع على اثنين من منظمات الحرارة: ترموستات 1 وترموستات 2. لمعرفة درجة الحرارة التي تم الإبلاغ عنها بواسطة منظم الحرارة 1:

  1. على جهازك في IoT Explorer، حدد مكونات IoT Plug and Play من القائمة اليسرى. ثم حدد منظم الحرارة 1 من قائمة المكونات.

  2. في جزء مكون منظم الحرارة1 ، حدد بيانات تتبع الاستخدام من القائمة العلوية.

  3. في جزء بيانات تتبع الاستخدام ، اتبع نفس الخطوات التي قمت بها سابقا. تأكد من تعيين استخدام مركز الأحداث المضمن إلى نعم ثم حدد ابدأ.

لعرض بيانات تتبع الاستخدام للجهاز باستخدام Azure CLI:

  1. قم بتشغيل الأمر az iot hub monitor-events لمراقبة الأحداث المرسلة من الجهاز إلى مركز IoT الخاص بك. استخدم الأسماء التي قمت بإنشائها مسبقا في Azure IoT لجهازك ومركز IoT.

    az iot hub monitor-events --output table --device-id mydevice --hub-name {YourIoTHubName}

  2. اعرض تفاصيل الاتصال وإخراج بيانات تتبع الاستخدام في وحدة التحكم.

    Starting event monitor, filtering on device: mydevice, use ctrl-c to stop...
event:
  component: thermostat1
  interface: dtmi:com:example:TemperatureController;2
  module: ''
  origin: mydevice
  payload:
    temperature: 28

event:
  component: thermostat2
  interface: dtmi:com:example:TemperatureController;2
  module: ''
  origin: mydevice
  payload:
    temperature: 10

تنظيف الموارد

إذا لم تعد بحاجة إلى موارد Azure التي تم إنشاؤها في هذا البرنامج التعليمي، فيمكنك استخدام Azure CLI لحذفها.

مهم

حذف مجموعة الموارد لا يمكن التراجع عنه. يتم حذف مجموعة الموارد وكافة الموارد المضمنة فيها بشكل دائم. تأكد من عدم حذف مجموعة الموارد الخاطئة أو الموارد غير الصحيحة بطريق الخطأ.

لحذف مجموعة موارد حسب الاسم:

  1. قم بتشغيل الأمر az group delete . يزيل هذا الأمر مجموعة الموارد ومركز IoT وتسجيل الجهاز الذي قمت بإنشائه.

    az group delete --name MyResourceGroup

  2. قم بتشغيل الأمر az group list لتأكيد حذف مجموعة الموارد.

    az group list

الخطوات التالية

في هذا البرنامج التعليمي، تعلمت سير عمل أساسي لتطبيق Azure IoT لتوصيل جهاز بأمان بالسحابة وإرسال بيانات تتبع الاستخدام من جهاز إلى سحابة. لقد استخدمت Azure CLI لإنشاء مركز Azure IoT ومثيل جهاز. ثم استخدمت SDK لجهاز Azure IoT لإنشاء وحدة تحكم في درجة الحرارة وتوصيلها بالمركز وإرسال بيانات تتبع الاستخدام. لقد استخدمت أيضا Azure CLI لمراقبة بيانات تتبع الاستخدام.

كخطوة تالية، استكشف المقالات التالية لمعرفة المزيد حول إنشاء حلول الأجهزة باستخدام Azure IoT.

التحكم في جهاز متصل بمركز IoT

  • Last updated on