البرنامج التعليمي: بإعداد بيئتك من أجل البرامج التعليمية والبرامج التعليمية الخاصة بـ IoT Plug and Play

  • مقالة

قبل أن تتمكن من إكمال أي من البرامج التعليمية والبرامج التعليمية الخاصة بـ IoT Plug and Play، تحتاج إلى تكوين مركز IoT وخدمة توفير الأجهزة (DPS) في اشتراكك في Azure. ستحتاج أيضاً إلى نسخ محلية من ملفات النماذج التي تستخدمها نماذج التطبيقات وأداة استكشاف Azure IoT.

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

في حال لم يكن لديك اشتراك Azure، فأنشئ حساباً مجانيّاً قبل البدء.

إعداد البيئة الخاصة بك لـ Azure CLI

إنشاء الموارد

قم بإنشاء مجموعة موارد Azure للموارد التالية:

az group create --name my-pnp-resourcegroup --location centralus

إنشاء مركز IoT. يستخدم الأمر التالي الاسم my-pnp-hub كمثال لاسم مركز IoT المراد إنشاؤه. اختر اسماً فريداً لمركز IoT الخاص بك لاستخدامه بدلاً من my-pnp-hub:

az iot hub create --name my-pnp-hub --resource-group my-pnp-resourcegroup --sku F1 --partition-count 2

إنشاء مثيل DPS. يستخدم الأمر التالي الاسم my-pnp-dps كمثال لاسم مثيل DPS المراد إنشاؤه. اختر اسماً فريداً لمثيل DPS لاستخدامه بدلاً من my-pnp-dps:

az iot dps create --name my-pnp-dps --resource-group my-pnp-resourcegroup

لربط مثيل DPS بمركز IoT الخاص بك، استخدم الأوامر التالية. استبدل my-pnp-dps وmy-pnp-hub بالأسماء الفريدة التي اخترتها سابقاً:

hubConnectionString=$(az iot hub connection-string show -n my-pnp-hub --key primary --query connectionString -o tsv)
az iot dps linked-hub create --dps-name my-pnp-dps --resource-group my-pnp-resourcegroup --location centralus --connection-string $hubConnectionString

استرجاع الإعدادات

تستخدم بعض إجراءات التشغيل السريع والبرامج التعليمية سلسلة الاتصال لمركز IoT الخاص بك. تحتاج أيضاً إلى سلسلة الاتصال عند إعداد أداة مستكشف Azure IoT. استرجع سلسلة الاتصال وقم بتدوينها الآن. استبدل my-pnp-hub بالاسم الفريد الذي اخترته لمركز IoT الخاص بك:

az iot hub connection-string show -n my-pnp-hub --key primary --query connectionString

تستخدم معظم إجراءات التشغيل السريع والبرامج التعليمية نطاق المعرف لتكوين DPS. استرجع نطاق المعرف وقم بتدوينه الآن. استبدل my-pnp-dps بالاسم الفريد الذي اخترته لمثيل DPS:

az iot dps show --name my-pnp-dps --query properties.idScope

تستخدم جميع إجراءات التشغيل السريع والبرامج التعليمية تسجيل جهاز DPS. استخدم الأمر التالي لإنشاء my-pnp-deviceتسجيل جهاز فردي في مثيل DPS. استبدل my-pnp-dps بالاسم الفريد الذي اخترته لمثيل DPS. قم بتدوين معرف التسجيل وقيم المفاتيح الأساسية لاستخدامها في التشغيل السريع والبرامج التعليمية:

az iot dps enrollment create --attestation-type symmetrickey --dps-name my-pnp-dps --resource-group my-pnp-resourcegroup --enrollment-id my-pnp-device --device-id my-pnp-device --query '{registrationID:registrationId,primaryKey:attestation.symmetricKey.primaryKey}'

إنشاء متغيرات البيئة

قم بإنشاء خمسة متغيرات بيئة لتكوين العينات في أنشطة التشغيل السريع والبرامج التعليمية لاستخدام خدمة Device Provisioning Service (DPS) للاتصال بمركز IoT الخاص بك:

  • IOTHUB_DEVICE_SECURITY_TYPE: القيمة DPS.
  • IOTHUB_DEVICE_DPS_ID_SCOPE: نطاق معرف DPS الذي قمت بتدوينه مسبقاً.
  • IOTHUB_DEVICE_DPS_DEVICE_ID: القيمة my-pnp-device.
  • IOTHUB_DEVICE_DPS_DEVICE_KEY: مفتاح التسجيل الأساسي الذي قمت بتدوينه مسبقاً.
  • IOTHUB_DEVICE_DPS_ENDPOINT: القيمة global.azure-devices-provisioning.net

تحتاج عينات الخدمة إلى متغيرات البيئة التالية لتحديد المركز والجهاز المراد الاتصال به:

  • IOTHUB_CONNECTION_STRING: سلسلة اتصال محور IoT التي قمت بتدوينها مسبقًا.
  • IOTHUB_DEVICE_ID: my-pnp-device.

على سبيل المثال، في Linux bash shell:

export IOTHUB_DEVICE_SECURITY_TYPE="DPS"
export IOTHUB_DEVICE_DPS_ID_SCOPE="<Your ID scope>"
export IOTHUB_DEVICE_DPS_DEVICE_ID="my-pnp-device"
export IOTHUB_DEVICE_DPS_DEVICE_KEY="<Your enrolment primary key>"
export IOTHUB_DEVICE_DPS_ENDPOINT="global.azure-devices-provisioning.net"
export IOTHUB_CONNECTION_STRING="<Your IoT hub connection string>"
export IOTHUB_DEVICE_ID="my-pnp-device"

على سبيل المثال، في سطر أوامر Windows:

set IOTHUB_DEVICE_SECURITY_TYPE=DPS
set IOTHUB_DEVICE_DPS_ID_SCOPE=<Your ID scope>
set IOTHUB_DEVICE_DPS_DEVICE_ID=my-pnp-device
set IOTHUB_DEVICE_DPS_DEVICE_KEY=<Your enrolment primary key>
set IOTHUB_DEVICE_DPS_ENDPOINT=global.azure-devices-provisioning.net
set IOTHUB_CONNECTION_STRING=<Your IoT hub connection string>
set IOTHUB_DEVICE_ID=my-pnp-device

تنزيل ملفات النموذج

تستخدم إجراءات التشغيل السريع والبرامج التعليمية ملفات نموذجية لوحدة التحكم في درجة الحرارة وأجهزة منظم الحرارة. لتنزيل ملفات النموذج:

  1. قم بإنشاء مجلد يسمى نماذج على جهازك المحلي.

  2. انقر بزر الماوس الأيمن فوق TemperatureController.json واحفظ ملف JSON في مجلد الطرز.

  3. انقر بزر الماوس الأيمن فوق Thermostat.json واحفظ ملف JSON في مجلد الطرز.

تثبيت مستكشف Azure IoT

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

في المرة الأولى التي تقوم فيها بتشغيل الأداة، ستتم مطالبتك بسلسلة اتصال مركز IoT. استخدم سلسلة الاتصال التي قمت بتدوينها مسبقاً.

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

لمعرفة المزيد، راجع تثبيت واستخدام مستكشف Azure IoT.

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

يمكنك استخدام مركز IoT ومثيل DPS لجميع إجراءات التشغيل السريع والبرامج التعليمية لـ IoT Plug and Play، لذلك ما عليك سوى إكمال الخطوات الواردة في هذه المقالة مرة واحدة. عند الانتهاء، يمكنك إزالتها من اشتراكك باستخدام الأمر التالي:

az group delete --name my-pnp-resourcegroup

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

الآن بعد أن أعددت بيئتك، يمكنك تجربة أحد إجراءات التشغيل السريع أو البرامج التعليمية مثل:

توصيل نموذج لتطبيق جهاز IoT Plug and Play على IoT Hub