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

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

قبل أن تتمكن من إكمال أي من البرامج التعليمية والبرامج التعليمية الخاصة بـ 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 explorer. استرجع سلسلة الاتصال وقم بتدوينها الآن. استبدل 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}'

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

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

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

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

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

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

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

az group delete --name my-pnp-resourcegroup

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

الآن بعد أن أعددت بيئتك، يمكنك تجربة أحد الخطوات السريعة أو البرامج التعليمية مثل:

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