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

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

يمكنك تلقائيًا استخدام أحد أرقام تعريف المورّدين التي خصّصها التحالف لأغراض الاختبار. اختَر أحد الأرقام التالية: 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 قائمة الأجهزة المعتمدة (DCL) التابعة للتحالف، لا تتوفّر عملية دمج في Developer Console Developer Console
الإنتاج معتمَدة في قائمة الأجهزة المعتمدة (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.

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

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