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

  • مقالة
  • قراءة خلال 42 دقائق

⁧⁩ينطبق على⁧⁩:⁧⁩مطوري تطبيقات الأجهزة⁧⁩

Browse code

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

المتطلبات الأساسية

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

  • Windows 10
  • نظام التشغيل Ubuntu 20.04 LTS
  • Raspberry Pi OS (Raspbian) الإصدار 10 ، الذي يعمل على Raspberry Pi 3 Model B +

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

  • في حال لم يكن لديك اشتراك في Azure، يتعين عليك ⁧⁧⁩⁩إنشاء حساب مجاني⁧⁧⁩⁩ قبل البدء.
  • Git.
  • Azure IoT Explorer: منصة متعددة؛ وأداة قائمة على واجهة المستخدم الرسومية لمراقبة وإدارة Azure IoT. إذا كنت تستخدم Raspberry Pi كمنصة تطوير، نوصيك بتثبيت IoT Explorer على جهاز كمبيوتر آخر. إذا كنت لا ترغب بتثبيت IoT Explorer، يمكنك استخدام Azure CLI لتنفيذ نفس الخطوات.
  • Azure CLI لديك خياران لتشغيل أوامر Azure CLI في البدء السريع:
    • استخدم Azure Cloud Shell، وهي واجهة تفاعلية تقوم بتشغيل أوامر CLI في المستعرض. يوصى بهذا الخيار؛ حيث لا تحتاج إلى تثبيت أي شيء. إذا كنت تستخدم Cloud Shell لأول مرة، فسجل الدخول إلى مدخل 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، قم بتثبيت البرنامج التالي:

قم بتثبيت ⁧⁩ سحابة القطاع الحكومي⁧⁩ و ⁧⁩ 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⁩ أعلى من ⁧⁩2.8.12⁧⁩، وإصدار ⁧⁩سحابة القطاع الحكومي⁧⁩ أعلى من ⁧⁩4.4.7⁧⁩.

cmake --version
gcc --version

Windows

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

  1. للمستخدمين الجدد، قم بتثبيت ⁧⁩Visual Studio (Community, Professional, or Enterprise) 2019 ⁧⁩. قم بتنزيل الإصدار الذي تريد تثبيته، وابدأ تشغيل المثبت.

    ملاحظة

    بالنسبة لمستخدمي Visual Studio 2019 الحاليين، حدد النافذة ⁧⁩ Start ⁧⁩، واكتب⁧⁩ Visual Studio Installer ⁧⁩، وابدأ المثبت.

  2. في علامة التبويب installer ⁦⁧⁩⁩Workloads⁦⁧⁩⁩، حدد ⁦⁧⁩⁩Desktop Development with C++⁦⁧⁩⁩ workload.
  3. التحقق من صحة التثبيت.

أنشئ مركز IoT

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

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

  1. تشغيل Azure CLI:

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

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

  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⁧⁩ لإنشاء مركز IoT. قد يستغرق إنشاء مركز IoT بضع دقائق.

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

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

    تلميح

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

تكوين IoT Explorer

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

ملاحظة

يمكنك أيضاً استخدام CLI Azure لتسجيل جهاز. استخدم الأمر 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 للحصول على سلسلة الاتصال بمركز إنترنت الأشياء.

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

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

  3. في Azure IoT Explorer، حدد «مراكز IoT» في القائمة اليسرى، ثم حدد «+ Add connection» .

  4. الصق ‏‏سلسلة الاتصال في خانة «Connection string» .

  5. حدد ⁧⁩حفظ⁧⁩.

    Screenshot of adding a connection in IoT Explorer

  6. إذا نجح الاتصال، يقوم IoT Explorer بالتبديل إلى طريقة عرض «Devices» .

لإضافة مستودع الطراز العام:

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

  2. في القائمة اليسرى، حدد «IoT Plug and Play Settings» ، ثم حدد «+Add» وحدد «Public repository» من القائمة المنسدلة.

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

    Screenshot of adding the public model repository in IoT Explorer

  4. حدد ⁧⁩حفظ⁧⁩.

تسجيل جهاز

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

لتسجيل جهاز:

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

  2. يجب أن يظهر الاتصال الذي أضفته مسبقًا. حدد «View devices in this hub» أسفل خصائص الاتصال.

  3. حدد «+ New» وأدخل معرف الجهاز لجهازك؛ على سبيل المثال، mydevice. اترك كافة الخصائص الأخرى كما هي.

  4. حدد Create.

    Screenshot of Azure IoT Explorer device identity

  5. استخدم أزرار النسخ لنسخ حقل ⁧⁩سلسلة الاتصال الأساسي⁧⁩ ودونه. ستحتاج إلى سلسلة الاتصال هذه لاحقًا.

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

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

إنشاء العينة

  1. افتح وحدة تحكم جديدة لتثبيت SDK الجهاز إنترنت الأشياء Azure وتشغيل نموذج التعليمات البرمجية. بالنسبة لنظام التشغيل Windows، حدد⁧⁩Start⁧⁩، واكتب ⁧⁩Developer Command Prompt for VS 2019⁧⁩، وافتح وحدة التحكم. لينكس والتوت بي OS، وفتح محطة لأوامر باش.

    ملاحظة

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

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

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

    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.

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

    CMD

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

    ملاحظة

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

    Bash

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

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

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

    ⁧⁧⁩⁩CMD⁧⁧⁩⁩

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

    Bash

    cmake/iothub_client/samples/pnp/pnp_temperature_controller/pnp_temperature_controller

    ملاحظة

    يستخدم نموذج التعليمات البرمجية هذا تقنية التوصيل والتشغيل لـ Azure IoT، وهو ما يتيح لك دمج الأجهزة الذكية في الحلول الخاصة بك دون أي تكوين يدوي. بشكل افتراضي، معظم العينات في هذه الوثيقة تستخدم تقنية توصيل وتشغيل IoT. لمعرفة المزيد حول مزايا IoT PnP، وحالات استخدامه أو عدم استخدامه، راجع ⁧⁧⁩⁩ما هو توصيل وتشغيل IoT؟⁧⁧⁩⁩.

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

عرض القياس عن بعد

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

لعرض القياس عن بُعد في Azure IoT Explorer:

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

  2. حدد من القائمة اليسرىالقياس عن بُعد.

  3. تأكد من تعيين لوحة الوصل المضمنة للحدث إلى"نعم" ثم حدد "بدء" .

  4. اعرض القياس عن بُعد حيث يرسل الجهاز رسائل إلى السحابة.

    Screenshot of device telemetry in IoT Explorer

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

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

  1. حدد على الجهاز في IoT Explorer،مكونات التوصيل والتشغيل لـ IoT من القائمة اليسرى. ثم حدد الحرارة الأولى من قائمة المكونات.

  2. في جزء مكون الحرارة الأولى حدد القياس عن بُعد من القائمة العلوية.

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

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

  1. شغل الأمررصد مركز إنترنت أشياء Azure -أحداث لمراقبة الأحداث المرسلة من الجهاز المحاكي إلى إنترنت الأشياء . استخدم الأسماء المُنشأة سابقًا في 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}'

Browse code

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

المتطلبات الأساسية

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

  • Windows 10
  • نظام التشغيل Ubuntu 20.04 LTS
  • Raspberry Pi OS (Raspbian) الإصدار 10 ، الذي يعمل على Raspberry Pi 3 Model B +

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

  • في حال لم يكن لديك اشتراك في Azure، يتعين عليك ⁧⁧⁩⁩إنشاء حساب مجاني⁧⁧⁩⁩ قبل البدء.

  • Git.

  • .NET Core SDK 3.1. تأكد من تثبيت SDK.NET، وليس فقط وقت التشغيل. للتحقق من إصدار .NET SDK ووقت التشغيل المثبت على جهازك، قم بتشغيلdotnet --info.

    • بالنسبة لنظامي التشغيل Windows وLinux (باستثناء Raspberry Pi)، اتبع التعليمات لتثبيت.NET Core SDK 3.1على النظام الأساسي الخاص بك.
    • بالنسبة إلى Raspberry Pi، ستحتاج إلى اتباع التعليمات لتثبيت SDK يدوياً. وهذا لأنه في دبيان، يتم دعم تثبيتات إدارة الحزمة لـ.NET SDK فقط لهندسة x64.

  • Azure IoT Explorer: منصة متعددة؛ وأداة قائمة على واجهة المستخدم الرسومية لمراقبة وإدارة Azure IoT. إذا كنت تستخدم Raspberry Pi كمنصة تطوير، نوصيك بتثبيت IoT Explorer على جهاز كمبيوتر آخر. إذا كنت لا ترغب بتثبيت IoT Explorer، يمكنك استخدام Azure CLI لتنفيذ نفس الخطوات.

  • Azure CLI لديك خياران لتشغيل أوامر Azure CLI في البدء السريع:

    • استخدم Azure Cloud Shell، وهي واجهة تفاعلية تقوم بتشغيل أوامر CLI في المستعرض. يوصى بهذا الخيار؛ حيث لا تحتاج إلى تثبيت أي شيء. إذا كنت تستخدم Cloud Shell لأول مرة، فسجل الدخول إلى مدخل 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 يعمل هذا كمركز رسائل مركزي للاتصال ثنائي الاتجاه بين تطبيق IoT والأجهزة.

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

  1. تشغيل Azure CLI:

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

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

  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⁧⁩ لإنشاء مركز IoT. قد يستغرق إنشاء مركز IoT بضع دقائق.

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

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

    تلميح

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

تكوين IoT Explorer

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

ملاحظة

يمكنك أيضاً استخدام CLI Azure لتسجيل جهاز. استخدم الأمر 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 للحصول على سلسلة الاتصال بمركز إنترنت الأشياء.

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

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

  3. في Azure IoT Explorer، حدد «مراكز IoT» في القائمة اليسرى، ثم حدد «+ Add connection» .

  4. الصق ‏‏سلسلة الاتصال في خانة «Connection string» .

  5. حدد ⁧⁩حفظ⁧⁩.

    Screenshot of adding a connection in IoT Explorer

  6. إذا نجح الاتصال، يقوم IoT Explorer بالتبديل إلى طريقة عرض «Devices» .

لإضافة مستودع الطراز العام:

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

  2. في القائمة اليسرى، حدد «IoT Plug and Play Settings» ، ثم حدد «+Add» وحدد «Public repository» من القائمة المنسدلة.

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

    Screenshot of adding the public model repository in IoT Explorer

  4. حدد ⁧⁩حفظ⁧⁩.

تسجيل جهاز

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

لتسجيل جهاز:

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

  2. يجب أن يظهر الاتصال الذي أضفته مسبقًا. حدد «View devices in this hub» أسفل خصائص الاتصال.

  3. حدد «+ New» وأدخل معرف الجهاز لجهازك؛ على سبيل المثال، mydevice. اترك كافة الخصائص الأخرى كما هي.

  4. حدد Create.

    Screenshot of Azure IoT Explorer device identity

  5. استخدم أزرار النسخ لنسخ حقل ⁧⁩سلسلة الاتصال الأساسي⁧⁩ ودونه. ستحتاج إلى سلسلة الاتصال هذه لاحقًا.

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

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

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

    ملاحظة

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

  2. استنساخ Microsoft Azure نماذج إنترنت الأشياء لC# (.NET) إلى الجهاز المحلي.

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

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

    Windows

    cd azure-iot-samples-csharp\iot-hub\Samples\device\PnpDeviceSamples\TemperatureController

    Linux أو Raspberry Pi OS

    cd azure-iot-samples-csharp/iot-hub/Samples/device/PnpDeviceSamples/TemperatureController

  4. تثبيت إنترنت الأشياء Azure C#SDK والتبعيات الضرورية:

    dotnet restore

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

  5. تعيين كل من متغيرات البيئة التالية لتمكين الجهاز للاتصال بإنترنت الأشياء Azure.

    • تعيين متغير بيئة يسمى ⁧⁧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 فإنه لا توجد علامات اقتباس تحيط بقيم السلسلة لكل متغير.

    PowerShell

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

    Bash

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

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

    dotnet run

    ملاحظة

    يستخدم نموذج التعليمات البرمجية هذا تقنية التوصيل والتشغيل لـ Azure IoT، وهو ما يتيح لك دمج الأجهزة الذكية في الحلول الخاصة بك دون أي تكوين يدوي. بشكل افتراضي، معظم العينات في هذه الوثيقة تستخدم تقنية توصيل وتشغيل IoT. لمعرفة المزيد حول مزايا IoT PnP، وحالات استخدامه أو عدم استخدامه، راجع ⁧⁧⁩⁩ما هو توصيل وتشغيل IoT؟⁧⁧⁩⁩.

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

عرض القياس عن بعد

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

لعرض القياس عن بُعد في Azure IoT Explorer:

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

  2. حدد من القائمة اليسرىالقياس عن بُعد.

  3. تأكد من تعيين لوحة الوصل المضمنة للحدث إلى"نعم" ثم حدد "بدء" .

  4. اعرض القياس عن بُعد حيث يرسل الجهاز رسائل إلى السحابة.

    Screenshot of device telemetry in IoT Explorer

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

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

  1. حدد على الجهاز في IoT Explorer،مكونات التوصيل والتشغيل لـ IoT من القائمة اليسرى. ثم حدد الحرارة الأولى من قائمة المكونات.

  2. في جزء مكون الحرارة الأولى حدد القياس عن بُعد من القائمة العلوية.

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

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

  1. شغل الأمررصد مركز إنترنت أشياء Azure -أحداث لمراقبة الأحداث المرسلة من الجهاز المحاكي إلى إنترنت الأشياء . استخدم الأسماء المُنشأة سابقًا في 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 لإنهاء المراقبة.

Browse code

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

المتطلبات الأساسية

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

  • Windows 10
  • نظام التشغيل Ubuntu 20.04 LTS
  • Raspberry Pi OS (Raspbian) الإصدار 10 ، الذي يعمل على Raspberry Pi 3 Model B +

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

  • في حال لم يكن لديك اشتراك في Azure، يتعين عليك ⁧⁧⁩⁩إنشاء حساب مجاني⁧⁧⁩⁩ قبل البدء.
  • Git.
  • Azure IoT Explorer: منصة متعددة؛ وأداة قائمة على واجهة المستخدم الرسومية لمراقبة وإدارة Azure IoT. إذا كنت تستخدم Raspberry Pi كمنصة تطوير، نوصيك بتثبيت IoT Explorer على جهاز كمبيوتر آخر. إذا كنت لا ترغب بتثبيت IoT Explorer، يمكنك استخدام Azure CLI لتنفيذ نفس الخطوات.
  • Azure CLI لديك خياران لتشغيل أوامر Azure CLI في البدء السريع:
    • استخدم Azure Cloud Shell، وهي واجهة تفاعلية تقوم بتشغيل أوامر CLI في المستعرض. يوصى بهذا الخيار؛ حيث لا تحتاج إلى تثبيت أي شيء. إذا كنت تستخدم Cloud Shell لأول مرة، فسجل الدخول إلى مدخل 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، قم بتثبيت البرنامج التالي:

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

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

لينكس أو التوت بي OS

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

ملاحظة

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

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

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

      لتثبيت الإصدار الافتراضي من OpenJDK لنظامك (OpenJDK 11 لأوبونتو 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

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

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

      sudo apt-get update
sudo apt-get install maven

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

      mvn --version

أنشئ مركز IoT

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

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

  1. تشغيل Azure CLI:

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

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

  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⁧⁩ لإنشاء مركز IoT. قد يستغرق إنشاء مركز IoT بضع دقائق.

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

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

    تلميح

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

تكوين IoT Explorer

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

ملاحظة

يمكنك أيضاً استخدام CLI Azure لتسجيل جهاز. استخدم الأمر 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 للحصول على سلسلة الاتصال بمركز إنترنت الأشياء.

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

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

  3. في Azure IoT Explorer، حدد «مراكز IoT» في القائمة اليسرى، ثم حدد «+ Add connection» .

  4. الصق ‏‏سلسلة الاتصال في خانة «Connection string» .

  5. حدد ⁧⁩حفظ⁧⁩.

    Screenshot of adding a connection in IoT Explorer

  6. إذا نجح الاتصال، يقوم IoT Explorer بالتبديل إلى طريقة عرض «Devices» .

لإضافة مستودع الطراز العام:

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

  2. في القائمة اليسرى، حدد «IoT Plug and Play Settings» ، ثم حدد «+Add» وحدد «Public repository» من القائمة المنسدلة.

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

    Screenshot of adding the public model repository in IoT Explorer

  4. حدد ⁧⁩حفظ⁧⁩.

تسجيل جهاز

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

لتسجيل جهاز:

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

  2. يجب أن يظهر الاتصال الذي أضفته مسبقًا. حدد «View devices in this hub» أسفل خصائص الاتصال.

  3. حدد «+ New» وأدخل معرف الجهاز لجهازك؛ على سبيل المثال، mydevice. اترك كافة الخصائص الأخرى كما هي.

  4. حدد Create.

    Screenshot of Azure IoT Explorer device identity

  5. استخدم أزرار النسخ لنسخ حقل ⁧⁩سلسلة الاتصال الأساسي⁧⁩ ودونه. ستحتاج إلى سلسلة الاتصال هذه لاحقًا.

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

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

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

    ملاحظة

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

    Linux وRaspberry Pi OS

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

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

    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.

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

    CMD

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

    ملاحظة

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

    Bash

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

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

    ⁧⁩CMD⁧⁩

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

    Bash

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

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

    mvn exec:java -Dexec.mainClass="samples.com.microsoft.azure.sdk.iot.device.TemperatureController"

    ملاحظة

    يستخدم نموذج التعليمات البرمجية هذا تقنية التوصيل والتشغيل لـ Azure IoT، وهو ما يتيح لك دمج الأجهزة الذكية في الحلول الخاصة بك دون أي تكوين يدوي. بشكل افتراضي، معظم العينات في هذه الوثيقة تستخدم تقنية توصيل وتشغيل IoT. لمعرفة المزيد حول مزايا IoT PnP، وحالات استخدامه أو عدم استخدامه، راجع ⁧⁧⁩⁩ما هو توصيل وتشغيل IoT؟⁧⁧⁩⁩.

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

عرض القياس عن بعد

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

لعرض القياس عن بُعد في Azure IoT Explorer:

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

  2. حدد من القائمة اليسرىالقياس عن بُعد.

  3. تأكد من تعيين لوحة الوصل المضمنة للحدث إلى"نعم" ثم حدد "بدء" .

  4. اعرض القياس عن بُعد حيث يرسل الجهاز رسائل إلى السحابة.

    Screenshot of device telemetry in IoT Explorer

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

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

  1. حدد على الجهاز في IoT Explorer،مكونات التوصيل والتشغيل لـ IoT من القائمة اليسرى. ثم حدد الحرارة الأولى من قائمة المكونات.

  2. في جزء مكون الحرارة الأولى حدد القياس عن بُعد من القائمة العلوية.

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

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

  1. شغل الأمررصد مركز إنترنت أشياء Azure -أحداث لمراقبة الأحداث المرسلة من الجهاز المحاكي إلى إنترنت الأشياء . استخدم الأسماء المُنشأة سابقًا في 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

Browse code

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

المتطلبات الأساسية

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

  • Windows 10
  • نظام التشغيل Ubuntu 20.04 LTS
  • Raspberry Pi OS (Raspbian) الإصدار 10 ، الذي يعمل على Raspberry Pi 3 Model B +

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

  • في حال لم يكن لديك اشتراك في Azure، يتعين عليك ⁧⁧⁩⁩إنشاء حساب مجاني⁧⁧⁩⁩ قبل البدء.
  • Git.
  • 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 لأول مرة، فسجل الدخول إلى مدخل 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 يعمل هذا كمركز رسائل مركزي للاتصال ثنائي الاتجاه بين تطبيق IoT والأجهزة.

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

  1. تشغيل Azure CLI:

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

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

  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⁧⁩ لإنشاء مركز IoT. قد يستغرق إنشاء مركز IoT بضع دقائق.

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

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

    تلميح

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

تكوين IoT Explorer

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

ملاحظة

يمكنك أيضاً استخدام CLI Azure لتسجيل جهاز. استخدم الأمر 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 للحصول على سلسلة الاتصال بمركز إنترنت الأشياء.

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

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

  3. في Azure IoT Explorer، حدد «مراكز IoT» في القائمة اليسرى، ثم حدد «+ Add connection» .

  4. الصق ‏‏سلسلة الاتصال في خانة «Connection string» .

  5. حدد ⁧⁩حفظ⁧⁩.

    Screenshot of adding a connection in IoT Explorer

  6. إذا نجح الاتصال، يقوم IoT Explorer بالتبديل إلى طريقة عرض «Devices» .

لإضافة مستودع الطراز العام:

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

  2. في القائمة اليسرى، حدد «IoT Plug and Play Settings» ، ثم حدد «+Add» وحدد «Public repository» من القائمة المنسدلة.

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

    Screenshot of adding the public model repository in IoT Explorer

  4. حدد ⁧⁩حفظ⁧⁩.

تسجيل جهاز

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

لتسجيل جهاز:

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

  2. يجب أن يظهر الاتصال الذي أضفته مسبقًا. حدد «View devices in this hub» أسفل خصائص الاتصال.

  3. حدد «+ New» وأدخل معرف الجهاز لجهازك؛ على سبيل المثال، mydevice. اترك كافة الخصائص الأخرى كما هي.

  4. حدد Create.

    Screenshot of Azure IoT Explorer device identity

  5. استخدم أزرار النسخ لنسخ حقل ⁧⁩سلسلة الاتصال الأساسي⁧⁩ ودونه. ستحتاج إلى سلسلة الاتصال هذه لاحقًا.

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

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

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

    ملاحظة

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

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

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

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

    Windows

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

    Linux أو Raspberry Pi OS

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

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

    npm install

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

  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 فإنه لا توجد علامات اقتباس تحيط بقيم السلسلة لكل متغير.

    PowerShell

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

    Bash

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

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

    node pnp_temperature_controller.js

    ملاحظة

    يستخدم نموذج التعليمات البرمجية هذا تقنية التوصيل والتشغيل لـ Azure IoT، وهو ما يتيح لك دمج الأجهزة الذكية في الحلول الخاصة بك دون أي تكوين يدوي. بشكل افتراضي، معظم العينات في هذه الوثيقة تستخدم تقنية توصيل وتشغيل IoT. لمعرفة المزيد حول مزايا IoT PnP، وحالات استخدامه أو عدم استخدامه، راجع ⁧⁧⁩⁩ما هو توصيل وتشغيل IoT؟⁧⁧⁩⁩.

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

عرض القياس عن بعد

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

لعرض القياس عن بُعد في Azure IoT Explorer:

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

  2. حدد من القائمة اليسرىالقياس عن بُعد.

  3. تأكد من تعيين لوحة الوصل المضمنة للحدث إلى"نعم" ثم حدد "بدء" .

  4. اعرض القياس عن بُعد حيث يرسل الجهاز رسائل إلى السحابة.

    Screenshot of device telemetry in IoT Explorer

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

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

  1. حدد على الجهاز في IoT Explorer،مكونات التوصيل والتشغيل لـ IoT من القائمة اليسرى. ثم حدد الحرارة الأولى من قائمة المكونات.

  2. في جزء مكون الحرارة الأولى حدد القياس عن بُعد من القائمة العلوية.

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

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

  1. شغل الأمررصد مركز إنترنت أشياء Azure -أحداث لمراقبة الأحداث المرسلة من الجهاز المحاكي إلى إنترنت الأشياء . استخدم الأسماء المُنشأة سابقًا في 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

Browse code

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

المتطلبات الأساسية

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

  • Windows 10
  • نظام التشغيل Ubuntu 20.04 LTS
  • Raspberry Pi OS (Raspbian) الإصدار 10 ، الذي يعمل على Raspberry Pi 3 Model B +

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

  • في حال لم يكن لديك اشتراك في Azure، يتعين عليك ⁧⁧⁩⁩إنشاء حساب مجاني⁧⁧⁩⁩ قبل البدء.
  • Git.
  • Python إصدار 3.7 أو الأحدث. للتحقق من إصدار 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 لأول مرة، فسجل الدخول إلى مدخل 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 يعمل هذا كمركز رسائل مركزي للاتصال ثنائي الاتجاه بين تطبيق IoT والأجهزة.

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

  1. تشغيل Azure CLI:

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

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

  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⁧⁩ لإنشاء مركز IoT. قد يستغرق إنشاء مركز IoT بضع دقائق.

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

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

    تلميح

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

تكوين IoT Explorer

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

ملاحظة

يمكنك أيضاً استخدام CLI Azure لتسجيل جهاز. استخدم الأمر 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 للحصول على سلسلة الاتصال بمركز إنترنت الأشياء.

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

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

  3. في Azure IoT Explorer، حدد «مراكز IoT» في القائمة اليسرى، ثم حدد «+ Add connection» .

  4. الصق ‏‏سلسلة الاتصال في خانة «Connection string» .

  5. حدد ⁧⁩حفظ⁧⁩.

    Screenshot of adding a connection in IoT Explorer

  6. إذا نجح الاتصال، يقوم IoT Explorer بالتبديل إلى طريقة عرض «Devices» .

لإضافة مستودع الطراز العام:

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

  2. في القائمة اليسرى، حدد «IoT Plug and Play Settings» ، ثم حدد «+Add» وحدد «Public repository» من القائمة المنسدلة.

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

    Screenshot of adding the public model repository in IoT Explorer

  4. حدد ⁧⁩حفظ⁧⁩.

تسجيل جهاز

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

لتسجيل جهاز:

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

  2. يجب أن يظهر الاتصال الذي أضفته مسبقًا. حدد «View devices in this hub» أسفل خصائص الاتصال.

  3. حدد «+ New» وأدخل معرف الجهاز لجهازك؛ على سبيل المثال، mydevice. اترك كافة الخصائص الأخرى كما هي.

  4. حدد Create.

    Screenshot of Azure IoT Explorer device identity

  5. استخدم أزرار النسخ لنسخ حقل ⁧⁩سلسلة الاتصال الأساسي⁧⁩ ودونه. ستحتاج إلى سلسلة الاتصال هذه لاحقًا.

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

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

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

    ملاحظة

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

  2. في وحدة تحكم Python، استنسخ نماذج إنترنت الأشياء Azure Python SDK إلى جهازك المحلي:

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

  3. انتقل إلى دليل العينات:

    Windows

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

    Linux أو Raspberry Pi OS

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

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

    pip3 install azure-iot-device

  5. تعيين متغيرات البيئة التالية لتمكين جهازك من الاتصال بإنترنت الأشياء Azure.

    • تعيين متغير بيئة يسمى ⁧⁧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 فإنه لا توجد علامات اقتباس تحيط بقيم السلسلة لكل متغير.

    PowerShell

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

    Bash

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

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

    python3 temp_controller_with_thermostats.py

    ملاحظة

    يستخدم نموذج التعليمات البرمجية هذا تقنية التوصيل والتشغيل لـ Azure IoT، وهو ما يتيح لك دمج الأجهزة الذكية في الحلول الخاصة بك دون أي تكوين يدوي. بشكل افتراضي، معظم العينات في هذه الوثيقة تستخدم تقنية توصيل وتشغيل IoT. لمعرفة المزيد حول مزايا تقنية التوصيل والتشغيل الخاصة بـ IoT، وحالات استخدامه أو عدم استخدامه، يُرجى الرجوع إلى ما هو توصيل وتشغيل IoT؟.

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

عرض القياس عن بعد

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

لعرض القياس عن بُعد في Azure IoT Explorer:

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

  2. حدد من القائمة اليسرىالقياس عن بُعد.

  3. تأكد من تعيين لوحة الوصل المضمنة للحدث إلى"نعم" ثم حدد "بدء" .

  4. اعرض القياس عن بُعد حيث يرسل الجهاز رسائل إلى السحابة.

    Screenshot of device telemetry in IoT Explorer

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

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

  1. حدد على الجهاز في IoT Explorer،مكونات التوصيل والتشغيل لـ IoT من القائمة اليسرى. ثم حدد الحرارة الأولى من قائمة المكونات.

  2. في جزء مكون الحرارة الأولى حدد القياس عن بُعد من القائمة العلوية.

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

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

  1. شغل الأمررصد مركز إنترنت أشياء Azure -أحداث لمراقبة الأحداث المرسلة من الجهاز المحاكي إلى إنترنت الأشياء . استخدم الأسماء المُنشأة سابقًا في 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: 29

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

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

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

هام

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

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

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

    az group delete --name MyResourceGroup

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

    az group list

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

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

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

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

إرسال بيانات تتبع الاستخدام إلى IoT Central

الاتصال من MXCHIP AZ3166 devkit إلى IoT Central