بدء استخدام 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 development

لدمج جهاز متوافق مع معيار 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 development kit
Realtek Ameba D Series
Silicon Labs ‫EFR32MG24 Dev Kit
EFR32MG Zigbee and Thread Starter Kit
Telink TLSR9528 دليل مطوّري معيار Matter من Telink
Texas Instruments CC2652R7 LaunchPad development 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 معيار 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.

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

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