بدء استخدام Matter

يتيح برنامج Google Home Developer للشركات المصنّعة للأجهزة ربط أجهزتها المنزلية الذكية بمنظومة Google Home المتكاملة. نعمل على توسيع مسار التنفيذ المحلي لإجراءات المنزل المزوّد بأجهزة ذكية من خلال إتاحة إمكانية إضافة الأجهزة التي تتضمّن ميزة Matter لإعدادها باستخدام Google Home app (GHA) والتحكّم فيها باستخدام Google Assistant أو GHA أو الشاشات الذكية مثل Google Nest Hub (2nd gen).

توضّح هذه المستندات كيفية البدء في إنشاء منصة متوافقة مع Matter ودمجها في منظومة Google Home المتكاملة.

بيانات إخلاء المسؤولية

في ما يتعلق بالإجراءات الموضحة في مستندات Matter، يُرجى الانتباه إلى ما يلي:

  • ننصح بأن يكون الحساب المستخدَم للتطوير مرتبطًا فقط بمركز واحد متوافق مع معيار Matter لأغراض الاختبار. قد يؤدي توصيل عدة أجهزة موزِّعة متوافقة مع Matter في الوقت نفسه أو توصيلها بالبنية نفسها أثناء الاختبار إلى سلوك غير متوقَّع.
  • تفترض جميع الإجراءات استخدام جهاز Linux يعمل بنظام التشغيل Ubuntu 20.04 لإنشاء عيّنات Matter وتثبيتها، والتي تم اختبارها من قِبل Google. على الرغم من أنّ أجهزة macOS متوافقة، ننصح باستخدام Linux. يتم توضيح التعليمات الخاصة بنظام التشغيل Mac في الإجراءات حسب الحاجة.

طريقة إنشاء الوكلاء

لإنشاء جهاز متوافق مع Matter يتكامل مع منظومة Google Home المتكاملة، عليك استخدام لوحة تطوير متوافقة مع Matter وحزمة تطوير البرامج (SDK) لـ Matter.

أسهل طريقة للبدء هي الاطّلاع على الدروس التطبيقية حول الترميز. ننصحك بإجراء واحد على الأقل من الدروس التطبيقية التالية حول الترميز:

بعد ذلك، اطّلِع على قائمة الأجهزة المتوافقة للتأكّد من أنّ الجهاز الذي تريد دمجه متوافق مع منظومة Google Home المتكاملة. بعد ذلك، اطّلِع على قائمة التحقّق للمطوّرين لفهم عملية التطوير بأكملها، بدءًا من إنشاء المشروع وحتى إطلاقه.

الأجهزة المتوافقة قائمة التحقّق للمطوّرين

التعريفات

يتم استخدام المصطلحات التالية في هذه المستندات:

جهاز توجيه الحدود
هو مركز ينفّذ جهاز توجيه حدود Thread للأغراض العامة للأجهزة التي تتضمّن ميزة Thread.
مركز النشاط
جهاز Google Nest متوافق، مثل Google Nest Hub (2nd gen). يجب استخدام وحدة تحكّم للتحكّم في الأجهزة المتوافقة مع معيار Matter من خلال مساحات عرض أخرى، مثل Assistant وGHA والشاشات الذكية.
جهاز متوافق مع Matter
جهاز أو لوحة تطوير تم تثبيت إصدار أو نموذج تطبيق متوافق مع "Matter" عليهما
الأجهزة الجوّالة
هاتف الاختبار المستخدَم للمساعدة في عملية الإقران هذا الهاتف هو حاليًا هاتف Android.

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

إضافات بيئة التطوير المتكاملة (IDE) المقترَحة لتطوير Matter

لدمج جهاز متوافق مع معيار Matter بشكل كامل مع منظومة Google Home المتكاملة، يجب أن يتوفّر لدى المطوّر ما يلي:

  1. مركز Google متوافق مع Thread ليعمل كـ border router للأجهزة المتوافقة مع Thread وكمسار تنفيذ محلي لتوجيه الطلبات المتعلقة بالمنزل المزوّد بأجهزة ذكية
  2. جهاز جوّال (هاتف اختباري) يستوفي الحدّ الأدنى من المتطلبات:
    • ‫Android O (الإصدار 8.1، المستوى 27 من واجهة برمجة التطبيقات أو إصدار أحدث)
    • نظام التشغيل iOS (الإصدار 16.5 أو إصدار أحدث)
    • إمكانية الاتصال عبر البلوتوث المنخفض الطاقة (BLE)
  3. معرّف المورّد (VID) ومعرّف المنتج (PID) للجهاز الذي يتضمّن ميزة "Matter"
  4. جهاز متوافق مع Matter يجب أن يكون هذا الجهاز أحد أنواع الأجهزة البالغ عددها Matter والمتوافقة مع منظومة Google Home المتكاملة، ويمكن أن يكون:
    • منتجك الخاص المزوّد ببرنامج ثابت يتوافق مع Matter
    • أحد أجهزة Matter التالية لاستخدامه في عملية التحقّق الشاملة:
الجدول: Matter أمثلة من مورّدي السيليكون
المورّد النظام الأساسي دعم "Thread" الدليل
Bouffalo Lab BL602
BL702
Espressif ESP32 اختبار OTA
Nordic Semiconductor nRF52840 DK اختبار OTA
NXP حزمة تطوير البرامج IOTZTB-DK006
Realtek Ameba D Series
Silicon Labs EFR32MG24 Dev Kit
مجموعة أدوات البدء EFR32MG Zigbee and Thread
Telink TLSR9528 دليل المطوّرين حول Telink Matter
Texas Instruments مجموعة تطوير CC2652R7 LaunchPad

رقم تعريف المورّد

يمكنك تلقائيًا استخدام أحد أرقام تعريف المورّدين التي يخصّصها التحالف لأغراض الاختبار. اختَر أحد الخيارات التالية: 0xFFF1 أو 0xFFF2 أو 0xFFF3 أو 0xFFF4.

لاستخدام معرّف مورّد للإصدار العلني من أجل اعتماد عملية الدمج وإطلاقها، عليك أولاً التحقّق منه من خلال Google للتأكّد من أنّه تم إصداره لك من قِبل "التحالف".

يجب تنفيذ رقم تعريف المورّد هذا في البرامج الثابتة لجهازك.

لا يمكن إقران جهاز Matter إلا في منظومة Google Home المتكاملة في سيناريوهات معيّنة لرقم تعريف المورّد ونوع الجهاز.

  • لا يمكن استخدام رقم تعريف المورّد الاختباري في جهاز المستهلك.
  • يجب أن يكون رقم VID الخاص بالإصدار العلني صادرًا عن Connectivity Standards Alliance (Alliance). ستتحقّق Google من أنّك مالك رقم تعريف المورّد هذا قبل أن تتمكّن من استخدامه في Google Home Developer Console. بعد ذلك، ستتمكّن من إنشاء عمليات تكامل لرقم تعريف المورّد هذا.
  • لأغراض التطوير وField Trial، يجب إنشاء مشروع وعملية دمج مع تركيبة VID وPID المقابلة في Developer Console. يجب أن يكون المستخدم الذي يشغّل الجهاز عضوًا في المشروع أو مدرجًا في قائمة مستخدمي Field Trial.
  • لا يمكن للمستهلكين استخدام منتجك إلا بعد اعتماده من قِبل Alliance.

يمكن استخدام VID وPID مرة واحدة فقط لعملية دمج واحدة. إذا أردت استخدام رقم تعريف المورّد (VID) أو رقم تعريف المنتج (PID) نفسه في عملية الدمج، عليك إجراء أي مما يلي:

  • عدِّل عملية الدمج باستخدام رقم تعريف المورّد (VID) أو رقم تعريف المنتج (PID) إلى رقم تعريف مورّد أو رقم تعريف منتج مختلفَين.
  • احذف عملية الدمج باستخدام رقم تعريف المورّد (VID) أو رقم تعريف المنتج (PID).
الجدول: سيناريوهات إقران معرِّف المورِّد (VID) ونوع الجهاز
ما هي أنواع المستخدمين الذين يمكنهم تشغيل الجهاز في منظومة Google Home المتكاملة؟
نوع مستند تعريف الهوية شهادة VID وحالة التكامل مع وحدة التحكّم الإصدار العلني
(المستخدمون المستهلكون)		 التطوير
(المطوّرون، Field Trial مستخدم)
اختبار لا يتوفّر دمج في Developer Console (لا يمكن اعتماده)
اختبار عملية الدمج متوفّرة في Developer Console (لا يمكن اعتمادها)
الإنتاج غير معتمَد، عملية الدمج غير متوفّرة في Developer Console
الإنتاج غير معتمَد، يتوفّر الدمج في Developer Console
الإنتاج معتمَد في قائمة الأجهزة المتوافقة (DCL) في Alliance، ولا يتوفّر الدمج في Developer Console
الإنتاج معتمَد في قائمة "Alliance" للبلدان المسموح بها، وعملية الدمج متوفّرة في "Developer Console"

معرّف المنتج

تتم قراءة المعلومات حول الجهاز من مجموعة المعلومات الأساسية Matter. يجب أن يتطابق معرّف المنتج المشفّر في البرامج الثابتة لجهازك مع معرّف المنتج لعملية دمج Matter في Developer Console.

الميزات غير المتوافقة

Matterبعض مجموعات الصور لا تظهر للمستخدمين بعد، ولكن قد يستخدمها النظام. في معظم الحالات، يعني ذلك أنّ السمات التي يتم عرضها من خلال هذه المجموعات لا تظهر للمستخدمين النهائيين:

Table: Matter clusters not exposed to users in the Google Home ecosystem
Cluster Type Clusters
Core
  • Binding ¹
  • Label
  • Fixed Label
  • User Label
  • Actions
  • Group Key
  • Localization Configuration
  • Time Format Localization
  • Unit Localization
  • Power Source Configuration
  • Power Source
  • Diagnostics clusters (Diagnostic Logs, General Diagnostics, Software Diagnostics, Thread Network Diagnostics, Wi-Fi Network Diagnostics, Ethernet Network Diagnostics)
  • Time Synchronization
  • Mode Select
Application
  • Groups and Scenes are not directly supported. Equivalent functionality is available via Routines.
  • All Media clusters. Equivalent functionality is available via Google Cast.

¹ يُرجى الاطّلاع على مفاتيح الإضاءة لمعرفة تأثير ذلك في مفاتيح الإضاءة.

التالي
قائمة التحقّق من مطوّري البرامج