بدء استخدام Matter

يسمح برنامج Home Developer من Google للشركات المصنّعة للأجهزة بربط أجهزتهم المنزلية الذكية بمنظومة 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 ليعمل كجهاز توجيه الحدود للأجهزة التي تستخدم تقنية Thread وكمسار تنفيذ محلي لتوجيه أهداف المنزل المزوّد بأجهزة ذكية.
  2. جهاز جوّال (هاتف تجريبي) يستوفي الحدّ الأدنى من المتطلبات:
    • الإصدار Android O (8.1، المستوى 27 من واجهة برمجة التطبيقات أو إصدار أحدث)
    • نظام التشغيل iOS (الإصدار 16.5 أو إصدار أحدث)
    • إمكانية تقنية البلوتوث المنخفض الطاقة (BLE)
  3. معرّف المورّد (VID) ومعرّف المنتج (PID) للجهاز الذي تم تفعيل Matter
  4. جهاز متوافق مع "Matter" يجب أن يكون هذا الجهاز أحد Matter أنواع الأجهزة المتوافقة مع منظومة Google Home المتكاملة، ويمكن أن يكون:
    • منتجك الخاص يحتوي على برامج ثابتة متوافقة مع Matter.
    • هي لوحة تطوير لمنصة مورّدين متوافقة يمكن استخدامها كجهاز متوافق مع Matter لإجراء عملية التحقّق التام بين الأطراف. في ما يلي الأنظمة الأساسية المتوافقة:
جدول: Matter أمثلة من مورّدي السيليكون
المورّد النظام الأساسي الأدلة دعم بقيمة Thread
مختبر بوفالو BL602 البدء بسرعة
BL702 البدء بسرعة
إسبرسيف ESP32 البدء بسرعة
اختبار عبر الهواء
صناعة أشباه الموصلات الشمالية nRF52840 DK البدء بسرعة
اختبار عبر الهواء
صرف العملات الأجنبية (NXP) مجموعة أدوات تطوير IOTZTB-DK006 البدء بسرعة
Realtek سلسلة Ameba D البدء بسرعة
مختبرات السيليكون مجموعة أدوات مطوّري البرامج EFR32MG24 البدء بسرعة
مجموعة أدوات المبتدئين EFR32MG Zigbee وThread البدء بسرعة
تيلينك TLSR9518 البدء بسرعة
آلات تكساس الآلية مجموعة أدوات تطوير LaunchPad لـ CC2652R7 البدء بسرعة

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

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

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

يجب تنفيذ معرِّف VID هذا في البرامج الثابتة لجهازك.

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

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

معرّف المنتج

تتم قراءة المعلومات عن الجهاز من مجموعة المعلومات الأساسية في Matter. يجب أن يتطابق معرّف المنتج الذي تم ترميزه في البرامج الثابتة لجهازك مع معرّف المنتج لعملية دمج Matter في Play 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.

1 راجع مفاتيح الإضاءة قيد التشغيل/الإيقاف لمعرفة كيفية تأثير ذلك في مفاتيح الإضاءة للتشغيل/الإيقاف.