بدء استخدام Matter

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

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

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

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

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

كيفية الإنشاء

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

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

بعد ذلك، اطّلِع على قائمة الأجهزة المتوافقة للتأكّد من أنّ ما تخطط لدمجه متوافق مع نظام 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 أمثلة على أجهزة Matter من مورّدي السيليكون
المورّد النظام الأساسي Thread الدعم الدليل
Bouffalo Lab BL602
BL702
Espressif ESP32 اختبار خدمة "عبر الهواء"
Nordic Semiconductor nRF52840 DK اختبار خدمة "عبر الهواء"
NXP لوحة تطوير IOTZTB-DK006 كيت
Realtek سلسلة Ameba D
Silicon Labs حزمة تطوير EFR32MG24
حزمة البدء EFR32MG Zigbee وThread
Telink TLSR9528 دليل المطوّر لمعيار Matter من Telink
Texas Instruments حزمة تطوير CC2652R7 LaunchPad kit

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

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

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

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

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

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

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

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

معرّف المنتج

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

¹ يمكنك الاطّلاع على مفاتيح تشغيل/إيقاف الإضاءة لمعرفة كيفية تأثير ذلك في مفاتيح تشغيل/إيقاف الإضاءة.

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